前言¶
在 DSH 的插件化場景裏，餘額和用量展示是一個比較具體的問題：官方接口可以查餘額，Harness 會話日誌裏可以看到調用，但側邊欄缺少一個能同時看當前餘額、刷新狀態和用量趨勢的入口。dsh-quota-badge 是一個 DSH 插件，用於在 DeepSeek Harness 側邊欄即時顯示 DeepSeek 賬戶餘額，並在設置頁提供餘額監控和用量統計。下面介紹它的能力、安裝方式和日常使用注意點。
這是什麼¶
dsh-quota-badge 是一個 DSH 插件，GitHub 倉庫爲 yoiizesdev-crypto/DSH-Balance-display，許可證爲 MIT。
它從 DeepSeek 官方餘額 API 獲取數據：
GET https://api.deepseek.com/user/balance
在 DeepSeek Harness 側邊欄顯示餘額徽章，並在 設置 → 餘額監控 頁面展示幣種明細、餘額趨勢和用量統計。
核心功能¶
側邊欄餘額徽章¶
在 DeepSeek Harness 側邊欄底部即時顯示 DeepSeek 賬戶餘額，支持賬戶內全部幣種：
CNY / USD / 其他
刷新方式包括自動刷新和手動刷新。餘額變化時，數字會播放滾輪動畫；手動刷新時，上升顯示綠色，下降顯示紅色。
設置頁：餘額監控¶
在 設置 → 餘額監控 頁面可以看到：
- 餘額卡片
- 幣種明細
- 餘額趨勢 Sparkline
頁面上還可以調整餘額顯示和刷新相關參數。參數、歷史與用量數據保存在：
~/.dsh/.quota-badge.json
用量統計¶
用量統計提供以下能力：
- 歷史回填
- 分 Key 統計
- 彙總卡片
- 每日消費折線
- 模型明細表
用量統計基於 Harness 會話日誌和 DeepSeek 官方峯谷定價本地估算，不是官方賬單接口返回的計費結果。
峯谷定價座標系¶
懸停餘額徽章 3 秒，會展示 DeepSeek 峯谷定價座標系。座標系用於查看當前時段對應的峯谷價格。
其中，週末（週六/週日）全天低谷價，2026-08-23 起生效。
安裝與啓用¶
要求：
- DeepSeek Harness 桌面版或 Web 版
- Node.js >= 18
安裝步驟如下：
- 進入 Harness profile 目錄：
cd ~/.dsh/profiles/desktop
- 安裝插件包：
npm install <git倉庫地址>
- 編輯
~/.dsh/profiles/desktop/package.json，把dsh.profile.bundles數組加上dsh-quota-badge：
{
"dsh": {
"profile": {
"bundles": [
"dsh-quota-badge"
]
}
}
}
- 確保
~/.dsh/.credentials.yaml裏有 DeepSeek API Key：
DEEPSEEK_API_KEY: sk-xxxxxxxxxxxxxxxx
-
完全退出並重新打開 DeepSeek Harness。
-
在
設置 → 餘額監控頁面查看趨勢、調整參數。
典型用法¶
- 查看當前餘額：看側邊欄底部的餘額徽章。
- 手動刷新：點擊徽章上的手動刷新入口，觸發餘額查詢和數字滾輪動畫。
- 查看多幣種餘額：在
設置 → 餘額監控頁面查看賬戶內全部幣種明細。 - 查看餘額趨勢：在餘額趨勢 Sparkline 中查看採樣數據。
- 查看用量統計：在用量統計區域查看歷史回填、分 Key 統計、彙總卡片、每日消費折線和模型明細表。
- 自動檢查更新：默認開啓，啓動後及每 6 小時自動檢查 GitHub 新版本。
適用場景與注意¶
適合以下場景：
- 在 DeepSeek Harness 中頻繁發起任務，需要隨時查看賬戶餘額。
- 需要查看 CNY、USD 和其他幣種的餘額明細。
- 需要按 Key、按天、按模型查看本地用量統計。
- 需要對照峯谷定價查看當前時段價格。
使用前注意：
- 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與
MIT許可證。 - 用量統計是基於 Harness 會話日誌和 DeepSeek 官方峯谷定價的本地估算。
- 插件運行期間會隱藏默認
cordis插件管理按鈕，卸載後恢復。 - 餘額接口依賴
DEEPSEEK_API_KEY，需要確認配置文件已正確寫入。 - 週末（週六/週日）全天低谷價，2026-08-23 起生效。
結尾¶
dsh-quota-badge 解決的是一個具體問題：把 DeepSeek 賬戶餘額、幣種明細、餘額趨勢和用量統計放進 DeepSeek Harness 的側邊欄與設置頁。安裝前檢查源碼和許可證，按 profile 配置啓用，再根據實際使用調整刷新與展示參數。
GitHub 倉庫：
https://github.com/yoiizesdev-crypto/DSH-Balance-display
