dsh-restart-suite
重启应用:把原来三个独立插件合成为一个,由它掌控「重启 → 唤醒 → 续跑」全链路。
dsh-autonomous-restart—— agent 调工具重启dsh-restart-now—— 用户点按钮重启dsh-interrupted-resume—— 重启后把被打断的会话叫醒
三者合并后共用一份清单(roster),从结构上杜绝「同一个会话在一次重启里被投递两次」。
安装
本插件是 bundle(package.json 的 dsh.bundle.patch → cordis.patch.yml),
不是纯 UI 插件:它同时挂了 host 半边(index.js,提供 restart_dsh 工具和
/dsh-restart-suite/api 路由)和浏览器半边(client.js,7 个界面座位)。
所以必须由宿主在启动时把它插进 cordis 树 —— 不能运行时动态加载。
从应用内安装
打开应用 → 设置 → 插件,选本包(本地目录 / npm pack 产物 / 市场条目都行)。
装完重启一次才生效:host 半边和客户端模块都只在启动时装载。
装成这样验证:
| 检查点 | 期望 |
|---|---|
| 侧栏左上角 | 出现「重启应用」行 |
| 设置页 | 出现「重启应用」一节(含倒计时/唤醒词默认值) |
| 会话标题栏 | 出现 ⟳ 按钮 |
| 工具列表 | 有 restart_dsh |
~/.dsh/dsh-auto-restart/logs/plugin-load.log |
有新的 apply 开始 pid=… 一行 |
最后一行是唯一可靠的判据:界面没出来、日志却已经有新 apply,说明是前端座位
注册的问题;日志里根本没新 apply,说明宿主没加载到本包。
⚠️ 不要用
dsh plugin --profile desktop add …。 桌面端 profile 由 Electron 应用独占管理,CLI 会直接拒绝:profile "desktop" is managed exclusively by the Electron application(@deepseek-ai/dsh/lib/bin.js的rejectElectronProfile();只有 desktop host 自带manageDesktopProfile: true时才放行)。桌面端正规入口只有「应用内插件页」。
本地开发(link 装法)
profile 的 dependencies 用 link: 指向本目录,改源码后重启即生效,不用重装:
"dsh-restart-suite": "link:C:/path/to/plugins/dsh-restart-suite"
还要把包名写进同一个 package.json 的 dsh.profile.bundles,否则
cordis.patch.yml 不会被应用,插件等于没装。
两个入口,同一套判定
| 入口 | 触发 | 判定链路 |
|---|---|---|
| agent | 调 restart_dsh 工具 |
判忙 → 倒计时 → 等人齐 → 动手 |
| 按钮 | 点界面按钮(3 处:侧栏面板 / 会话标题栏 / 设置通用行) | POST /restart → 同一个 tool.execute() |
按钮不自己判断能不能重启——它和 agent 走完全相同的链路,否则就成了绕过安全检查的后门。
只允许根会话触发
子代理(session.header.origin === 'subagent' 或有 parentSession)调 restart_dsh 会被拒绝:
子代理不能自己重启应用。原因:你的父代理正在等你返回结果, 重启会把整棵树一起打断,父代理和你会互相等死。
正确做法:把「需要重启才能验证」这件事写进你返回给 Lead 的结果里, 由 Lead 汇总所有子代理结果后,自己调一次 restart_dsh。
读不到 session.header 时按根会话处理(宁可放行 Lead,也不误拒)。
一份清单(roster)
{
"runId": "mw97j3ld-f5lz6h",
"phase": "ready",
"sessions": [
{ "id": "session-A", "role": "initiator", "text": "跑 npm test", "deliveredAt": 0 },
{ "id": "session-B", "role": "waiter", "text": "改动已生效", "deliveredAt": 0 },
{ "id": "session-C", "role": "bystander", "turn": 6, "text": null, "deliveredAt": 0 }
]
}
| role | 谁 | 投递内容 |
|---|---|---|
initiator |
触发这次重启的会话 | 它自己的 autoSay |
waiter |
也表达了意愿、一起等的 | 它自己的 autoSay |
bystander |
没表达意愿但会被打断的 | 插件生成的「先核对状态再继续」 |
幂等三层
- requestId:
restart-wake-<runId>-<sessionId>—— 跨重试恒定,宿主按它去重 - deliveredAt:投递成功立刻落盘,重启再崩也不会重复
- phase:
phase !== 'ready'时不投递
曾经
requestId里带Date.now(),每次重试都是新 id,等于把这层幂等彻底关掉 (2026-11-09 修)。
判定策略
判忙(core/policy.js)
任一成立即算忙:
- agent
status === 'running' inbox.nextTurn/nextStep非空(排队消息)- 有已武装的定时提醒(
session/activity瀑布里kind === 'schedule') - 后台 job 处于
running/stopping - 拿不到
agents服务(无法确认空闲)
三档分类(classifyStrangers)
| 类型 | 判据 | 处理 |
|---|---|---|
| 硬拦 | job / 定时提醒 / 排队消息 / 服务不可用 | 永远等(不会自愈) |
| 硬拦 | 无关会话,这一轮还没结束 | 等 |
| 软拦 | 无关会话,这一轮已有 turn/end |
放行,记日志 |
判据是「这一轮结不结束」,不是「跑了多久」。2026-11-09 实测推翻了 「跑久了就可以打断」这个启发式——被打断的会话
resume.log显示0 resumed, 用户只能手动点继续。
保护期(earlyGoGraceFor)
倒计时期间若「发起会话已说完 + 全机空闲」,可以提前动手,但要等满保护期:
保护期 = min(5 秒, countdownSec / 2)
| countdownSec | 保护期 |
|---|---|
| 3(最小) | 1.5 秒 |
| 5(默认) | 2.5 秒 |
| 10 | 5 秒 |
| ≥60 | 5 秒(上限) |
保护期是留给人的取消窗口。固定 5 秒会压过短倒计时——用户设 3 秒却要等 5 秒, 设置就形同虚设。
界面座位(7 个)
| 座位 | 用途 | order |
|---|---|---|
shell.overlay |
倒计时 / 等待 / 终止页 | 100 |
settings.section |
设置页(可编辑默认值) | 900 |
settings.section.icon |
设置页导航行的图标(id 必须等于 settings.section 的 id,否则走 navIcon() 齿轮兜底) |
— |
sidebar.panellist |
侧栏左上角「重启应用」行 | 60 |
main |
点上面那条后显示的面板(key 必须等于 panellist 的 id) | — |
conversation.session.header.actions |
会话标题栏 ⟳ 按钮 | 15(< 20 才不被官方 jobs 挤右) |
settings.general.item |
设置 → 通用 行 | 91 |
图标档位两处不同:sidebar.panellist 用 regular(1)(与「更多」同列同档),
settings.section.icon 用 medium(1.3)(与官方 navIcon() 兜底同档)。
为什么必须分开——官方图标只有两档线宽,档位按座位对齐邻近的官方图标,不是全局统一:
| 座位 | 邻近的官方图标 | 档位 | 尺寸 |
|---|---|---|---|
sidebar.panellist |
同一列的「更多」 | regular = 1 |
16(窄)/ 18 |
settings.section.icon |
navIcon() 兜底(如设置齿轮) |
medium = 1.3 |
16 |
三条要点:
stroke-width挂在<svg>上,不要挂在<path>上 —— 官方就是<svg … stroke-width="…">+<path stroke="currentColor">。- path 数据逐字抄官方
refresh-outline,不要自己画:官方坐标在 16×16 网格上 已经对过视觉重心。 - 不要加
strokeLinecap: 'round'/strokeLinejoin: 'round'—— 圆头等于两端 各撑粗半个线宽,16px 上就是「加粗一档」,用户会直接看出颜色不对。
线宽只要不是 1 或 1.3,就一定被看出来。参考实现与钉住这两件事的测试见
client.js 的 RefreshIcon 和 test/client-smoke.test.mjs。
sidebar.footer.action 没有注册:侧栏底部按钮与左上角面板功能重复,
按用户反馈去掉。
等人齐用悬浮卡片,不是全屏遮罩
waiting 可能持续 GATHER_MAX_MS = 10 分钟。用全屏遮罩意味着用户十分钟什么都干不了
(2026-11-09 用户直接反馈)。所以这一态用右下角卡片,外层 pointerEvents: 'none',
卡片以外的区域照常可点。
倒计时(counting)仍然用全屏遮罩:只有几秒,且「一动就取消」是设计意图。
测试
npm test
| 文件 | 覆盖 |
|---|---|
test/roster.test.mjs |
清单结构、幂等键、原子写、脏数据丢弃 |
test/policy.test.mjs |
判忙、三档分类、保护期 |
test/deliver.test.mjs |
按 role 投递、三层幂等 |
test/suite-integration.test.mjs |
装配层:读清单 → 投递 → 清理 |
test/client-smoke.test.mjs |
浏览器 bundle:座位注册、8 个 phase 渲染、按钮行为 |
test/manifest-integrity.test.mjs |
package.json 的承诺是否兑现(见下) |
test/unload-cleanup.test.mjs |
卸载后必须停表(不再对已卸载的插件拉起脚本)、日志滚动、请求体上限、坏清单隔离文件不再累积 |
manifest-integrity 为什么必须有
2026-11-09 事故:本包在 package.json 里声明了 exports["./client"] 和
dsh.client.platform='web',但 client.js 从未落地。dsh-client-modules 是
required 插件,它启动时强校验 bundle 存在,缺失即抛 → 整个应用 fatal。
那天至少 3 次启动全部失败。 这条检查跑 3 毫秒,本来能挡住它。
详见 docs/INCIDENT-20261109-missing-client-bundle.md。
状态目录
沿用 ~/.dsh/dsh-auto-restart/(不是新目录):
settings.json 用户改过的默认值(倒计时、唤醒词、launchCommand)
roster.json 重启清单
wake-request.json 脚本信号文件(脚本写 ready,插件据此认为应用起来了)
launch-plan.json 启动计划
logs/ plugin.log / restart-*.log
为什么不换新目录:旧目录里有用户的 settings.json 和历史日志,换目录等于全丢。
为什么 roster 和 wake-request 是两个文件
脚本写 ready 时会整份重建 wake-request.json,只保留它认识的字段
(runId / phase / sessionId / text / startedAt / error)。把
sessions[] 数组放进去会被丢掉。
所以:roster.json 存完整清单,wake-request.json 只做「应用起来了没有」的信号,
两者靠 runId 关联。
已知缺口
| 项 | 状态 | 影响 |
|---|---|---|
| 两段式停机 | ❌ 未接线 — engine/helper-src.js 已搬入但主流程没调用 |
现在靠脚本硬杀,进程可能来不及落盘 |
| 崩溃续跑 | ❌ 已移除 — 原 after/sweep.js(全量扫描兜底)从未被接线,2026-11-10 删除 |
崩溃/强杀后被中断的会话不会自动续跑,需手动继续 |
abort 分支 |
⚠️ 未真机验证 — 普通 Esc 走的是 cancel 分支 |
只有按住「停止生成」按钮才走 abort |
| 跨平台 | ❌ 仅 Windows — 实际接线只到 scripts/Restart-DSH.ps1(PowerShell);engine/helper-src.js 有 darwin/linux 分支但未被 index.js 引用 |
macOS / Linux 无停机脚本 |
| 按钮逐项开关 | ❌ 未实现 — restart-now 有此功能,本包全开 | 无法单独关掉某个入口 |
已验证(真机)
| 项 | 证据 |
|---|---|
| 清单投递全链路 | 发现重启清单:runId=… phase=starting sessions=1 → 投递完成【initiator】… → 清单已全部投递,清理完成 |
| 图标档位(侧栏 regular) | 墨量 208.4,同列官方 217.0 / 242.5,同档 |
| 图标档位(设置页 medium) | 墨量 92.0,同页官方 medium 92.8,差 0.9% |
settings.section.icon 座位配对 |
真机显示圆弧箭头而非齿轮 = id 配对成功 |
| 改名生效 | 侧栏 + 设置页 + 面板标题均显示「重启应用」 |
No comments yet. Be the first to write one.