DeepSeek Harness (DSH) 的 Web 界面目前沒有原生功能來查看 API 餘額或本次對話的具體消耗。開發者通常需要手動切換到官方平臺或查看日誌。dsh-web-api-balance 插件通過在輸入框旁提供一個常駐膠囊來解決這個問題，懸停展開後可查看賬戶餘額與本次對話的消耗明細。
這是一個由 Charaaah 維護的客戶端插件。它通過在輸入框工具欄常駐顯示餘額膠囊，並支持懸停展開詳情，解決了在開發過程中實時監控 API 使用情況和費用的問題。
核心功能¶
- 常駐餘額膠囊：在輸入框工具欄顯示 DeepSeek API 總餘額。
- 懸停展開詳情：
- 左欄顯示賬戶餘額（總餘額、贈送餘額、更新時間）。
- 右欄顯示本次對話消耗（包含緩存命中、緩存未命中、輸出分檔）。 - 峯谷自動判斷：根據工作日特定時間段（北京時間 9:00-12:00 和 14:00-18:00）自動切換價格檔位。
- 充值入口：膠囊右側滑出可充值區域，優先使用賬號服務的充值地址，否則使用官方平臺地址。
- 多憑證來源：支持從賬號授權、已保存的 API Key 或環境變量獲取餘額。
- 餘額緩存：支持配置緩存窗口（
refreshSeconds），避免頻繁請求接口。 - 技術實現：無構建步驟、無外部依賴。
安裝與配置¶
安裝插件需要使用官方安裝命令，建議釘死版本號。
dsh plugin --profile web add dsh-web-api-balance@1.0.5
安裝後，需要在 Web Profile 的配置文件中啓用並配置參數。配置文件位於 ~/.dsh/profiles/web/cordis.patch.yml：
- id: dsh-web-api-balance
disabled: false
inject: [webServer]
config:
apiKey: '' # 單獨指定 key 時填 sk-...（優先級最高）
apiKeyEnv: DEEPSEEK_API_KEY # 否則用這個憑證引用 / 環境變量名
baseURL: https://api.deepseek.com
refreshSeconds: 300 # 緩存窗口，30-86400 秒
插件會按照“賬號授權” → “config.apiKey” → “憑證服務的 apiKeyEnv” → “同名環境變量”的順序獲取憑證。
卸載與清理¶
卸載插件使用以下命令：
dsh plugin --profile web remove dsh-web-api-balance
此命令僅會卸載包並刪除 package.json 中的依賴項。若要徹底卸載，需要手動編輯 ~/.dsh/profiles/web/package.json 刪除依賴行。此外，卸載不會刪除 ~/.dsh/.credentials.yaml 中的 DEEPSEEK_API_KEY，也不會刪除 localStorage 中的 dsh-web-api-balance:last 緩存數據。
注意事項¶
- 隱私安全：插件不包含任何憑證，不向任何地方回傳數據。API Key 僅在運行時從配置或憑證服務讀取，且不會進入瀏覽器環境（通過 host.js 轉發請求）。
- 價格表：價格表是寫死的，不包含未知模型的價格。
- 累計用量：顯示的是當前會話的累計用量，不含子代理，也不是賬號的歷史賬單。
- 節假日：峯谷判斷基於北京時間，不含法定節假日，法定假日的工作日仍會顯示高峯價檔位。
總結¶
dsh-web-api-balance 爲 DSH Web 界面提供了輕量級的餘額監控能力。通過膠囊展示與懸停詳情，開發者可以直觀地掌握當前 API 餘額及本次對話的 Token 消耗。源碼與文檔位於 GitHub。
