子代理续跑看门狗 quaner1234-cmd/dsh-subagent-watchdog

dsh-subagent-watchdog

一个 DSH 插件，可从一个高置信度故障中安全地恢复原生可继续子代理：显式的 max-tokens 终止。

当原生可继续的 DSH 子代理因触发 max-tokens 而结束时，Watchdog 会自动继续同一个子对话一次，然后停止。不会循环。

为什么

当你在 DSH 中把任务委派给一个可继续的子代理，而子代理在任务中途耗尽了输出 token 时，运行时会以 stopReason: 'max-tokens' 结束该轮次，向委派代理报告失败，然后停止。工作处于未完成状态；父代理必须注意到失败、判断其可恢复，并手动继续子代理。

Watchdog 恰好执行这一次恢复——确定性地，最多一次——仅使用官方 DSH 接缝。

它做什么

- 可继续子代理上的首次 max-tokens —— Watchdog 观察到终止性的 turn/end { kind: 'max-tokens' }，在子会话仍然存活时启动一次官方持久性检查点（sessions.flush），等待正常结算和检查点解析，然后通过官方 subagents.followup() 接缝发送恰好一次继续。同一个持久子对话在新的激活纪元中冷恢复，并附带一条简短指令，要求从其现有状态继续未完成的任务。
- 恢复后的运行正常完成 —— Watchdog 保持静默。没有消息，没有标记，没有进一步动作。
- 第二次失败（再次 max-tokens，或显式的运行时/提供方错误）—— Watchdog 停止干预，并向委派父代理发送一条通知，包含失败事实和官方手动选项（手动 send_message、interrupt_agent，或重新委派一个新的子代理）。
- 从不恢复 —— 一次性子代理（DSH 未为其暴露恢复接缝）、正常完成、干净中止、拒绝、未知的未来停止原因，以及任何首次出现的结果是错误而非 max-tokens 的情况。提供方/模型错误会被报告，绝不会自动重试。
- 无持久化 / 无法验证的子代理 —— 恢复决策在可用时通过官方持久化接缝验证子代理的持久日志；无法验证其可继续模式的子代理会被跳过，绝不会猜测。没有持久会话日志时，重启安全的“已继续”标记无法跨重启查询，因此那里的保护仅依赖于进程生命周期守卫。

继续一次的保证是针对子代理的持久会话 id（跨激活纪元稳定）以及写入子代理自身持久日志中的继续标记来强制实施的——重复事件、插件重启或重复结算都不会导致第二次自动继续。

安装

通过普通的 DSH 插件路径（已在 dsh 0.1.1-rc.2 上验证）：

dsh plugin --profile add dsh-subagent-watchdog

或从本地 tarball 安装：

npm packbash
dsh plugin --profile add ./dsh-subagent-watchdog-0.1.0.tgz

该包声明了 dsh.bundle.patch；dsh plugin add 会自动将其协调到 profile 的 bundle 栈中。零依赖，无需构建步骤，Node >= 20。

安全性与非目标

- 每个子任务/恢复链最多一次自动续接。
- max-tokens 是唯一的自动恢复触发条件。
- 无定时器、无轮询、无自定义持久化、无私有运行时 API——仅使用官方接缝。
- 没有第二个 LLM 来决定是否需要恢复；没有仪表盘、没有 DAG、没有团队管理器、没有启发式卡死检测器。

兼容性

仅针对 @deepseek-ai/dsh 0.1.1-rc.2 进行了端到端实机测试。未声称或测试更广泛的兼容性。

验证与证据

- 本地测试套件：针对两个随附产物（lib/index.js 和派生的动态包主体），在真实的 cordis/dsh-subagent/dsh-session 调度下运行 38 个场景——node --test test/watchdog.test.mjs。
- 最终打包后的重新验证直接观察到：一个真实的原生可续接子任务以显式 max-tokens 结束，同一个持久化子会话 id 在结算后 68 毫秒以新的 runId 启动新的激活，在后续检查中恰好保留一个持久化的 subagent-watchdog/relay 标记，并且恢复后的激活正常完成，没有 watchdog 失败通知。
- 检查点先于后续操作的顺序以及真实的 AbortSignal 管道连接由先前的插桩实机探测以及确定性测试套件支持；它们并未在最终打包的跟踪中作为显式记录独立输出。

完整的已验证接缝调查和证据日志位于 docs/DSH-SEAMS.md。最终验收阶段在调试期间越过了其最初的一次运行/STOP 边界；该协议偏差及由此产生的证据校准记录在 docs/PROTOCOL-DEVIATION-2026-08-23.md 中。

许可证

MIT