🐳 dsh-whale-aquarium
给 DSH（DeepSeek Harness）Web 界面养一缸鲸鱼。
一群 DSH 官方鲸鱼标志在你整个界面之上游动：鼠标靠近就加速躲开，点一下画面整群四散。图层完全穿透——不挡点击、不挡输入、不影响任何快捷键。
鲸鱼在界面里游动，鼠标靠近时鱼群四散
10 秒演示（100 帧）：安静巡游 → 鼠标逼近 → 整群四散。
非官方插件 · Unofficial plugin. 与 DeepSeek 无关联、未获其授权或背书。
Not affiliated with, authorized by, or endorsed by DeepSeek.
安装
一条命令，然后重启 DSH：
dsh plugin --profile web add github:tulipdkw/dsh-whale-aquarium
# 装完后重启 web profile（不是刷新浏览器页面）
dsh web
重启后：侧边栏底部出现鲸鱼标志按钮，界面上开始有鲸群游动。
其他安装方式 / 卸载 / 前置条件
从本地目录或 tarball（自己改了代码想试）
git clone https://github.com/tulipdkw/dsh-whale-aquarium && cd dsh-whale-aquarium
dsh plugin --profile web add file:$PWD
从前置条件说起：dsh plugin 是把参数转发给 pnpm 执行的，所以需要机器上有 pnpm：
npm i -g pnpm # 或 corepack enable pnpm
确认装上了
dsh plugin --profile web why dsh-whale-aquarium
dsh --profile web --dump-config | grep -n whale-aquarium
更新到新版本（从 GitHub 装的会重新解析到最新提交；改完一样要重启 profile）
dsh plugin --profile web update dsh-whale-aquarium
卸载（会把包和它的配置层一起撤掉）
dsh plugin --profile web remove dsh-whale-aquarium
浏览器里残留的设置可以顺手清掉：Console 执行 localStorage.removeItem('dsh-whale-aquarium/v1')。
使用
| 想做 | 在哪 |
|---|
| 一键开关水族箱 | 侧边栏底部的鲸鱼标志按钮（点击切换，开启时变主题色） |
| 调鲸鱼数量 / 体型 / 游速 / 透明度 | 设置 → Whale Aquarium |
| 调避险半径、气泡数量、气泡大小、混合模式、朝向 | 同上 |
| 逗鱼 | 鼠标靠近它们会躲；点一下画面整群四散 |
- 避险半径：鼠标进入这个距离内鲸鱼就开始逃，默认 150px。
- 混合模式：让鲸鱼与界面颜色做
mix-blend-mode，更融进背景，略耗性能，默认关。
- 朝向翻转：万一鲸鱼看着像在倒着游，点一下即可。
- 设置存在浏览器
localStorage，会记住（不写进 DSH 配置，也不跨浏览器同步）。
常见问题
装完没反应？
必须重启 profile（dsh web 关掉重开），不是刷新浏览器页面。浏览器半的代码是在 profile 启动时读入并缓存的。
鲸鱼浮在界面上面，不是真正的背景？
是的，这是 DSH 目前的限制，不是 bug。原因和取舍写在 docs/HOW-IT-WORKS.md。默认 45% 透明度就是为此调的。
觉得太吵？
设置里把透明度降到 25% 左右，或把数量调到 4–6 条，基本就只剩氛围了。
没有气泡？
先看 设置 → Whale Aquarium 里 Bubbles 是不是被关掉了（这个开关会持久化，v0.1.2 起气泡本身也做得明显多了）。
会不会拖慢界面？
一个全屏 canvas，每帧重画一群矢量鲸鱼（默认 10 条 ≈ 750 段贝塞尔）——canvas2d 的常规负载。嫌吵就降数量/透明度，或者开混合模式让它更融入背景。
兼容性
在 DSH 0.1.2-rc.1 + macOS 上验证；只对 web profile 有意义（它是浏览器端插件）。
它是怎么做的
一句话：一个 npm 包，宿主半是空的，全部逻辑在浏览器半——用 DSH 官方的鲸鱼标志路径（含官方那两套游动姿态）画在一个 shell.overlay 浮层的 canvas 上，只往三个增量插槽里注册，不替换任何出厂 UI。
技术细节（包结构、dsh.bundle / dsh.client 双面契约、插槽选择、性能取舍）在 docs/HOW-IT-WORKS.md；
测试与发布流程在 docs/MAINTAINING.md。
许可与致谢
MIT，见 LICENSE；不随主许可授予的事项（标志来源、非官方声明）见 NOTICE.md。
鲸鱼标志及其两套官方游动姿态来自 DeepSeek Harness 的开源客户端包（@deepseek-ai/dsh-client-ui-primitives、@deepseek-ai/dsh-client-ui-conversation，同为 MIT）。标志本身是 DeepSeek 的品牌资产，本项目按官方 BRAND_GUIDELINES.md 使用：项目名只用推荐的缩写 "DSH"、不冒用完整商标、并明确声明非官方。
版本历史见 CHANGELOG.md。
English
A whale aquarium for the DSH (DeepSeek Harness) web UI. A school of the official DSH whale mark swims over the whole frame, flees your cursor, and scatters when you click. The layer is fully click-through.
dsh plugin --profile web add github:tulipdkw/dsh-whale-aquarium
dsh web # restart the profile (a page reload is not enough)
Toggle it from the whale-mark button at the sidebar foot; tune it under Settings → Whale Aquarium (count, size, speed, opacity, shyness radius, bubbles, blend mode, facing). Settings persist in localStorage and are not written to DSH config.
It uses the official whale mark paths — including the two official swim poses DSH itself renders — on a single shell.overlay canvas, and registers only additive slots. No build step: lib/*.js is the shipped artifact.
Unofficial plugin, not affiliated with or endorsed by DeepSeek. MIT licensed.
