dsh-balance

A DeepSeek Harness (dsh) web profile plugin that puts a DeepSeek API balance button in the sidebar foot, right above the Settings entry.

• One click → popover with total / granted / topped-up balance per currency, with refresh and close actions
• Optional inline display: show the balance on the button itself without opening the popover
• Optional auto refresh: re-query the balance in the background every N conversation turns
• Full settings page (余额 / Balance) in the Settings panel: enable/disable the plugin, inline display, auto-refresh interval
• Cosmetic touch: shrinks the built-in Cordis Plugin badge at the sidebar foot to a compact round icon so both buttons share the row cleanly
• Clicking anywhere outside the popover closes it

The API key is never embedded: it resolves per request from the DSH credential seam (~/.dsh/.credentials.yaml → DEEPSEEK_API_KEY, or the ambient environment variable).

Install

# 1. install the package into your web profile (pnpm under the hood)
dsh plugin --profile web add github:HiNEM66/deepseek-harness-balance

# 2. register the bundle patch layer: edit ~/.dsh/profiles/web/package.json
#    and add "dsh-balance" to the "dsh.profile.bundles" array, e.g.
#    "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-balance"]

# 3. restart the web GUI
dsh web

Alternative to step 2: add the row by hand to ~/.dsh/profiles/web/cordis.patch.yml:

- insert:
    - id: dsh-balance
      name: dsh-balance

Requires the DEEPSEEK_API_KEY credential (set it in ~/.dsh/.credentials.yaml
or through the dsh Models page). The plugin itself ships no key.

Settings

Settings persist in ~/.dsh/settings.yaml under the dsh-balance: section (live-applied; edits there are picked up within ~10 s):

Requirements

• dsh 0.1.0-rc.x web profile with the standard client modules (sidebar, settings, slots)
• Windows host for the balance route (it shells out to curl.exe); network access to https://api.deepseek.com

Development

No build step: lib/client.js is a hand-written, self-contained __ModuleLoader__ bundle (React comes from the shell's shared module registry), and lib/index.js is plain ESM.

npm run check   # node --check both files
npm test        # execute the client bundle against a fake ModuleLoader kernel

Layout:

lib/index.js        host half: /deepseek-balance, /state, /config routes +
                    settings namespace + agent turn counter
lib/client.js       client bundle: sidebar button + popover + settings page
cordis.patch.yml    bundle patch: inserts the dual-face row
dsh.plugin.json     plugin inventory metadata
tests/smoke.mjs     bundle contract smoke test

Upgrading

dsh plugin --profile web update dsh-balance   # refetches the latest commit
dsh web                                       # restart

Releasing (maintainers)

# 1. bump "version" in package.json and dsh.plugin.json, then:
npm run check && npm test

# 2. commit (Conventional Commits) and push
git add -A && git commit -m "feat: ..."
git push origin main

# 3. tag the release
git tag v<version> && git push origin v<version>

# 4. dogfood locally: refresh the git dep to the new commit and restart
cd ~/.dsh/profiles/web && pnpm update dsh-balance
dsh web

Known limitations

• The badge-shrinking CSS targets the shipped Nqubda_* class names; a future dsh upgrade that renames them silently restores the stock badge (the balance button is unaffected).
• The client syncs settings by polling /deepseek-balance/state every 10 s.

Uninstall

dsh plugin --profile web remove dsh-balance
# and drop "dsh-balance" from "dsh.profile.bundles" (or remove the row from cordis.patch.yml)

License

MIT