前言¶
DeepSeek Harness (DSH) 的狀態欄中存在兩個獨立的錢包來源：一個是登錄賬號的 Platform 錢包（包含充值與贈送餘額），另一個是 API Key 對應的官方餘額。目前的社區插件大多隻覆蓋了 API Key 餘額，無法查看登錄賬號內的實際可用資金。
dsh-dual-balance 插件將這兩個來源統一展示在狀態欄中。它利用 DSH 內置的 deepseekAccount 服務讀取賬號餘額，同時調用官方 /user/balance 接口讀取 Key 餘額。對於同一筆錢，它會自動合併顯示；對於不同賬號，則並排展示。
核心功能¶
- 雙餘額顯示：同時顯示登錄賬號的 Platform 錢包餘額與 API Key 餘額。
- 智能摺疊：當兩個來源屬於同一賬號時，自動摺疊爲一段顯示。
- 詳情面板：點擊藥丸狀圖標可展開詳情，包含充值/贈送明細。
- 零配置：無需額外配置，安裝後即用。
- 安全可靠：密鑰僅在 Host 進程內使用，瀏覽器只通過只讀路由讀取數字。
- 失敗處理：讀取失敗時保留上次成功值並標記
⚠，絕不顯示爲 0。 - 視覺對齊：複用官方 CSS 原語，與狀態欄其他藥丸像素級對齊。
安裝與啓用¶
本插件要求 DSH 版本 0.1.5-rc.1 或更高，以及 Node.js >= 20。包內自帶預構建的 lib/，無需額外構建步驟。
從倉庫安裝（推薦）：
dsh plugin --profile web add github:fangweixuan26-hash/dsh-dual-balance
從本地目錄安裝（用於開發調試）：
dsh plugin --profile desktop add /path/to/dsh-dual-balance
安裝後，Web 端與 Desktop 端界面會自動刷新。若未變化，請手動刷新頁面。
卸載：
dsh plugin --profile web remove dsh-dual-balance
使用說明¶
安裝完成後，狀態欄會出現一枚新的藥丸。藥丸會根據當前狀態顯示不同內容：
- 同一賬號：顯示爲
餘額 ¥9.49。 - 不同賬號：顯示爲
賬號 ¥13.78 | API ¥2.00。 - 賬號未登錄：顯示
賬號 未登錄。 - API Key 未配置：顯示
API 未配置。 - 讀取失敗：保留上次成功值並標記
⚠。 - 不可達：顯示
餘額不可用。
刷新邏輯：
- 空閒 60 秒自動刷新一次。
- 點擊藥丸打開面板時強制刷新一次。
技術細節¶
- 口徑：優先顯示 CNY，若無 CNY 則顯示絕對值最大的幣種。
- 摺疊判定：當兩個來源均就緒、幣種相同且賬號側總額與 API 側總額差值 ≤ 0.01 時，視爲同一筆錢進行摺疊。
- 依賴：零 npm 運行時依賴。
- 安全：賬號憑證與 API Key 僅在 Host 進程內使用，瀏覽器通過本地只讀路由獲取數據。
總結¶
dsh-dual-balance 解決了 DSH 用戶無法在狀態欄直接查看登錄賬號 Platform 錢包餘額的問題。它通過複用官方原語，提供了安全、穩定且視覺一致的餘額查看體驗。
