dsh-plugin-balance-float

Plugin Balance Float

适用于 DeepSeek Harness Web GUI 的浮动 DeepSeek API 余额胶囊：主机代理路由，以及注入每个 index.html 的仅点击显示状态小组件。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:Yochor-Debug/dsh-float#52d1b4a464ab7dda20f2322f0680394fd0f8796d

兼容性与来源证明

Plugin Balance Float 以 dsh-plugin-balance-float 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: any
发布来源: github
Registry 更新时间: 2026/9/20

版本

1.0.0stable

2026/9/20

README

dsh-plugin-balance-float

A floating DeepSeek API balance capsule for the DeepSeek Harness Web GUI — the Sogou-input-method kind of status pill: it sits in the corner, shows your remaining balance, and gets out of the way.

中文文档见 README.zh.md。

What it does

Appears with the page, disappears with it. The host plugin injects the widget into every rendered index.html, so it is not tied to any session and costs no conversation context.
Collapsed it shows just the balance plus a status dot: green = healthy, amber = low, red = depleted. A small ▼ hints that it can be opened.
Click to open the detail panel: total, granted and topped-up balance, and the last refresh time. Hovering does nothing — the pointer merely passing over the capsule must not pop anything up. Click again (or click elsewhere) to close.
Double-click to refresh immediately, on both the collapsed and expanded states; the ↻ icon spins as feedback, and the panel's ↻ button does the same.
Auto-refreshes every 5 seconds. Polling pauses while the tab is hidden and catches up on the first visible frame.
Draggable, snaps inside the viewport, remembers its position in localStorage, and follows the system light/dark theme.
Lives in a closed shadow root, outside the SPA's React tree, so it neither disturbs nor is disturbed by the app's styles.

Install

dsh plugin --profile web add dsh-plugin-balance-float

Then restart dsh web (see Why a restart below) and refresh the page.

Once installed it shows up in Settings → 插件 → 插件列表 → 全局插件 with an enable/disable control, alongside every other installed plugin.

Uninstall:

dsh plugin --profile web remove dsh-plugin-balance-float

Requirements

A DeepSeek API key on the machine, as the DEEPSEEK_API_KEY environment variable, or as refs.DEEPSEEK_API_KEY in $DSH_HOME/.credentials.yaml.
DeepSeek Harness >= 0.1.5-rc.2 (the profile bundle mechanism this package uses).

Why the balance is fetched on the host

DeepSeek's /user/balance requires Authorization: Bearer <key> and sends no CORS headers. Putting the key in the browser would both expose the credential and be blocked by CORS, so the host half reads the local credential and proxies the call; the browser only ever talks to the same-origin /x-balance-float.

Credential resolution order, per request (nothing is cached long-term):

the DEEPSEEK_API_KEY environment variable;
the Harness credential service, ctx.credentials.resolve('DEEPSEEK_API_KEY');
a direct read of $DSH_HOME/.credentials.yaml as a fallback.

The key never appears in any response.

Files

File	Role
`package.json`	Manifest: declares `dsh.bundle.patch`, which is what makes `dsh plugin` treat this package as a profile layer
`cordis.patch.yml`	The package's own profile layer: inserts `id: balance-float` / `name: dsh-plugin-balance-float`
`lib/index.js`	Host half: the `GET /x-balance-float` proxy route plus the index injection
`lib/client.js`	Browser half: the widget's DOM/CSS/drag/poll logic (injected inline)
`tools/verify-package.mjs`	Package-level verification (manifest, patch, route, injection, click-only interaction)

The host re-reads lib/client.js on every index render, so widget tweaks only need a page refresh — no reinstall, no dsh web restart.

Verify

node tools/verify-package.mjs

Known limitations

A restart is required after install. A running dsh composes its profile bundle list once, at boot; patchReload: live watches patch files, not package.json. So a host started before the install does not know about the new layer. Restarting dsh web is the fix.
Balance figures come from DeepSeek's own endpoint and are subject to its caching and reporting delay.
The widget shows the first currency DeepSeek reports; multi-currency accounts see one line for the primary entry.

