小鲸鱼动画插件 Lsc-Cyber/dsh-whale

🐋 dsh-whale — 会游泳会喷水的小鲸鱼（DeepSeek Harness 动态 Cordis 插件）

一个为 DeepSeek Harness 打造的动态 Cordis 插件（纯 Client）：在聊天输入框上方注入一只与页面 LOGO 逐像素同款的小鲸鱼。它会优雅地来回游动、随机起伏，左键点击喷水，右键打开菜单开关游泳——全程纯 CSS 动画，零定时器、零 DOM 侵入，卸载即彻底清理。

✨ 功能一览

| 交互 | 效果 |
| 观察 | 14s 一个来回的游动，横跨输入框上方约 76% 宽度；到墙边减速、压扁翻转、掉头，头永远朝前进方向 |
| 游动中 | 叠加 9s 不规则起伏（高度/俯仰角随机错开），模拟真实游泳姿态 |
| 悬停 | 停下等你，放大、歪头、变主题色 |
| 左键 | 喷水（水柱 + 7 颗水珠，受"重力"回落渐隐），鲸鱼欢快跳跃 |
| 右键 | 弹出小菜单：✓ 游泳（开关）、喷水（快捷触发） |
| 切换模式 | 淡出 → 隐形切换 → 淡入 的优雅过渡，无瞬间跳变 |
| 静止模式 | 关掉游泳后鲸鱼静立居中，但左键喷水 + 跳跃依然有反应 |
| 无障碍 | 跟随系统"减少动态效果"设置自动停用动画；支持键盘触发（焦点 + 菜单键） |

🚀 快速开始（动态插件方式）

前提：DSH Web 界面已启动（本插件为 Client 端，无需任何 Host 代码、无需改配置）。

1. 在 DSH 会话中，把 plugin/client.js 的文件内容整体作为 code.client 传入 cordis_define：

cordis_define
plugin.kind = new
plugin.idPrefix = whale
code.client =

2. 用返回的 pluginId / packageId 调用 cordis_run（首次运行 mode = run）。

3. 浏览器弹出运行审批，点允许。搞定 🎉

4. 想改代码后升级：cordis_define 用 plugin.kind = existing + 原 pluginId 追加新包，然后 cordis_run 用 mode = update 切换（旧版本存档，可随时回滚）。

🛠️ 技术实现

- 纯 Client：无 Host 半区，无网络请求，无持久化。
- 插槽：注册在 conversation.input.dock（输入框正上方的整行插槽，id: 'whale'，加法式、不替换任何现有单元格）。
- 动画：全部 CSS @keyframes（styles.insert 注入，随运行自动清理）——
- 水平游动：绝对定位层 translateX（百分比按泳道宽度解析，窗口多宽游多宽）；
- 掉头朝向：同步 scaleX 关键帧（LOGO 原生头朝左，向右游时镜像）；
- 随机起伏：多关键帧不规则曲线模拟；
- 喷水/跳跃：水珠用 CSS 变量（--dx/--rise/--fall/--delay）做粒子动画。
- 时序：切换/喷水的复位全部用 animationend 事件驱动，不用 setTimeout。
- 不碰产品 DOM：不查询、不修改任何产品内部元素（LOGO 本体是外壳固定组件，无法直接动画，本插件是"同款鲸鱼"）。

⚙️ 参数速查（想定制就改这些）

| 想要的效果 | 改哪里 |
| 游动更快/更慢 | plugin/client.js 中 dsh-whale-swim / dsh-whale-face 的 14s |
| 游动幅度 | dsh-whale-swim 的 ±38% |
| 鲸鱼大小 | 组件里 |
| 起伏更明显 | dsh-whale-bob 的 translateY 数值 |
| 喷水更高/水珠更多 | DROPS 数组 + dsh-whale-drop 的 --rise |
| 切换过渡时长 | dsh-whale-fade-out/in 的 .35s |

📦 版本历史

| 版本 | 内容 |
| v1 | 原地漂浮 + 点击喷水 |
| v2 | 来回游动 + 随机起伏 |
| v3 | 修复游动朝向（消除"太空步"） |
| v4 | 恢复优雅转向动画 + 右键菜单开关游泳 |
| v5 | 修复静止模式喷水无反应 |
| v6 | 模式切换加入淡出/淡入过渡（当前） |

⚠️ 已知说明

- 新会话空状态页（hero 屏）的标题行里还有一只外壳自带的静态鲸鱼（产品外壳固定组件，无法被插件操作）；本插件的动感鲸鱼出现在输入框正上方。开始对话后，原版消失，只剩本插件的鲸鱼。
- 需要 DSH 版本支持动态 Cordis 插件（Client 侧插槽注入）。

📄 License

MIT © Lsc-Cyber