dsh-usage-monitor
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-monitorAdd 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 webAfter 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
