.agents/skills/maa-issue-log-analysis/KNOWLEDGE.md
gui.log、asst.log、资源任务和当前代码一起判断。从 SKILL.md 迁入：分析时容易踩的误判陷阱。
gui.log 只显示"连接失败"，但 asst.log 里已经给出 adb devices、adb connect、端口轮询和 ConnectionInfo。连接类问题必须以 asst.log 为准。adb devices 显示目标地址 offline，随后 MuMu 备选端口都 10061，通常更像模拟器 / ADB 状态异常，或自动探测到的端口不可达，而不是任务逻辑问题。gui.log 显示选中的关卡是 15-13-hard 一类 hard 代码，而 asst.log 长时间卡在 ChapterDifficultyHard，OCR 却反复识别到和按钮无关的文字，通常说明当前画面没有进入预期的难度切换界面。asst.log 明确写了 Save image 到 debug/interface/*.png 或 debug/drops/*.png，但上传包没有相应分卷时，要把"缺失的现场证据"单独写出来。part02 可以是空包，也可以只包含图片；不要因为没有文本日志就把它判成"无用分卷"。gui.log 说"任务出错"，但对应 taskid 的 asst.log 实际 AllTasksCompleted，要明确写"本次日志未复现用户描述的问题"。asst.log 里出现 InfrastClueQuickInsert、remove_clue、SendClues 或 InfrastClueQuickSendDuplicates，先对照资源任务判断这是不是当前设计流程，不要只看线索板中途是否为空。git checkout vXXX）核对旧逻辑。src/MaaCore/Task/Interface/RoguelikeTask.cpp 中 // m_roguelike_task_ptr->set_ignore_error(true); 来自提交 ｢不忽略肉鸽的报错｣（d3a5217f3b）。旧版任务级容错在卡到不可恢复的画面时，会反复重试、长时间既不报错也不往下执行，一挂几个小时；该提交正是为消除这种静默挂死。恢复它等于重回旧病——当年禁用某机制时观察到的症状，就是恢复它要付出的代价。set_ignore_error 是任务 / 插件级 ｢失败不报错｣ 开关，不是 ｢非关键子任务失败不中断整链｣；插件级的非关键忽略（肉鸽战斗 / 招募 / 技能选择插件）早已单独设置，任务级一刀切打开只有掩盖错误一个效果。FailureDisposition（src/MaaCore/Task/Roguelike/BlackFlow/BlackFlowSession.h：RestartRun / StopTask 两档）：可恢复失败已会自动放弃当前局重开；用户仍看到 ｢停止｣，恰是框架判定不可恢复或恢复链失败的适配 bug，该修的是分类与适配，不是加重启循环。StartExplore 受 starts_count 次数限制，默认无限局），任务链不是恢复的自然粒度；在 GUI 层捕获 TaskChainError 后重抛整条任务链，画面可识别时不如 Core 层恢复出口，画面不可识别时只会循环复现同一失败。gui.new.json 和实际日志不一致时，不要急着判"用户配置写错了"；先看 gui.new.json.bak，尤其是用户复现后又改回开关的场景。ConnectConfig=PC 的 issue 里，Win32Controller::click 正常返回不代表点击真的生效；要看点击后的下一帧中，按钮状态、数量 OCR、场景识别有没有变化。gui.log 中"已使用即将过期的理智药"这类高层提示，不一定等价于底层逐药 OCR 结论；如果 asst.log 明确识别到 3天、NotExpiring 等相反证据，应优先相信 asst.log。注意过期天数阈值现为可配置参数 medicine_expire_days，不再是固定 48 小时。minitouch（默认）、maatouch（实验性）、adb input（不推荐使用）、MaaFwAdb（GUI 显示为 ｢MaaFramework（实验功能）｣）和 MumuExtras（仅 MuMu 截图增强启用时可选）。maatouch 是 minitouch 的 Java 实现，并额外支持按键输入，可避免 minitouch 走 adb 命令传输按钮带来的较高延迟。adb input 仅用于兼容部分系统版本过低、无法运行 minitouch 或 maatouch 的实体机设备。adb input。adb input 的滑动容易拖飞，为避免此问题，滑动速度会被设置得非常慢，且滑动距离与其他模式不同；在需要精确控制坐标的场景下无法使用。MaaFwAdb 不支持额外滑动：额外滑动是主滑动结束后沿垂直方向追加一小段的 ｢刹车｣ 滑动（轨迹类似拐 90° 的 L 形），用于抵消列表惯性；MaaFwAdbController::swipe 的 extra_swipe / slope_in / slope_out 参数均未实现，只做纯直线滑动。依赖额外滑动防拖飞的页面在该模式下会拖飞。adb input 或 ｢MaaFramework（实验功能）｣ 时，应优先建议切换为 minitouch 或 maatouch 再复现，排除模式自身的局限与延迟问题。