前言¶
在 DeepSeek Harness (DSH) 的開發與調試過程中，實時掌握 API 賬戶餘額有助於控制成本或規劃使用。dsh-balance 插件解決了這一需求，通過在 Web 界面中常駐顯示餘額、提供工具接口以及自動刷新機制，讓餘額查詢變得直觀且高效。
插件介紹¶
dsh-balance 是一個 DeepSeek API 餘額顯示插件，由 Yogioo 維護。它將賬戶剩餘金額常駐顯示在 dsh web 對話輸入框下方，併爲模型提供了 check_balance 工具，同時通過宿主進程處理 API Key，確保安全性。
核心功能¶
- Web 界面常駐顯示
在 dsh web 對話輸入框下方顯示DeepSeek 餘額:¥xx.xx。
懸停該信息可查看贈送與充值明細。 - 模型工具集成
插件註冊了check_balance工具，開發者可直接對 agent 說“查下餘額”來調用該功能。 - 安全與自動刷新
API Key 僅存在於宿主進程，瀏覽器端不接觸密鑰。宿主進程每 60 秒自動刷新余額數據。 - 自動化部署
聲明瞭dsh.bundle，通過一條命令即可完成安裝與掛載，無需手動修改配置文件。
安裝¶
使用官方提供的命令安裝即可。安裝器會自動將插件加入 profile 層並掛載 patch。
dsh plugin --profile web add git+https://github.com/Yogioo/dsh-balance.git
安裝後重啓 dsh web，刷新頁面即可看到餘額讀數。
典型用法¶
- 查看餘額：在對話界面輸入框下方查看實時餘額。懸停可查看贈送和充值的具體構成。
- 指令查詢：直接與 agent 交互，發送“查下餘額”或類似指令，觸發
check_balance工具。 - 錯誤處理：若查詢失敗，界面會顯示錯誤原因，並在 60 秒後自動重試。
技術細節與注意事項¶
- 環境要求：需要 dsh web 部署環境，且宿主 Node.js 版本需 ≥ 18。
- 密鑰配置：需配置
DEEPSEEK_API_KEY環境變量，且credentials服務能正確解析該變量。 - 刷新機制：宿主每 60 秒通過官方接口查詢餘額，客戶端同步拉取宿主緩存。
- 代碼修改：修改宿主邏輯（如
lib/index.js）通常直接生效；修改客戶端邏輯（如lib/client.js）需要重啓dsh web。 - 衝突處理：關於行 id 衝突，bundle 的 patch 與用戶 patch 按“同一行 id 後者覆蓋”的規則合併，允許用戶覆蓋默認配置。
總結¶
dsh-balance 插件通過在 UI 和工具層面的雙重支持，解決了 DSH 開發者頻繁查看餘額的痛點。它不僅提供了可視化的餘額讀數，還通過常駐刷新和錯誤重試機制，確保了信息的及時性與穩定性。
