DSH Web 界面右下角的常驻挂件：小鲸鱼气泡图 + DeepSeek API 余额 + 今日已用 + 每轮对话消耗。这是基于 MeteorNOX/DeepSeek-Balance-Whale-Widget 修改的铁盆鲸鱼娘版，整合了原版的桌面端适配、安全边界与记账内核，增加了顶碗/拿碗两套形象与钢管音效组。
安装与启用¶
使用官方 CLI 安装：
dsh plugin --profile web add dsh-whale-widget-bowl
或通过 GitHub 安装：
dsh plugin --profile web add github:Witherwithwinter/DeepSeek-Balance-Whale-Widget-Bowl
核心功能¶
余额与记账¶
挂件每 60 秒自动刷新余额，也可点击手动刷新。余额变化时伴随滚动动画，网络抖动时自动沿用最近余额。内置“小鲸鱼记账”功能，观测余额下降为消费，余额上升单独记录，支持在“小鲸鱼记账 -> DeepSeek（内置）-> 设置 -> 余额校正”中进行校正。数据按 90 天或 2 万条归档。
支持峰谷定价，工作日高峰时段（9:00-12:00, 14:00-18:00）与周末谷价。
自定义泡泡系统¶
泡泡内容可完全自定义，支持点击序列、模块化排版、随机语句/图片。模块包括文本、超链接、随机语句、图片/动图、总余额、赠金、充值余额、今日已用、峰谷时段、对话名等。支持拖拽排版，每行最多 6 个模块，泡泡最多 6 行。样式支持字体、字号、加粗/斜体、纯色或跑马灯渐变。
交互功能¶
支持拖拽吸附（可自定义四边或角落吸附区）、贴左时的水平镜像翻转、按压 Q 弹效果。提供隐藏菜单按钮（电脑端右键、手机端长按约 1.5 秒唤出）。
音效与提示¶
内置三套音效组（小黄鸭、音效1、钢管），每套有独立音量控制。支持自定义音频片段。可配置每轮对话消耗提示（监听 usage，自动关闭秒数，自定义内容），以及等待交互音效（提问、授权）。
多厂商自定义 API¶
内置 34 个厂商模板，支持添加任意厂商。密钥不落配置文件，写入 DSH 官方凭据服务。支持余额查询与额度统计（订阅资源包）。硅基流动余额接口已于 2026-08-14 停止服务。
注意事项¶
- 路由冲突：本插件与上游
dsh-whale-widget不能共存，路由前缀均为/dsh-whale/。 - 密钥管理：密钥需写入 DSH 官方凭据服务，配置文件中仅存储凭据名。
- 安装方式：npm 包名与 GitHub 链接二选一，不要混用。
生态背景¶
DeepSeek Harness（DSH）采用“一切皆插件”的理念，社区目录与 DeepSeek / 幻方无官方从属关系。
