游戏崩溃诊断 FLL123-Arch/game-crash-doctor

game-crash-doctor

DeepSeek Harness 插件：游戏崩溃后，用 Windows 事件日志、WER 报告和转储文件告诉你为什么崩、怎么修。

仅支持 Windows · DSH 0.1.2+ · 所有分析都在本机完成，不联网、不上传数据。

功能

- 自动监控：每 45 秒检查一次事件日志，发现新的游戏崩溃时在当前会话里推送一条通知（原因摘要 + 3 条建议）。
- 按需诊断：随时调用 diagnose_game_crash，可指定回溯小时数和游戏名。
- 数据来源：
- 应用程序日志：Application Error 1000、Windows Error Reporting 1001、Application Hang 1002、.NET Runtime 1026
- 系统日志：显示驱动 TDR 4101、Kernel-Power 41、BugCheck 1001、意外关机 6008
- WER 报告 Report.wer（异常代码、故障模块、Bucket）
- 崩溃转储：%LOCALAPPDATA%\CrashDumps、C:\Windows\Minidump、C:\Windows\LiveKernelReports
- 原因归类：ACCESS_VIOLATION、C++/.NET 异常、堆破坏、栈溢出、显卡 TDR、DXGI 设备丢失、反作弊、蓝屏 BugCheck 等，并给出置信度和排查顺序。
- 重复崩溃识别：同一程序/异常/模块在时间窗内反复出现时会单独提示。

安装

从 npm

dsh plugin --profile desktop add game-crash-doctor

从本地源码

1. 把本目录放到 profile 的 plugins 下 %USERPROFILE%\.dsh\profiles\desktop\plugins\game-crash-doctor
2. 注册到 profile
dsh plugin --profile desktop add file:./plugins/game-crash-doctor

安装后重启 DSH（或在插件市场里点重启），工具和后台监控才会生效。

使用

直接对智能体说：

- “刚才游戏为什么崩了？”
- “帮我看看最近 3 天的崩溃记录”
- “只查 Wuthering Waves 的崩溃”

智能体会调用 diagnose_game_crash：

| 参数 | 说明 |
| hours | 回溯小时数，1–168，默认 24 |
| game | 只看可执行文件名/路径包含该关键词的记录 |

配置

在 profile 的 cordis.patch.yml 中给插件加 config：

- id: game-crash-doctor
name: game-crash-doctor
config:
notify: true # 是否自动推送崩溃通知 pollSeconds: 45 # 轮询间隔（15–600 秒） gameOnly: true # 只对“像游戏”的崩溃推送 notifyAllSessions: false # true = 通知所有打开的会话 maxNotificationsPerHour: 3

判断逻辑示例

| 信号 | 典型结论 |
| 0xC0000005 @ 游戏模块 | 模组/补丁越界、文件损坏、内存不稳 |
| 0xE06D7363 @ KERNELBASE.dll | 未捕获的 C++ 异常：游戏 bug、模组/汉化、反作弊注入 |
| 0xC0000374 / 0xC0000409 | 堆破坏 / 栈溢出：优先查内存超频、XMP、注入 DLL |
| 0x887A0006 或 4101 TDR | 显卡驱动超时：DDU 重装驱动、恢复默认频率、查供电/温度 |
| Kernel-Power 41 | 异常断电/死机：电源、散热、超频、BIOS |
| BugCheck 0x124 | WHEA 硬件错误：CPU/内存/电源 |
| Application Hang 1002 | 主线程卡死：驱动、覆盖层、资源加载 |

隐私与安全

- 只读取本机 Windows 事件日志、WER 报告和转储文件，不发起任何网络请求。
- 不收集、不上传崩溃内容、路径或用户信息。
- 需要执行的唯一外部程序是系统自带的 powershell.exe（只读采集）。
- 事件日志查询不需要管理员权限；C:\Windows\LiveKernelReports 和部分 WER 目录可能需要管理员权限，读不到会自动跳过。

限制

- 仅支持 Windows 10/11。
- 不解析转储里的调用栈（没有符号表）；转储只用于定位和关联。需要更深的栈分析时，用 WinDbg 打开报告里给出的 .dmp。
- 如果游戏是“直接断电/死机”且系统来不及写日志，可能只能看到 Kernel-Power 41，插件会明确说明“没有应用崩溃记录”。
- 自动通知要求 DSH 正在运行；DSH 关闭期间发生的崩溃，会在下次启动后的第一次轮询补报。

License

MIT