zlZayn/dsh-ds-balance

dsh-ds-balance is a native plugin built specifically for DeepSeek Harness (DSH) that surfaces your live DeepSeek account balance in the DSH sidebar, reading real numbers from the official GET /user/balance endpoint on api.deepseek.com rather than estimating them. It installs through dsh plugin --profile web add dsh-ds-balance from npm, or from source via git clone https://github.com/zlZayn/dsh-ds-balance.git, npm install && npm run build, and dsh plugin --profile web add "$PWD"; either path needs a restart of dsh --profile web to take effect. The package name dsh-ds-balance doubles as the bundle-config key in plugins.bundle.config, so each install gets its own detail page directly under a localized title that follows the UI language.

A typical run starts from the Plugins page in the sidebar, where the user opens the installed plugin card, configures thresholds, currency, and refresh cadence across four collapsed groups (Connection, Display, Thresholds, Refresh), and saves without restarting DSH. After that, a status ring pinned to the bottom of the sidebar reports at a glance how much budget remains relative to the warning line, while clicking the entry expands the popover showing the total balance split into gifted and topped-up amounts, a data-freshness stamp, a cooldown-protected manual refresh button, and an external link to the official DeepSeek usage page. Multi-currency accounts are auto-detected; if the selected currency is missing on the account, the popover offers a one-click "use actual currency" action that writes the new value back into the settings card.

Dependencies center on the @deepseek-ai/dsh host on its current alpha line (its latest tag is older than what this plugin declares, so the install command must pin the alpha channel) plus Node.js ≥ 20, with engines.dsh and peerDependencies in package.json as the source of truth and weekly CI running swap tests on alpha and next via .github/workflows/compat.yml. Lower-bound breakage is detected at runtime through ctx.inject(['configForms']) rather than slot-name checks, and surfaces as an [WARN] line in the popover pointing users to upgrade. Credentials default to a read-only inheritance from the official Models page, the API key never returns to the UI (only a fixed-length mask), snapshots are partitioned by a ledger id derived from the key plus a .salt file under DSH's home directory, and the project is released under the MIT license.