DSH Usage Monitor: auto-query provider credit balances and time-window limits from configured API keys, with input capsule and custom provider support.
Install
# from npm (prebuilt)
dsh plugin --profile web add @lcthe/dsh-usage-monitor
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:lcthe/dsh-usage-monitor
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
DSH Usage Monitor — View API credit balance and usage status across all configured LLM providers.
🎯 Overview
A DSH plugin that adds a Usage page to the settings UI. It automatically reads your configured API keys from the DSH credential system and queries each provider's balance API, displaying the results in a clean card-based layout.
✨ Features
- Auto-detect configured providers — reads API keys from DSH credentials, no manual input needed
- Card-based UI — DSH unified card style, responsive grid layout
- Multiple display modes — currency (¥/$), token count, time-window progress bars
- Custom providers — add and remove display-only provider cards; Base URL is required and the console URL is optional
- Built-in query overrides — edit query URL, method, authentication, and response field paths for third-party balance endpoints
- Input capsule — balance in composer toolbar, refreshes on provider switch, message send, or click
- Console links — one-click access to provider dashboards
- Filtering — filter by All / Configured / Balance Supported
- i18n — Chinese and English
Screenshots
1. Balance capsule in the composer
2. Usage overview
3. Query configuration editor
4. Custom provider form
📐 Requirements
Requires a DSH deployment with a browser client, including the Desktop or Web version with Web UI.
📦 Installation
pnpm add @lcthe/dsh-usage-monitor
Add the plugin to your cordis.yml at the same include level as other bundles:
- insert:
- id: dsh-usage-monitor
name: '@lcthe/dsh-usage-monitor'
Start the DSH Web client:
pnpm dsh web
After DSH starts, open Settings → Usage to view your provider balances.
🔑 Provider Support
已稳定测试： DeepSeek、OpenCode Go。其他供应商的余额查询接口未经完整测试，欢迎反馈。
余额查询支持
| 供应商 | 余额接口 | 计费模式 | 显示方式 | 控制台 | 状态 |
|---|---|---|---|---|---|
| DeepSeek | GET /user/balance |
按量付费 | ¥ 余额 | platform.deepseek.com | ✅ 已验证 |
| OpenCode Go | GET /v1/usage |
订阅制 | 5h/周/月 进度条 | opencode.ai/workspace/go | ✅ 已验证 |
| Moonshot AI | GET /v1/users/me/balance |
按量付费 | ¥ 余额 | platform.moonshot.cn | ⚠️ 未测试 |
| Moonshot AI CN | GET /v1/users/me/balance |
按量付费 | ¥ 余额 | platform.moonshot.cn | ⚠️ 未测试 |
| OpenRouter | GET /api/v1/credits |
按量付费 | $ 余额 | openrouter.ai | ⚠️ 需 Management Key |
| Fireworks AI | GET /v1/accounts/-/billingUsage |
后付费 | $ 已用费用 | fireworks.ai | ⚠️ 未测试 |
| Z.AI（智谱） | GET /user/rights |
按量付费 | token 余量 | open.bigmodel.cn | ⚠️ 未测试 |
| Z.AI CN | GET /user/rights |
按量付费 | token 余量 | open.bigmodel.cn | ⚠️ 未测试 |
不支持余额查询
以下供应商暂无公开的余额查询 API，显示控制台链接供手动查看：
| 供应商 | 控制台 |
|---|---|
| OpenAI | chatgpt.com |
| Anthropic | console.anthropic.com |
| Google Gemini | aistudio.google.com |
| Groq | console.groq.com |
| Mistral | console.mistral.ai |
| xAI | console.x.ai |
| Together AI | api.together.ai |
| Cerebras | cloud.cerebras.ai |
| NVIDIA | build.nvidia.com |
| Hugging Face | huggingface.co |
| Qwen（通义千问） | dashscope.console.aliyun.com |
| Xiaomi（小米） | platform.xiaomimimo.com |
| Kimi For Coding | kimi.moonshot.cn |
| Ant Ling（蚂蚁灵） | ant-ling.com |
| OpenCode Zen | opencode.ai/workspace |
Query overrides
Built-in provider cards can be edited from the Edit action. Overrides are stored globally by the DSH host in ~/.dsh/usage-monitor/config.json and do not contain API key values. The editor supports HTTPS query URLs, GET/POST, Bearer Token, X-API-Key, no authentication, and safe dot-separated response field paths. Localhost, private-network, loopback, and cloud metadata addresses are rejected.
Issues and PRs are welcome!
📄 License
MIT
Links
More in this category
bowenliang123/dsh-context★ 1880
DSH context insight panel: Context dashboard + /context command + Context browser — one-stop context lifecycle management with categorized composition, content details, evolution trends, compaction/injection events, and stats.
Han-1413141/dsh-cost-meter★ 375
Per-session and daily API cost, budget with usage %, official balance, history dashboard, and one-click official price sync with peak/off-peak pricing.
wssfk12138/dsh-damage-pulse★ 245
Tracks DeepSeek token usage, per-call and session costs, and account balance with cache-aware charge animations in the DSH Web UI.
zh667/TokenLedger★ 204
Sidebar usage panel that attributes tokens to the relay site that served each request, read from your existing provider config: today/month/all-time totals, per-site and per-model breakdowns, a year activity heatmap, and New API / Sub2API / DeepSeek balances.
Ychris12138/dsh-usage-stats★ 170
Multi-provider usage dashboard with provider/model token breakdowns, calendar drill-downs, account balances, and OpenCode Go / Z.ai subscription quota tracking.
PolinniZhong/dsh-personal-center★ 118
Personal center for DeepSeek Harness: cross-session usage statistics, per-model cost estimation, global custom instructions, a global font-size adjuster, a data-driven desktop pet with bitmap & vector skins, and a conversation status overview, all local and offline.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.