dsh-goal-restart

当 dsh 服务（重新）启动时，自动重新武装（re-arm）持久化的同会话目标， 让 goal-round driver 无需人工干预即可自动续跑目标轮次。

为什么需要它？ 当智能体正在做长期任务——比如开发它自己的插件——而它 所在的服务被重启（崩溃、launchd 自动拉起、主动重启）时，此前进行中的目标 会一直停在原处，直到有人执行 /goal resume。这个插件省掉了这一步。

问题背景

dsh 目标的持久化状态（objective、phase、revision、roundsStarted）保存在 会话日志中，可以跨重启存活。但它的激活状态（"armed"）刻意做成进程本地： 它从不持久化，而且每次 agent/session-start 边界都会解除武装（disarm）。 因此，当 dsh 服务重启后，进行中的目标会被回放为 active，但会一直停住， 直到有人显式恢复（resume）。

这个插件做什么

在 agent/session-start 且 payload.source === 'resume'（会话刚从持久化 存储重新加载）时，只要目标处于持久化的 active 状态且还有轮次预算，就调用 ctx.goals.resume(agent, ref)。随后内置的 goal-round-driver（由 dsh-base 挂载）会像普通的人类恢复那样预留并投递下一轮——只是这次不需要 任何人去点按钮。

策略（保守，一目了然）

| 场景 | 动作 | | ------------------------------------------------ | ----------------------------- | | 服务重启后会话重新加载，目标 active，预算充足 | 重新武装（ctx.goals.resume） | | 新会话启动（source: 'startup'） | 跳过（无目标） | | Fork 出来的会话（继承父目标） | 跳过（进程内派生） | | 子代理会话（origin: subagent） | 跳过（进程内派生） | | 目标为 paused / blocked / complete | 跳过（以持久化阶段为准） | | 目标为 active 但已经 armed | 跳过（幂等） | | 目标已达 roundsStarted >= maxGoalRounds | 跳过（无预算——先调大上限再恢复）|

安装

dsh plugin --profile <profile> add dsh-goal-restart

然后重启 dsh 服务以加载新的 bundle。

禁用

在 profile 的 cordis.patch.yml 中加入：

- id: goal-restart
  disabled: true

说明

• 重新武装会向会话日志写入一条持久的 resume 变更（revision +1）——这是领域 文档中规定的重新激活边界，与人工执行 /goal resume 写入的内容一致。
• 轮次驱动的持久化与取消安全已由 round driver 处理；本插件只决定要不要继续， 不决定如何运行。
• 会话在某个活体智能体加载它时才会恢复。在 Web GUI 中，这发生在重启后重新打开 会话时；重新武装就在那一刻发生，早于 driver 的第一个空闲检查点。
• 该策略由 13 个纯内存单元测试（npm test）和一个 smoke 脚本（npm run smoke） 验证，都不需要网络和真实进程。

许可证

MIT