Harzva/dsh-restart-autoresume

dsh-restart-autoresume

@harzva/dsh-restart-autoresume 为 DeepSeek Harness (DSH) 添加了一个受控的 重启并恢复运行中的任务 流程。它会记录普通的顶层会话，刷新其持久状态，将实际重启委托给现有的 dsh-restart Host 服务，并在新 Host 启动后，为每个符合条件的意图安全地提交一个可审计的延续轮次。

此公开 alpha 版本面向 DSH 0.1.1-rc.2、Cordis 4.0.1 和 Node.js 22+。它通过 GitHub Releases 分发，发布流程不会将其安装到生产配置中。

截图

现有的 DSH 重启服务可用

由现有 DSH 重启服务支持的重启操作

捕获到一个普通的顶层任务

重启前捕获到一个正在运行的普通顶层任务

原始会话在重启后继续

延续轮次在原始持久会话中完成

Resume Ledger 结算该意图

操作者意图在一次尝试后被持久完成

这些截图来自一次性的本地 Web 配置。它们不包含任何凭据或机器私有路径，并且是仓库文档资产，而非运行时依赖。

它提供什么

- 一个附加的 Host 加载器行和一个 Client 侧边栏 Slot；
- 重启并恢复运行中的任务 和 仅重启 操作，并带有显式确认；
- 现有的 dsh-restart Host 服务能力检查，失败时关闭；
- 在 ledger 提交之前进行 Session 刷新，并在延迟的原生重启请求之前接受重启确认；
- 一个私有的、带 schema 版本的 Resume Ledger，具有串行化原子更新、损坏隔离、过期、容量清理和 0600 文件；
- 启动恢复，具有稳定的 intent/RPC 来源、租约、有界并发、重试上限和手动重试；
- 在派发之前和持久化之后进行实时和冷 Session 证据检查；
- 仅对已注册、被中断的普通顶层会话进行自动崩溃恢复；
- fiber 拥有的 Agent 监听器、启动工作、定时器、Remote 服务、Slot 注册、样式和清理。

用户停止、已完成、被阻塞、达到最大 token、出错以及子代理会话均被排除。恢复的轮次是一个新的可见延续请求；它不是进程级检查点恢复。

部署契约

此包有意不实现另一种 DSH 重启机制。目标配置必须已经挂载 dsh-restart@0.3.1 或此小型 Host 契约的其他兼容提供者：

{
provider: 'dsh-restart',
requestRestart: () => Promise
}
dsh-restart 仍然是关闭和重新打开 DSH 的唯一所有者。本包仅负责围绕该操作的持久化恢复编排。如果 dshRestartRuntime 缺失或格式错误，重启请求会在捕获候选对象或写入 Ledger 状态之前返回 RESTART_RUNTIME_UNAVAILABLE。本包不接受任何 launchd/systemd/macOS 辅助程序配置。

安装

仅安装到一次性或明确批准的 profile 中：

dsh plugin --profile web add https://github.com/Harzva/dsh-restart-autoresume/releases/download/v0.1.0-alpha.1/harzva-dsh-restart-autoresume-0.1.0-alpha.1.tgz --ignore-scripts

兼容的 dsh-restart@0.3.1 provider 是前置依赖，必须先安装并挂载。除非当前使用未限定作用域名称 dsh-restart 的不相关公共 npm 包明确实现了上述 dshRestartRuntime 契约，否则不要用它替代。

该 bundle 恰好贡献一行，即 dsh-restart-autoresume。请在 profile patch 层中配置该行；以 id 为目标的 patch 会替换整个 config，因此请重新声明你需要的每一个非默认字段：

- id: dsh-restart-autoresume
config:
autoResumeCrash: true
maxAttempts: 3
claimTtlMs: 30000
intentTtlMs: 86400000
recoveryConcurrency: 1
startupSettleMs: 1000
restartDelayMs: 250

dsh-restart bundle 必须挂载在同一个 Host realm 中。服务查找是实时的，因此停止或卸载该 provider 会立即禁用重启操作，而不会影响 DSH 启动或 Ledger 检查。

禁用与回滚

单个 loader 行就是即时恢复边界。保持包处于安装状态，但通过以下方式禁用所有 Host 和 Client 行为：

- id: dsh-restart-autoresume
disabled: true

重启 profile，并确认原版 DSH 在没有侧边栏操作的情况下启动。若要同时移除包依赖：

dsh plugin --profile web remove @harzva/dsh-restart-autoresume

Resume Ledger 仅包含安全的路由/状态元数据。禁用或移除 loader 不会修改 DSH Session 历史。

安全语义

- 操作员重启仅快照普通运行中的根，刷新每个 Session，原子地记录一个重启代次，确认请求，然后通过 Cordis 拥有的定时器调用现有的 dshRestartRuntime。
- 同一批 Session 的现有已武装崩溃标记会被操作员代次原子地取代，从而防止重复恢复竞争。
- 崩溃恢复仅使用有效的插件拥有的 intent，并要求持久化 Session 边界为 interrupted。
- 每个 intent 使用 dsh-restart-autoresume: 作为稳定的 RPC 来源。在任何重新派发之前，都会检查持久化 inbox 和用户消息证据。
- 续接提示会告知 Agent 在重试之前检查未知的外部结果。本插件不承诺对任意工具或外部系统提供 exactly-once 行为。
- 自动尝试是有界的。一个最终失败的意图可以从 Client 显式重新武装，同时保留相同的意图 id 和去重溯源。

开发验证

pnpm install --ignore-scripts
pnpm check
pnpm run pack:dsh
pnpm run verify:dsh-offline

最终的隔离验证包括真实 Web 加载、Client Remote 激活、通过现有 dsh-restart Host 服务进行的闭环重启、一个正在运行的普通顶层任务的持久化延续、先前的无任务/单任务/多任务以及 SIGKILL 恢复演练、工具结果未知边界、用户停止保护、重试上限/手动重试、断开/重连、响应式浅色/深色 UI，以及仅禁用的原版冷启动。有关证据矩阵和已知限制，请参见 docs/05-验收报告.md。

已知限制

- 受支持的基线是 DSH 0.1.1-rc.2；其他 DSH 候选版本需要重新进行契约和运行时验证。
- 首个版本从不直接恢复子代理。其父级顶层 Session 可以在恢复后协调新的子代理。
- DSH 的原子写入契约提供了加锁的同目录替换，但不声称在突然断电情况下具有完整的目录 fsync 持久性。
- 在确认没有写入者存活后，孤立的账本锁是操作员需要修复的事项。
- 一次性的 Phase 6 进程重启测试装置是用于崩溃/重连演练的测试基础设施；它不是生产依赖，也不是第二个随附的重启实现。