前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在開發或使用 DSH 的過程中，實時掌握 API 餘額是一個基礎需求。市面上常見的做法是依賴本地估算，這種方式容易受價格表變動影響，且往往不夠精確。dsh-balance 插件直接調用 DeepSeek 官方的 GET /user/balance 端點，以賬戶幣種顯示真實餘額，並在側邊欄提供即時反饋。
核心功能¶
該插件主要提供以下能力：
- 官方數據覈實：直接調用官方 API 端點，覈實 API key 後返回真實餘額。
- 即時推送：使用 SSE 長連接推送數據，1 秒內上屏；另有 15 秒輪詢作爲兜底機制。
- 低餘額告警：餘額低於閾值時，數字變橙色。
- 中英雙語：文案跟隨界面語言自動切換。
- 零依賴：無 npm 運行時依賴。
安裝¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add @pengpeng6845/dsh-balance
配置與使用¶
安裝後，需要在 profile 的 cordis.patch.yml 文件中按 id 覆蓋配置。同時，確保環境變量 DEEPSEEK_API_KEY 已正確設置。
在 cordis.patch.yml 中添加以下配置：
- id: balance
config:
balanceEnabled: true # 是否輪詢官方餘額端點
balanceApiKeyEnv: DEEPSEEK_API_KEY # 餘額 API key 的憑據引用（環境變量名）
balanceBaseUrl: https://api.deepseek.com
balanceRefreshMs: 60000 # 兜底輪詢間隔（毫秒）
lowBalanceAlert: 5 # 低餘額警戒線（賬戶幣種單位）
顯示與狀態¶
- 界面：顯示在側邊欄底部，一行扁平原生風格（無卡片、無邊框）。
- 狀態：網絡失敗後退避期，數據灰化顯示，但仍保留上次成功值。標籤頁不可見時自動暫停輪詢。
注意事項¶
- 餘額以賬戶幣種顯示，不做任何匯率換算。
- 不做成本估算，只顯示真實數據。
- 該插件以 dsh 進程權限運行，安裝前應檢查源碼與許可證。
總結¶
dsh-balance 是一個輕量級工具，適合需要精確監控 API 餘額的用戶。其零依賴和官方數據源保證了數據可靠性。
- 維護者：PengPeng6845
- 許可證：MIT
- 目錄頁：https://www.skillhub.cn/plugins/PengPeng6845/dsh-balance
- 源碼：https://github.com/PengPeng6845/dsh-balance
