前言¶
在 DSH「一切皆插件」的機制下，Web GUI 可以掛載不同的擴展能力。dsh-provider-quota 解決的是模型供應商額度分散的問題：它把已配置供應商的餘額查詢集中到 DSH Web GUI 的側邊欄和設置頁，提供即時面板與手動刷新入口。
這是什麼¶
dsh-provider-quota 是一個模型供應商額度查詢插件，維護者爲 781316853，許可證爲 MIT。
它爲 DSH Web GUI 提供即時額度顯示：側邊欄底部入口 + 彈出面板（每 60 秒自動輪詢），以及「設置 → 模型額度」頁的完整查詢區塊。
核心功能¶
側邊欄即時面板¶
側邊欄底部提供「模型額度」入口。
點擊後彈出即時面板，每 60 秒自動輪詢所有已配置供應商的餘額。
設置頁查詢區塊¶
「設置 → 模型額度」展示每個已配置供應商的賬戶餘額。
展示字段包括可用 / 已用 / 總額 / 套餐 / 滾動窗口等，並支持手動刷新。
支持的供應商¶
支持以下提供餘額查詢接口的供應商：
- DeepSeek
- OpenAI
- Moonshot
- 智譜
- OpenRouter
- SiliconFlow
- Z.AI
額度形態¶
插件可展示多形態額度：
- 金額：CNY/USD 等
- 百分比窗口：如 5 小時滾動
- Token 用量：Z.AI
密鑰處理與界面語言¶
API 密鑰僅在宿主側解析，瀏覽器端只渲染路由返回的歸一化結果，密鑰不會發送到瀏覽器。
界面文案跟隨 GUI 語言，支持中英文雙語。
掛載方式¶
插件通過 profile bundle patch + node_modules 鏈接掛載，無需改動 dsh 源碼。
安裝與啓用¶
先執行安裝命令，把插件添加到 web profile：
dsh plugin --profile web add github:781316853/dsh-provider-quota
該插件是 bundle 形態插件。除依賴安裝外，還需把該插件包名加入 profile 的 dsh.profile.bundles 層棧；二者缺一不可。
配置項如下：
dsh.profile.bundles
完成安裝與 bundle 層棧配置後，重啓 web 服務：
dsh web
也可以重啓桌面端，使插件加載。
典型用法¶
1、在「模型」頁配置至少一個支持餘額查詢的供應商及其 API 密鑰。
2、點擊側邊欄底部的「模型額度」圖標，面板自動刷新余額；「全部刷新」可手動立即刷新。
3、在「設置 → 模型額度」查看每個供應商的詳細額度與更新時間。
適用場景與注意¶
- 適合需要集中查看多個模型供應商餘額的 DSH 用戶，尤其是已把供應商密鑰配置到「模型」頁的場景。
- 插件以當前 dsh 進程權限運行。安裝前建議檢查源碼與許可證；該插件許可證爲 MIT。
- 插件聲明 peerDependencies，包括
react與多個@deepseek-ai/dsh-client-*包；宿主環境需要滿足這些依賴。 - API 密鑰不會發送到瀏覽器，但仍應謹慎管理宿主側可訪問的密鑰配置。
相關鏈接¶
- 獨立社區目錄頁面：https://www.skillhub.cn/plugins/781316853/dsh-provider-quota
- GitHub：https://github.com/781316853/dsh-provider-quota
