Mda Issue Log Analysis

MDA Issue / Log Analysis

Scope

• 用于 MDA 仓库：https://github.com/1204244136/MDA。
• 输入可以是完整 issue URL、#1234 形式的 issue 编号、本地日志目录或日志压缩包路径。
• 只分析用户授权访问的公开 issue、用户提供的日志包或本地文件。
• 如果 issue 没有日志包，且问题明确需要运行证据，先说明证据不足；不要凭空推断根因。
• 如果发现 .dmp 文件，必须联动 dmp-analysis skill，不要只凭文本日志猜测崩溃原因。

Workflow

1. 规范化输入

• #1234 视为 https://github.com/1204244136/MDA/issues/1234。
• 如果 URL 不是 1204244136/MDA，说明本 skill 不适用，除非用户明确要求按 MDA 同类日志格式分析。
• 如果输入是本地路径，先识别它是目录、zip 包还是单个日志文件。

2. 获取 issue / 日志上下文

从 issue 或用户描述中提取：

• MDA 版本。
• MaaFramework / MXU 版本。
• 控制器类型。
• 任务名 / 入口名。
• 用户期望行为。
• 实际行为。
• 复现步骤。
• 维护者评论。

维护者评论只能作为线索；仍需用日志和代码自行验证。

3. 提取日志附件

关注 MDA 导出的日志压缩包。附件命名可能随打包工具变化，不要只匹配单一文件名；优先寻找包含以下文件或目录的 zip：

• maafw.log
• maafw.bak.*.log
• go-service.log
• mxu-tauri.log
• mxu-web-YYYY-MM-DD.log
• mxu-agent*.log
• config/
• on_error/
• .dmp

如果同一个 issue 有多个日志包：

1. 先看最新一次复现。
2. 若 issue 在对比版本、控制器或配置，再补看前面的包。

4. 下载 / 解压日志包

二进制 zip 不要用网页抓取工具直接读取。使用终端下载到临时目录，例如：

.cache/issue-logs/issue-<number>/
.cache/log-analysis/local-<timestamp>/

解压后先列目录，不要假定结构固定。常见差异：

• 多份 mxu-agent-<index>-<pid>.log。
• 多天 mxu-web-YYYY-MM-DD.log。
• maafw.log 过短，需要看 maafw.bak.*.log。
• 没有 on_error/。
• 现场图被日志导出体积限制截断。
• 包内存在 .dmp。

5. DMP 崩溃转储分析

如果发现 .dmp：

1. 立即读取并执行 .claude/skills/dmp-analysis/SKILL.md。
2. 解析异常类型、崩溃模块、crashing thread。
3. 需要时下载 MaaFramework / MXU PDB 并符号化。
4. 用 DMP 文件名中的 PID 与 maafw.log 的 [Px<pid>] 或 MXU 日志交叉验证。
5. 最终报告必须包含 DMP 分析区域，并列出 crashing thread 的全部有效帧。

不要把 .dmp 当作普通附件跳过。

6. 建立时间线

先定位用户认为出问题的时间，再串联日志：

1. mxu-web-*：前端提交了什么任务和配置。
2. mxu-tauri.log：实例、控制器、资源、任务开始/停止、agent 生命周期。
3. maafw.log / maafw.bak.*.log：Pipeline 节点识别、动作、超时、回调。
4. go-service.log：Go 自定义逻辑、环境检查、业务日志。
5. mxu-agent*.log：agent stdout/stderr 和用户运行日志面板。
6. on_error/：错误现场截图。

优先锁定本次复现的 task_id，后续分析都限定到该任务实例。一个日志包里经常混有历史运行，不要串任务。

7. 回溯到 MDA 代码和配置

MDA 代码证据优先顺序：

• 任务入口、控制器限制、用户选项：
  • assets/tasks/*.json
  • assets/interface.json
  • assets/tasks/preset/*.json
• Pipeline 节点：
  • assets/resource/pipeline/**/*.json
• Go 扩展逻辑：
  • agent/go-service/**
• Schema / 协议：
  • tools/schema/*.json
• 本地化文案：
  • assets/locales/interface/zh_cn.json
  • assets/locales/interface/en_us.json

总结任务、选项、界面提示时，优先读取 zh_cn.json 的中文文案，不要直接把 task id 当成用户可见名称。

8. 必要时查上游

先用 issue、日志、MDA 仓库和 MaaFramework 文档做初步归因。只有证据指向上游实现或现有证据不足时，再看：

• MaaFramework：https://github.com/MaaXYZ/MaaFramework
• MXU：https://github.com/MistEO/MXU
• maa-framework-go：https://github.com/MaaXYZ/maa-framework-go
• maa-framework-rs：https://github.com/MaaXYZ/maa-framework-rs

不要为了普通 Pipeline 配置问题过早下钻上游源码。

Log Map

maafw.log

MaaFramework 核心运行时日志。

最适合看：

• Pipeline 是否按预期推进。
• next / on_error 是否命中。
• Tasker.Task.Starting / Succeeded / Failed。
• Node.Recognition.Failed 连续重复。
• Node.Action.Failed。
• OCR / TemplateMatch / ColorMatch 细节。
• 控制器、截图、资源加载问题。

maafw.bak.*.log

滚动日志。用于：

• 当前 maafw.log 不够长。
• 复现发生在较早时间。
• 对比同配置的历史成功/失败样本。

不要把旧日志误判成最新复现。

go-service.log

MDA Go Agent 日志。

最适合看：

• 自定义识别器/动作是否触发。
• taskersink 环境检查，例如 HDR、分辨率、进程检查、会员/额度逻辑。
• Go 参数解析、外部请求、业务扩展错误。

环境告警不一定是根因，必须和 maafw.log、现场截图一起判断。

mxu-tauri.log

MXU Tauri/Rust 后端日志。

最适合看：

• 实例创建与资源加载。
• 控制器连接。
• 任务开始/停止。
• agent 生命周期。
• maa_ffi 回调。
• 用户是否手动停止任务。