dsh-deepseek-balance

dsh-deepseek-balance

A DeepSeek Harness plugin that shows your live DeepSeek API account balance as a frame-wide badge in the top-right corner of the web GUI.

English | 中文

What it does

• Host half: registers GET /dsh-deepseek-balance, reads DEEPSEEK_API_KEY from the harness credentials seam (falling back to the environment variable), and returns GET https://api.deepseek.com/user/balance.
• Browser half: registers a pill into the shell.overlay seat, polls on a configurable interval (default 60s), and refreshes immediately when clicked.

The API key never reaches the browser; it is resolved in the host process per request.

Install

dsh plugin --profile web add dsh-deepseek-balance

Then restart your web profile and refresh the page. The badge appears in the top-right corner:

• green dot — balance available
• amber dot — funds exhausted
• gray dot — loading
• red dot — request failed (hover for the reason)

Click the pill to refresh immediately (hover shows the granted/topped-up split).

Configure

The key is the same one the harness already uses for the model. Set it once in Settings → Models (the credentials seam), or export it:

export DEEPSEEK_API_KEY=sk-...

Optional overrides in the bundle row (config:):

config:
  refreshIntervalMs: 30000   # poll interval in ms (default 60000)
  baseUrl: 'https://api.deepseek.com'

Build from source

pnpm install
pnpm build

pnpm build emits lib/index.js (host half) and lib/client.js (browser half).

License

MIT