How to install DeepSeek-Balance-Whale-Widget
Install command, configuration and the one gotcha — taken from MeteorNOX/DeepSeek-Balance-Whale-Widget's own README, not invented here.
Repo: MeteorNOX/DeepSeek-Balance-Whale-Widget · Stars: 5853 · Category: UI & Themes
Install
Copy from your project's README (source: upstream). The README gives 2 install paths — pick the one matching your setup.
# 1) 若是 zip:先解压到一个固定、以后不会移动或删除的目录(不要放临时目录/下载目录)
# 例:D:\Plugins\dsh-whale-widget
# 要安装的是「包含 package.json 的那一层」,不要多套一层同名目录
# 2) 确认关键文件都在(缺 assets/ 会导致没图、没声)
Test-Path "D:\Plugins\dsh-whale-widget\package.json",
"D:\Plugins\dsh-whale-widget\lib\index.js",
"D:\Plugins\dsh-whale-widget\assets\whale-widget.js"
# 3) 如果之前从 GitHub / npm 装过同名插件,先卸载避免版本冲突
dsh plugin --profile web remove dsh-whale-widget
# 4) 用绝对路径安装(路径含空格要加引号)
dsh plugin --profile web add link:D:\Plugins\dsh-whale-widget
dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget
After installing, restart the DSH session. A plugin that is installed but does not load is almost always a profile mismatch — see nine causes of "plugin installed but not loading".
Configuration
- insert:
- id: whale-balance-widget
name: ./whale-balance.mjs?v=1
[]
What it does
DeepSeek Harness(DSH)Web 界面右下角的常驻挂件:小鲸鱼气泡图 + DeepSeek API 余额 + 今日已用 + 每轮对话消耗,并且泡泡内容可以完全自定义(点击序列、模块化排版、并列加权出泡、随机语句/随机图片)。标准 DSH bundle 插件,dsh plugin 一键安装,无需任何会话令牌。
| DSH Web 界面右下角(就是这个 README 描述的插件) | main(默认分支) | dsh plugin --profile web add dsh-whale-widget(推荐,装 npm 已发布版);也可以从本仓库装 dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget,但那样装的是 main 当前状态、不跟随已发布版本 |
Caveats before you install
- The upstream README is written in Chinese. The commands below are verbatim; the surrounding explanation on this page is ours.
- The command above was copied on 2026-10-25. If it fails, the README is the authority, not this page.
- This site does not execute plugin code. Install commands are reproduced, not tested.