License

MIT

README

dsh-plugin-balance-float

A floating DeepSeek API balance capsule for the DeepSeek Harness Web GUI — the Sogou-input-method kind of status pill: it sits in the corner, shows your remaining balance, and gets out of the way.

中文文档见 README.zh.md。

What it does

Appears with the page, disappears with it. The host plugin injects the widget into every rendered index.html, so it is not tied to any session and costs no conversation context.
Collapsed it shows just the balance plus a status dot: green = healthy, amber = low, red = depleted. A small ▼ hints that it can be opened.
Click to open the detail panel: total, granted and topped-up balance, and the last refresh time. Hovering does nothing — the pointer merely passing over the capsule must not pop anything up. Click again (or click elsewhere) to close.
Double-click to refresh immediately, on both the collapsed and expanded states; the ↻ icon spins as feedback, and the panel's ↻ button does the same.
Auto-refreshes every 5 seconds. Polling pauses while the tab is hidden and catches up on the first visible frame.
Draggable, snaps inside the viewport, remembers its position in localStorage, and follows the system light/dark theme.
Lives in a closed shadow root, outside the SPA's React tree, so it neither disturbs nor is disturbed by the app's styles.

Install

dsh plugin --profile web add dsh-plugin-balance-float

Then restart dsh web (see Why a restart below) and refresh the page.

Once installed it shows up in Settings → 插件 → 插件列表 → 全局插件 with an enable/disable control, alongside every other installed plugin.

Uninstall:

dsh plugin --profile web remove dsh-plugin-balance-float

Requirements

A DeepSeek API key on the machine, as the DEEPSEEK_API_KEY environment variable, or as refs.DEEPSEEK_API_KEY in $DSH_HOME/.credentials.yaml.
DeepSeek Harness >= 0.1.5-rc.2 (the profile bundle mechanism this package uses).

Why the balance is fetched on the host

Credential resolution order, per request (nothing is cached long-term):

the DEEPSEEK_API_KEY environment variable;
the Harness credential service, ctx.credentials.resolve('DEEPSEEK_API_KEY');
a direct read of $DSH_HOME/.credentials.yaml as a fallback.

The key never appears in any response.

Files

File	Role
`package.json`	Manifest: declares `dsh.bundle.patch`, which is what makes `dsh plugin` treat this package as a profile layer
`cordis.patch.yml`	The package's own profile layer: inserts `id: balance-float` / `name: dsh-plugin-balance-float`
`lib/index.js`	Host half: the `GET /x-balance-float` proxy route plus the index injection
`lib/client.js`	Browser half: the widget's DOM/CSS/drag/poll logic (injected inline)
`tools/verify-package.mjs`	Package-level verification (manifest, patch, route, injection, click-only interaction)

The host re-reads lib/client.js on every index render, so widget tweaks only need a page refresh — no reinstall, no dsh web restart.

Verify

node tools/verify-package.mjs

Known limitations

A restart is required after install. A running dsh composes its profile bundle list once, at boot; patchReload: live watches patch files, not package.json. So a host started before the install does not know about the new layer. Restarting dsh web is the fix.
Balance figures come from DeepSeek's own endpoint and are subject to its caching and reporting delay.
The widget shows the first currency DeepSeek reports; multi-currency accounts see one line for the primary entry.

License

MIT

Plugin Balance Float

兼容性与来源证明

版本

相关插件

Plugin Balance Float

README

dsh-plugin-balance-float

What it does

Install

Requirements

Why the balance is fetched on the host

Files

Verify

Known limitations

License

兼容性与来源证明

版本

相关插件

相关插件

相关插件

README

dsh-plugin-balance-float

What it does

Install

Requirements

Why the balance is fetched on the host

Files

Verify

Known limitations

License