3D 鲸鱼桌宠 FaMuer/dsh-real-fish-pet

DSH-RealFish-Pet

在 DeepSeek Harness web 界面里游动的 3D 渲染鲸鱼桌面宠物（个人用插件）。

鲸鱼模型为原创 Blender 作品（受 DeepSeek 标志启发），所有动画帧由 Blender 头less 逐帧渲染，行为全部由本插件自定义实现（不依赖 dsh-pet 状态机）。

行为

- 默认状态：在屏幕右下 1/4 区域（52–84vw / 54–78vh）内随机连续游动，出界自动折返；鼠标悬停时原地冻结，移开后继续。
- attention（任务事件提示）：模型任务完成 / 出错 / 需要手动处理（批准请求）等事件触发跳跃 attention 动画 + 随机播放鲸吟 1/2/3.mp3（两次事件间隔 ≥6s 防轰炸；声音需先与页面有过一次交互才会自动播放）。
- 交互：
- 单击：停下游动 + 反应动画 + 气泡
- 双击：位置不变，直接恢复自由游动
- 拖拽：可拖到任意位置，松手后从新位置继续游动
- 右键菜单（宠物头上 ⋮）：开心一下 / 原地睡觉 / 回家睡觉（游到右下角 HOME 然后睡 5 分钟后自动醒来游动）/ 自由游动 / 隐藏宠物
- 隐藏后右下角出现「召唤宠物」按钮

结构

lib/index.js host 半：资源静态路由 + 事件队列 HTTP API（node:fs，无额外依赖） lib/client.js browser 半：ModuleLoader bundle（手写，无构建步骤） assets/ 帧图（idle/react/drag/swimL/swimR/turn）+ 鲸吟音效 cordis.patch.yml 一行插件行挂载

- 资源路由：/dsh-real-fish/assets/...（PNG/MP3，Cache-Control: public, max-age=86400）
- 事件 API：GET /dsh-real-fish/api/poll（client 每 2s 轮询）、/api/stats

安装（本地开发）

dsh plugin --profile web add link:
重启 dsh web 后宠物自动出现（无需手动运行插件）

发布

1. npm pack 产出 tarball（或直接推 GitHub 仓库）。
2. 发布到 npm registry（需 npm 账号）后即可被市场 / dsh plugin add 安装。

许可

- 代码与资产：CC-BY-4.0（详见 LICENSE）。
- 鲸鱼为原创模型二次创作（灵感来自 DeepSeek 标志），与 DeepSeek 官方无关联。