dsh-guard (plugin)
yokoswy/dsh-guard/plugin
A 护航 panel in the session header that switches the local dsh-guard watchdog on or off and shows whether scanning is enabled, whether the guard is alive and when it last scanned; the Python watchdog that does the watching is deployed separately and found through the DSH_GUARD_ROOT environment variable. The watchdog defaults to a Windows checkout (D:\AI\Projects\dsh-guard); set DSH_GUARD_ROOT to point at another directory.
설치
dsh plugin --profile web add github:yokoswy/dsh-guard이 플러그인은 저장소의 plugin 하위 디렉터리에 있습니다.
README
dsh-guard
dsh-guard 是给 DSH NEXT（DeepSeek Harness 桌面版）做崩溃判定与恢复的单机工具：一个 Python 命令行 + 一个界面插件，读取 DSH 的日志工作，不修改 DSH 本体。
特性
- 判定： 按
runId聚合 UTC 分卷日志，叠加 Windows 关机事件（1074 → 6006），输出 7 类结局；对 88 次历史启动回放，漏报 0、误报 0 - 降级识别： 渲染进程 / GPU / 网络服务崩溃、子进程 OOM、10 分钟内连环崩，单独统计不混进崩溃数
- 体检：
preflight.py只读检查 BOM、JSON/YAML 语法、link:目标、node_modules软链、端口、基线漂移，退出码 0/1/2 - 还原： 写前三查（无 DSH 进程、目标 mtime 10 秒未变、持锁），同目录 temp → fsync →
os.replace，写后重算 sha256，不符即整批回滚 - 备份： 配置快照 57 文件 / 0.83 MB 一份；会话记录走硬链接增量，第二份新增 0.00 MB
- 守护： 120 秒一轮，只记录与通知；
unclean-unknown会留现场文件（事件尾巴 + 文本日志 + 进程快照） - 开关： 会话头部按钮写
state/control.json的enabled，只启停扫描与通知
前提
- Windows 10/11
- Python 3.11 及以上（仅标准库；
psutil、PyYAML可选） - DSH 安装在同一台机器上（工具读它的
logs/、profiles/、sessions/） - 官方版与 NEXT 可以同时装：在
config.json的targets里各写一条，判定、守护、备份都按目标分开
多实例（NEXT + 官方版）
"targets": [
{ "name": "next", "home": "D:\\AI\\DSH-NEXT" },
{ "name": "official", "home": "D:\\AI\\DSH-official\\home" }
]
| 能力 | 多实例行为 |
|---|---|
| 判定 | python detect.py --all 逐目标输出；--home <path> 只看一个 |
| 体检 / 救援 | preflight.py --home <path> --label <name>、rescue.py --home <path> --label <name> |
| 守护 | 每轮逐个目标扫描，scan.json 按 target 分开存，首次跑只建基线不通知 |
| 备份 | 第一个目标落 lkg/、sessions-backup/（默认标签），其余落 lkg/<name>/、sessions-backup/<name>/ |
| 界面开关 | 每套 DSH 各装一次插件；两个桥读同一份 state/control.json，开关对两套同时生效 |
官方版是 0.2.1-rc.2 时实测可用：日志事件词表与 NEXT 一致（electron/run.start、desktop/host.start.start、desktop/message），头部插槽 conversation.session.header.actions 也存在。
安装
git clone https://github.com/YokosWY/dsh-guard.git <project-dir>
cd /d <project-dir>
copy config.example.json config.json
python paths.py
python paths.py 打印解析到的 dsh_home / python / pythonw 三项；任一项不对就改 config.json，或设 DSH_HOME。
快速开始
python detect.py
输出四行以内：
run 总数 84 需要处理 31 可由配置恢复 3
结局分布: {'ok': 27, 'boot-fail': 19, ...}
崩因分布: {'shell-load': 18, 'silent': 9, ...}
完整逐条用 python detect.py --list。这一步只读，不改任何东西。
日常看一眼
python guard.py --status :: 开关 / 守护 / 每个 DSH 的启动数、事故数、上次扫描
python guard.py --report :: 同上，另存一份 markdown 到 reports/
python detect.py --all --csv :: 导出 88 条启动记录，Excel 能直接打开
--status 输出示例：
开关: 开（用户从界面切换）
守护: 运行中 pid=39220，心跳 4s 前
[next] D:\AI\DSH-NEXT
启动 88 次，事故 33 条，最近一次启动 10-24 15:09
结局: boot-fail=21 crash=3 ok=27 quit-forced=14 shutdown=13 unclean-unknown=9
上次扫描 2026-10-24T07:26:19+00:00（本轮新事故 0）
边界
- 不修 DSH 本体：壳页加载失败（
ERR_FAILED ... dsh-app://app/）属应用内部，这里只出证据 unclean-unknown不猜死因，只留现场- 不接管 DSH 自带的
recovery/：那份快照会把即将崩的配置标成 healthy，所以备份仓自建 - 计划任务仅在当前用户登录后生效；注销或关机期间不运行
文档
贡献
改完先跑 自检.cmd（5 个测试文件 + 78 次回放 + 当前配置体检），再读 docs/DEVELOP.md。
问题走 Issues；报障请附 python detect.py --list 的输出，它不含会话内容。
许可
MIT © 2026 YokosWY，见 LICENSE。