DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在使用 DeepSeek API 進行開發或調試時，實時掌握賬戶餘額和當前會話的 Token 消耗有助於成本控制。balance-dsh 是一個 DSH 插件，它能在 Web UI 中直接顯示 DeepSeek 賬戶餘額和當前會話的 Token/金額消耗。
基本信息¶
- 名稱：balance-dsh
- 類型：聯網工具
- 維護者：Rannist
- 許可證：MIT
- GitHub：github.com/Rannist/balance-dsh
核心功能¶
- 側邊欄餘額行：側邊欄展開時顯示在底部，包含錢包圖標、餘額金額、時段標籤（高峯紅 / 空閒綠）。金額顏色會根據餘額狀態變化：充足爲綠色，偏低（<10）爲琥珀黃，爲 0 顯示紅色“去充值”。
- 收起態顯示：側邊欄收起時，餘額以左下角懸浮膠囊（FAB）形式顯示。
- 自動刷新：每 60 秒自動刷新一次；對話完成後也會立即刷新；右鍵點擊餘額區域可手動刷新。
- 統計彈窗：單擊餘額會打開統計彈窗，展示賬戶餘額、近 90 天計費 Token、估算費用、活躍天數、熱力圖（按日聚合）以及按模型與高峯/空閒拆分的數據。
- 峯谷計費邏輯：工作日 09:00-12:00 和 14:00-18:00 爲高峯時段（價格翻倍）；週末及中國法定節假日全天按空閒計費（調休上班的週末按工作日計峯谷）。
- 會話消耗行：對話框下方實時顯示當前會話消耗（新增 tokens + 估算金額），懸停可查看詳細計費口徑。
- 官方用量入口：雙擊餘額或使用統計面板中的“查看官方用量”，會在 DSH 內嵌瀏覽器中打開 DeepSeek 官方用量頁。
- 命令查詢：在對話框輸入
/balance可查詢餘額明細和當前會話消耗。
安裝與啓用¶
- 確保已安裝 DSH Desktop。
- 執行安裝命令：
dsh plugin --profile desktop add github:Rannist/balance-dsh
- 重啓 DSH Desktop。服務端界面改動需重啓後生效。
- 插件價格自 2026-09-10 起生效。
典型用法¶
- 查看官方用量：雙擊側邊欄的餘額行，應用會在內嵌瀏覽器中打開 DeepSeek 官方用量頁。
- 手動刷新：右鍵點擊餘額區域，可立即更新余額數據。
- 命令查詢：輸入
/balance查看餘額明細和當前會話消耗。
注意事項¶
- 餘額來源：插件優先讀取 DSH 官方賬號餘額（登錄官方版即可），未登錄時回退到 API Key。
- 數據隱私：插件不收集、不上傳任何會話內容；消費統計完全基於本地會話事件。
- 價格生效時間：消費統計的價格基準自 2026-09-10 起生效。
