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 挂载声明