前言¶
在 DeepSeek Harness (DSH) 或 Claude Code 等开发环境中，长时间运行任务时往往缺乏视觉反馈。鲸鱼娘桌宠提供了一个陪伴方案：她不仅出现在桌面上，还能根据开发者的行为（如发消息、模型干活、轮次结束）做出相应反应。
这是什么¶
这是一个开源的桌宠项目，由 wei125775-lab 维护，代码使用 MIT 许可证。插件支持两个主要平台版本：dsh（DshDesktop） 和 Claude Code（PetPet 框架）。
核心特点是角色的所有动作素材由 AI 视频生成，待机动画则通过分层 PSD 烘焙程序化生成，而非简单的帧动画。
核心功能¶
-
双平台支持
- dsh 版本：适配 DshDesktop，使用frames2d格式。
- Claude Code 版本：适配 PetPet 框架。
- WorkBuddy 版本：提供钩子插件，适配腾讯的 WorkBuddy 工作台。 -
待机表现
- 由分层 PSD 烘焙生成，包含呼吸、飘发和眨眼效果，动作幅度较小，避免 AI 视频常见的抽帧抖动。 -
交互动作
- 吃饭与收碗：发消息或模型干活时捧碗吃，一轮结束后收碗。
- 打断反应：按 Esc 键打断当前动作时，会立刻停止并甩出“屑表情”。
- 点击反馈：点击角色会触发挥手或比心。
- 起子代理：在起子代理（Subagent）运行时，脚边会游出小海豚并绕圈。 -
素材来源
- 所有角色素材均由 AI 生成。
安装与启用¶
根据你使用的环境选择对应的安装方式。
dsh 版本¶
在项目根目录执行安装脚本。脚本会自动处理依赖，包括检测并安装 @linxin666/dsh-pet 渲染器（如果需要）。
node install.mjs
Claude Code 版本¶
进入 claude 目录执行安装脚本。
cd claude
node install.mjs
绿色版（Windows）¶
直接下载 Releases 中的绿色压缩包（如 whalegirl-petpet-win-x64.zip），解压后双击 启动.cmd 启动。
WorkBuddy 版本¶
下载 whalegirl-workbuddy-win-x64.zip，先运行 启动.cmd 启动桌宠本体，再运行 装WorkBuddy钩子.cmd，最后完全退出并重启 WorkBuddy。
典型用法¶
- 工作状态：当你发消息或模型开始处理任务时，她端着碗吃饭。
- 轮次结束：一轮任务完成后，她收起碗，可能进入托腮、双手合十或待机状态。
- 紧急打断：在任务中途按下 Esc，她会停下手中的动作并给你一个“屑表情”。
- 点击互动：直接点击桌面上的她，会触发挥手或比心动作。
- 特殊事件：当起子代理介入时，她脚边会出现小海豚游动。
注意事项¶
- Windows 安全提示：双击解压后的
.cmd文件时，Windows 可能会弹出“已保护你的电脑”提示。这是因为浏览器下载的 zip 标记为“来自 Internet”。点“更多信息”后选择“仍要运行”即可解决，文件本身未损坏。 - 包体积：绿色版包含完整的 Electron 运行时，包体积较大（约 200MB）。
- 平台条款：所有素材均由 AI 生成，使用前需确认相关平台的服务条款。
- 依赖与版本：
- dsh 版本依赖dsh >=0.1.5-rc.1或@linxin666/dsh-pet。
- 渲染器版本必须与目标 dsh profile 的版本对应，否则可能导致显示异常或安装失败。 - MIT 代码：代码部分采用 MIT 协议开源。
总结¶
鲸鱼娘桌宠通过 AI 生成的素材和程序化烘焙的待机动画，为 DSH 和 Claude Code 用户提供了具备交互性的桌面反馈。安装过程相对简单，但需注意 Windows 系统的安全提示及不同平台的渲染器版本兼容性。
