dsh-quota-hub
English · 中文
Unified real-time quota dashboard for DeepSeek Harness.
One collapsible glass panel shows every provider quota/balance you care about —
OpenCodeGo rolling/weekly/monthly windows, DeepSeek official balance,
OpenRouter credits, SiliconFlow and Moonshot balances — refreshed on a timer,
with a live health dot on the sidebar button. API keys stay on the host:
the browser only ever receives parsed numbers.
Features
- Auto-detect — built-in adapters appear as soon as the matching
credential exists (
OPENCODE_GO_API_KEY, DEEPSEEK_API_KEY,
OPENROUTER_API_KEY, SILICONFLOW_API_KEY, MOONSHOT_API_KEY in DSH
credentials / env). Unconfigured providers show collapsed as “未配置”.
- Collapsible & compact — every provider card collapses to one line;
“全部收起/展开” in one click; auto-refresh with per-card updated time.
- Health colors — sidebar dot and progress bars turn green (>50% left),
yellow (20–50%), red (<20%).
- Custom providers — any HTTP endpoint with JSON quota fields can be
added in
~/.dsh/dsh-quota-hub.json (dot-path field extraction).
- Host-side only — all fetching happens in a host service; keys never
cross the browser boundary.
Install
dsh plugin --profile web add dsh-quota-hub
Restart DSH afterwards. The 💰 额度 button appears in the sidebar footer.
Custom providers
~/.dsh/dsh-quota-hub.json:
{
"refreshMs": 120000,
"providers": [
{
"id": "my-relay",
"label": "My Relay",
"url": "https://relay.example.com/v1/usage",
"credential": "MY_RELAY_API_KEY",
"fields": [
{ "key": "used", "label": "已用", "path": "usage.used", "unit": "USD" },
{ "key": "percent", "label": "用量", "path": "usage.percent", "percent": true }
]
}
]
}
credential names a DSH credential/env var (Bearer auth). Or drop
credential and put a static headers object on the entry instead — note
that stores the token in the config file in plain text.
How it works
Host: a top-level quotaHub Remote service resolves each adapter's
credential via ctx.credentials, fetches the provider endpoint (10 s timeout,
refreshMs cache, shared in-flight requests), and returns normalized
snapshots. Client: the panel double-unwraps the transport envelope exactly
like the core messageFeedback remote and renders provider cards.
License
MIT
Acknowledgements
Built for the DeepSeek Harness plugin ecosystem — thanks to the community on
LINUX DO for feedback and testing.
