DeepSeek Harness (DSH) 採用了插件化架構。在開發或調試過程中，調整配置、重載插件或重啓 Harness 進程是常見需求。如果依賴命令行操作，不僅中斷當前會話，還可能丟失部分上下文。本文介紹的 dsh-power-xc 插件旨在解決這一問題，爲 DSH 提供了優雅的重啓、關機及頁面刷新功能，支持通過 Web UI 一鍵操作。
插件定位¶
dsh-power-xc 是 DeepSeek Harness 的電源管理插件，由開發者 xchannel1987 維護，採用 MIT 許可證。它通過在側邊欄集成電源按鈕，配合獨立的重啓引擎，實現了對 DSH 進程的安全控制。
核心功能¶
該插件主要提供以下能力：
- 頁面刷新：刷新當前瀏覽器頁面。與重啓不同，刷新不會重載插件和配置，僅刷新頁面。適用於頁面狀態異常時的快速恢復。
- 側邊欄電源按鈕：集成在側邊欄底部，與設置按鈕並列。按鈕樣式會自動適配當前的主題風格。
- 重啓功能：具備 Windows 風格的全屏過渡動畫。重啓完成後頁面會自動刷新，且會重載插件和配置。插件內置了獨立的重啓引擎，不依賴外部工具（如 PowerShell 或 taskkill）。
- 關機功能：提供確認對話框，默認焦點在取消按鈕，防止誤操作。關機過程會顯示全屏進度，並確保資源正確釋放。
- 斜槓命令支持：支持
/restart重啓 DSH 和/shutdown關閉 DSH。 - 模型工具支持：提供了
restart_harness工具，可以在對話中請求模型調用以重啓 Harness。 - 日誌清理：自動清理 7 天前的
restart-helper日誌，避免文件堆積。
安裝與啓用¶
確保你的 DSH 版本滿足要求（DSH ≥ 0.2.0-rc.1）。0.2.0 版本起，插件依賴 @deepseek-ai/cordis 提供的 Context，因此安裝前請檢查宿主版本。
使用官方 CLI 進行安裝：
dsh plugin --profile web add dsh-power-xc
安裝完成後重啓 DSH，側邊欄底部將出現電源按鈕。
典型用法¶
插件提供了三種操作方式：
-
Web UI 操作
點擊側邊欄底部的電源按鈕，選擇「刷新」、「重啓」或「關機」，並確認操作。 -
斜槓命令
在輸入框中直接輸入/restart重啓 DSH，或輸入/shutdown關閉 DSH。 -
模型工具
在對話中請求模型重啓 DSH，模型會調用restart_harness工具執行操作。
適用場景與注意事項¶
- 刷新 vs 重啓：當頁面出現顯示異常或響應遲緩時，可使用刷新功能快速恢復；當需要重載插件或配置時，必須使用重啓功能。
- 進程權限：插件以當前 DSH 進程的權限運行，這意味着它無法執行需要更高權限的系統操作。
- 安全設計：重啓過程採用獨立 helper 進程，設置了 30 秒超時機制和健康檢查，支持優雅退出。
- 源碼審查：雖然插件採用 MIT 許可證，但在安裝前建議檢查其源碼，確保符合你的安全與合規要求。
總結¶
dsh-power-xc 爲 DeepSeek Harness 提供了一套輕量且安全的電源管理方案。通過 Web UI 和命令行的結合，它簡化了開發過程中的重啓與關機流程，提升了工具的使用體驗。
