DeepSeek-Balance-Whale-Widget

DeepSeek Harness(DSH)一只住在 DSH 界面右下角的小鲸鱼娘,帮你盯着DeepSeek账户余额。QQ弹弹,支持拖拽吸附、左吸附翻转、数字滚动动画,随界面自动启用,建议直接喊来

What is DeepSeek-Balance-Whale-Widget?

DeepSeek Harness(DSH)一只住在 DSH 界面右下角的小鲸鱼娘,帮你盯着DeepSeek账户余额。QQ弹弹,支持拖拽吸附、左吸附翻转、数字滚动动画,随界面自动启用,建议直接喊来你的dsh安装

Overview of DeepSeek-Balance-Whale-Widget

What it is

DeepSeek Balance Whale Widget is a plugin for DeepSeek Harness (DSH) that lives in the bottom-right corner of the DSH web interface. It displays your DeepSeek account balance, today's usage, and per-session cost in a cute whale bubble. It is a standard DSH bundle plugin, installable via dsh plugin with no session token required. The widget supports drag-and-drop, edge snapping, mirror flip on left snap, and number scrolling animations. It automatically activates when DSH web interface opens.

Key features

  • Balance monitoring: Auto-refreshes every 60 seconds; manual refresh on click. Supports two data sources: DEEPSEEK_API_KEY or DSH account login (no need to create a platform key). Shows total balance (recharge + bonus), bonus, and recharge separately.
  • Today's usage tracking: Tracks consumption by observing balance decreases. Records balance increases separately (recharge/gift) without overwriting consumption. Provides a correction mechanism for balance adjustments.
  • Per-session cost display: Listens to DSH session events and calculates cost based on actual token usage (input/cache/output/reasoning). Shows a bubble after each session end; content is customizable.
  • Interactive bubble system: Click sequence with first-click bubble and subsequent queue. Supports modular content: text, hyperlinks, random sentences, images, random images, and built-in values (balance, today's usage, peak/valley status). Each module has individual styling (font, size, color, gradient, background).
  • Drag & snap: Draggable with edge snapping (customizable snap zones). Left snap triggers horizontal mirror flip. Press-and-hold Q-elastic effect.
  • Alerts: Balance warning when below threshold, daily budget alert, per-session cost notification. All with customizable content and auto-close timer.
  • Sound effects & roles: Built-in sound presets (rubber duck, etc.) and custom sound groups. Task-end sound, prompt sound, authorization sound. Role images and animations.

Use cases

  • Monitoring DeepSeek API balance and usage in real-time within the DSH interface.
  • Tracking daily API consumption and setting budget alerts.
  • Viewing per-session cost breakdown for cost management.
  • Customizing the display and interaction to personal preference.

Getting started

Install via DSH plugin command: dsh plugin --profile web add dsh-whale-widget For the official desktop client, let DSH install it automatically (see repository README for details).

License and pricing

Licensed under MIT. Open source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/meteornoxdeepseek-balance-whale-widget.svg)](https://yunodb.com/tools/meteornoxdeepseek-balance-whale-widget?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/meteornoxdeepseek-balance-whale-widget?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/meteornoxdeepseek-balance-whale-widget.svg" alt="Featured on YunoDB" height="20"></a>