dsh-api-balance
> DSH Plugin · A floating account widget for DeepSeek Harness that shows multiple AI providers' balances and usage in the session header.
中文文档
A persistent web plugin for DeepSeek Harness (DSH): it pins a small pill to the top-right header (to the left of the "Session log" button) showing the selected provider's account balance in real time. Click it to expand a dropdown with two tabs — Balance (余额) for account/credit balance and Usage (用量) for 30-day cost or token quota — where you can switch provider, enter an API key, and refresh manually.
Features
- Multi-provider: one plugin queries multiple AI vendors; switch provider in the UI
- Two tabs: Balance (余额) shows account balance; Usage (用量) shows 30-day cost or token quota — each tab keeps its own provider, API key, and refresh
- Persistent: provider / API key / extra params are stored in the DSH credentials store (
~/.dsh/.credentials.yaml, mode 0600), surviving restarts - Live refresh: 30s auto-poll + manual refresh
- Secure: host routes accept loopback requests only; API keys are never sent back to the frontend or logged
- Theme-aware: all styles use DSH theme tokens, following light/dark mode
- Extensible: add a provider by appending one entry to
PROVIDERSon the host; the UI renders the matching form automatically
Supported providers
Balance (余额)
| Provider | Endpoint | Extra params |
|---|---|---|
| AGICTO | POST /v1/enterprise/account |
uuid (account UUID) |
| DeepSeek | GET /user/balance |
— |
| OpenRouter | GET /api/v1/credits |
— |
| Moonshot (Kimi) | GET /v1/users/me/balance |
— |
| SiliconFlow | GET /v1/user/info |
— |
| MiniMax | GET /v1/token_plan/remains |
— |
| StepFun | GET /v1/accounts |
— |
| xAI (Grok) | GET /v1/billing/credits |
— |
Usage (用量)
| Provider | Endpoint |
|---|---|
| OpenAI | GET /v1/organization/costs |
| 智谱 GLM | GET /api/monitor/usage/quota/limit |
| Together AI | GET /v1/billing/usage |
| Anthropic (Claude) | GET /v1/organizations/cost_report |
> Provider endpoints may change upstream; if a provider fails to parse, consult its official docs. See "Adding a provider" below.
Architecture
Host (Node process) Client (browser)
─────────────── ──────────────
lib/index.js lib/client.js
├─ GET /balance/providers header pill + dropdown (2 tabs)
├─ GET /balance/status ├─ Balance tab: balance
├─ GET /balance/usage ├─ Usage tab: 30d cost / quota
├─ POST /balance/config ├─ provider selector
├─ POST /balance/usage-config ├─ API key input
├─ POST /balance/clear └─ extra fields (per provider)
└─ POST /balance/usage-clear
│
└─ credentials service (~/.dsh/.credentials.yaml)
BALANCE_PROVIDER / BALANCE_API_KEY / BALANCE_EXTRA
USAGE_PROVIDER / USAGE_API_KEY / USAGE_EXTRA
The host registers loopback-only /balance/* routes via webServer, reads the credentials store, and queries the selected provider's balance or usage endpoint; the client fetches the same-origin routes directly and renders the widget (Balance + Usage tabs) with React.createElement (bundled in __ModuleLoader__ format, no build step).
Install
Option A: dsh plugin command
dsh plugin --profile web add https://github.com/Badegg404/dsh-api-balance.git
Option B: manual install
- Place this repo somewhere local (e.g.
~/.dsh/profiles/web/plugins/dsh-api-balance/) - Edit
~/.dsh/profiles/web/package.json:
{
"dependencies": {
"@Badegg404/dsh-api-balance": "file:plugins/dsh-api-balance"
},
"dsh": {
"profile": {
"bundles": [
// ...existing bundles...
"@Badegg404/dsh-api-balance"
]
}
}
}
pnpm install, then restart DSH.
Usage
- Open a session; the pill appears to the left of the "Session log" button
- In the Balance (余额) tab: pick a balance provider → paste the API key (AGICTO also needs the account UUID) → save; the balance shows in the pill and tab, auto-refreshing every 30s
- Switch to the Usage (用量) tab: pick a usage provider (e.g. OpenAI) → paste the API key → save; it shows the 30-day cost (or token quota for 智谱), also auto-refreshing
Screenshot
┌─ Header ─────────────────────────────────────────────┐
│ session title… [● Balance 12.34 USD] [Session log] │
└──────────────────────────────────────────────────────┘
│ click
▼
┌─ Account Monitor ────────────────┐
│ [ Balance ] [ Usage ] │
├───────────────────────────────────┤
│ Provider [AGICTO ▾] │
│ AGICTO ¥ 4.9974451 │
│ API Key [••••••••] │
│ Account UUID [a1b2c3... ] │
│ [ Save ] [Clear] [Refresh] │
└───────────────────────────────────┘
Adding a provider
Append one entry to BALANCE_PROVIDERS (balance) or USAGE_PROVIDERS (usage) in lib/index.js; the form renders automatically:
{
id: "myplatform",
label: "My Platform",
currency: "USD", // optional display currency
extraFields: [], // extra params (e.g. agicto's uuid)
request: {
method: "GET",
url: "https://api.example.com/v1/balance",
headers: { "Authorization": "Bearer {key}" }, // {key} → API key
// body: '{"uuid":"{uuid}"}', // enable if needed; {field} → extra param
},
parse(res) {
// balance provider: return { balance: "12.34" } (or { balance: null, error: "..." })
// usage provider: return { summary: "近30天费用: $1.23" } (or { summary: null, error: "..." })
},
}
Placeholders {key} and {} in request.headers / request.body are substituted before the request; usage providers can also use {start_date} / {end_date} / {start_ts} / {end_ts} / {start_iso} / {end_iso} — a 30-day window is computed automatically.
License
MIT
