悬浮鲸鱼助手 OnlyAPI/dsh-client-ui-sedentary-whale

悬浮小鲸鱼（Floating Whale Plugin）

一只悬浮在 DSH Web 页面上的小鲸鱼：轻量、灵动的桌面萌宠，支持一键实时查询 DeepSeek 账户余额与丰富的点击互动。

界面示例

为什么去掉久坐提醒？

在实际长时间编码和日常开发场景中：
1. 打断心流：久坐提醒的弹窗与计时胶囊经常在深度编码的关键时刻打断思路，带来额外的视觉干扰和疲倦感。
2. 实际用处有限：弹窗提醒容易被顺手关闭或忽略，反而增加了插件的状态复杂度与代码包体积。
3. 回归核心刚需：开发者真正高频、关心的是随时掌握 DeepSeek API 余额，以及写代码累了时戳一戳桌面萌宠解压。

因此在 v0.3.0 中，我们做减法，全面剥离所有臃肿的计时状态机、倒计时胶囊与设置项统计，让小鲸鱼彻底回归为轻量、专注、响应即时的余额助手 & 桌面萌宠！

功能特点

- DeepSeek 余额查询：右键打开面板或双击小鲸鱼即可实时查询/刷新账户余额（每次打开面板都会重新查询）。自动使用 DSH 已配置的 DEEPSEEK_API_KEY 凭据（~/.dsh/.credentials.yaml），Key 不写进前端代码、不进请求体、也不存浏览器。面板在余额下方展示 今日消耗（当天首次查询的余额作为基准，之后用基准减去最新余额；跨天重置，充值后自动校准基准）。打开后约 3 秒自动收起，鼠标停在面板上时会暂缓关闭。
- 取消 5 秒人工限制：官方 DeepSeek 接口对余额查询并不设单次硬性时间间隔限制，现已彻底解除插件内置的 5 秒人工冷却，刷新即点即查、毫秒级响应。
- 趣味点击互动：
- 拖动：自由拖动到屏幕任意位置，位置自动持久化记忆。
- 单击：小鲸鱼头顶冒出可爱的互动文案气泡（约 2.5 秒后自然消散）。
- 双击：小鲸鱼扎猛子跃出水面，同时快捷刷新并展示 DeepSeek 余额。
- 右键：打开/关闭精致小巧的余额卡片面板，支持查看余额与手动点击 ↻ 刷新。
- 灵动动效：起伏游动、白光掠过、偶尔冒气泡；水面波浪随主题波动，单击荡漾涟漪，双击扎水水花。系统开启「减少动态效果」时循环动效自动停用。
- 外观与主题适配：跟随宿主 body[data-ds-dark-theme] 自动无缝切换深浅色；也可在「设置 → 通用 → 悬浮鲸鱼」中自由指定颜色（跟随主题 / 黑 / 白 / 蓝）或随时开启/隐藏小鲸鱼。

交互一览

| 操作 | 效果 |
| 拖动鲸鱼 | 移动位置（位置自动保存） |
| 左键单击鲸鱼 | 冒出趣味互动气泡 |
| 左键双击鲸鱼 | 扎水动效 + 快捷刷新/打开余额面板（约 3 秒后自动收起） |
| 右键单击鲸鱼 | 打开 / 关闭「DeepSeek 余额」面板（每次打开都会刷新余额和今日消耗；约 3 秒后自动收起；悬停面板可暂缓） |
| 余额面板 ↻ | 手动刷新 DeepSeek 余额（无冷却，即点即查；同时更新今日消耗） |
| 点击页面空白处 | 自动关闭余额面板 |
| 设置 → 通用 → 悬浮鲸鱼 | 显示 / 隐藏小鲸鱼、切换小鲸鱼颜色（黑/白/蓝/跟随主题） |

余额查询与安全

- 面板中点击 ↻ 或双击鲸鱼即发起查询；自动通过宿主 Host 代理读取已配置的 DEEPSEEK_API_KEY。
- Host 端只接受页面本身的同源 fetch（Sec-Fetch-Site: same-origin 或 Origin 与 Host 完全一致）；跨域或外部 curl 等脚本请求均被拒绝。
- 官方 DeepSeek API 对账户主要采用高并发限额机制，针对 /user/balance 轻量端点无短时间单次调用间隔限制；插件移除了旧版 5 秒人工限流，刷新更跟手流畅。
- 优先采用进程内 fetch 请求 DeepSeek 官方接口；缺失环境时回退至 stdin 输入流，API Key 绝不在系统进程列表命令行中泄露。

安装

已发布到 npm（@yifanfff/dsh-client-ui-sedentary-whale）
dsh plugin --profile web add @yifanfff/dsh-client-ui-sedentary-whale

或从 GitHub 源码安装（按 tag 锁定版本，源码即运行代码，可完整审计）
dsh plugin --profile web add github:OnlyAPI/dsh-client-ui-sedentary-whale#v0.3.0

本地开发（源码目录以符号链接安装，修改代码实时生效）
dsh plugin --profile web add link:D:/DevApps/AI-Ide/DeepSeek-harness/deepseek-plugins/sedentary-whale

重启 dsh web 后生效：页面右下角出现悬浮小鲸鱼

- 包清单声明了 dsh.bundle.patch（cordis.patch.yml 插入插件行）与 dsh.client（web 平台、注入 runtime/layout），是官方 bundle 插件形态。
- 移除：dsh plugin --profile web remove @yifanfff/dsh-client-ui-sedentary-whale。

更新记录

v0.3.0

- 重构定位：彻底移除全部久坐提醒、专注/休息计时、倒计时胶囊与统计看板，全面减负。
- 取消 5 秒限制：移除旧版 5 秒查询冷却机制，点击即查，响应更加流畅跟手。
- 余额卡片：右键面板精简为纯粹优雅的 DeepSeek 余额卡片，加载、金额与错误提示清晰直观。
- 今日消耗：余额下方轻量展示当天消耗（本地记录当日首次余额为基准，跨天重置，充值自动校准）。
- 自动收起：余额面板打开约 3 秒后自动隐藏；鼠标停在面板上时暂缓关闭。每次打开都会重新查询余额与今日消耗。
- 双击交互：双击鲸鱼触发扎水动效并快捷刷新/展开余额面板。
- 性能与体积：彻底剥离时钟算法与 session 频繁读写，代码量大幅缩减，运行更加轻盈。

v0.2.3

- 余额查询优化：同源安全校验、Key 保护。
- 鲸鱼交互与外观动效增强。