Whalegirl Deskpet — Development skill for Claude Code

鲸鱼娘桌宠


一只会跟着你干活的鲸鱼娘桌宠，同一个角色的两个平台版本：**Claude Code（PetPet 桌宠）** 和 **dsh（DshDesktop）**。

她不是那种只会原地晃两下的桌宠 —— 你发消息她捧着碗一口一口吃，这一轮干完她收碗，偶尔双手合十给你祝福，你按 Esc 打断她，她会停下手里的事甩你一个屑表情，点她会挥手/比心。

**English**: a desktop pet that reacts to your AI coding session. Same character, two builds: **Claude Code** ([PetPet](https://github.com/stshourenxy-dev/petpet-playbook)) and **dsh**. She eats from a bowl while you work, puts it away when the turn ends, and gives you a smug look if you hit Esc to interrupt. On **Windows** you can grab the [green build](https://github.com/wei125775-lab/whalegirl-deskpet/releases/latest), unzip it and double-click `启动.cmd`.


*实拍：左边是 Claude Code 正在跑任务，右边就是她——干活期间一直端着碗吃，气泡是她自己弹的。*


*上图是她的十个动作，全部实拍自宠物素材。*


*挥手 → 起子代理时脚边游出一只小海豚，绕着她转一圈再沉下去。上面这段是 6 秒循环（436×640 原尺寸，[15 秒完整版](docs/preview/showcase.mp4)还含比心、吃饭、收碗和屑表情）。*

她什么时候做什么

你做什么	Claude Code 版	dsh 版
你发消息 / 模型开始干活	捧着碗吃（循环）；10% 的轮次换成端着中碗、拿筷子正经吃一顿	捧着碗吃（循环，全程一条轨道，见坑五）
这一轮结束	收碗 → 55% 托腮发呆 / 10% 双手合十祝福 / 35% 待机	native 同左（靠 transitions.json）；legacy 直接回待机（粘性 phase 的限制，见坑一）
按 Esc 打断她	立刻停下手里的动作，甩你一个屑表情	工具失败/本轮出错时同样甩屑表情
点她	挥手（8% 换成屑表情）	57% 挥手 / 20% 托腮 / 15% 比心 / 8% 屑表情
起子代理	收碗 → 脚边游出一只小海豚转圈 → 跑完沉下去	同左（靠打补丁，见「看鲸鱼」一节）
什么都不做	老实待机——长发和尾巴轻轻晃，偶尔眨眼	同左


*上面这段就是宠物里真实的待机循环（24 帧 @12fps）：呼吸、飘发、眨眼都是程序化烘焙的，不是抽帧——AI 画不出这种幅度的小动作。其余动作由 AI 视频转序列帧、再逐帧抠像配准，工具链在 [whalegirl-pet-kit](https://github.com/wei125775-lab/whalegirl-pet-kit)。*

装

**最省事：下 [绿色版](https://github.com/wei125775-lab/whalegirl-deskpet/releases/latest)** —— Windows x64，解压后双击 `启动.cmd` 就有她。不用装 Node、不用 clone 源码、不用编译。代价是包大（200MB，整个 Electron 运行时都在里面）。

⚠️ **双击时可能弹「Windows 已保护你的电脑」**——点「更多信息」→「仍要运行」即可，不是文件坏了。浏览器下载的 zip 会被打上「来自 Internet」标记，解压时传给里面的文件，Windows 对没签名的程序都会拦这一次。**交给 AI 装