dsh-hot-restart：DeepSeek Harness 熱重啓與診斷插件

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 進程與命令行、插件日誌等。

默認不創建任何進程，只讀策略與狀態，因此不會觸發殺毒軟件的授權窗口。

典型用法¶

1. 重啓 DSH：

   • 點擊左下角按鈕。
   • 在確認框中選擇「立即熱重啓」。
   • DSH 關閉並自動重開。

2. 靜默重啓：

   • 雙擊插件目錄下的 tools/restart-dsh.vbs，可在不彈出確認框的情況下重啓 DSH。

3. 生成診斷報告：

   • 右鍵按鈕，選擇「自檢並生成診斷報告」。

限制與注意事項¶

• 環境限制：僅限 Windows 桌面客戶端，其他環境按鈕會變灰。
• 重啓強制：重啓是強制的，正在運行的任務會被中斷。
• 啓動方式：不要在控制台裏敲命令啓動 DSH，否則 DSH 會掛在該窗口上，導致插件無法注入。
• 位置調整：按鈕位置寫死在主區域左下角，如需調整需修改 lib/ui.js。

文件與日誌¶

插件運行時會在 $DSH_HOME/hot-restart/ 目錄下生成 restart.log 和 last-restart.json，用於記錄重啓日誌。

插件倉庫：https://github.com/xiaolu511/dsh-hot-restart