dsh-hot-restart

dsh-hot-restart · DSH 热重启

中文 | English | 小白向指南

在 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。

安装

已发布到 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 或本插件的重启工具都没这个问题。
• 按钮位置写死在主区域左下角。想换位置就改 lib/ui.js 里 #dsh-hr-btn 的 left 和 bottom。