SuperAPI AI 工具集

triage-runtime-logs

通用与其它

查看项目

更新于 10-16 09:28

技能介绍

用途:当用户提供 XerahS 日志、异常堆栈或重复调试输出,并希望得到可执行结论而非泛泛解读时使用。典型触发包括启动日志中的 JSON/配置错误、System.InvalidOperationException、XamlLoadException、热键、截图、历史记录或缩略图错误,以及“这些 bug 是否仍存在”“修复日志中的问题”等请求。

输入:粘贴的日志片段或日志文件路径、当前 XerahS 代码检出,以及可选的复现命令。若只提供部分日志,先基于该部分工作,仅在确认根因需要时再读取更多上下文。

工作流程:先将日志折叠为不同签名,按异常类型、logger 前缀、配置路径或重复消息文本分组,把逐行或逐热键的重复错误视为同一根因;按用户影响排序,优先崩溃、截图失败、历史记录损坏、启动失败或数据丢失风险,其次正确性回归,最后是噪声或误导性日志;改代码前先查阅仓库指引,如 developers/hardening/*.md、developers/guidelines/TROUBLESHOOTING_CAPTURE_ISSUE.md、HISTORY_TESTING_GUIDE.md、app_errors.txt;将每个签名映射到代码,搜索确切消息文本、异常类型、logger 标签、配置类型或文件路径,编辑前先阅读所属子系统;判断问题是否仍存在,优先用定向复现或聚焦构建/测试验证,若日志已过时先对照当前代码确认;被要求修复时实现最小且稳健的改动,仅诊断时只报告已验证原因与建议修复,不编辑代码;优先根因修复而非压制下游日志,仅在必要时添加守卫、快照、校验或解析兼容;若只是日志误导,则收紧日志以便后续排查;验证时先运行最窄的相关验证,若改动了代码,除非仓库规则明确豁免,最后运行 dotnet build,历史或截图修复若自动化覆盖薄弱,附简短手动复现路径;必要时在 developers/lessons-learnt/general.md 或主题文件中记录预防规则。

限制与规则:不要把每条重复行都当作独立 bug;不要修复当前代码已不存在的推测问题;优先使用子系统文档与加固笔记;多个签名共享同一原因时在结果中清楚说明压缩关系;结论需可溯源,引用具体日志签名、所属文件与验证路径。常见模式包括配置枚举解析错误一次性修复兼容或迁移、后台工作期间集合被修改需检查并发枚举并快照或移动变更边界、历史/截图回归先对照相关排查与测试指南、更新/插件/热键噪声需区分无害状态行与真实注册或加载失败。