dsh-balance-stats

Balance

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.

Harness local estimate

The plugin scans usage events in Harness conversation logs and calculates spend from model prices using:

• Uncached input tokens
• Cache-hit/write tokens
• Output tokens
• Spend aggregated by date and model

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:

• A usage sample replaces the earlier sample of the same (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.
• Prices are applied at the sample's own event time, so a replacement that crosses midnight or a peak/off-peak boundary moves its full cost between the affected day and rate buckets.
• Day buckets and the Today/7-day/30-day windows all use 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.
• Token fields accept only nonnegative safe integers (or their numeric strings); malformed values become zero, and cache reads are never subtracted from inputTokens.
• Accumulators keep full precision and round to six decimals only when a view is published, so totalCost, costByModel, costByDay, and the sum of per-session costs agree.

Historical invoices

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)

1. Click the stats bar to open the details card and expand "Auto invoice import".
2. Follow the 3-step guide: sign in to the platform → run copy(localStorage.userToken) in the console → come back, paste it, and press Save.
3. Saving verifies the token with one live fetch, then persists it to the local credentials file ~/.dsh/.credentials.yaml (mode 0600). The plugin re-fetches invoices every invoiceRefreshIntervalMs (default 6 hours) and restores the token automatically after restarting dsh web.
4. An expired session turns the status dot amber ("Expired"); paste a fresh token to resume. "Clear" removes everything again.

Option 2 — manual JSON paste (no token)

1. Sign in to https://platform.deepseek.com/.
2. Use browser developer tools to copy the JSON response from https://platform.deepseek.com/auth-api/v0/users/get_all_invoice.
3. Open the details card, expand "Advanced", paste the complete JSON, and click Import.

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%

• By default (no token provided), the plugin never requests get_all_invoice and stores no DeepSeek Platform credentials.
• Only when you explicitly paste a 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.
• No DeepSeek Platform cookies are accepted or stored; the token never leaves your machine except to platform.deepseek.com.
• Manually pasted JSON is parsed only in memory. The browser-side 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.
• Signing out of the DeepSeek Platform immediately invalidates any saved token.

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.

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

Local directory

npx @deepseek-ai/dsh plugin --profile web add /absolute/path/to/dsh-balance-stats
npx @deepseek-ai/dsh web

Tarball

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).

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 600000
• platformBaseUrl: DeepSeek Platform base URL; normally leave as default

After 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 }
  }
}