MaaFW 调试与验收

标注 TODO 的节为实践待补的经验样本（增量内容，不影响可用性）；分诊状态见 skills/README.md。

定位：开发态、设备在线的实时调试与验收（验收环节的冷启动 / 重连 / 断线恢复由开发者主动制造离线与重连窗口，属验收手段而非离开开发态）。字段精确语义（字段名、参数、默认值、版本支持）与调试命令一律路由 MaaLLMWiki 版本锁定的协议原文（2.4-控制方式说明、3.1-任务流水线协议、3.3-ProjectInterfaceV2）；运行工具的命令与结果字段路由所选运行工具自身文档（Agent 自主默认 maafw-live，见 references/tooling.md）——协议原文不含工具命令。两类来源不可达时标记"未验证"。事后日志与证据诊断（用户日志、Sentry、历史记录）归 MaaEvidenceKit 的 maa-evidence，不是本 skill。

硬护栏

1. 证据优先：每个诊断结论必须有实时观测证据——当前帧、识别命中/未命中与得分、日志、box 与落点比对；「可能是」必须转成可验证假设再测，不许凭猜下结论（与 maafw-pipeline 的探索优先同源）。
2. 一次一个变量：阈值 / ROI / 模板 / 参数每次只改一个，改完立即复测并留记录；多处同时改后结果变化无法归因——调试态第一纪律。
3. 走框架链路：诊断用截图与点击必须走框架截图链路（观测底座 / 框架截图 API / 运行工具），不用外部截图工具——分辨率与图像空间必须与识别输入一致（像素空间一致原则继承 maafw-pipeline 素材标准）。
4. 只定位不修复：本 skill 产出「定位结论 + 证据」。边界：为验证假设可临时改并立即复测（硬护栏 2「一次一个变量」正是此用法），但交付物仍是结论 + 证据，修复落盘走交接（识别/流程 → maafw-pipeline，接线/选项 → maafw-interface，custom → maafw-custom；修改轨已含 ROI 微调这类小修）——不边定位边做结构性改动。
5. 判定分级：区分调用成功（命令是否执行完）、任务成功（任务级结果 + 实际识别命中）、业务验收成功（功能行为符合预期）——三层互不顶替，调用层信号（外层 ok / 退出码）不能当任务或验收结论；具体判定字段与退出码语义随工具（maafw-live 见 tooling.md 判定要点）。一次跑通 ≠ 稳定——验收要重复、含冷启动与重连。
6. 调试现场及时留存：调试过程中的关键帧及时升格进关键帧库（观测底座留存），现场过了就过了；脱机的事后分析转 maa-evidence。

工作流

0. 分诊（先分层再动手）