dsh-quota-hub

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.