DeepSeek Harness(DSH)的日常开发中,经常遇到需要重置客户端状态或排查环境问题的情况。手动关闭窗口再重新打开效率较低,且遇到杀毒软件拦截或策略异常时难以定位。dsh-hot-restart 插件通过在窗口内嵌入固定按钮,实现了一键热重启与内置诊断功能。
该插件由 xiaolu511 维护,开源协议为 MIT。它不创建新进程,仅读取策略与状态,因此不会触发杀毒软件的授权弹窗。核心功能包括:一键重启 DSH,以及右键按钮生成诊断报告。
安装与启用¶
在 spec 中指定准确版本号,避免供应链策略跳过。安装命令如下:
dsh-hot-restart@0.3.16
若安装失败或需离线安装,可使用 GitHub 地址或 tgz 文件:
github:xiaolu511/dsh-hot-restart
file:/path/to/tgz
安装完成后,必须手动重启一次 DSH。因为宿主侧代码按模块 URL 缓存,且注入表只在启动时收集,页面脚本需要通过一次真实的进程重启才能生效。
核心功能¶
热重启¶
按钮固定在主区域左下角,主题色加白字,不会挤压正文。点击按钮后弹出确认框,选择「立即热重启」即可。页面会弹出「DSH 已热重启完成」提示。按 Esc 可关闭确认框。
重启过程全程零控制台窗口。插件通过向宿主发送 POST /dsh-hot-restart/restart 请求(需带上 x-dsh-hot-restart: 1 头)来触发,宿主使用 WMI 调用 wscript.exe //B lib\relaunch.vbs 来执行重启逻辑,利用 GUI 子系统特性避免创建控制台。
内置自检¶
右键按钮选择「自检并生成诊断报告」,系统会在屏幕正中弹出进度卡片,跑完约 9 秒后生成报告并自动用记事本打开。报告包含派发能力矩阵、安全环境(WSH 策略、杀软状态)、DSH 进程与命令行、插件日志等。
默认不创建任何进程,只读策略与状态,因此不会触发杀毒软件的授权窗口。
典型用法¶
-
重启 DSH:
- 点击左下角按钮。
- 在确认框中选择「立即热重启」。
- DSH 关闭并自动重开。
-
静默重启:
- 双击插件目录下的
tools/restart-dsh.vbs,可在不弹出确认框的情况下重启 DSH。
- 双击插件目录下的
-
生成诊断报告:
- 右键按钮,选择「自检并生成诊断报告」。
限制与注意事项¶
- 环境限制:仅限 Windows 桌面客户端,其他环境按钮会变灰。
- 重启强制:重启是强制的,正在运行的任务会被中断。
- 启动方式:不要在控制台里敲命令启动 DSH,否则 DSH 会挂在该窗口上,导致插件无法注入。
- 位置调整:按钮位置写死在主区域左下角,如需调整需修改
lib/ui.js。
文件与日志¶
插件运行时会在 $DSH_HOME/hot-restart/ 目录下生成 restart.log 和 last-restart.json,用于记录重启日志。
插件仓库:https://github.com/xiaolu511/dsh-hot-restart