DeepSeek Harness (DSH) 採用插件化架構，開發者常需要快速查看賬戶餘額或完整關閉 Harness 進程。dsh-system-control 插件將這兩個核心功能直接嵌入到左側邊欄中，避免了使用浮層帶來的遮擋和干擾。
插件簡介¶
這是一個由 lnetrit-alt 維護的 DSH Web 插件，定位爲側邊欄組件。它主要解決兩個痛點：一是提供實時的 API 餘額顯示，二是提供優雅的全機關機入口。插件遵循 MIT 許可證。
核心功能¶
1. 側邊欄嵌入¶
插件註冊在 sidebar.footer.action，渲染位置位於左側邊欄的設置按鈕上方。它不使用卡片樣式，直接跟隨主題渲染，不會遮擋或被裁剪。
2. 實時餘額顯示¶
餘額數據來源於 https://api.deepseek.com/user/balance。
* 自動刷新：每次模型 API 調用後自動刷新，同時每 25 秒輪詢一次。
* 手動刷新：點擊餘額文本即可觸發刷新。
* 容錯處理：獲取失敗時顯示 獲取失敗，點擊可重試。
3. 極簡關機按鈕¶
採用黑色線框風格的電源圖標（無填充、無圓圈）。點擊後彈出確認對話框，確認流程如下：
1. 調用 sessions.flush 刷新所有會話數據，確保持久化。
2. 調用 appExit(0) 優雅退出 Harness，包括停止 Web UI、終止子進程並銷燬進程樹。
3. 硬回退機制：如果在 1.5 秒內優雅退出未完成，強制執行 process.exit(0)，確保 Web UI 關閉。
4. 佈局適配與清理¶
- 摺疊側邊欄支持：在 56px 寬的摺疊側邊欄模式下，確認提示會自動收縮爲
退出？。 - 視覺清理：激活該插件時，會隱藏官方 Cordis 面板圖標，保持側邊欄整潔。
安裝與啓用¶
目前插件通過 Git 源安裝。本地開發同樣支持。
dsh plugin --profile web add git+https://github.com/lnetrit-alt/dsh-system-control.git
重啓 Harness 或刷新頁面後生效。客戶端部分支持熱重載。
典型用法¶
- 查看餘額：在側邊欄底部查看
餘額 ¥0.69等信息，貨幣符號根據 API 返回的 CNY/USD/EUR/GBP 自動映射。 - 手動刷新：點擊餘額文本，立即獲取最新數值。
- 關閉 Harness：點擊電源圖標，確認後系統將保存會話並退出 Harness 進程。
適用場景與注意¶
該插件屬於 UI 表面層，不註冊模型可見工具，不會改變 Agent 行爲，模型無需感知其存在。
安裝使用時需注意以下事項：
* 依賴服務：需要 DSH 啓動器提供的 appExit 服務。如果是在非官方 dsh 或 dsh web 環境中嵌入運行，關機可能會報錯而無法執行。
* 權限風險：插件以當前 DSH 進程權限運行，請從可信源安裝並檢查源碼。
* 發佈狀態：NPM 發佈待定（需配置賬戶 2FA），目前僅支持 Git 源安裝。
總結¶
dsh-system-control 通過側邊欄嵌入的方式，提供了非侵入式的餘額監控和可靠的關機功能。對於需要頻繁管理賬戶狀態和進程的 DSH 用戶，這是一個提升操作效率的實用工具。
- 項目主頁：https://github.com/lnetrit-alt/dsh-system-control
- 目錄頁：https://www.skillhub.cn/plugins/lnetrit-alt/dsh-system-control
