DeepSeek Harness (DSH) 的 Web profile 提供了模塊化擴展能力。在使用過程中，開發者需要頻繁確認 DeepSeek 官方賬戶餘額與 OpenCode Go 套餐的剩餘情況。dsh-sidebar-balance 插件將這兩個核心數據直接嵌入側邊欄底部，與「設置」同排，不改變原有佈局，只做極簡的數字展示。
安裝¶
在終端中執行以下命令安裝插件。該插件支持通過 GitHub、本地路徑或 npm 安裝，無需額外構建授權。
dsh plugin --profile web add github:zhouchengke2046/dsh-sidebar-balance
安裝後，請確保已安裝並啓動支持 Web profile 的 DSH 客戶端。
核心功能¶
該插件主要包含以下能力：
- 極簡單行展示：以純文字形式融入側邊欄底部，與設置按鈕同排，不新增入口，不改變頁面佈局。
- 雙餘額集成：常駐顯示 DeepSeek 官方餘額，右側附帶 OpenCode Go 套餐消耗進度圓環。
- 原生適配：完全消費 DSH 設計令牌，自動適配深淺色主題。
- 安全設計：API Key 僅在宿主進程內解析，瀏覽器端僅接收數字結果，避免 Key 泄露。
- 自動刷新：餘額與圓環每 60 秒自動刷新，點擊金額可立即刷新，失敗時保留舊值並降級。
使用方法¶
- 常駐行交互：側邊欄底部的常駐行中，左側爲設置按鈕（點擊打開設置面板），右側爲餘額金額與 Go 消耗圓環。點擊金額僅刷新數據，不會誤觸設置面板。
- 懸浮卡片：鼠標移動到金額上，會彈出磨砂玻璃效果的懸浮卡片，顯示 DeepSeek 餘額明細（總金額、充值、贈送）以及 OpenCode Go 三窗口（滾動 5h、周、月）的餘量與進度。
- 摺疊適配：當側邊欄摺疊時，常駐行僅保留設置圖標，懸浮卡片功能依然可用。
配置與依賴¶
使用該插件需要滿足以下環境要求：
- DeepSeek Harness 版本 0.1.0-rc.6+ (Web profile)
- Node.js ≥ 18
插件依賴宿主環境中的兩個環境變量來獲取數據：
DEEPSEEK_API_KEY：用於查詢 DeepSeek 官方賬戶餘額。OPENCODE_GO_API_KEY：用於查詢 OpenCode Go 套餐使用情況。
原理與說明¶
- 零構建：插件爲純 JavaScript 手寫 bundle，無需 Node.js 構建步驟。
- 重啓功能：側邊欄中的刷新按鈕僅刷新余額數據，不包含重啓功能。重啓功能由獨立的
dsh-restart插件負責。 - 加載機制：瀏覽器端通過 Host 路由自託管，配合
tapIndex注入方式加載，非client-modules掃描路徑，確保在任意安裝位置均可正常工作。
信息來源¶
- 插件目錄：https://www.skillhub.cn/plugins/zhouchengke2046/dsh-sidebar-balance
- 源碼倉庫：https://github.com/zhouchengke2046/dsh-sidebar-balance
