dsh-restart
DeepSeek Harness(DSH)纯插件:侧栏左下角账户行(用户名右侧,也就是有更新时 「安装并重启」按钮出现的位置)加一个无边框的纯线条「重启」图标按钮(无文字), 让整个桌面应用一键重启;若重启时当前回合仍在运行,重启后自动"继续"接着跑。
不修改任何 @deepseek-ai/dsh-* 源码。
功能:一键重启 DSH(线条图标按钮)+ 条件自动续跑
左下角账户行有一个无边框的纯线条「重启」图标按钮(电源符号造型,无文字,线条颜色跟随 界面文字色,悬停显示 tooltip;发起重启后图标变成循环箭头并持续旋转表示进行中)。它位于用户名右侧、 连接/更新指示器之前——有更新时「安装并重启」按钮出现的同一列;侧栏收起成窄条时按钮 退回侧栏底部的动作区(避免挤进 36px 的账户行),展开后回到账户行:
- 第一次点击进入确认态(图标变琥珀色,3 秒不点自动复位,防误触);
- 再点一次执行:
- 若当前会话的 agent 正在运行(回合未结束),写入"续跑标记"(重启后自动发"继续"); 若 agent 已停止,则只重启、不续跑;
- 按当前桌面代际选择重启方式(见下),无论如何保证宿主必退;
- 桌面应用随之整体重启:44.x 下 shell 收到插件借道发出的 fatal 通知后,自己走优雅
退出链并原生 relaunch(复活进程只负责替你点掉致命恢复对话框并见证新实例;
兜底才强杀 + 自行拉起);旧版桌面则由复活进程**确认旧实例退出(宽限期内不退就
taskkill /F强杀)**后重新启动应用; - 重启后,被标记的会话一旦由 web 端正常创建/恢复(打开该会话),自动注入"继续"接着跑。
⚠️ 重启会短暂断开当前会话(属预期);回合未结束才会自动"继续"。
自动续跑实现
- 插件监听
agent/created事件:被标记的会话一旦被创建/恢复,立即agent.followup(...)注入"继续"并清标记。 - 不在启动时自己
agents.resume——那会造出缺 agent preset / 工具呈现 / 权限的 "半成品 agent",导致该会话工具大面积 UNKNOWN_TOOL(已踩过坑)。 - 续跑标记 5 分钟内有效,防陈旧标记误复活旧会话。
- 只在 agent 运行中才写标记:回合已结束不续跑。
Agent 触发的重启("你也能自动重启 DSH")
会话内的 agent 可以直接触发带续跑的自动重启:
Invoke-RestMethod -Method Post -ContentType 'application/json' `
-Body (@{ sessionId = $env:DSH_SESSION_ID; text = '继续' } | ConvertTo-Json) `
"$env:DSH_WEB_URL/dsh-revive"
你在对话里说一句"重启 DSH",我就在回复末尾执行它:应用自动关、自动开、回合未结束则自动继续。
三代桌面宿主,插件自动识别
插件在 apply 时按以下顺序识别宿主代际,任一命中才注册 /dsh-revive 路由
(纯 CLI 下保持纯占位,不注册):
| 代际 | 识别条件 | 重启方式 |
|---|---|---|
| 旧版桌面 | 环境变量 DSH_DESKTOP=1 |
复活进程等桌面主进程退出(8 秒宽限,不退 taskkill /T /F),再拉起应用 |
| 中间版桌面(dsh-plugin-desktop v2) | ctx.desktopRuntime 存在 |
宿主原生 desktopRuntime.requestRestart()(app.relaunch() + app.exit(0)),不 spawn 任何外部进程 |
新版桌面(DSH Desktop 44.x,dsh-desktop-host) |
profileContext.name === 'desktop' 且 argv 带 dsh-desktop-host 入口路径 |
借道 fatal IPC 弹恢复对话框 → 窗口助手点「重启应用」→ shell 优雅停宿主后原生 relaunch(兜底:强杀 + 自拉起) |
为什么需要"复活进程 + 强杀"(旧版桌面)
桌面应用(Electron)对 host 只有监督、没有自动复活:host 一退出,桌面主进程理应
app.quit()——但实测经常不退出(变成无子进程的僵尸一直挂着),导致只等它自然退出
永远等不到。所以:
index.js先spawn出revive.mjs(detached,宿主退出后仍存活);revive.mjs给旧实例 8 秒宽限自然退出,不退就taskkill /T /F强杀并确认死透;- 再拉起桌面可执行文件;新实例 5 秒内退出则按 2s/3s/5s/8s 退避重试(最多 5 次)。
全程日志:~/.dsh/storages/dsh-restart-revive.log。
新版桌面(DSH Desktop 44.x,dsh-desktop-host)的重启流程
44.x 桌面与旧版一样是"Electron 主进程 + 独立宿主子进程",但监督行为完全不同:
- 宿主(Cordis host,
dsh-desktop-host)以 Node 模式(ELECTRON_RUN_AS_NODE=1)跑在 Electron 主进程之下,插件就在这个宿主进程里;process.ppid即 Electron 主进程; - 宿主意外退出时主进程不会自动重启,而是弹出「退出 / 重启 / 禁用第三方插件」的
致命恢复对话框,一直等用户点击——审查 DSH 源码后确认:它是插件唯一够得着的
"应用级优雅收尾"杠杆(shell→宿主的
shutdown优雅通道、renderer 桥、二次实例、dsh://协议均无重启入口;宿主→shell 的 IPC 是封闭白名单,仅有fatal一条 "让 shell 弹恢复对话框"的合法消息); - 中间版(v2)的
ctx.desktopRuntime在这一代已不存在,DSH_DESKTOP=1也不再设置 ——这就是插件在 44.x 下按钮失效的根因; - 所以本代重启流程(
revive.mjs三参数模式)是"借对话框 + 让 shell 自己编排":- 插件先脱离地拉起
revive.mjs <hostPid> <shellPid> <exePath>("点击器 + 见证者"); - 复活进程随即预热一个 PowerShell「窗口助手」(枚举 Win32 对话框、发 TaskDialog 消息),趁这几秒把脚本编译好、轮询就位;
- 插件借宿主→shell 的 fatal IPC 消息(协议白名单内的合法消息,插件与宿主同
进程可直接
process.send)触发 shell 弹出上述恢复对话框(先写崩溃报告再弹窗); - 对话框刚冒头,窗口助手就按标题(
DeepSeek Harness …前缀,跨 zh/en 生效)+ 类#32770+ 归属主进程 pid 识别它,先SW_HIDE压掉闪窗,再发TDM_CLICK_BUTTON点「重启应用」(ElectronshowMessageBox的按钮 id 即其在 buttons 数组的下标)——主进程随即走自身的完整优雅链:backend.close()→ 向 宿主发shutdownIPC → 宿主 Cordis 树 dispose、存储落盘、回shutdown-complete→app.relaunch()原生拉起新实例(execPath/argv 完全保真,无外部 launch 与单实例锁赛跑); - 复活进程"见证":确认宿主与主进程都退场、且出现了晚于死亡时刻启动的同名 新进程(StartTime 过滤,排除旧实例残留子进程)即功成身退,全程不再自己拉起;
- 兜底(任一命中才走):
TDM点击不奏效 → 回退WM_CLOSE(等价点「退出应用」, shell 退出但不 relaunch);对话框 30 秒未出现 / 主进程 12 秒未退完 / PowerShell 助手不可用 / 未见证到新实例 →taskkill /T /F强杀整棵树并自行拉起应用 (新实例 5 秒内退出则按 2s/3s/5s/8s 退避重试,最多 5 次)。
- 插件先脱离地拉起
- 若宿主 dispose 卡死超 12 秒:
revive.mjs只强杀宿主单个进程(不带/T——此时复活 进程与窗口助手还是宿主的孩子,树杀会自杀),主进程随后仍走"对话框 → 优雅链"路径。 - 代价:重启瞬间主进程的致命恢复对话框会闪现一次(窗口助手发现后立即
SW_HIDE, 可见时长压到约 1–3 帧),并写一份崩溃报告(报告先于对话框落盘,插件侧无法避免) ——属预期、无害。彻底消除闪窗需上游为宿主→shell 增加"请求重启"的协议消息。
中间版桌面(dsh-plugin-desktop v2,宿主即 Electron 主进程)仍走
requestRestart()原生 relaunch,不经过 revive.mjs——那时process.ppid不是应用本体,强杀会杀错进程。
两种桌面共用:POST /dsh-revive 路由、续跑标记(~/.dsh/storages/dsh-restart-resume.json)、
agent/created 自动注入"继续"。
边界与安全
- 仅在桌面托管下注册(三代识别条件见上表);纯 CLI 宿主下按钮路由不存在。
- 新版识别要求 desktop profile 与
dsh-desktop-host入口路径(argv)同时成立: 从 CLI 手动跑 desktop profile 时后者不成立(此时ppid是用户终端,绝不能杀), 插件保持 no-op。 - 路由为 loopback 的
POST /dsh-revive,只影响本机。 - 强杀只作用于用户主动请求重启的这一棵桌面进程树,不碰其他进程。
安装
# 把插件目录放到你已有的 DSH 插件目录(~/.dsh/profiles/node_modules/ 下),然后运行:
.\install.ps1 -PluginSource "C:\path\to\dsh-restart"
# 不传参数时默认用脚本自身所在目录作为插件源
脚本会:
- 在
~/.dsh/profiles/node_modules/dsh-restart建 Junction 指向插件目录; - 在 profile 的
cordis.patch.yml追加一个- insert:注册块 (自动识别桌面 profile~/.dsh/profiles/desktop/,否则用旧版~/.dsh/profiles/web/); - 校验
require.resolve可解析。
然后完全退出 DSH 进程并重启(这一次仍需手动,因为按钮本身要等插件加载后才出现); 之后插件改动即可用左下角账户行的「重启」图标一键重启。
卸载
Remove-Item "$env:DSH_HOME\profiles\node_modules\dsh-restart" -Force # 删 Junction
# 手动删掉 cordis.patch.yml 里对应的 insert 块
工作原理(为什么不用改源码)
- 侧栏底部有一个
sidebar.footer.action(list 槽,root 作用域);本插件以id: dsh-revive, order: 90注册组件。框架没有给账户行开放插槽,组件再用react-dom的 portal 把按钮挂进settings.launcher锚点所在行(用户名右侧、 更新指示器之前),宿主节点被重渲染挤掉时由 MutationObserver 自动补挂。 client.js点击后fetch POST /dsh-revive;index.js在webServer上注册该路由:- 中间版桌面(
ctx.desktopRuntime存在):直接desktopRuntime.requestRestart(); - 新版桌面(desktop profile + argv 带
dsh-desktop-host):spawn 三参数revive.mjs,随后ctx.appExit(0)优雅退出宿主(3 秒兜底强退); - 旧版桌面(
DSH_DESKTOP=1):spawn 二参数revive.mjs,再请求宿主退出 —— 宿主提供ctx.appExit则调用并 3 秒兜底强退;桌面 web 宿主不提供appExit, 直接process.exit(0)(宿主退出 → 桌面监督器app.quit()→ 复活进程重新拉起应用)。
- 中间版桌面(
- 请求体带
{ sessionId, text }且 agent 运行中时,先写"续跑标记"到~/.dsh/storages/dsh-restart-resume.json;重启后agent/created事件触发自动注入"继续"。
注意事项
- 一键重启会断开当前会话;若复活进程异常(极少数),应用可能只是关闭未自动重启, 手动再开一次即可,不会损坏任何数据。
- 宿主半边只在应用启动时加载:装好插件 / 改动
index.js后,必须完全退出并重启一次 桌面应用,/dsh-revive路由才存在。若只刷新了页面(图标已是新的)而宿主还是旧代码, 点击会失败——此时图标会变红 4 秒提示,控制台有详情。 - 新版桌面上每次一键重启都会在应用日志目录留下一份"宿主停止"的崩溃报告,且主进程的
恢复对话框会闪现不到半秒(随即被复活进程的窗口助手以
WM_CLOSE关闭,主进程优雅 自退)——均属预期现象。
No comments yet. Be the first to write one.