dsh-procguard

DSH（DeepSeek Harness）进程看护管家：一个跑在 dsh web 进程里的 Cordis 插件，把自己的看护层安装进操作系统——launchd（macOS）/ systemd（Linux，骨架）保活、启动前依赖链校验、内存哨兵、断链自愈。进程死了有人拉起，链断了有人修，泄漏了有现场。

它解决什么问题

2026-09-12 的一次完整事故复盘（同一台机器，一夜两崩）：

四层防御架构

第 1 层  OS 保命     launchd agent（KeepAlive）：崩溃 ≤30s 自动拉起，开机自启
第 2 层  启动闸      preflight：boot 前校验依赖链，断链拒启并明示原因（不再裸崩留堆栈）
第 3 层  内存哨兵    mem-watch：每 5 分钟采样 RSS，超阈值 kill -USR2 抓堆快照（12h 限一次）
第 4 层  管家(本包)  procguard 插件：每 5 分钟对账 8 项资产，agent 掉册自动重装、断链自动重建

关键设计：插件不负责"救自己的命"（OS 层负责），插件负责"把 OS 层维持在正确状态"。插件死了前三层还在；前三层出问题，下次插件上岗时修好。OS 看护层是本包的交付物，卸载插件不回收。

本插件零外部 import（不依赖 @deepseek-ai/* 任何包，仅 ctx 注入的 timer/shell/fs），失败面从构造上收窄：坏也只坏自己，不连坐插件树——对照 2026-09-12 imgview 的 peer import 断链连坐事故。

平台支持

安装

第一步：部署 OS 看护层（只需一次）

git clone https://github.com/fuguier001/dsh-procguard.git
cd dsh-procguard/assets && bash install-os-layer.sh

部署 4 个脚本、2 个 launchd agent、桌面重启入口，全部幂等可重跑。

第二步：安装插件（web profile）

方式一：GitHub Packages（npm registry，需配一次 .npmrc）

# 在 ~/.npmrc（没有就新建）加两行：
@fuguier001:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=<你的GitHub令牌，需read:packages权限>

cd ~/.dsh/profiles/web
pnpm add @fuguier001/dsh-procguard

方式二：GitHub 直装（免 registry 配置）

cd ~/.dsh/profiles/web
pnpm add github:fuguier001/dsh-procguard

第三步：挂进组合

把本仓库根目录 cordis.patch.yml 里的行并进 ~/.dsh/profiles/web/cordis.patch.yml，重启 dsh web（或等 patchReload: live 热加载）。

验证

tail -f ~/.dsh/web-restart.log        # 应出现 "[procguard] 管家上岗" 与每 5 分钟的 "对账完成"
cat ~/.dsh/procguard-status.json      # 8 项资产对账结果

升级 / 卸载

cd ~/.dsh/profiles/web && pnpm update @fuguier001/dsh-procguard   # 升级（GitHub Packages 方式）
launchctl bootout gui/$(id -u)/com.fuguier001.dsh-web             # 停用保活层（一般不需要）

已知边界

• 管家的对账资产清单（路径、agent 名）当前按作者机器写死（~/Documents/DSCli/dsh-imgview 等）；换机器需改 lib/index.js 顶部 assets 常量。
• 堆快照依赖启动参数 --heapsnapshot-signal=SIGUSR2（keepalive 脚本已内置）；手动 dsh web 启动的实例没有该开关，哨兵只记警情不动进程。
• 插件沙箱按实例 cwd 授权文件写入：keepalive 保证 cd $HOME，故 ~/.dsh/procguard-status.json 正常落盘；若从其他目录裸启 dsh web，状态写盘会被拒（已优雅降级：只记日志，审计与自愈不受影响，2026-09-12 3099 端口实测）。
• Linux 的 assets 脚本移植（lsof→ss、launchctl→systemctl）欢迎 PR——带上你的真机验证记录。

License

MIT