前言¶
DSH 中如果配置了多個模型 Provider，餘額、密鑰狀態和模型範圍需要分別查看。下面介紹一個 DSH 插件：dsh-balance-panel。它在 Web UI 側邊欄底部提供餘額入口，打開後可查看當前 DSH 配置中 Provider 的模型、密鑰狀態與餘額明細。
這是什麼¶
dsh-balance-panel 是 wycto 維護的 DeepSeek Harness（DSH）插件，npm 包名爲 @wycto/dsh-balance-panel。它用於集中展示當前 DSH 實際配置過的 Provider，以及這些 Provider 下的實際配置模型。許可證爲 MIT。舊無前綴名 dsh-balance-panel 已廢棄，安裝時使用帶 @wycto/ 前綴的包名。
核心功能¶
- 只展示實際配置過的 Provider 與實際配置的模型。休眠聲明與 schema 默認全量模型列表不會出現在面板裏。
- 內置 DeepSeek 官方
/user/balance接口。 - 支持爲其他 Provider 自定義餘額接口。
- 按 Provider 顯示
apiKeyEnv憑證是否已配置，密鑰本身不進入前端。 - 在側邊欄底部顯示餘額摘要膠囊，每 5 分鐘自動刷新。
- 點擊膠囊打開全屏餘額面板，逐 Provider 展示模型 chips、餘額明細與狀態徽標。
- 無密鑰、接口不支持或查詢失敗時給出明確文案，不影響其他 Provider。
安裝與啓用¶
profile 用戶安裝：
dsh plugin --profile web add @wycto/dsh-balance-panel
安裝後重啓 Web UI，或刷新：
http://127.0.0.1:3080
源碼運行：
pnpm dsh web --patch ./dsh-balance-panel/cordis.patch.yml
典型用法¶
- 啓動 DSH Web UI。
- 在側邊欄底部查看餘額膠囊。
- 點擊膠囊打開餘額面板。
- 面板右上角可手動刷新。
對於 DeepSeek，插件會查詢官方 /user/balance 接口。對於其他 Provider，如果無標準餘額接口，面板會顯示不支持；也可以在 settings 的 Provider profile 中添加 balance 字段，包含 endpoint 與 auth：
balance
endpoint
auth
這些字段用於描述 Provider 的自定義餘額接口。
安全與運行邊界¶
密鑰只通過 credentials.resolve 在 Host 進程內解析使用。餘額請求由 Host 發出，瀏覽器端只拿到餘額結果，密鑰不進入前端或日誌。
相關路由與接口：
/dsh-balance-panel
/user/balance
/dsh-balance-panel 路由只在迴環 webServer 上註冊，因此需要通過 localhost 迴環訪問 DSH Web UI。
適用場景與注意¶
適合在 DSH 中配置多個 Provider，並需要確認餘額、密鑰狀態和模型範圍的用戶。
注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與 MIT 許可證。 - 安裝時使用 npm 包名
@wycto/dsh-balance-panel。 - 倉庫路徑在資料中存在不一致：插件線索與 README 來源指向
https://github.com/wycto/dsh-balance-panel，而package.json中的 repository 爲https://github.com/wycto/dsh-model-balance.git。以 npm 包名作爲安裝依據更穩妥。
結尾¶
dsh-balance-panel 將 Provider 餘額、密鑰狀態和模型配置集中到 DSH Web UI 的側邊欄。
社區目錄頁：
https://www.skillhub.cn/plugins/wycto/dsh-balance-panel
GitHub 鏈接：
https://github.com/wycto/dsh-balance-panel
