DSH Account Balance Badge

A persistent DeepSeek Harness (DSH) Web UI plugin that keeps the signed-in DeepSeek account balance visible in the left sidebar, with a one-click in-app recharge action that opens DeepSeek's official top-up page without leaving the app.

中文说明

Features

• Always visible, on the left: a full-width balance row in the sidebar footer, directly above Settings (below the shipped Cordis plugins row), so it stays visible across home, settings, and conversation views instead of hiding inside the Account settings page.
• Recharge and bonus wallets: shows every wallet returned by the account service with the Platform's currency formatting (CNY ¥, USD $; two decimals with digit grouping; sub-cent amounts shown as <¥0.01). Positive bonus credit is appended as a small Bonus ¥x.xx note.
• Recharge inside the app: a compact Top up (充值) button beside the amount opens the official DeepSeek top-up page as an in-app native Platform view on the Desktop app, with a "Back to DeepSeek Harness" bar; returning re-reads the balance. A plain Web UI opens the same page in a new tab instead. The button is disabled while signed out.
• Sensible refresh: reads once on mount, refreshes every 60 seconds while the page is visible, on window focus, when the row is clicked, and after returning from the top-up page. Reads are in-flight deduplicated.
• Localized and theme-aware: English and Chinese copy follows the interface language; colors use the host theme tokens, so light and dark themes and the collapsed 36 px rail both work.
• Credentials never reach the browser: the balance is read through the Host account service via the Client Remote account.getBalance method, and the top-up page is a Desktop-owned native view authenticated by the Desktop's own Platform session — no raw account tokens are exposed to the page.

Requirements

• DSH >=0.2.1-rc.2 <0.3.0-0 (verified on DSH 0.2.1-rc.2).
• A profile-managed DSH installation (the Desktop app, or dsh web launched with a profile), with the shipped Web UI plugins enabled (the sidebar, locale, and account controller are part of the standard Web app).
• A signed-in DeepSeek account for amounts; a signed-out installation shows the localized "signed out" state instead of an amount and keeps the recharge action disabled.
• In-app recharge needs the Desktop app: it uses the preload-owned dshPlatform bridge to host the official page in a native view. A plain browser build opens the deployment's top-up URL in a new tab instead.

Install

The plugin is distributed from GitHub — repository · latest release. It is not on npm yet, so install it from the Git address or from the release tarball. A step-by-step macOS walkthrough (both languages) lives in docs/INSTALL-macOS.en.md and docs/INSTALL-macOS.md.

From the DSH Web UI (recommended)

1. In DSH, select Plugins in the left sidebar.
2. Click Add plugin (or the arrow → Install a third-party plugin).
3. Enter one of:
   • a Git address: github:NebulaXIX/dsh-account-balance-badge (tracks main), or github:NebulaXIX/dsh-account-balance-badge#v0.2.0 to pin the release
   • the release tarball: the absolute path to dsh-account-balance-badge-0.2.0.tgz
   • an absolute path to a local checkout
4. Click Install.
5. When installation finishes, choose Enable now. A profile with HMR recomposes immediately; otherwise restart DeepSeek Harness. The balance row appears in the left sidebar footer.

The Desktop app manages the desktop profile itself, so the Plugins UI is the only supported install route there.

With the dsh CLI

Requires the dsh CLI and pnpm on your PATH; start DSH once first so the target profile exists. --profile is required, and desktop is reserved for the Desktop app:

# Git, tracking main
dsh plugin --profile web add github:NebulaXIX/dsh-account-balance-badge

# Git, pinned to the v0.2.0 release
dsh plugin --profile web add "github:NebulaXIX/dsh-account-balance-badge#v0.2.0"

# the tarball attached to the GitHub release
dsh plugin --profile web add ./dsh-account-balance-badge-0.2.0.tgz

# a local checkout (absolute path in the UI; relative paths resolve from the invoking directory)
dsh plugin --profile web add ./path/to/dsh-account-balance-badge

This package is plain JavaScript with no dependencies and no build script, so a Git install needs no pnpm build-script approval. dsh plugin ... add also appends the bundle to the profile's bundle list, so no manual patch editing is needed.

Not on npm yet. dsh plugin ... add dsh-account-balance-badge (the package name) only works after an npm release; until then use the Git address or the release tarball above.

Update / uninstall

Third-party plugins are upgraded by uninstalling and reinstalling the new version — in the Web UI from the bundle page (Uninstall, then install again), or with the CLI:

