前言¶
DeepSeek Harness (DSH) 提供了一個本地化的客戶端環境，適合進行 AI 模型的交互與開發。在使用 API 調用過程中，監控賬戶餘額和用量是控制成本的關鍵環節。dsh-balance 插件直接將餘額顯示功能集成到 DSH 的側邊欄底部，讓開發者無需頻繁切換標籤頁即可查看當前的 DeepSeek API 賬戶餘額。
插件定位¶
該插件由開發者 shawnyhu 維護，開源協議爲 MIT。它是一個客戶端插件，核心價值在於將 DeepSeek 平臺的用量信息可視化，集成在本地開發環境的一側，減少操作干擾。
核心功能¶
- 側邊欄展示：在側邊欄底部顯示餘額行。寬欄模式下顯示具體金額（如
¥110.00），收起時僅顯示圖標。 - 交互操作：單擊餘額區域可立即刷新數據；雙擊可跳轉至 DeepSeek 平臺用量頁
https://platform.deepseek.com/usage。 - 自動刷新：在每次會話回合結束後自動刷新一次，並支持每 30 分鐘定時自動刷新。
- 安全機制：API Key 完全保留在本地宿主進程，通過本機路由返回數據，瀏覽器端無法獲取 Key。
- 配置繼承：自動沿用 DSH 設置中「模型 → DeepSeek」的配置項。默認讀取環境變量
DEEPSEEK_API_KEY，API 地址默認爲https://api.deepseek.com。支持通過環境變量DEEPSEEK_BASE_URL覆蓋地址。
安裝與啓用¶
推薦使用官方的 DSH CLI 進行安裝。
dsh plugin --profile web add <path-to-dsh-balance>
安裝完成後，需要重啓 DeepSeek Harness 才能生效（客戶端模塊僅在啓動時掃描包清單）。
典型用法¶
插件默認安裝即可使用，無需額外配置。如果需要自定義 API Key 或地址，請前往「設置 → 模型 → DeepSeek」頁面進行配置。
配置項包括：
* apiKeyEnv：默認值爲 DEEPSEEK_API_KEY，指定讀取的環境變量或憑證引用。
* baseURL：默認值爲 https://api.deepseek.com，指定 API 根地址。
修改設置後，無需重啓應用，下次刷新時即可生效。若未配置 Key，側邊欄將顯示「未配置 Key」。
注意事項¶
- 重啓要求：插件集的增刪操作必須重啓 DeepSeek Harness 才能生效。
- 配置生效：修改「設置」中的配置項不需要重啓，下次刷新界面即可看到變化。
- 許可證：MIT License。
總結¶
dsh-balance 通過將餘額監控嵌入側邊欄，降低了查看 API 用量的門檻，適合需要頻繁調試或關注成本的開發者。插件完全開源且本地運行，保證了 Key 的安全性。更多細節可參考插件目錄或 GitHub 倉庫。
