进程自重启 instpe/dsh-self-restart

dsh-self-restart

让会话智能体重启承载它的 DeepSeek Harness 宿主进程，重启完成后在原会话内收到一条消息（默认「已重启」）。

设计说明见 docs/design.md。

能力

- 工具 restart_self：由会话智能体调用，写入重启标记，等当前轮结束并刷盘后替换进程。
- 命令 /restart：由人直接触发，出现在输入框的命令菜单中，不经模型；命令名之后的文本即投递文本。
- 常驻提示段：把「何时该用」写进系统提示，让模型在「重启 dsh / 让改动生效」这类请求下主动选择该工具，而不只靠 schema 被偶然读到。
- 进程替换：分离式 helper 等待端口释放，以完全相同的命令行拉起替换进程；日志写入系统临时目录。
- 续跑投递：浏览器端在宿主恢复后，把标记中的消息作为一条用户消息送回原会话。
- 其它活动会话续跑：重启时仍 running 的其它顶层会话各收到一条提示，说明宿主重启过、本轮可能被中断、请从未完成处继续（notifyActive 可关闭）。

智能体如何知道有这个工具

三层，缺一都会退化成「偶然才用」：

1. 目录：ctx.tools.register 让 restart_self 进入该 Agent 的工具目录，随每次模型请求下发名称、描述与参数。
2. 提示：ctx.systemPrompt.section 注入常驻提示段，写明触发条件与「调用后不必再叮嘱重启」。
3. 命令：/restart 给人用；输入框输入 / 即可看到。

注意：若会话使用「首轮工具收窄」的预设（例如 liangshen），新会话的第一个请求只暴露 bootstrap 工具，restart_self 会在第一次工具调用之后才出现于目录中；这属于预设行为，不是插件缺注册。

配置

插件行 config 支持下列键（缺省值见括号）：

| 键 | 类型 | 说明 |
| allowRestart | boolean（true） | 为 false 时工具直接失败 |
| message | string（已重启） | 默认投递文本 |
| maxAgeMs | 正整数（600000） | 标记有效期 |
| readyDelayMs | 非负整数（1500） | 刷盘后到终止自身的等待 |
| idleTimeoutMs | 正整数（15000） | 等待智能体静默的上限 |
| port | 正整数或 null（null） | 覆盖端口；缺省取 Web 载体实际端口 |
| markerDir | string（''） | 覆盖标记目录；缺省 <DSH_HOME>/self-restart |
| dryRun | boolean（false） | 只写标记，不替换进程；用于自检与演练 |
| notifyActive | boolean（true） | 是否为重启时仍在工作的其它会话各留一条续跑提示 |
| resumeMessage | string（见源码） | 发给那些会话的提示文本 |

安装

1. 目录联接：把插件检出目录接到 profile 的 @local 作用域（与既有 @local 插件同形） New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\@local\dsh-self-restart" -Target "<CHECKOUT>"

2. profile 清单：dependencies 增加 "link:<CHECKOUT>"， dsh.profile.bundles 追加 "@instpe/dsh-self-restart"

3. 重启一次宿主

其中 <CHECKOUT> 指本仓库的本地检出路径，例如 link:C:/src/dsh-self-restart。

不要用 cordis.patch.yml 直接插入：插件自带装载行，重复插入会产生同 id 双行。

使用

两种触发方式，效果相同：

/restart # 人：输入框直接执行，投递默认文本「已重启」 /restart 环境已就绪 # 人：命令名之后的文本即投递文本

restart_self({ message: "已重启" }) # 模型：由智能体调用

两条路径都是「先安排、后发生」：调用当即返回，此刻尚未重启。工具返回值里 restarted 恒为 false，并用 timing 说明随后的等待：

{
"ok": true,
"restarted": false,
"pid": 20532,
"sessionId": "session-…", "deliverAfterRestart": "已重启",
"timing": { "afterTurnMs": 1500, "idleTimeoutMs": 15000, "portWaitMs": 30000 },
"note": "尚未重启。进程会在本轮回复结束、会话刷盘后被替换……", "logPath": "…\\Temp\\dsh-self-restart-….err.log" }

restarted: false 是刻意留的：只有它能让模型不把「已排程」说成「已重启」。本轮回复可能在替换时被截断，属正常；浏览器重连后，原会话收到 deliverAfterRestart 并产生一轮回复。

重启时仍在运行的其它顶层会话也各收到一条续跑提示（默认文案见源码 resumeMessage），由同一条投递通道送出，所以被切断的工作会自己接上。判定口径：只取根会话、只取 running、排除发起者、每会话一条、上限 20 条、临动手前取快照。

验证

node test/smoke.mjs

自检覆盖配置校验、启动命令行重建、工具/命令/提示段/路由注册、标记存储与接口契约（含写入者隔离），以及真实拉起一个替换子进程。第 4 项会把返回值键集合与 output.schema.required 逐字比对——只断言「字段存在」抓不到「schema 已改、execute 还返回旧字段」这种半途状态。

查看运行中的注册情况（宿主 Inspect）：Tool.listTools 应含 restart_self；/api/commands/list 应含 restart。
改动本插件时的注意：宿主会热重载被 watch 的插件文件。若一次改动拆成多次保存，watcher 可能在中间态重载，得到一个「新 schema + 旧 execute」的混合定义，表现为调用时报 missing required property "value.…"。改完一组相关编辑后重启一次宿主再验收，或一次保存整块。

投递语义

标记带写入者 pid，GET /api/pending 只返回非当前进程写入的条目。因此在重启发生前，前端看不到这条标记，不会把消息投进仍在运行的旧智能体的队列；只有替换进程启动后条目才可见，此时会话处于冷态，投递会正常开启一轮。若一次重启并未真的发生（例如 dryRun，或 helper 引导失败），这条消息就不投递——因为「已重启」只有在确实重启后才成立。

已知局限

- 无恢复页面：替换进程引导失败时只有日志，需手工重新执行 dsh web。
- 投递依赖浏览器在线：无界面宿主下标记会在有效期后失效。
- 多标签页并发投递为弱一致去重，极端竞态最多重复一条消息。