FLL123-Arch/game-crash-doctor

game-crash-doctor

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

Windows only · 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（或在插件市场里点重启），工具和后台监控才会生效。

使用

直接对 Agent 说：

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

Agent 会调用 diagnose_game_crash：

配置

在 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

判断逻辑示例

隐私与安全

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

限制

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

License

MIT