前言¶
在 DSH Web UI 裏調試時，經常會遇到需要重新拉起 dsh web 的情況：頁面狀態需要重置、本地修改後需要重新加載，或者希望少切回終端執行命令。dsh-web-restart 把這類操作收斂爲界面裏的一個按鈕：在側邊欄底部、Settings 旁邊增加一個圓形重啓按鈕，單擊後直接重啓 dsh web 進程。
這是什麼¶
dsh-web-restart 是面向 DeepSeek Harness Web UI 的一個小型插件。它給 Web 側邊欄底部增加一個重啓入口，用於單擊重啓 dsh web 進程，不提供二次確認步驟。插件以 bundle-layer plugin 形式安裝，因此它觸發的 DSH 重啓後，按鈕本身仍然保留。
倉庫地址爲：
https://github.com/1123762794/dsh-web-restart
許可證爲：
MIT
核心功能¶
- 在側邊欄底部、Settings 旁邊增加小圓形重啓按鈕。
- 單擊按鈕即可重啓
dsh web進程，沒有確認步驟。 - 重啓進行中會顯示反饋；如果一次重啓尚未完成，第二次點擊會被拒絕。
- 插件持久存在，作爲 bundle-layer plugin 可經受它觸發的 DSH 重啓。
- 插件用於顯示 DSH 的存活/狀態，輪詢接口爲：
GET /dsh-health
輪詢間隔爲 5 秒。
安裝與啓用¶
從 GitHub 安裝¶
已覈實的安裝命令使用佔位 YOUR_OWNER，執行前需要替換爲實際倉庫所有者。本文給出的倉庫地址爲：
https://github.com/1123762794/dsh-web-restart
安裝命令如下：
dsh plugin --profile web add github:YOUR_OWNER/dsh-web-restart
執行後，需要再重啓一次 dsh web，讓 bundle 層加載。
手動編輯 profile 文件¶
如果不用命令安裝，也可以手動編輯 web profile 文件。
1、在下面的文件中加入依賴：
~/.dsh/profiles/web/package.json
{
"dependencies": {
"dsh-web-restart": "github:YOUR_OWNER/dsh-web-restart"
}
}
2、在下面的文件中加入插件插入行：
~/.dsh/profiles/web/cordis.patch.yml
- insert:
- id: dsh-web-restart
name: dsh-web-restart
3、在 profile 目錄執行依賴安裝：
pnpm install
4、再重啓一次 dsh web。
典型用法¶
安裝並重啓 dsh web 後，可以在 Web UI 的側邊欄底部看到重啓按鈕。單擊按鈕後，dsh web 進程會被重啓；頁面通常會斷開約 15–20 秒，完成後刷新頁面即可恢復。資料說明會話會保存在磁盤上，並自動恢復。
在調試本地改動時，可以檢查下面兩個文件：
node --check lib/index.js
node --check lib/client.js
組成與文件¶
下面列出已覈實的文件與職責。
lib/index.js
lib/client.js
cordis.patch.yml
lib/index.js：宿主側文件，負責觸發重啓。資料說明宿主側會在danger-full-access沙箱策略下啓動重啓腳本。lib/client.js：客戶端文件，負責註冊側邊欄按鈕並輪詢GET /dsh-health。cordis.patch.yml：bundle 層插入行，用於把插件掛載到 web profile。
適用場景與注意¶
版本與依賴：
DeepSeek Harness 0.1.0-rc.6
@deepseek-ai/cordis ^4.0.1
適合以下場景：
- 使用 DeepSeek Harness 的 web profile。
- 希望把
dsh web的重啓動作放到 Web UI 中完成，減少切換到終端。 - 需要看到 DSH 基本存活/狀態，避免誤以爲頁面還可用。
使用前需要注意：
- 該插件偏 Windows：重啓會通過一個獨立的隱藏 PowerShell 進程啓動
dsh web，以便在 harness 進程被終止後腳本仍可繼續運行。 - 重啓腳本路徑按作者機器硬編碼爲：
D:\1\dsh-web-host.ps1
如果你的環境不同，需要 fork 倉庫後調整路徑，或替換 lib/index.js 中的命令。
- 宿主側在
danger-full-access沙箱策略下啓動重啓腳本。由於這類操作會由 dsh 宿主側觸發，應將其視爲以當前 dsh 進程可獲得的權限運行；安裝前建議檢查源碼、許可證，並確認你信任該倉庫。 - 重啓期間頁面會斷開約 15–20 秒；完成後需要刷新頁面。會話保存在磁盤上，並自動恢復。
結尾¶
dsh-web-restart 把 dsh web 的重啓動作從終端移到 Web UI 側邊欄：單擊觸發、有進行中反饋、重啓後按鈕仍在，並能顯示 DSH 的存活/狀態。許可證爲 MIT，倉庫地址爲：
https://github.com/1123762794/dsh-web-restart
如果通過獨立社區目錄檢索，可以按插件名 dsh-web-restart 查找；本文未提供已覈實的目錄頁鏈接。
