Maa Issue Log Analysis
Testing & Qualitymaa-issue-log-analysisMaa Issue Log Analysis is an Agent Skill for testing & quality published in the MaaAssistantArknights/MaaAssistantArknights repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
分析 MaaAssistantArknights 上游仓库公开 Issue(`https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/...` 或 `#1234`)。自动抓取 issue 正文和评论中的 `report_*.zip` 附件,优先读取 `debug/asst.log`、`debug/gui.log`、`config/gui.json` / `config/gui.new.json`、`cache/resource/tasks.json`,并在有后续分卷时补看 `debug/interface/*.png`、`debug/drops/*.png`、`debug/infrast/**`、`debug/dumps/*` 等现场证据;结合 MAA Core/WPF/资源任务代码与文档判断根因、给出修复方案,供用户让你分析 MAA issue、日志包、ADB 连接失败、关卡导航、识别失败、任务出错、闪退时使用。
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/HEAD/.claude/skills/maa-issue-log-analysis/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/maa-issue-log-analysis, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
MAA Issue Log Analysis
Required Reading
- 开始分析前,先读取同目录的
KNOWLEDGE.md,先用其中的通用误判规则校正自己的分析路径,再读 issue 和日志。 - 如果 issue 涉及会客室、线索、快捷按钮、批量按钮、自动领取/赠送/放置这类“会先改变界面状态再继续执行”的流程,必须先套用
KNOWLEDGE.md中的Stateful UI Automation Checks与Reception Clue Analysis。 - 如果用户没有贴出日志、报告包、报错文本、截图或导出诊断等有效证据,不要直接进入严肃日志分析;先转用同目录技能
maa-cyber-fortune-master/SKILL.md生成一段短小的玄学回复,把对话自然引导到“补日志 / 截图 / 报错 / 诊断信息”。
Scope
- 仅用于上游公开仓库
https://github.com/MaaAssistantArknights/MaaAssistantArknights。 - 输入可以是完整 issue URL,或
#1234形式的 issue 编号。 - 只分析公开 issue 中可直接访问的附件。
- 如果没有可下载的
report_*.zip,先判断用户是否至少提供了其他有效证据(报错文本、截图、导出诊断、清晰复现步骤)。 - 如果连这些也没有,优先转用
maa-cyber-fortune-master/SKILL.md,不要直接输出严肃分析模板。 - 如果没有
report_*.zip但仍有其他有效证据,再明确说明证据不足,并尽量基于 issue 文本、截图、代码和文档给出初步判断。 - 如果评论里有机器人提示“日志没有上传成功”,不要直接放弃;正文里的附件链接仍可能可下载。
Workflow
- 规范化输入。
#1234视为https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/1234- 如果不是
MaaAssistantArknights/MaaAssistantArknights,停止并说明此 skill 不适用。
- 先判断证据是否足够。
- 如果用户只给一句模糊现象,且没有日志、报告包、截图、报错文本、导出诊断或清晰复现步骤,不进入本 skill 的严肃分析流程。
- 此时改用
maa-cyber-fortune-master/SKILL.md,先用短小玄学回复活跃气氛,再把对话引导到补充日志、截图、报错或诊断信息。 - 只有在用户已经提供可分析证据时,才继续下面的 issue / 日志分析步骤。
- 获取 issue 内容。
- 读取正文和评论。
- 提取这些信息:UI/Core/Resource 版本、资源时间、模拟器类型、分辨率、截图增强、GPU 推理、任务名、关卡名、是否有
-hard、用户现象、复现步骤、维护者或机器人评论。 - 不要把评论结论当成唯一证据;仍要用日志和代码自行验证。
- 如果 issue 文本或评论里已经有人下了“这是游戏设计 / 不是 bug / 本来就这样”的结论,先暂存,不要直接复述成最终判断;先核对日志、资源任务和当前代码是否真的支持这个结论。
- 提取报告附件。
- 关注
report_*.zip。 - 附件可能同时出现在正文和评论。
- 按
report_MM-dd_HH-mm-ss分组,同一时间戳下的part01、part02、part03是独立 zip,不是需要先拼接的分卷压缩包。
- 先看
part01,再决定是否看part02+。
- 根据 WPF 打包逻辑,
part01一定优先,通常包含: debug/asst.logdebug/asst.bak.logdebug/gui.logdebug/gui.bak.logconfig/*cache/*resource/*_custom.*part02+只包含debug子目录中最近 3 天修改过的文件,可能是:debug/interface/*.pngdebug/drops/*.pngdebug/infrast/**debug/roguelike/**debug/dumps/*part02+可能是空包,也可能只包含图片;不要默认里面一定有文本日志。
- 建立时间线。
- 先用
gui.log找用户点击、所选关卡、任务链开始、报错时间。 - 再用
asst.log还原底层行为。 - 关卡或任务问题时,优先用
gui.log中的Start Task Chain、GetFightStage、任务出错锁定时间窗,再回到asst.log里的taskid、SubTaskError、TaskChainError。 - 连接问题时,优先把
gui.log中的重试流程和asst.log中的adb devices、adb connect、ConnectionInfo串起来。 - 如果
ConnectConfig是PC,改走AttachWindow/Win32Controller这条线: - 先在
gui.log确认AttachWindow: Found window - 再在
asst.log里看Win32Controller::screencap、Win32Controller::click - 不要再按 ADB 端口或
ConnectionInfo.ConnectFailed的思路分析 - 如果问题属于状态型 UI 自动化(例如会客室线索、批量按钮、快捷按钮、先拆后放一类流程),时间线里必须单独标出:
- 自动化在什么时刻先修改了用户原状态
- 后续进入下一步或恢复终态由哪个条件控制
- 条件不满足时流程是停止、跳过,还是按设计停在别的状态
- 区分 issue 当时环境和当前分支。
- 先以报告包中的
config/与cache/resource/还原用户当时实际运行的配置和资源。 - 再对照当前仓库代码,判断该问题是当前仍存在,还是当时存在但现在已修复。
- 输出给用户时,如果提到任务名、设置项、按钮名、错误提示或日志前缀,先到
src/MaaWpfGui/Res/Localizations/zh-cn.xaml查中文文案,不要直接把LocalizationHelper.GetString("Key")里的Key、DynamicResourcekey、TaskChain名或枚举名当成最终展示文本。
Report Map
debug/asst.log
- 模块归属:MAA Core 运行时。
- 主要内容:ADB 命令、连接回调、识别、Pipeline、关卡导航、截图保存路径、C++ 源文件和函数名。
- 最适合看:
- ADB 连接问题
- 关卡导航问题
SubTaskError/TaskChainError- OCR / 模板 / 点击失败
- 对根因判断最权威。
debug/asst.bak.log
- 模块归属:上一轮 Core 滚动日志。
- 最适合看:
- 最新一次复现不在
asst.log - 需要对比前一次成功 / 失败
debug/gui.log
- 模块归属:WPF GUI / AsstProxy / TaskQueue。
- 主要内容:程序版本、资源加载、所选任务与关卡、用户可见报错、连接重试流程、
Start Task Chain。 - 最适合看:
- 建时间线
- 用户到底选了什么
- GUI 是否自动做了“断开重连 / 重启 ADB / 强杀 ADB”
- 这是最快的入口,但不是所有问题的最终根因。
debug/gui.bak.log
- 模块归属:上一轮 GUI 滚动日志。
- 最适合看:
- 程序重启前的上下文
- 更早一次复现
config/gui.json、config/gui.new.json、备份文件
- 模块归属:GUI 配置快照。
- 常见文件:
config/gui.jsonconfig/gui.new.jsonconfig/gui.json.oldconfig/gui.json.bak- 最适合看:
- 实际连接配置
- 模拟器路径、ADB 地址、是否开启截图增强
- 任务队列、
StagePlan - 是否真的选择了
15-13-hard之类的硬难度关卡 - 注意:
gui.new.json可能比gui.json更接近用户当前界面上的任务配置,不能只看一个文件。- 如果
gui.new.json与gui.log/asst.log的实际运行状态冲突,继续检查: gui.new.json.bakgui.json.oldgui.json.bak- 报告导出时用户可能已经改过勾选项,当前文件不一定就是复现时那一份。
cache/resource/tasks.json 和 cache/resource/tasks/tasks.json
- 模块归属:issue 当时使用的缓存资源。
- 最适合看:
- 用户当时到底跑的是哪一版资源定义
- 当前分支资源和 issue 当时资源是否不同
- 如果 issue 版本较旧,先信报告包里的
cache/resource,再用当前仓库代码判断是否已修复。
cache/gui/StageActivity.json / StageActivityV2.json
- 模块归属:GUI 关卡活动缓存。
- 最适合看:
- 活动 / 章节 / 关卡可用性
- 关卡显示和导航问题
debug/interface/*.png
- 模块归属:界面失败现场图。
- 最适合看:
- 关卡导航失败
- 识别错画面
- 按钮没出现、位置不对、被别的界面覆盖
- 如果
asst.log有Save image ... debug/interface/...,但上传包没有这张图,要明确说明“日志表明现场图存在,但用户未上传对应分卷”。
debug/drops/*.png
- 模块归属:掉落识别现场图。
- 最适合看:
- 结算页与掉落识别问题
debug/infrast/**、debug/roguelike/**
- 模块归属:任务特定调试图。
- 最适合看:
- 基建换班
- 肉鸽识别或路径问题
debug/dumps/*
- 模块归属:崩溃转储副本。
- 最适合看:
- 闪退、崩溃
- issue 模板还可能要求额外上传
MAA.exe.dmp,如果有,也要一起分析。
How To Filter Evidence
- 先从 issue 文本拿到这几个锚点:
- 版本与资源时间
- 模拟器品牌、分辨率、截图增强、GPU 推理
- 任务名 / 关卡名 / 是否有
-hard - 报告时间戳,例如
report_03-15_11-07-05 - 如果日志流程和当前主线代码不一致,先确认用户版本,必要时切到对应 tag(例如
git checkout vXXX)复核旧逻辑
- 再从
gui.log找这几类高价值信号:
正在连接模拟器Already connectedGetFightStageStart Task Chain任务出错连接失败
- 再到
asst.log找底层证据:
ConnectionInfoConnectFailedTaskChainErrorSubTaskErrorto_be_recognizedcur_retrySave imageofflineunauthorizedfailed to connectcannot connect
- 对连接问题,重点看:
adb.exe devices里有没有offlineadb.exe connect是否报10061ConnectionInfo.what/whyconfig/gui.json中的:ConnectConfigConnect.AddressConnect.AllowADBRestartConnect.AllowADBHardRestartConnect.MuMu12Extras.Enabled- 默认 MuMu 12 端口列表是否和日志中的轮询顺序一致
- 对 PC / AttachWindow 问题,重点看:
config/gui.json中Connect.ConnectConfig == "PC"gui.log中:连接 PC 端(实验性功能,稳定性无法保证)AttachWindow: Found windowhandle: ..., hwnd: ..., screencapMethod: ..., mouseMethod: ..., keyboardMethod: ...asst.log中:Win32Controller::screencapWin32Controller::click- 点击后的下一次识别结果是否真的改变
- 如果点击日志存在,但后续截图和 OCR 状态完全没变,要优先判断为“输入未生效”,而不是“流程已正确前进”
- 对关卡导航 / 磨难切换问题,重点看:
config/gui.new.json/gui.json中的StagePlangui.log中的GetFightStageasst.log中的:Episode15ChapterDifficultyHardEnterChapterDifficultyHardSubTaskErrordebug/interface/*.pngresource/tasks/tasks.json与cache/resource/tasks*.json
- 回答时只保留关键证据。
- 摘几十行足够支撑结论的片段即可。
- 不要把整份日志倾倒进回复。
- 对状态型 UI 问题,结论前先做一次“设计一致性检查”。
- 先判断日志中的状态变化是否符合游戏规则、资源任务定义和当前实现。
- 如果流程与设计一致,不要把用户不喜欢的中间状态直接归为 bug。
- 只有当日志、资源任务和代码彼此冲突,或流程没有达到设计要求的终态时,再归类为实现缺陷。
Common Patterns
-
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可以是空包,也可以只包含图片;不要因为没有文本日志就把它判成“无用分卷”。 -
issue 机器人评论“日志没有上传成功”时,不要自动当真;先验证正文附件是否仍可下载。
-
如果
gui.log说“任务出错”,但对应taskid的asst.log实际AllTasksCompleted,要明确写“本次日志未复现用户描述的问题”。 -
对会客室 / 线索 issue,如果
asst.log里出现InfrastClueQuickInsert、remove_clue、SendClues或InfrastClueQuickSendDuplicates,先对照资源任务判断这是不是当前设计流程,不要只看线索板中途是否为空。 -
如果线索流程里出现“取下线索 -> 赠送重复线索 -> 条件满足后统一放置”,默认先按 by design 处理;只有当日志显示本应统一放置却没有发生时,再继续追实现问题。
-
用户日志里的任务流程与当前主线代码明显不一致,且当前代码看起来已经修掉了该问题:
- 先确认用户版本,必要时切到对应 tag(例如
git checkout vXXX)核对旧逻辑。 - 不要用当前分支否定旧日志;旧版本问题可能真实存在。
- 如果主线已修复,再看修复 commit 是否已进入 tag / release:已发版建议升级,未发版建议等待 release。
- 先确认用户版本,必要时切到对应 tag(例如
-
gui.new.json、gui.json和实际日志不一致时,不要急着判“用户配置写错了”;先看gui.new.json.bak和gui.json.old,尤其是用户复现后又改回开关的场景。 -
在
ConnectConfig=PC的 issue 里,Win32Controller::click正常返回不代表点击真的生效;要看点击后的下一帧中,按钮状态、数量 OCR、场景识别有没有变化。 -
gui.log中"已使用即将过期的理智药"这类高层提示,不一定等价于底层逐药 OCR 结论;如果asst.log明确识别到3天、NotExpiring等相反证据,应优先相信asst.log。注意过期天数阈值现为可配置参数medicine_expire_days,不再是固定 48 小时。
Correlating With Code
报告打包结构
src/MaaWpfGui/ViewModels/UserControl/Settings/IssueReportUserControlModel.cs
GUI / Core 日志文件名
src/MaaWpfGui/Main/Bootstrapper.cssrc/MaaCore/Utils/Logger.hppsrc/MaaUtils/include/MaaUtils/Logger.h
连接回调与 GUI 侧重试
src/MaaWpfGui/Main/AsstProxy.cssrc/MaaWpfGui/ViewModels/UI/TaskQueueViewModel.cssrc/MaaWpfGui/ViewModels/UserControl/Settings/ConnectSettingsUserControlModel.cssrc/MaaCore/Controller/MinitouchController.cppdocs/zh-cn/protocol/callback-schema.mddocs/zh-cn/manual/device/android.md
PC / AttachWindow / Win32 输入
src/MaaWpfGui/ViewModels/UserControl/Settings/ConnectSettingsUserControlModel.cssrc/MaaWpfGui/Main/AsstProxy.cs
关卡导航与磨难切换
resource/tasks/tasks.json
理智药 / 临期药
src/MaaWpfGui/ViewModels/UserControl/TaskQueue/FightSettingsUserControlModel.cssrc/MaaWpfGui/Models/AsstTasks/AsstFightTask.cssrc/MaaCore/Task/Interface/FightTask.cppsrc/MaaCore/Task/Fight/MedicineCounterTaskPlugin.cppresource/tasks/tasks.json
现场图保存
src/MaaCore/Utils/DebugImageHelper.hpp
GUI 中文文案
src/MaaWpfGui/Res/Localizations/zh-cn.xaml
Localized Copy
- 总结任务类型、设置项、按钮、错误提示、日志前缀时,优先使用
src/MaaWpfGui/Res/Localizations/zh-cn.xaml中的中文文案。 - 常见查找顺序:
- 默认任务类型名:先看
src/MaaWpfGui/ViewModels/UI/TaskQueueViewModel.cs中LocalizationHelper.GetString(taskType.ToString())的 key,再到src/MaaWpfGui/Res/Localizations/zh-cn.xaml查StartUp、Fight、Infrast、Recruit、Mall、Award、Roguelike、Reclamation、Custom。 - 任务开始 / 完成 / 出错等 GUI 日志前缀:优先查
StartTask、CompleteTask、TaskError、ConnectFailed、TryToReconnect等 key。 - 设置项、按钮、界面提示:先在对应
*.xaml/*.cs里找DynamicResource SomeKey或LocalizationHelper.GetString("SomeKey"),再到src/MaaWpfGui/Res/Localizations/zh-cn.xaml查中文。 - issue 反馈相关入口:优先查
Issue、GenerateSupportPayload、OpenDebugFolder等 key。
- 默认任务类型名:先看
- 如果
config/gui*.json里任务有用户自定义Name,输出时优先保留用户自定义名称;必要时再括号补默认任务类型中文,例如刷理智(理智作战 / Fight)。 - 输出时优先写中文,必要时在括号里补原始 key /
taskChain/ 枚举名,例如基建换班(Infrast)。 - 如果
src/MaaWpfGui/Res/Localizations/zh-cn.xaml没有对应 key,再退回原始 key 或代码里的英文字符串,并明确说明“未在src/MaaWpfGui/Res/Localizations/zh-cn.xaml找到对应文案”。
Linking Code Evidence
- 如果要指向具体代码行,不要写本地路径加行号,也不要写绝对路径。
- 统一给出对应仓库的远端 GitHub
blob行号链接,用尖括号包裹。 - MaaAssistantArknights 仓库链接格式:
https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/<commit>/<path>#L14-L20
<commit>必须是本次分析实际依据的代码版本:- 默认使用当前检出的
HEAD - 如果为了复核旧 issue 切到了某个 tag / commit,就使用那个版本解析后的 SHA
- 默认使用当前检出的
- 例子:
- https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/f8b64ef908d8b82bb71ba753b69a30ea658f9054/src/MaaWpfGui/Main/AsstProxy.cs#L1072-L1079
- https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/f8b64ef908d8b82bb71ba753b69a30ea658f9054/src/MaaWpfGui/Res/Localizations/zh-cn.xaml#L680-L695
- 如果引用的是其他上游仓库或文档,也用对应远端链接,不要给本地文件行号。
Example Heuristic
如果 issue 像 #16014 一样是 MuMu ADB 连接随机失败,并且同时出现:
config/gui.json里ConnectConfig是MuMuEmulator12- 地址是
127.0.0.1:16384 gui.log在复现时段从16384轮询到16576asst.log里adb devices返回127.0.0.1:16384 offlineasst.log里对备选端口出现cannot connect ... (10061)ConnectionInfo.what是ConnectFailed
那么根因更可能是 ADB / 模拟器连接层异常,而不是 GUI 任务队列逻辑;此时应结合 MuMu 默认端口表和 Android offline 文档给出建议。
如果 issue 像 #16002 一样是 15/16 章 hard 难度切换失败,并且同时出现:
config/gui.new.json或gui.log里关卡是15-13-hardasst.log里先进入Episode15- 随后卡在
ChapterDifficultyHard - OCR 反复识别到
推演计分等无关文本 - 最后
SubTaskError,并保存debug/interface/*.png resource/tasks/tasks.json里EnterChapterDifficultyHard期望在固定 ROI 识别到进入作战
那么根因更可能是当前画面没有进入预期的难度切换界面,或按钮没有出现在资源定义的期望区域,而不是“Hard 后缀本身没有传到 core”。
Output Format
先做输出分流,不要无论什么情况都套完整模板。
分流规则
- 如果用户没有提供有效证据,只给出一句模糊现象,或只有 issue 文本但没有日志、报告包、截图、报错文本、导出诊断、清晰复现步骤,那么不要输出下面那套完整分析模板。
- 这类场景直接改用
maa-cyber-fortune-master/SKILL.md的风格回复,并把“赛博算一卦”放在开头。 - 此时输出必须足够短,通常 2 到 4 句即可。
- 这类短回复里不要再展开:
Issue 概要关键证据根因判断修复方案English translation- “点击此处展开”这类折叠块
- 本质要求是:先用玄学接住气氛,再用一句话明确要求补日志、截图、报错或诊断信息。
无有效证据时的推荐格式
[一句简短复述用户现象]
[赛博算一卦 / 掐指一算 / 夜观天象开场]
[1 到 2 句短小玄学分析]
[一句自然收束到补日志、截图、报错或导出诊断]
无有效证据时的示例
你这个是刷界园时,第一层商店点了招募券就直接结束。
赛博算一卦,界园属木,招募券属火,如今商店财位一震,像是招募灵脉和界园卦象临时撞了车,程序当场收摊回府。
不过这卦现在只有天象,没有脉案。建议补一份复现当次的日志或报错截图,不然贫道也只能隔着网线观星象。
有有效证据时
最终回答再用这个完整结构:
## Issue 概要
- issue:`#1234`
- 版本 / 资源时间:
- 模拟器 / 连接配置 / 任务:优先写 `zh-cn` 中文任务名;如果日志里是用户自定义任务名,先写自定义名,再补默认任务类型中文 / key
- 相关设置项 / 关键提示文案:优先写 `src/MaaWpfGui/Res/Localizations/zh-cn.xaml` 中的中文文案
- 用户现象:
## 关键证据
<details><summary>点击此处展开</summary>
- `debug/gui.log`:
- `debug/asst.log`:
- `config/gui.json` / `config/gui.new.json`:
- `cache/resource` / `cache/gui`:
- `debug/interface` / `debug/drops`:
- 代码依据:如需指向具体实现,直接附远端 GitHub 行号链接
</details>
## 根因判断
- 直接结论:
- 证据链:
## 给用户的建议
- 用户现在可以直接尝试的动作:
- 是否建议升级 / 重下完整包 / 同步资源 / 重置配置:
- 是否需要等待开发者修复:
- 是否有临时绕过方案:
## 修复方案
1. 代码 / 资源 / 配置层修复
2. 需要补充的日志或截图
3. 需要补充的测试
## 给修复 AI 的建议(可复制)
<details><summary>点击此处展开</summary>
~~~text
现象:
[一句话描述用户可见的问题]
关键证据:
[粘贴原始日志、堆栈、监控截图中的关键文本]
可能相关线索(待验证):
[根据日志/现象推测的可能方向,不保证准确,供参考]
~~~
</details>
## 置信度
- 高 / 中 / 低
- 还缺什么证据
## English translation
<details><summary>Click here to expand</summary>
Translate the complete conclusion directly into English and paste it here. Note that the English text is in `src/MaaWpfGui/Res/Localizations/en-us.xaml`.
</details>
Reminders
- 如果用户没有贴出日志、报告包、截图、报错文本或导出诊断,不要硬套本 skill 的完整分析模板;优先改用
maa-cyber-fortune-master/SKILL.md,先把气氛接住,再把话题引回补证据。 - 如果是“无有效证据”分支,赛博算卦段落应该放在最开头,并直接结束在“请补证据”;不要再追加长篇的 Issue 摘要、猜测性根因、修复方案或英文翻译。
- 不要只看
gui.log下结论。 - 不要把 issue 评论或机器人提示当成唯一证据。
- 不要把当前分支资源直接当成 issue 当时的真实环境;先看报告包里的
cache/resource。 - 日志和截图冲突时,优先相信现场图,再回头解释 OCR / 模板为何误判。
- 如果问题本身没有在当前日志中复现,要明确写“证据未复现”,不要硬凑结论。
- 如果 issue 版本很旧,要明确区分“当时的根因”和“当前分支是否已修复”。
- 如果用户日志与当前代码不一致,先按用户版本 tag 复核;若确认已修,再看修复是否已进入 tag / release:已发版建议升级,未发版建议等待 release。
- 如果回答里出现任务名、设置项、按钮名、提示文案,优先使用
src/MaaWpfGui/Res/Localizations/zh-cn.xaml的中文文案;必要时才在括号里补原始 key /taskChain/ 枚举名。 - 如果回答里引用了具体代码行,直接给远端 GitHub
blob行号链接,用尖括号包裹,不要给本地路径加行号。 - 如果证据表明问题已在新版本修复,明确建议用户升级;如果怀疑安装包、资源文件或配置损坏,明确建议重新下载或重建;如果判断为真实代码缺陷且暂无 workaround,明确建议等待开发者修复。