dsh-agent-guardian

> 守卫插件：web 保活——拉起 / 崩溃自愈 / 收养外部 dsh web。 > DeepSeek Harness 自研插件 · v0.1.1（从 dsh-agent-watch 拆分）

定位

让 DeepSeek Harness web 服务永不静默死亡：端口空闲时拉起、崩溃时自愈、外部启动的 web 被收养（零互踢）。与哨兵（sentinel）分工：guardian 管「活着」，sentinel 管「重启」。

功能特性

• 启动时拉起：端口空闲时自动拉起 web（配合运行时服务 runtime 环境发现）
• 崩溃自愈：快速退出计数 + 落盘事故，崩溃后自动重启
• 收养外部 web：检测到外部启动的 dsh web（非本进程 spawn），收养为受管实例（零互踢）
• 预检门控（fail-closed）：崩溃自愈 / 拉起前调用沙盒预检（ctx.preflight.run quick 模式，消费 dsh-agent-preflight 服务）——预检不过不拉起，防止带病重启
• 不越权：不负责哨兵监听与重启协调（归 dsh-agent-sentinel），单一职责

安装

git clone https://github.com/jonah791/dsh-agent-guardian.git self-plugins/dsh-agent-guardian
cd self-plugins/dsh-agent-guardian && pnpm install && pnpm build

在 DSH 的 watch profile 添加插件行（与 sentinel / preflight / runtime 同 profile 协作）。

使用

• 守护进程模式：挂载到 watch profile 后自动运行——无需人工干预
• 依赖服务：ctx.preflight.run（dsh-agent-preflight）用于预检门控；ctx.runtime（dsh-agent-runtime）用于环境发现

配置

字段	默认	说明
quickExitCount	配置值	快速退出计数阈值（崩溃判定）

技术要点

• fail-closed 设计：预检不过不拉起——「旧实例可能有问题，但新实例没验证过更危险」
• 零互踢：收养外部 web 而非杀掉重启，避免多人/多进程操作同一端口冲突
• 三插件分工（guardian / sentinel / preflight）消除了原 dsh-agent-watch 的单体耦合

License

MIT