A permanent widget in the bottom-right corner of the DSH Web interface: little whale bubble graphic + DeepSeek API balance + today’s usage + per-round conversation consumption. This is the Iron Basin Whale Girl edition, modified from MeteorNOX/DeepSeek-Balance-Whale-Widget. It integrates the original version’s desktop compatibility, security boundaries, and accounting core, and adds two character designs—bowl-balancing / bowl-holding—and a steel-pipe sound-effect set.

Installation and Enablement

Install using the official CLI:

dsh plugin --profile web add dsh-whale-widget-bowl

Or install via GitHub:

dsh plugin --profile web add github:Witherwithwinter/DeepSeek-Balance-Whale-Widget-Bowl

Core Features

Balance and Bookkeeping

The widget automatically refreshes the balance every 60 seconds; you can also click to refresh manually. Balance changes are accompanied by a rolling animation; during network jitter, it automatically keeps the most recent balance. The built-in “Little Whale Bookkeeping” feature records a balance decrease as consumption, while a balance increase is logged separately. You can adjust it under “Little Whale Bookkeeping -> DeepSeek (built-in) -> Settings -> Balance Correction”. Data is archived every 90 days or after 20,000 entries.

Supports peak/off-peak pricing, with weekday peak hours (9:00-12:00, 14:00-18:00) and weekend off-peak rates.

Custom Bubble System

Bubble content is fully customizable, supporting click sequences, modular layout, and random phrases/images. Modules include text, hyperlinks, random phrases, images/animated images, total balance, bonus credits, recharged balance, today’s usage, peak/off-peak time, conversation name, etc. Drag-and-drop layout is supported, with up to 6 modules per line and up to 6 lines per bubble. Styling supports font, font size, bold/italic, solid color, or marquee gradient.

Interaction Features

Supports drag snapping (customizable snapping zones on sides or corners), horizontal mirror flip when aligned to the left edge, and a bouncy press effect. Provides a hidden menu button (right-click on desktop, long-press for about 1.5 seconds on mobile to invoke).

Sound Effects and Prompts

Includes three built-in sound-effect sets (Little Yellow Duck, Sound 1, Steel Pipe), each with independent volume control. Supports custom audio clips. Configurable per-round consumption prompts (monitors usage, automatic dismissal after a set number of seconds, customizable content), as well as waiting interaction sound effects (question, authorization).

Multi-Vendor Custom API

Includes 34 vendor templates and supports adding any vendor. Secrets are not stored in configuration files; they are written to DSH’s official credential service. Supports balance queries and quota statistics (subscription resource packs). The SiliconFlow balance interface has been discontinued as of 2026-08-14.

Notes

  • Route Conflict: This plugin cannot coexist with the upstream dsh-whale-widget; both use the route prefix /dsh-whale/.
  • Key Management: Secrets must be written to DSH’s official credential service; only the credential name is stored in configuration files.
  • Installation Method: Choose either the npm package name or the GitHub link; do not mix them.

Ecosystem Background

DeepSeek Harness (DSH) follows the “everything is a plugin” philosophy. The community catalog has no official affiliation with DeepSeek / Huanfang.