MeteorNOX/DeepSeek-Balance-Whale-Widget
A fixed-corner whale widget for the DSH web GUI — balance, today's usage and per-turn cost with peak/off-peak pricing, editable balance-alert and daily-budget bubbles, a module-based custom bubble queue with A/B weighted choices and random lines or images, 30+ vendor templates (OpenAI, OpenRouter, Kimi, SiliconFlow, Ark, Zhipu, MiniMax and more) with per-model balance and subscription quota, plus task-end sound, imported audio, custom roles and a resource manager. Local-only, no telemetry.
Install
via npm
Resolves a published tarball rather than cloning the repository, and installs without any extra setup. Swap `web` for your profile name if you run another one.
via GitHub · npm package
Installing from GitHub runs the project's build script, which pnpm blocks until you allowlist it — run the command once and pnpm prints the exact key to add under `allowBuilds` in ~/.dsh/profiles/web/pnpm-workspace.yaml.
The desktop app keeps its own profile, desktop, and only the dsh command it ships may change it — the npm-installed dsh refuses that profile. Install the command from the app menu (Manage dsh Command…), open Desktop once, quit it fully, run the line below, then reopen Desktop.
via npm
Resolves a published tarball rather than cloning the repository.
via GitHub · npm package
Installing from GitHub runs the project's build script, which pnpm blocks until you allowlist it — run the command once and pnpm prints the exact key to add under `allowBuilds` in ~/.dsh/profiles/desktop/pnpm-workspace.yaml.
Our install check ran in a web profile on npm's dsh, not in the desktop app.
What happened when we ran it
Installed cleanly when we ran it
Every command here is run in a throwaway container against a clean profile, and the result is whatever the harness recorded — not a guess from the source. Last run 6d agoon DeepSeek Harness 0.2.1-rc.5.
Show it in your README
For maintainers: the badge serves this listing's latest sandbox verdict, so a re-run updates it on its own — and it links readers to the full result here.
Due diligence
Security
No build script was blocked in our run.
Source: our sandbox install on DeepSeek Harness 0.2.1-rc.5, 6d ago.
package.json declares no preinstall, install or postinstall script.
Source: package.json on GitHub, read at our last sync. prepare is not recorded; it runs only on a GitHub install, and shows up under build scripts when pnpm blocks it.
shell commands (bash, exec, spawn …)
Source: a keyword match on the README — a hint about what the plugin touches, not an analysis of its code.
Not an audit. These are the record of one install and two text scans; nobody has read this plugin's code on your behalf. Plugins run with your agent's permissions.
What it is — It displays balance, today's usage and per-turn costs in the bottom right corner of the DeepSeek Harness web GUI.
Who it is for — If you need to track multiple vendors' model balance and consumption in the DeepSeek Harness web interface, it is suitable. If you use the official desktop client, it is not necessary.
Watch out — It was sandbox tested successfully in a new profile and registered by harness. No obvious issues found.
The verdict — I would install it because it supports custom bubble content and multiple vendor templates without telemetry.
Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.
DeepSeek-Balance-Whale-Widget is a DeepSeek Harness plugin that adds a fixed-corner whale widget to the web interface for balances, usage and per-turn cost tracking. DeepSeek Harness loads it as a standard bundle plugin. It listens to local session events for model usage, including input, cache, output and reasoning tokens, then calculates estimated costs using the configured model pricing. DeepSeek-Balance-Whale-Widget reads DEEPSEEK_API_KEY from DeepSeek Harness credentials, or uses a logged-in DeepSeek account when no key is configured. Balance observations and usage records are stored locally; older records are archived in .dshw-usage-archive.json. The README states that the plugin sends no telemetry.
The widget supports editable balance and daily-budget alerts, custom bubble queues with weighted A/B choices, random text or images, imported audio, custom whale images and vendor-specific balance or subscription quota checks. It includes templates for vendors such as OpenRouter, Kimi, OpenAI, SiliconFlow and MiniMax, while providers without a balance endpoint use key probing and local session estimates.
This suits developers who want account and model-cost information visible in DeepSeek Harness Web. It is a poor fit for the Codex desktop application, which uses a separate repository, and the package has separate installation constraints for the official Electron client. The listed terminal-surface risk should be reviewed before installation; the supplied README does not specify which terminal operation causes that flag.
DeepSeek Harness supplies credentials through its official credential service. For the built-in DeepSeek entry, the plugin first looks for DEEPSEEK_API_KEY; without that key, it can use the DeepSeek account logged in through the DeepSeek Harness account settings. Configuration stores credential names rather than secret values. The README does not name the main configuration file.
The widget can be configured from its menus for:
Usage records retain per-turn details for 90 days or 20,000 entries, and daily archives for 365 days. Older data is moved to .dshw-usage-archive.json.
DeepSeek Harness installs the web package under the web profile. The package name is dsh-whale-widget. The README documents installation through the dsh plugin command, but this page does not repeat that command. A GitHub source installation uses github:MeteorNOX/DeepSeek-Balance-Whale-Widget; the README warns against installing both forms because they can coexist and conflict.
The plugin listens for DeepSeek Harness local session events. It uses actual token usage where available and observes balance changes for providers with balance endpoints. Quota templates can read provider windows, while providers without such endpoints show — and estimate daily usage from session events.
The templates cover 34 entries, including DeepSeek, OpenRouter, Kimi, StepFun, OpenAI-compatible services, OpenAI, Anthropic, Google Gemini, Ark, SiliconFlow, MiniMax, local Ollama or LM Studio models and others. Custom HTTP entries require the URL and field paths to be supplied manually.
The web plugin is not compatible with the Codex desktop application. The same package may support the official Electron client, but the README says not to install it with the web profile there. No minimum DeepSeek Harness version is specified in the supplied documentation.
Written from the project's own documentation and kept in sync with it. Where the two disagree, the source is authoritative — read the README on GitHub
Same category
zhu1090093659
Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.
No one-line install — this plugin lives inside a larger repository and publishes no npm package.
zhu1090093659
Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.
Installed cleanly when we ran it
zhu1090093659
Task board for the dsh web GUI: a sidebar multi-column kanban whose cards run in real DSH agent sessions and can also be scheduled with cron expressions, executed host-side even with the browser closed.
Installed cleanly when we ran it
ccch1mneyyy
Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.
DeepSeek Harness 0.2.1-rc.5 refuses the latest release
omdsh-dev
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
Installed cleanly when we ran it
