seek://map/meteornox-deepseek-balance-whale-widget
DSH Balance Whale Widget
#balance #usage #widget #community
TL;DR
A persistent bottom-right widget for the DSH Web UI that surfaces the live DeepSeek API balance, today's spend, and per-turn usage. Ships as a standard DSH bundle plugin (the package.json declares dsh.bundle) so it installs into a profile via dsh plugin like any other plugin — no manual cordis.patch.yml edits.
A bottom-right balance and usage tracker for the DSH Web UI. It refreshes the live DeepSeek API balance on a 60-second cycle, reconciles today’s spend, and pops a per-turn cost bubble read from the session’s own usage events rather than inferred from balance drops. The package declares a standard dsh.bundle manifest, so it installs into a profile via dsh plugin like any other DSH plugin.
Facts
- install
- dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget
- license
- MIT
- note
- 实时余额需要 DEEPSEEK_API_KEY；每轮消耗无需额外凭据
Key points
- Ships as a standard DSH bundle: package.json declares `dsh.bundle: { patch: "./cordis.patch.yml" }`, matching the bundle manifest shape documented in the upstream CLI reference
- Auto-refreshes the live balance on a 60-second timer; brief network failures reuse the last known value rather than surfacing errors
- Two daily-usage modes: a token-free bookkeeping mode that reconciles today's spend from observed balance deltas, and an opt-in real-time mode that calls DeepSeek's platform usage endpoint and prices by a built-in peak/off-peak schedule
- Per-turn usage is read from the live session's own usage events — not estimated from balance drops — and pops a small bubble after each turn completes
- Anchor edges snap on all four sides; left-anchor mirrors the layout horizontally. The widget is bundled with optional PNG / GIF / MP3 assets and degrades silently when any of them are absent
- MIT licensed; live repo metadata is mirrored in src/data/github.json and surfaced by the stats widget, so the entry itself deliberately cites no point-in-time numbers
FAQ
How is this different from dsh-pet?
dsh-pet is a decorative companion without a backing purpose; this widget's whale is the visual layer for a balance / usage tracker. The two can coexist on the same DSH Web profile — they live in different bundles and different UI corners.
Do I need any token to install it?
Per the README, the bundle installs as a normal DSH plugin via `dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget` (or the local link variant). The widget will run, but the live balance readout needs `DEEPSEEK_API_KEY` in the credential store; the per-turn usage popup does not need any extra credential.
How does today's spend get calculated?
There are two paths. The default bookkeeping mode reconciles today's spend from observed balance deltas and resets at day boundaries — no extra token. The opt-in real-time mode reads DeepSeek's platform usage endpoint with `DEEPSEEK_PLATFORM_TOKEN` and applies a built-in peak/off-peak price schedule (weekday peaks 09:00-12:00 and 14:00-18:00; weekends off-peak) so the figure is exact rather than inferred.
Why a whitelist of plugins for per-turn cost?
Per-turn cost uses the live session's own usage events, not balance drops, so it stays accurate even when the DSH process was offline during a turn — a balance-delta approach would miss that spend entirely.
Official references