前言¶
用 DeepSeek Harness（DSH）跑智能體時，API 餘額和本地用量往往要切到瀏覽器或第三方面板查看。DSH 本身支持 Cordis 動態插件，社區目錄 SkillHub 上也有面向聯網場景的擴展。yxxbc/dsh-balance-plugin（分類：聯網工具）把餘額查詢、官方充值入口、用量統計和三方插件清單收進 DSH 界面，維護者爲 yxxbc，當前版本 1.3.0，MIT 許可，GitHub 約 55 stars。
下面介紹插件定位、核心能力、安裝步驟和典型用法。
這是什麼¶
dsh-balance-plugin 是 DSH 的動態 Cordis 插件，在輸入框工具行右側提供三個圖標入口，並在下方常駐餘額條。它自動讀取本機 DSH 憑據 DEEPSEEK_API_KEY，無需在界面裏重複填寫 Key；配置寫入插件目錄 config.json，重啓後恢復。
核心功能¶
餘額監控與告警¶
- 查詢 DeepSeek API 餘額，支持 CNY / USD 雙餘額池，多賬戶可並行查詢。
- CNY / USD 各自設置低餘額閾值（默認 ¥10 / $2），低於閾值時餘額條標紅。
- 提供直達官方充值頁
platform.deepseek.com/top_up的入口，以及用量明細頁鏈接。
用量統計¶
用量頁參考 Miyu WebUI 用量頁 的佈局，包含：
- 統計瓦片、GitHub 貢獻圖風格的用量日曆；
- 三段堆疊趨勢柱狀圖；
- 模型消耗環形圖與明細表；
- 最近 50 條調用記錄。
性能指標覆蓋輪次、步數、LLM 時長、工具調用時長、首 token 平均延遲、tok/s、緩存命中率。
三方插件管理¶
列出非官方（非 @deepseek-ai）Web 插件：包名、本地路徑、Bundle rev、依賴；支持一鍵「打開目錄」定位源碼。
模型工具¶
註冊 query_api_quota 工具。在對話裏直接問「DeepSeek 餘額還剩多少」即可得到餘額摘要。
更新與持久化¶
插件面板內可檢查更新並一鍵更新；也可用安裝腳本帶 UPDATE=1 更新。設置持久化到 config.json。
安裝與啓用¶
前置條件¶
- 已安裝並運行 DeepSeek Harness。
- （可選）DeepSeek API Key。若本機已配置
DEEPSEEK_API_KEY，插件啓動時自動讀取。
一鍵安裝¶
macOS / Linux：
curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.sh | bash
Windows（PowerShell）：
irm https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.ps1 | iex
安裝完成後重啓 DeepSeek Harness。輸入框右側出現三個圖標按鈕即表示生效。可用 DSH_PROFILE=<name> 指定其他 profile。
更新¶
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.sh | UPDATE=1 bash
或在 DSH 面板內點擊「檢查更新」→「更新」。
卸載¶
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/uninstall.sh | bash
注意： README 說明 npm 上存在他人同名包 dsh-balance-plugin@0.1.0，裸包名 dsh plugin add dsh-balance-plugin 可能裝錯。請使用上述一鍵腳本或 github: 源安裝。
典型用法¶
- 看餘額：重啓 DSH 後看輸入框下方常駐餘額條；或點錢包圖標進入餘額監控面板，配置閾值與刷新間隔。
- 查用量：點用量統計圖標，切換時間範圍，查看日曆、趨勢圖和模型消耗明細。
- 對話查餘額：在智能體對話中詢問餘額，由
query_api_quota返回摘要。 - 管理本地三方插件：打開三方插件管理頁，覈對包名與路徑，需要改源碼時用「打開目錄」。
入口固定在輸入框工具行右側。DSH 側邊欄底部插槽可能被官方 Cordis 面板插件佔用，本插件不依賴該插槽。
適用場景與注意¶
適合誰：
- 長期在 DSH 裏跑智能體、需要隨時看 CNY/USD 餘額和本地用量的人；
- 本機裝了多個非官方 DSH Web 插件、需要統一清點路徑與依賴的人。
使用前注意：
- 插件以當前 DSH 進程權限運行，安裝前建議閱讀 源碼 與 MIT 許可證。
- API Key 保存在本機插件目錄
config.json，界面僅顯示掩碼；README 稱源碼與文檔不含密鑰。 - SkillHub 目錄頁與 DeepSeek / 幻方無官方從屬關係，屬於社區插件生態。
鏈接¶
- 目錄頁：https://www.skillhub.cn/plugins/yxxbc/dsh-balance-plugin
- GitHub：https://github.com/yxxbc/dsh-balance-plugin
- 配置與架構文檔見倉庫
docs/configuration.md、docs/architecture.md、docs/faq.md
