dsh-restart

DSH 应用内整体重启插件：agent 自主 / 人工触发，忙碌会话协调，失败自动回滚，重启后自动恢复会话并继续任务。

版本：1.0.0 · License: MIT

功能

• 应用内整体重启：进程不退出，重新读取全部配置并重挂插件树
  • 插件行添加/移除/修改 → 生效
  • 外部插件代码改动 → 生效（自动重载磁盘最新代码）
  • 配置变更 → 生效
  • 配置错误 / 启动失败 → 自动回滚到上一状态并记录错误（应用不中断）
• agent 自主触发：模型工具 dsh_restart(when, reason)
  • when: 'now'：当前轮结束后立即重启
  • when: 'wait'：等其它会话空闲后再重启（超时仍重启，超时可配置）
• 人工触发：GUI 侧边栏「🔄 重启」按钮（立即 / 等任务完成）
• 重启后自动恢复：恢复发起会话并注入「继续重启前的任务」，agent 自动继续并向用户汇报
• 模型保持：恢复时使用发起会话的模型，不会串到其它模型

安装

前置条件

• DSH（DeepSeek Harness）web 或 headless profile
• DSH 版本需含 launcher 的 appRestart 服务（较新版本内置；如不确定，安装后运行 dsh_restart 工具，返回 ok: true 即支持）

方式一：npm 安装（发布后）

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

方式二：GitHub 仓库

dsh plugin --profile <profile名> add git+https://github.com/<owner>/dsh-restart.git

方式三：本地路径（开发 / 本机使用）

dsh plugin --profile web add D:\path\to\dsh-restart

手动配置（任意方式安装后可选）

在 profile 的 cordis.patch.yml 中按需覆盖配置：

- id: dsh-restart
  name: 'dsh-restart'
  config:
    waitTimeoutMs: 900000   # when=wait 最大等待 ms（默认 15 分钟）

安装完成后重启一次 DSH：侧边栏出现「🔄 重启」按钮，agent 获得 dsh_restart 工具。

使用

Agent 自主

对 agent 说：

请重启 DSH，等其它会话任务完成后执行，原因：更新插件配置

agent 会调用 dsh_restart({ when: 'wait', reason: '...' })；重启完成后本会话自动恢复，agent 继续原任务并向你汇报结果。

人工

侧边栏底部「🔄 重启」→ 立即重启 / 等任务完成后重启。

配置项

架构

重启流程：重读全部配置层 → 备份并重载外部插件模块 → 销毁旧树 → 挂新树 → 失败自动回滚。

HTTP API

POST /plugins/dsh-restart/api

{ "method": "restart.request", "args": { "when": "now", "reason": "..." } }
{ "method": "restart.status", "args": {} }

故障排查

踩坑记录

详细修复链见 docs/2026-08-16-fixes-postmortem.md（5 个根因 + 验证矩阵）。

边界认知：

• 应用内重启 = 外部插件 + 配置变更
• 核心包代码改动 = 进程级重启
• GUI 视图需手动刷新

开发

npm pack     # 构建发布包（产物 .tgz，清单见 package.json files）

Changelog

见 CHANGELOG.md。