dsh-balance-stats
适用于 DeepSeek Harness Web 的社区余额和支出统计插件，提供会话使用量和可选的自动导入发票摘要。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:pangzi499/dsh-balance-stats#170018b586c8100765daae48135e7493bae1c4efBalance Stats 以 dsh-balance-stats 发布，当前版本为 0.3.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
dsh-balance-stats is a balance and usage statistics plugin for DeepSeek Harness Web. It displays three key figures in a bar below the conversation composer:
Balance ¥40.22 | This session ¥0.15 | Total spent 42.5%
Click the bar to open an interactive, scrollable details card with balance composition, Harness local usage estimates, model-level spend, token usage, and historical billing summaries.
Make sure Node.js >=22.19.0 is installed and pnpm --version works, then run:
npx @deepseek-ai/dsh plugin --profile web add https://github.com/pangzi499/dsh-balance-stats.git
Start or restart Harness Web, then hard-refresh the browser:
npx @deepseek-ai/dsh web
Update:
npx @deepseek-ai/dsh plugin --profile web update dsh-balance-stats
Stats bar — balance, current session cost, and total spend below the composer:
Balance, current session, and total spend bar
Details card — click the bar to open it: balance composition, billing history, per-model spend, token usage, and the invoice import field:
Balance and usage details card
balanceStatsSessionCost projection and falling back to a server-side fold of that exact session (GET /balance-stats?s=<sessionId>), so a restart cannot leave the bar on a bare dash.userToken once in the details card and the server re-fetches invoices on a schedule; the token persists to the local credentials file (mode 0600), survives restarts, and clears with one click.get_all_invoice JSON response for a one-shot import. Importing force-refreshes the balance, so every figure updates at once.The server requests:
GET https://api.deepseek.com/user/balance
By default, the API key is read from the Harness credential DEEPSEEK_API_KEY. It is never sent to the browser.
The plugin scans usage events in Harness conversation logs and calculates spend from model prices using:
This is a local estimate. It may exclude calls made outside Harness, deleted historical logs, or calls without standard usage events.
prices applies to ordinary models and v4 usage before 2026-08-17 00:00 +08:00.
After that cutoff, v4 usage selects v4PeakPrices during 09:00–12:00 and
14:00–18:00 Beijing time, and v4OffPeakPrices at other times. All three
price maps are configurable.
The fold is deterministic and independent of when you look at it:
(turn, step) instead of double-counting it; llm/retry-started closes the matching slot so a retry keeps the cost of the attempt it replaced.2026-08-17-style UTC+08:00 dates. A record without a usable timestamp inherits the last valid one in log order; with none available it falls back to base prices under the unknown day, stays inside the total, and is excluded from the date windows. The viewing clock is never used for historical pricing.inputTokens.totalCost, costByModel, costByDay, and the sum of per-session costs agree.The public DeepSeek balance API does not return historical top-ups. To enable accounting-based figures, pick one of three ways:
Option 1 — auto import (recommended)
get_all_invoice and stores no DeepSeek Platform credentials.userToken and press Save does the plugin call the invoice endpoint with it and write the token to the local Harness credentials file ~/.dsh/.credentials.yaml (mode 0600, managed by the Harness credentials provider). "Clear" in the card removes it again.platform.deepseek.com.localStorage fallback summary keeps only aggregates: historical top-ups, grants, order count, currency, and import time. Order IDs, payment channels, and transaction details are not persisted.get_all_invoice is a private, authenticated DeepSeek Platform endpoint and its response format may change. Never share your userToken, cookies, authorization headers, or raw JSON containing order details.
0.1.0-rc.6 through 0.1.5-rc.2>=22.19.0PATH because Harness uses it to manage profile plugins (missing? see Installation)24.19.0DeepSeek Harness is still in developer preview. The client APIs and mounting slot used by this plugin may change in upstream releases.
This is a community plugin for DeepSeek Harness. It is not an official @deepseek-ai plugin.
Install the latest version from the default branch:
npx @deepseek-ai/dsh plugin --profile web add https://github.com/pangzi499/dsh-balance-stats.git
npx @deepseek-ai/dsh web
Repository: https://github.com/pangzi499/dsh-balance-stats
You can also download dsh-balance-stats-0.3.2.tgz from the GitHub Release and install it as a tarball.
Harness manages profile plugins with pnpm. Check it before installing:
pnpm --version
command -v pnpm
If pnpm is missing, install it with Corepack:
corepack enable
corepack prepare pnpm@10 --activate
pnpm --version
If Corepack is unavailable in your Node.js installation, use npm:
npm install --global pnpm@10
pnpm --version
npx @deepseek-ai/dsh plugin --profile web add /absolute/path/to/dsh-balance-stats
npx @deepseek-ai/dsh web
Build:
cd /path/to/dsh-balance-stats
npm pack
Install:
npx @deepseek-ai/dsh plugin --profile web add /absolute/path/to/dsh-balance-stats-0.3.2.tgz
npx @deepseek-ai/dsh web
Then hard-refresh the browser (macOS: Command + Shift + R; Windows/Linux: Ctrl + Shift + R).
For GitHub one-line installs, the update command is in Quick install above.
For local-directory or tarball installations, run add again with the new path, then restart dsh web.
Override plugin configuration in $DSH_HOME/profiles/web/cordis.patch.yml. Configuration is replaced as a whole, so repeat every key you want to retain:
- id: dsh-balance-stats
config:
apiKey: ''
apiKeyRef: DEEPSEEK_API_KEY
baseUrl: https://api.deepseek.com
refreshIntervalMs: 300000
clientPollIntervalMs: 30000
timeoutMs: 8000
currency: CNY
platformToken: ''
platformTokenRef: DEEPSEEK_PLATFORM_TOKEN
invoiceRefreshIntervalMs: 21600000
platformBaseUrl: https://platform.deepseek.com
prices:
deepseek-chat: { cacheHit: 0.1, cacheMiss: 1, output: 2 }
deepseek-reasoner: { cacheHit: 1, cacheMiss: 4, output: 16 }
deepseek-v4-flash: { cacheHit: 0.02, cacheMiss: 0.1, output: 0.2 }
deepseek-v4-pro: { cacheHit: 0.025, cacheMiss: 3, output: 6 }
v4PeakPrices:
deepseek-v4-flash: { cacheHit: 0.10, cacheMiss: 3.0, output: 9.0 }
deepseek-v4-pro: { cacheHit: 0.30, cacheMiss: 9.0, output: 27.0 }
v4OffPeakPrices:
deepseek-v4-flash: { cacheHit: 0.05, cacheMiss: 1.5, output: 4.5 }
deepseek-v4-pro: { cacheHit: 0.15, cacheMiss: 4.5, output: 13.5 }
defaultPrices: { cacheHit: 0.1, cacheMiss: 1, output: 2 }
Prefer apiKeyRef / platformTokenRef so the plugin reuses Harness credentials. Never put a real API key or platform token in a cordis.patch.yml file that you plan to share.
Auto import keys:
platformToken: literal platform token (plaintext; not recommended — prefer saving via the UI or credentials)platformTokenRef: credential reference name (default DEEPSEEK_PLATFORM_TOKEN; saving in the UI writes this credential entry)invoiceRefreshIntervalMs: invoice refresh interval, default 21600000 (6 h), minimum 600000platformBaseUrl: DeepSeek Platform base URL; normally leave as defaultAfter starting the Web profile:
curl http://127.0.0.1:3080/balance-stats
curl 'http://127.0.0.1:3080/balance-stats?s=<sessionId>'
The first call returns the account snapshot; the second adds currentSession { cost, costByDay }
folded from exactly that session log. A client bundle is served under its revisioned combo URL
(/plugins/??dsh-balance-stats/client.js&rev=<hash>, hash taken from window.__DSH_BOOT__),
so the bare /plugins/dsh-balance-stats/client.js path answers 404 by design.
Example statistics response (amounts are illustrative):
{
"ok": true,
"currency": "CNY",
"balances": [
{ "currency": "CNY", "total": 40.22, "granted": 0, "toppedUp": 40.22 }
],
"stats": {
"state": "ok",
"totalCost": 2.103612,
"percent": 5,
"today": 2.103612,
"day7": 2.103612,
"day30": 2.103612,
"costByDay": { "2026-09-15": 2.103612 },
"costByModel": { "deepseek-v4-flash": 1.702128 },
"tokens": { "uncachedInput": 25361491, "cacheRead": 647550144, "cacheWrite": 0 },
"sessions": 10
},
"currentSession": {
"cost": 0.258097,
"costByDay": { "2026-09-15": 0.258097 }
}
}
get_all_invoice response format.userToken expires when you sign out of the DeepSeek Platform; paste a fresh one to resume auto import.npx @deepseek-ai/dsh plugin --profile web remove dsh-balance-stats
MIT
copy(localStorage.userToken)
in the console → come back, paste it, and press Save.~/.dsh/.credentials.yaml (mode 0600). The plugin re-fetches
invoices every invoiceRefreshIntervalMs (default 6 hours) and restores the
token automatically after restarting dsh web.Option 2 — manual JSON paste (no token)
https://platform.deepseek.com/.https://platform.deepseek.com/auth-api/v0/users/get_all_invoice.Option 3 — environment / config
Store the token under the Harness credential DEEPSEEK_PLATFORM_TOKEN
(or platformToken in cordis.patch.yml, or an env var of that name); auto
import starts on launch.
Only top-up orders where payment_order_status === "SUCCESS" are counted. Valid grant orders are accumulated separately.
Accounting total = historical top-ups + historical grants
Accounting spend = max(0, accounting total - current total balance)
Total spent = accounting spend / accounting total × 100%
Without imported invoices:
Total spent = Harness local estimated spend
/ (current total balance + Harness local estimated spend)
× 100%