Diagnostics Report

English | 中文

取证与报障

遇到"订单结果不对 / CPU 卡死 / 数量不对"时，按下面的步骤取证，能把"复现不出来"的问题变成作者可离线定位的证据。全程约两分钟。

步骤一：预备录制

1. 登录服务器，在聊天栏输入：

/ae2vm trace record next

2. 回执确认录制待命成功（"下一次下单将被记录"）。

【截图位 1：record next 的回执消息】

步骤二：复现问题

3. 立即在终端手动重新下一单（参数与出问题时一致：同一物品、同一数量）。注意：只记录预备后的下一单，多余操作不会录入；如果问题只在特定网络状态下出现，先恢复那个状态再下单。

【截图位 2：下单与异常结果（如确认界面/卡住的 CPU 状态）】

步骤三：找到轨迹

4. 输入：

/ae2vm trace list

5. 列表最上方就是刚生成的轨迹（状态列：绿=完成、黄=停摆、红=异常）。鼠标悬停可看详情。

【截图位 3：trace list 输出】

步骤四：交付证据（二选一）

方式 A（推荐，最快）——上传短链：

6. 点击列表条目旁的 [上传] 按钮（或输入 /ae2vm trace upload <编号>）；
7. 聊天栏返回一个 mclo.gs 短链——把它贴进 issue 即可。

【截图位 4：upload 返回的短链】

方式 B——下载文件：

6. 客户端安装本 mod 时，点击 [下载] 按钮（或 /ae2vm trace download <编号>）；
7. 文件落在 .minecraft/aevm/traces/，直接作为附件上传 issue。

轨迹在上传/下载前已自动脱敏：物品与玩家名称都已替换为代号，不含你的整合包明文名称。

步骤五（可选，进阶）：本地重放

装了 mod 的玩家也可以在自己电脑上重放该轨迹并核对判定，命令与退出码见CPU 模拟判定。不做这一步也完全不影响报障。

在 issue 里贴什么

• 复现步骤（含 record next 的时机）；
• mclo.gs 短链或轨迹文件；
• （可选）服务端 latest.log 上传 mclo.gs 后的链接（VM 的 [AE2-VM DIAG-*] 行同样有价值）。