dsh-whale-pet —— 鲸鱼娘桌宠

为 DeepSeek Harness Web GUI 打造的右下角看板娘插件。

一只鲸鱼娘会待在 Web 界面右下角，根据 Agent 当前的工作状态做出不同动作：

Agent 状态	鲸鱼娘动作	立绘
running = true（工作中）	抱起笔记本陪你干活，带淡蓝光晕	running
pendingInteraction（等你答复）	歪头等你	waiting
任务刚完成	庆祝 + 随机播一句「晓伊」鲸鱼娘语音	celebrate
completed（未打开前）	完成啦	success
空闲	安静待机、轻轻漂浮	idle-cute

• 立绘素材取自 DeepSeek 社区开源项目 dsh-whale-musume（MIT License），不自行重新设计形象。
• 语音素材（二次元鲸鱼娘「晓伊」神经网络音色，49 条台词中的 welcome/celebrate/coquetry 片段）取自 DeepSeek 社区项目 aceice01/dsh-whale-pet（非商业使用许可，见 NOTICE）。

特性

• 官方 shell.overlay 槽位注入（React 组件，走 useSessions 全局标准 hook），零侵入、不改业务 DOM。
• 状态机：working / waiting / completed / celebrate / idle，随 Agent 运行状态实时切换。
• 任务完成边沿检测：只播一次庆祝语音，不重复轰炸（10 句随机）。
• 首次出现会用「晓伊」语音打招呼；点击鲸鱼娘随机撒娇语音。
• 可拖拽；右上角小喇叭可静音/取消静音。
• 全部资源本地加载（宿主静态路由），无外部请求、无遥测。
• 尊重 prefers-reduced-motion，减少动效。

目录结构

dsh-whale-pet/
├── package.json        # dsh.bundle + dsh.client 双面声明
├── cordis.patch.yml    # bundle patch：insert 宿主行
├── lib/
│   ├── index.js        # 宿主半边：注册 /api/dsh-whale-pet/assets 静态资源路由
│   └── client.js       # 浏览器半边：shell.overlay 桌宠组件
├── assets/             # 鲸鱼娘立绘 (webp) + 鲸鱼娘语音 (mp3)
├── NOTICE              # 素材来源与授权
└── README.md

安装

1. 把本目录安装为 profile 的树外插件（复制到 $DSH_HOME/profiles/node_modules/dsh-whale-pet/）。
2. 在 profile 的 package.json 的 dsh.profile.bundles 末尾追加 "dsh-whale-pet"。
3. 重启 dsh web（插件集变化需重启生效），刷新页面即可在右下角看到鲸鱼娘。

示例（dsh web profile）：

{
  "name": "dsh-profile-web",
  "private": true,
  "dependencies": {},
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-whale-pet"
      ]
    }
  }
}

二次开发

• 换动作/立绘：改 lib/client.js 里的 IMAGES 与 deriveState。
• 换语音：替换 assets/voice-*.mp3（庆祝 10 句、撒娇 3 句、问候 1 句）。
• 换文案：改 LABELS。

License

本插件代码 MIT；鲸鱼娘立绘来自 dsh-whale-musume（MIT），鲸鱼娘语音来自 aceice01/dsh-whale-pet（非商业使用许可，仅本地非商业演示）。详见 NOTICE。