dsh plugin --profile web remove dsh-account-balance-badge
dsh plugin --profile web add "github:NebulaXIX/dsh-account-balance-badge#v<new-version>"

Usage

• The row shows a wallet icon, the localized label, and the current balance(s).
• Click the row to refresh; it also refreshes when the window regains focus and every 60 seconds while the page is visible.
• Click Top up (充值) beside the amount to recharge: on the Desktop app the official DeepSeek top-up page opens inside the application window under a "Back to DeepSeek Harness" bar, and returning re-reads the balance; in a plain Web UI the same page opens in a new tab.
• Loading, signed-out, and failed-but-retryable states are shown in place; the row never fabricates a zero balance. If the page fails to load, the return bar stays available with a localized error and a Retry action; Escape also returns.
• The row expands to a full-width 42 px row when the sidebar is wide and becomes a compact 36 px icon in the collapsed rail (the accessible name and tooltip carry the amount). On Windows Desktop the shipped shell hides the whole sidebar footer while the sidebar is collapsed, so the row is hidden there just like the Settings and Cordis rows.

How it works

Half	File	Role
Host	index.js	Empty bundle half: carries the Loader row only, adds no Host capability, tool, or prompt surface.
Client	client.js	Registers the row in sidebar.footer.action and one page host in shell.overlay; reads balances through ctx.remote.account.getBalance; asks the Desktop preload bridge (globalThis.dshPlatform) to host the top-up page and renders the row, the return bar, and the component-local stylesheet.
Loader patch	cordis.patch.yml	Inserts the account-balance-badge row named after this package.
Display metadata	locale/en.json, locale/zh.json, icon.svg	Plugin Manager title, description, and icon.

The balance read is a Host-to-Platform query performed by the account service; the browser only receives wallet amounts (currency and decimal strings). The recharge page is not rendered by this plugin at all: the Desktop owns the native WebContentsView and its Platform credentials, while the plugin only contributes the 48 px return bar and reports the measured viewport rectangle (open / setBounds / close on the preload bridge).

Development

The plugin is plain JavaScript with no build step and no dependencies:

• index.js is an ES module exporting apply().
• client.js is a lazy browser module in the window.__ModuleLoader__.load({ id, factory }) format; it is served as-is, so keep it valid plain JavaScript (no JSX/TypeScript/import). Its factory resolves only react and react-dom from the page's frozen module table (no npm dependencies); react-dom is used solely to portal the recharge overlay out of the shell.overlay layer, the same approach the shipped account page uses.

git clone https://github.com/NebulaXIX/dsh-account-balance-badge.git
cd dsh-account-balance-badge
npm test          # zero-dependency manifest/structure checks

Install your checkout as a bundle with the local-path option in the Plugins dialog (or dsh plugin --profile web add /absolute/path/to/checkout). The Web UI picks up client changes through HMR while the bundle is link-installed; a full page refresh loads the latest bundle if HMR is unavailable.

Refresh interval

The background refresh cadence is the REFRESH_INTERVAL_MS constant at the top of client.js (default 60000 ms). Change it in a local checkout if you prefer another cadence; the row still refreshes on click and on window focus.

Publishing this plugin (maintainers)

The public repository is https://github.com/NebulaXIX/dsh-account-balance-badge. Releases are tagged vX.Y.Z and carry the npm pack tarball as a release asset, which is what users install.

1. Bump version in package.json and add an entry to CHANGELOG.md.
2. Run npm test (scripts/check.mjs, zero dependencies) and npm pack --dry-run; the tarball must contain index.js, client.js, cordis.patch.yml, icon.svg, locale/en.json, and locale/zh.json (plus README/LICENSE/CHANGELOG, which npm always includes; scripts/, docs/, and .github/ are intentionally not shipped).
3. Commit on a dev/<task> branch, run npm test again, then merge into main.
4. Tag and push: git tag v<version> && git push origin main --tags.
5. Pack and publish the release with the tarball attached: npm pack --pack-destination dist then gh release create v<version> dist/dsh-account-balance-badge-<version>.tgz --title "v<version>" --notes-file <notes>.
6. Optional npm publication (makes the package-name install route work): npm publish --access public — the package name dsh-account-balance-badge is currently free on the registry, but publishing needs a logged-in npm account.
7. If the package is ever renamed, change it in three places and keep them identical: package.json name, the cordis.patch.yml row's name, and the id passed to window.__ModuleLoader__.load(...) in client.js.

License

MIT