在 DeepSeek Harness (DSH) 的開發流程中，實時掌握賬戶餘額有助於控制成本和資源規劃。若通過手動查詢或切換窗口的方式查看，效率較低。下面介紹由 MatsMQ 維護的 dsh-deepseek-balance 插件，它將餘額查詢功能集成到 DSH Web 界面中，提供直觀的監控體驗。
功能定位¶
這是一個爲 DSH Web GUI 設計的餘額小部件。它通過 host 側的安全通道獲取 API Key 並向官方接口請求餘額數據，瀏覽器端僅接收結果，確保 Key 永遠不離開主機進程。核心功能包括：
- 雙處顯示：在會話標題欄右側顯示餘額徽章，在 設置 → 插件 → 賬戶餘額 顯示詳細數據。
- 自動刷新：每 30 秒自動輪詢一次，數據在各視圖間同步。
- 安全處理：Host 端處理認證，瀏覽器側通過同源圍欄校驗保護數據。
安裝與啓用¶
安裝前請確認 host 側已啓用 webServer 和 credentials 服務（web profile 自帶），且瀏覽器側已加載 React。使用以下命令從 GitHub 安裝：
dsh plugin --profile web add https://github.com/MatsMQ/dsh-deepseek-balance
使用步驟¶
安裝完成後，需確保憑據配置正確並重啓服務：
- 在 host 端配置環境變量
DEEPSEEK_API_KEY（或寫入$DSH_HOME/.credentials.yaml），確保與模型設置中使用的 Key 一致。 - 重啓 DSH Web 服務，插件會在啓動時自動裝載。
- 進入任意會話，在標題欄右側即可看到餘額徽章。
- 在 設置 → 插件 → 賬戶餘額 中可查看總餘額、贈送餘額、充值餘額及可用狀態。
配置項¶
插件通過 cordis.patch.yml 進行配置，默認值如下：
| 字段 | 默認值 | 說明 |
|---|---|---|
credentialRef |
DEEPSEEK_API_KEY |
使用的憑據引用名 |
upstreamUrl |
https://api.deepseek.com/user/balance |
餘額查詢端點 |
timeoutMs |
10000 |
上游請求超時（毫秒） |
安全邊界與注意事項¶
- 密鑰隔離：API Key 僅在 host 進程內使用，通過 DSH 的憑據通道傳遞，瀏覽器端無法接觸。
- 網絡監聽：默認 Web 部署僅監聽
127.0.0.1。若綁定0.0.0.0，餘額信息會暴露到局域網（但 Key 依然安全）。 - 文件保護：插件不會修改任何配置文件或憑據文件。
- 路由安全：API 請求路由爲
GET /dsh-balance，瀏覽器請求受同源圍欄（Sec-Fetch-Site）保護。
該插件適合需要在 DSH Web 界面中持續監控 DeepSeek 餘額的開發者。使用前請確認源碼與許可證，並確保 host 服務依賴已滿足。
