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 继续原任务并向你汇报结果。

人工

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

配置项

| 配置 | 默认 | 说明 | |---|---|---| | waitTimeoutMs | 900000（15 分钟） | when=wait 的最长等待时间（1000 ~ 24h） | | stateDir | <DSH home>/restart | notice 与诊断日志目录 |

架构

| 组件 | 说明 | |---|---| | 插件 Host | 工具注册、重启编排、忙碌协调、通知恢复、HTTP API（lib/index.js） | | 插件 Client | GUI 侧边栏按钮（lib/client.js） | | appRestart 服务 | 由 DSH launcher 提供（profile-boot.ts），负责重读配置、重载模块、事务性重挂与回滚 |

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

HTTP API

POST /plugins/dsh-restart/api

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

故障排查

| 症状 | 处理 | |---|---| | 重启后没有收到恢复通知 | 检查 <stateDir>/notices.jsonl 是否有 pending 记录；重启后应被消费清空 | | 恢复轮报 has no provider/model | 确认 notices.jsonl 中该条 notice 带 provider/model 字段（发起时写入） | | GUI 看不到注入消息 | 刷新页面 / 重开会话 | | 重启后插件代码未更新 | 仅外部插件支持热更；核心包（@deepseek-ai/*）需进程级重启 |

踩坑记录

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

| 坑 | 现象 | 解法 | |---|---|---| | 通知轮缺模型 | 恢复会话报 has no provider/model | notice 携带发起时的 provider/model，resume 显式传入 | | notice 误删 | 重启后用户没收到注入 | notice 改用唯一 id，dropNotices 按 id 过滤而非 sessionId | | 缓存清理失效 | 重启后插件仍运行旧代码 | 模块 URL 做 realpathSync 归一化，匹配 Node ESM loadCache 键 | | 核心包重载崩溃 | Duplicate type name 'STARTUPINFOW' | 应用内重启跳过 @deepseek-ai/* 核心包（koffi 等非幂等） | | 重写文件漏函数 | 重启静默失败无报错 | 重写后必须 diff 验证；restartApp 增加 trace 日志 |

边界认知：

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

开发

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

Changelog

见 CHANGELOG.md。