dsh-hot-restart

dsh plugin --profile web add dsh-hot-restart

dsh-hot-restart · DSH 热重启




[中文](README.md) | [English](README.en.md) | [小白向指南](小白向指南.md)

在 DSH 窗口里放一个固定的按钮，点一下就把 DSH 关掉并自动重开；出问题的时候，右键它就能生成一份能直接定位的诊断报告。

• 按钮固定不动，浮在页面上，不会挤压正文；
• 实心主题色加白字「热重启 DSH」，一眼能看见；
• 点下去先弹确认框，提醒重启会中断正在运行的任务；
• 重开之后页面会弹一条「DSH 已热重启完成」；
• 右键按钮 → 自检：十秒左右产出一份自包含的诊断报告，用户只要把那个 txt 发过来就行，不用自己描述症状。

内置自检

按钮不好使、DSH 关了没起来、装了插件打不开 —— 这类问题以前只能靠来回问。现在点一下就有答案：

• 右键按钮 →「自检并生成诊断报告」，屏幕正中弹一张进度卡片（第几步 / 在干什么 / 已用秒数），

跑完给出报告完整路径，并自动用记事本打开。卡片上有「取消自检」；

• 出错会自动跑：重启请求被拒、点了变灰的按钮、宿主发现上一次启动是失败的；
• DSH 没起来时助手也会跑：DSH 被关掉之后只有助手还活着，它启动新实例失败、

或者新实例起来 12 秒内又死了，就自动生成报告并弹窗；

• 默认不创建任何进程：只读策略与状态，所以不会触发杀毒软件的授权窗口（自检 9 秒左右）。

要看五条派发通道的实测结果，加开关再跑一次：tools\diagnose.cmd -DeepProbe；

• 也可以直接双击 tools\diagnose.cmd 手动跑，报告写到桌面。

报告里有什么：结论速览、派发能力矩阵（五条通道各报「进程建了没 / 还活着吗 / 脚本产出了没」）、

安全环境（WSH 策略 / 执行策略 / 已装杀软 / Defender 受控文件夹与 ASR / AppLocker）、

DSH 全部进程与命令行、插件文件哈希、市场锁是否卡死、上次启动停在哪个阶段、GPU 崩溃次数、

端口、路由，以及完整的插件日志。

每个版本的改动见 [CHANGELOG.md](CHANGELOG.md)。

安装

已发布到 npm。spec 要带准确版本号 —— 刚发布的版本在 24 小时内会被 DSH 的供应链策略跳过，只写包名会停在旧版本：

dsh-hot-restart@0.3.16

装不上就换 GitHub 地址，目标机器需要有 git：

github:xiaolu511/dsh-hot-restart

离线环境可以用打包好的 tgz，spec 写 file: 加上 tgz 的绝对路径。

桌面客户端让 Agent 执行 plugin_manager 的 install_bundle 即可。web profile 走 CLI：

dsh plugin --profile web add dsh-hot-restart

装完要手动重启一次 DSH

两个原因，都得靠一次真实的进程重启解决：

1. 桌面壳的注入表只在宿主启动时收集一次，之后经 IPC 交给页面并缓存，运行期没有刷新通道。

不重启的话，页面里不会出现按钮；

2. 宿主侧代码按模块 URL 缓存，热装热更不会替换已经在跑的模块，所以 lib/index.js 的改动

要等下一次宿主启动才生效。插件管理器也会把这类安装标成 restart-required。

重启方式二选一：

• 双击 tools\restart-dsh.vbs，推荐；
• 托盘图标右键「退出」，再正常打开 DSH。

用法

操作 · 结果

点按钮 · 弹确认框 →「立即热重启」→ 关闭并自动重开 DSH

Esc · 关掉确认框

按钮平时是主题色；宿主判断不可重启时变灰，悬停能看到原因；正在重启时变琥珀色。

它是怎么重启的

1. 页面请求 POST /dsh-hot-restart/restart，带上 x-dsh-hot-restart: 1 头；

2. 宿主半区先定位外壳进程，看的是自己的父进程：不能是 Electron 的 --type= 子进程，不能是终端或解释器，

并且 exe 名字得像 DSH 应用，否则直接拒绝，绝不去杀终端里的 dsh web；

3. 用 WMI 派发 wscript.exe //B lib\relaunch.vbs。wscript 是 GUI 子系统程序，不创建控制台；

WMI 创建的进程脱离 DSH 的 Job，能活到外壳退出之后；

4. 宿主回包给页面，700ms 后 taskkill /F 终结外壳进程；

5. 助手等外壳退出，25 秒内没等到就自己用 WMI 强制结束，接着等 19387 端口释放，

最后用 WMI 拉起 DSH，新实例不继承任何控制台。

日志在 $DSH_HOME/hot-restart/，里面有 restart.log 和 last-restart.json。

文件

dsh-hot-restart/
├─ cordis.patch.yml          # bundle 挂载声明
├─ lib/
│  ├─ index.js               # 宿主半区：注入行 + /dsh-hot-restart/* 路由 + 重启编排
│  ├─ relaunch.vbs           # 重启助手首选：零控制台，等外壳退出后用 WMI 拉起 DSH
│  ├─ relaunch.ps1           # 助手兜底，只在系统禁用 wscript 或 VBScript 时用到
│  └─ ui.js                  # 页面侧：固定位置的按钮，无构建步骤
├─ tools/
│  ├─ restart-dsh.vbs        # 双击即静默重启 DSH，零窗口，升级或救急用
│  ├─ restart-dsh.cmd        # 终端里用，会打印进度，但 .cmd 必然带控制台窗口
│  └─ restart-dsh.ps1        # 上面 .cmd 的实现
├─ tests/host-half.test.mjs
└─ package.json

路由

方法 · 路径 · 说明

GET · /dsh-hot-restart/status.json · 宿主与外壳信息、能否重启，页面加载时问一次

POST · /dsh-hot-restart/restart · 发起热重启，需要 x-dsh-hot-restart: 1

GET · /dsh-hot-restart/ui.js · 页面脚本本体

三条路由都会先过插件自己的回环检查、同源检查和 Sec-Fetch-Site 检查，再交给宿主信任栅栏，

所以只有本机页面能触发。裸 curl 会拿到 401。

卸载

让 Agent 执行 plugin_manager 的 remove_bundle，target 写 dsh-hot-restart；或者：

dsh plugin --profile web remove dsh-hot-restart

最后删掉 $DSH_HOME/hot-restart/ 就行，里面只有日志和上次重启记录。

限制

• 只在 Windows 桌面客户端下能热重启，其它情况按钮会变灰并说明原因。
• 重启是强制的。正在生成或执行工具的任务会被中断，会话与项目文件都已落盘，重开后可以继续。
• 别用「在控制台里敲命令」的方式启动 DSH：那样 DSH 会挂在那条命令行的控制台上，关掉那个窗口 DSH 也会死。

这是 Windows 的行为，不是插件造成的。用开始菜单快捷方式、双击 exe 或本插件的重启工具都没这个问题。

• 按钮位置：普通 Web 页面在主区域左下角；Windows 桌面壳里自动放到右上角、最小化按钮左边

（40px 标题栏内居中，全屏时退回左下角）。想改就改 lib/ui.js 里 #dsh-hr-btn 的 left/bottom/right。

鸣谢

• @xiangjian9998：把按钮从主区域左下角挪进 Windows 标题栏右上角、

最小化按钮左边（PR #3）