dsh-balance
DeepSeek Harness plugin that displays the selected model provider's account
balance as a small text next to the composer's model seat, once a model (and
its reasoning effort) is selected for the active conversation.
How it works
- Host half (
lib/index.js, a Cordis plugin) mounts one loopback HTTP
route — GET /dsh-balance/balance?provider=<route> — on the webserver. The
route resolves the selected provider's own API key through the standard
credentials service (the llm-deepseek section for the DeepSeek official
route, the llm-pi-ai providers table for custom/other routes), then probes
the provider's balance: DeepSeek-style GET <baseURL>/user/balance first,
falling back to the OpenAI-style GET <baseURL>/v1/dashboard/billing/credit_grants.
The key never crosses the wire boundary.
- Client half (
client/client.js, a web client plugin) registers a seat
into the conversation.input.right slot (immediately beside the model
selector). It subscribes to the active session's model-selection directory
(modelDirectories), passes the selected provider to the route, and only
renders after a model with a non-empty id is selected — an empty selection
hides the text instead of retaining a stale balance. Polls every 60s;
clicking the text refreshes immediately.
Installation
From source (any DSH profile)
The package declares a dsh.bundle manifest, so it installs through the
standard plugin command once the repo is resolvable:
dsh plugin add @kkbsgg/dsh-balance
Manual (packaged DSH Desktop)
With the package resolvable from the profile's node_modules, add one loader
row to the profile patch ($DSH_HOME/profiles/<profile>/cordis.patch.yml):
- insert:
- id: balance
name: 'dsh-balance'
and restart the application so the loader composes the new row. Subsequent
edits to the client bundle hot-reload through the client HMR channel.
For the packaged DSH Desktop app, the package lives in the app's unpacked
node_modules and is linked into $DSH_HOME/profiles/node_modules as a
junction, so the profile loader resolves it exactly like the in-box plugins.
Note: the package is installed by hand into the pnpm-managed hoisted store.
A future pnpm install in the profile may prune it; re-create the link if
the balance text disappears after a plugin-market install.
Repository layout
dsh-balance/ (@kkbsgg/dsh-balance)
├── lib/index.js # host half (Cordis plugin + balance route)
├── client/client.js # client half (web client plugin bundle)
├── test/smoke.test.mjs # host-half smoke test (run: node test/smoke.test.mjs)
├── cordis.patch.yml # dsh.bundle patch (market installability)
├── package.json # dsh.bundle + dsh.client manifest
├── CHANGELOG.md
├── .editorconfig
└── README.md
The live copy currently installed in the DSH Desktop app lives under the app's
unpacked node_modules; this repository is the source of truth. After
changing code here, re-sync the files into the installed copy (or install the
package from this repo and re-create the profile link).
Response shape
{ "ok": true, "isAvailable": true,
"balanceInfos": [{ "currency": "CNY", "totalBalance": "110.00", "grantedBalance": "10.00", "toppedUpBalance": "100.00" }],
"fetchedAt": "2026-01-01T00:00:00.000Z" }
{ "ok": false, "code": "no-api-key", "message": "no credential configured for DEEPSEEK_API_KEY" }
