DeepSeek-Balance-Whale-Widget

它是做什么的

DSH 界面右下角的一只小鲸鱼，气泡里显示你的 API 余额、今天花了多少、每轮对话消耗多少。属于「看着安心」类的小挂件，但功能比想象中多。

特点

• 显示余额、今日已用、每轮消耗，并区分峰谷价
• 气泡内容可完全自定义：点击顺序、模块排版、随机台词、随机图片，还能做并列加权的 A/B 展示
• 内置 30 多家厂商的模板（OpenAI、OpenRouter、Kimi、硅基流动、方舟、智谱、MiniMax 等），按模型查余额和订阅额度
• 支持余额预警和今日预算
• 有任务结束音效，可导入自定义音频

什么任务适合用它

• 经常用 API，想随时知道花了多少钱
• 同时用多家模型服务，想在一个地方看余额
• 喜欢桌面挂件、愿意花点时间调外观

使用建议

• 从 npm 装已发布版：`dsh plugin --profile web add dsh-whale-widget`，不要从仓库装，那拿到的是未发布的中间状态
• 如果你用的是官方桌面客户端（Electron），**不能**用 `--profile web`，要在桌面端会话里让 DSH 自己装
• 只需要看余额的话，把随机台词、随机图片这些关掉，界面会清爽很多

注意事项

• 安全红线：它能读凭据又能联网——查余额确实需要读 Key，但同一个权限也能把 Key 发出去
• 19 万下载量很高，但下载量不等于安全审计
• 已有 Codex 版本迁到了别的仓库，照着旧教程装可能装错

它声明需要的权限

标红的能力属于高影响权限（读凭据、运行动态代码、执行命令等），装前请确认这个插件值得信任。

下载与安装

npm 包 `dsh-whale-widget`，当前版本 0.4.2。

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

dsh plugin --profile web add "https://registry.npmmirror.com/dsh-whale-widget/-/dsh-whale-widget-0.4.2.tgz"

以上链接均逐个实测可访问。「直连可用」= 不开代理也能下载；「需代理」= 你的网络需要已开启代理。

使用说明

查看完整使用说明（中文）→ · GitHub 仓库 ↗

中文版由官方 README 翻译整理，保留原结构与命令，专有名词附英文原文。

查证来源

本文依据该仓库 README 与插件目录声明整理。

打开 GitHub 仓库 ↗