前言¶
DeepSeek Harness (dsh) 是智能體開發環境，使用 DeepSeek 模型時，隨時查看賬戶餘額是基礎需求。balance-dock 是一個專爲 dsh 設計的常駐 Web 插件，由開發者 Cao-zhi-hao 維護。它解決了動態插件刷新即失效的問題，通過常駐機制在會話輸入框下方提供實時的餘額狀態顯示。
核心功能¶
- 常駐持久：刷新頁面或重啓進程後依然存在，無需手動激活。
- 安全取數：API 密鑰僅存在於 Host 端，瀏覽器只通過同源接口
/ds-balance獲取數據。 - 自動刷新：默認每 60 秒刷新一次，支持手動刷新。
- 主題適配：自動適配 dsh 的明暗主題。
- 多幣種：支持 CNY、USD、EUR 符號顯示。
安裝與啓用¶
前置要求¶
- 已安裝並運行 DeepSeek Harness (dsh)。
- 已配置
DEEPSEEK_API_KEY（通常位於$DSH_HOME/.credentials.yaml）。
安裝¶
推薦使用 dsh 內置命令安裝，它會自動處理插件註冊：
dsh plugin --profile web add balance-dock
驗證¶
重啓 dsh 進程後，訪問 http://127.0.0.1:<port>/ds-balance 接口，應返回包含餘額信息的 JSON。在任意會話頁面，輸入框下方應顯示餘額狀態條。
注意事項¶
- 該插件依賴 Host 端的
DEEPSEEK_API_KEY。 - 若採用手動安裝方式，必須在
profiles/web/cordis.patch.yml中添加插件行，並重啓 dsh 進程。 - 僅支持 CNY、USD、EUR 符號顯示。
結語¶
balance-dock 通過常駐插件機制，讓餘額查看變得無縫且安全。
