前言¶
在使用 DeepSeek API 時，頻繁查看賬戶餘額通常需要切換到官方控制台。dsh-ds-balance 將餘額信息直接集成到 DeepSeek Harness (DSH) 的側邊欄中，通過狀態環和彈出窗口提供直觀的查看方式。
插件簡介¶
dsh-ds-balance 是一個 DSH 插件，由 dsh-plugin-lab 維護。它直接從官方 DeepSeek API 端點讀取餘額，並在側邊欄底部展示狀態，同時在插件頁面提供配置卡片。
核心功能¶
- 側邊欄狀態環：在側邊欄底部固定顯示餘額狀態，通過顏色和弧度展示餘額多少及距離警告閾值的距離。
- 餘額彈出窗口：點擊狀態環展開，顯示總額、贈送/充值細分以及數據年齡。
- 配置卡片：在插件頁面提供連接、顯示、閾值和刷新設置。
安裝與啓用¶
- 前置條件：DSH 當前 RC 線（安裝時需指定
@next），Node.js 版本 >= 20。 - 安裝 DSH 主機：
npm install -g @deepseek-ai/dsh@next
- 安裝插件：
dsh plugin --profile web add dsh-ds-balance
- 啓動 DSH：
dsh --profile web
- 從源碼安裝：克隆倉庫後執行
pnpm install && pnpm run build，然後通過上述命令添加插件路徑。
典型用法¶
安裝並啓動 DSH 後，側邊欄底部會出現 DeepSeek 餘額的狀態環。點擊該環可以展開彈出窗口，查看詳細的餘額構成和更新時間。
安全與架構¶
- 憑證管理：插件通過 DSH 的憑證通道解析憑證，自身不存儲密鑰。UI 僅顯示頭尾掩碼（如
sk-cf08d*****3b84），完整密鑰不會在傳輸、日誌或文件中暴露。 - 網絡訪問：僅連接
api.deepseek.com，不代理其他流量。 - 數據存儲：餘額快照按憑證存儲，切換憑證會重置記錄。
配置說明¶
在 DSH 側邊欄點擊“插件”，找到已安裝的“DeepSeek Balance”卡片進入詳情頁。配置區域包含：
* Connection：只讀，顯示當前使用的憑證來源，提供測試按鈕。
* Display：設置貨幣顯示方式。
* Thresholds：設置警告和嚴重閾值（同一貨幣下嚴重值必須低於警告值）。
* Refresh：設置服務端刷新間隔、UI 輪詢間隔和手動刷新冷卻。
升級說明¶
插件版本 3.0 移除了手動設置的 apiKey 和 baseUrl，憑證統一由 DSH 管理。升級後，舊的設置值不會自動遷移，需在配置卡片中重新填寫。
結尾¶
該插件通過官方 API 提供餘額監控，適合需要管理多個 DeepSeek 賬戶或需要實時監控 API 消耗的開發者。相關源碼與更新請訪問 GitHub。
