Asteroid0449/dsh-restart-resume

dsh-restart-resume

简体中文 | English

License: MIT
Node.js >= 22.19
DSH >= 0.1.0-rc.8
Status: developer preview

面向 DeepSeek Harness rc8+ 的安全自重启与同会话续接：等待工作排空、展示真实状态、由外部监督器重新拉起后端，并在续接落盘后自动恢复 Web 页面。

必要前提： DSH 必须由理解退出码 75 的监督器启动。插件不能凭空重新拉起已经退出的进程；没有监督器时，dsh_restart 会拒绝执行。

30 秒快速开始

要求：Node.js 22.19+、DeepSeek Harness 0.1.0-rc.8+。

从 Releases 下载压缩包后安装到 Web profile：

dsh plugin --profile web add .\dsh-restart-resume-0.2.2.tgz

随后按 监督器契约与示例 配置启动器，并通过监督器重新启动 DSH。普通的 dsh web 不满足自动拉起条件。

首次验证可以告诉 Agent：

查询自重启状态。只有监督器、bootId 和运行版本都可验证时，安排一次 report-only 测试重启；不要要求我手动刷新页面。

普通用户会看到什么

- 重启请求先进入等待排空状态，不会强杀会话、子代理或后台任务。
- 最终倒计时只在已经排空时出现；期间出现新工作会退回等待状态。
- 后端断联期间状态条明确显示“启动暂不可观测”，不会提前宣称成功。
- 新 bootId 证明新的后端实例已经应答。
- 原会话的续接消息持久化后，Web 自动重连并刷新。
- 点击“取消重启”后，终止状态会短暂确认并彻底移除，不持续闪烁。
- 启动或续接失败会显示失败状态，不会伪装成“重启完成”。

三项固定工具

| 工具 | 用途 | 是否写入 |
| --- | --- | --- |
| dsh_restart | 安排受监督重启，默认把它视为原任务中的检查点并在同会话继续 | 是：写入持久化 marker，并最终请求退出 |
| dsh_restart_status | 查询阶段、倒计时、阻塞项、bootId 和稳定工具面摘要 | 否 |
| dsh_restart_cancel | 取消尚未退出的重启请求并清理状态 | 是：取消 marker |

三个工具始终以相同顺序和 schema 注册；状态变化不会改变模型请求的工具前缀。

状态流程

stateDiagram-v2
[] --> scheduled: 用户授权
scheduled --> draining: 到达计划时间
draining --> countdown: 会话、子代理和 jobs 已排空
draining --> timed_out: 排空超时
scheduled --> cancelled: 取消
draining --> cancelled: 取消
countdown --> draining: 出现新工作
countdown --> exiting: 倒计时结束
exiting --> booted: 新 bootId 被观测
booted --> resuming: 找到原会话
resuming --> resumed: 续接已持久化
resumed --> []: Web 自动刷新
timed_out --> []
cancelled --> []
exiting --> failed: 启动或续接不可验证
failed --> [*]

安全行为

- 默认等待全部活跃会话、已发布子代理和后台 jobs 排空。
- 排空超时只取消重启，不强杀工作；单次工具调用最短等待 5 分钟。
- 最终倒计时默认 10 秒、最短 5 秒。
- 只用退出码 75 请求自动拉起；普通退出和崩溃不能形成重启循环。
- 原子 marker、有效期、频率限制和幂等消息避免重复续接与重启环路。
- resumeMode: "continue" 会继续原始任务中尚未完成的配置、验证和交付；只有独立测试才使用 report-only。
- 续接契约明确规定 Web 自动恢复。只有实际检查证明页面仍旧时，Agent 才应建议手动刷新。

监督器契约

启动器必须在每次拉起进程前设置：

DSH_RESTART_SUPERVISOR=1
DSH_BOOT_ID=
DSH_RUNTIME_VERSION=

它必须只在退出码 75 时重新拉起，并限制短时间内的重启次数。完整的 PowerShell 示例、退出语义和验收清单位于 docs/SUPERVISOR.md。

配置

| 配置项 | 默认值 | 范围/作用 |
| --- | --- | --- |
| defaultDelaySeconds | 10 | 5–3600，进入排空前的计划延迟 |
| drainTimeoutSeconds | 1800 | 300–86400，等待工作排空的上限 |
| finalCountdownSeconds | 10 | 5–300，退出前的最终倒计时 |
| pollIntervalMs | 250 | 100–2000，状态检查间隔 |
| maxRestarts / restartWindowSeconds | 见 patch | 重启频率上限 |
| resumeTtlSeconds | 86400 | 待续接 marker 有效期 |
| resumePrompt | 内置安全提示 | 追加到原会话的固定续接文本 |

单次 dsh_restart 可设置 delaySeconds、maxWaitSeconds、resumeMode 和 afterRestart，但不能突破安全下限。

上下文与缓存
插件不注入 system prompt。动态重启状态只在显式工具结果中出现，Web 状态条完全位于浏览器展示层，不进入模型上下文。升级前后可序列化三项工具的 name、description 和 parameters 并比较 SHA-256；相同版本和配置下应保持一致。

常见问题

| 现象 | 原因与处理 |
| --- | --- |
| restart supervisor is not active | 当前进程不是由合规监督器启动；按监督器文档重新启动 |
| DSH_BOOT_ID 无效或没有变化 | 监督器没有为每次进程生成新标识；修复后再测试 |
| 取消后状态条仍出现 | 先调用 dsh_restart_status 确认已取消；若终止状态超过短暂确认期仍存在，请提交浏览器日志 |
| 状态长期“不可观测” | 后端尚未恢复、状态 API 不可达或 bootId 没变化；检查监督器终端，不要把它当作成功 |
| 后端恢复但没有续接 | 检查 marker 是否过期、原会话是否存在以及后端日志；失败不会自动改报成功 |
| 页面没有自动刷新 | 先验证已经到达 resumed；只有页面确实仍加载旧状态时才手动刷新并提交复现 |
| 反复重启 | 监督器应只处理退出码 75，并同时启用插件与监督器的频率限制 |

与其他生命周期工具的关系

- 用户 cordis.patch.yml：已能从 profile 解析的包可事务化 HMR，写 patch 本身不会安装依赖。
- dsh-super-injector：开发态热注入、重载与卸载。
- 本插件：必须重新加载后端或前端 bundle 时，走受监督的正式进程重启。

三者相互独立、定位互补，本插件不冒充、包含、调用或依赖 super-injector。

开发验证

npm test
npm pack --dry-run

CI 在 Windows + Node.js 22.19 上执行同样检查。报告问题时请附 DSH/Node 版本、监督器输出、已脱敏的状态结果和最小复现步骤。

反馈与社区

插件问题请提交到本仓库 Issues。确认属于 Harness 上游的问题，再前往 DeepSeek Harness Discussions。贡献前请阅读 贡献指南，安全问题请阅读 安全策略。

致谢与项目状态

本项目是独立维护的 DeepSeek Harness 社区插件，并非 DeepSeek 官方产品，也未获得 DeepSeek 的背书、合作或认证。感谢 DeepSeek Harness 团队提供插件平台、bundle 机制与开发文档。

感谢 dsh-super-injector 项目对 DSH 开发态热注入、重载与卸载流程的探索。dsh-super-injector 面向开发态插件生命周期，本插件面向受监督的后端进程重启和同会话续接；两者相互独立、定位互补。本插件不包含、调用或依赖 dsh-super-injector 的实现。

DeepSeek Harness、DeepSeek 及其他第三方项目的名称与商标归各自权利人所有；本文提及这些名称仅用于说明兼容性和项目关系。

许可证

MIT