Name: dsh-guard (plugin)
Author: yokoswy

Installer

dsh plugin --profile web add github:yokoswy/dsh-guard

Ce plugin se trouve dans le sous-répertoire plugin du dépôt.

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）