whale-girl

工作台不只有冷冰冰的终端：右下角多一只可投喂、可玩耍、会积累资历的鲸鱼娘。

解决什么问题

长时间盯工作台难免枯燥，任务跑起来也没个”同伴”陪着你。whale-girl 在 DSH Web GUI 右下角放一只可悬浮的桌面宠物（QQ 宠物形态），可拖拽、可投喂 / 玩耍，完成的任务、会话与陪伴时长会积累成资历等级、称号与回忆——干活本身成了养成的过程。

它带一套完整状态机，把 agent 的实时状态翻译成宠物情绪：拖拽被斜向拉扯、喂食 / 玩耍后开心、空闲 60 秒打盹、任务完成 / 升级时举手欢呼、请求出错时惊吓失落、新会话挥手欢迎、会话思考中沉思陪伴、等待批准时期待等待……看得见的陪伴，让等待与出错都不再那么抽象。

核心功能

• 右下角悬浮宠物：官方 bundle 插件格式（dsh.bundle + dsh.client），装完重启 web 即出现在右下角
• 投喂 / 玩耍：菜单喂食（🍗）、玩耍（🎾），互动触发 eat / play → joy
• 资历成长系统：完成任务、会话与陪伴时长积累 XP、等级、称号与回忆，hover 状态栏可见
• 15 态完整状态机：idle / working / celebrate / error / disappointed / joy / eat / play / drag / walk / sleep / wake / welcome / think / wait
• 实时配置生效：whale-girl: 配置段（enabled、size、opacity、walk、sleepAfterMs）改完即时生效，无需重启
• 多角色切换：Switch Character 循环切换角色（清单只有一个时按钮置灰）
• 可选桌面伴侣：仓库 desktop/ 下的独立应用（Node 引擎 + Tauri 壳）可把鲸鱼娘渲染到操作系统桌面常驻

快速上手

安装官方 bundle 插件并重启 web：

dsh plugin —profile web add “github:vlln/whale-girl#main”

或 npm 源：dsh plugin —profile web add whale-girl@0.1.0

重启后宠物出现在右下角：点它弹出菜单（🍗 喂食 / 🎾 玩耍），拖拽移动，hover 显示资历等级 / 任务数 / 最近共同回忆。更新用 dsh plugin --profile web update whale-girl 后重启。可选桌面伴侣：npm install -g whale-girl-desktop 再 whale-girl-desktop --headless，用 Tauri 构建渲染壳常驻桌面（默认指向本地 3080 端口）。

适合谁

• 想要工作台有个”伙伴”陪伴、用积累式玩法激励自己的 DSH 用户
• 对桌面宠物 / 状态可视化有爱好的玩家与插件作者
• 想参考官方 bundle 插件范式（结构、约定、资产契约）来写新插件的开发者