前言¶
DSH 的理念是「一切皆插件」，web 表面可以圍繞現有宿主能力做擴展。使用 DSH 的開發者經常會同時配置多個 AI provider，需要頻繁查看某個 key 還剩多少餘額或額度；coding plan 還可能涉及 5 小時窗口、weekly pool 和 MCP monthly lane。
dsh-quota-panel 解決的是這個具體場景：在 dsh web 的產品 UI 右下角提供一個狀態組件，把已配置 provider 的餘額/額度集中顯示出來。
這是什麼¶
wenzetan/dsh-quota-panel 是一個面向 DeepSeek Harness（DSH）web surface 的 provider quota / balance widget。
它位於產品 UI 右下角，支持收起的 capsule 視圖、展開的 card 視圖和 settings panel。作者爲 wenzetan，許可證爲 MIT，版本號爲 0.9.1-rc.1。
它自 v0.5 起是 dual-face 插件：宿主側負責處理 provider 請求與憑證，瀏覽器側通過 loopback-only RPC 通道渲染狀態；組件運行在 shell.overlay 槽位，也就是右下角。
核心功能¶
自動發現 provider¶
該插件內置 provider catalog，包含 15 個 built-in providers。當某個 provider 的 key 在以下位置可解析時，對應行會自動出現：
$DSH_HOME/.credentials.yaml
.env
environment variables
也就是說，安裝並重啓 dsh web 後，已配置 key 的 provider 可以零配置出現在面板中。
移除 key 後，對應行會消失。
支持的 provider 類型¶
已覈實的支持範圍包括：
- DeepSeek
- OpenRouter
- SiliconFlow
- Moonshot
- StepFun
- xAI
- Zhipu GLM
- OpenCode Go
- ChatGPT subscription，Plus / Pro 通過 Codex login
- Volcengine Ark
- one-api / new-api style aggregators
- coding plans，包括 5-hour window、weekly pool 和 MCP monthly lane
狀態顯示¶
組件提供兩種形態：
- 收起狀態：minimal capsule，用獨立的狀態點和數值表示賬戶狀態。
- 展開狀態：完整 card，每個 provider 一行，包含狀態點、名稱、主數值、輔助信息，以及 usage 類 provider 的進度信息。
對 balance 行和 usage 行會做 per-account status grading。也就是說，不同賬戶或不同額度行可以分別顯示狀態，而不是整張卡片統一變色。
自動刷新¶
默認刷新間隔爲 60 秒。
頁面隱藏時會暫停刷新；刷新請求進行中時，重複點擊不會觸發併發請求。
設置面板¶
settings panel 支持以下本地設置：
- per-provider visibility
- refresh interval
- per-provider warn thresholds
- per-provider HTTP(S) proxy URL
- capsule display mode
- restore defaults
這些設置會立即生效，並持久化到瀏覽器 localStorage；已覈實說明指出，它們不會被寫入 profile，也不會上傳。
代理支持¶
組件支持 per-row HTTP(S) proxy。對於無法從當前網絡直連的 provider，可以爲對應行配置代理地址。
已覈實限制是：只接受 HTTP/HTTPS proxy，socks5 proxy 會被拒絕。
主題¶
組件主題由 Harness design tokens 驅動，跟隨產品主題。它不單獨攜帶一套固定配色。
安全邊界¶
API keys 不會到達瀏覽器。瀏覽器側只通過 loopback-only RPC 通道與宿主側通信，接收的是 normalized views。
另外，該插件沒有 npm dependencies，並且不需要 allowBuilds authorization。
安裝與啓用¶
已覈實材料中沒有給出官方安裝命令，因此這裏不補寫安裝命令。
可覈實的包信息如下：
name: dsh-quota-panel
version: 0.9.1-rc.1
license: MIT
peerDependencies:
@deepseek-ai/cordis: ^4.0.1
react: *
文檔中給出的啓用流程是：
- 安裝該插件。
- 重啓
dsh web。 - 當 provider 的 key 在
$DSH_HOME/.credentials.yaml、.env或 environment variables 中可解析時，對應行自動出現。
典型用法¶
- 安裝後重啓
dsh web。已配置 key 的 provider 會自動出現在面板中，無需逐項手動添加。 - 刪除某個 provider 的 key 後，對應行會消失。
- 在 settings panel 中調整 per-provider visibility、refresh interval、warn thresholds、capsule display mode 等本地設置。這些設置立即生效，並保存在瀏覽器
localStorage。 - 如果某個 provider 無法從當前網絡直連，可以爲其配置 HTTP(S) proxy URL。
- 如果缺少某個 provider，可以按 README 的建議提交 issue，提供 provider id 和 balance API URL。
適用場景與注意¶
適合：
- 使用 DSH web surface 的開發者。
- 已經配置一個或多個 provider API key，並需要頻繁查看餘額、額度、coding plan 窗口的用戶。
- 需要在右下角快速查看 provider 狀態，並希望減少手動打開 provider 控制檯的場景。
不適合：
- 只暴露 usage/cost 查詢、不暴露 remaining balance endpoint 的 provider。已覈實說明中提到，OpenAI、Anthropic、Together、Groq、Mistral、Cohere、DashScope、Baichuan 目前尚未支持。
- 只能依賴 cookie 或 CLI 訪問 quota 頁面的 coding plan。已覈實說明中提到，Qwen Token Plan、Xiaomi MiMo Token Plan 和 Qoder 目前不支持。
- 需要從 profile 插入 custom adapter 的場景。已覈實說明指出，custom adapters cannot be plugged in from the profile。
- 需要把組件放到 sidebar、header 或 status bar 的場景。該組件限制在
shell.overlay槽位，即右下角。 - 需要 socks5 proxy 的場景。該組件只接受 HTTP/HTTPS proxy。
注意：
- 插件以當前 dsh 進程權限運行。安裝前建議檢查源碼、許可證和 peerDependencies。
- 已覈實許可證爲 MIT。
- API keys 不會到達瀏覽器，瀏覽器只接收 normalized views。
- 本地設置保存在瀏覽器
localStorage，不會寫入 profile 或上傳。
結尾¶
dsh-quota-panel 是一個面向 DSH web surface 的輕量 provider quota / balance widget。它通過 built-in catalog 和 auto discovery 降低配置成本，用 capsule、card 和 settings panel 提供日常查看與調整入口，同時保持 API keys 不進入瀏覽器。
相關鏈接：
- 目錄頁：
https://www.skillhub.cn/plugins/wenzetan/dsh-quota-panel - GitHub：
https://github.com/wenzetan/dsh-quota-panel
