技能介绍

它解决什么问题

盯着 WorkBuddy 等结果时，屏幕上没有任何反馈：思考、调用工具、完成、失败这些状态变化只存在于终端日志里，可视化程度几乎为零。这个技能让一只跨平台的 Electron 桌面宠物常驻屏幕右下角，把后台状态翻译成可见的动画——思考时托腮、工作中跳动、完成时庆祝、失败时抖动，任务提示还会以气泡形式实时浮在头顶。宠物可以拖拽到任意位置，重启后位置保持不变，右键菜单提供唤起 WorkBuddy、隐藏、回右下角、设置与飞行等操作，Cmd/Ctrl+Shift+P 可全局切换显隐。

核心能力与工作原理

状态感知与动画映射：通过 hooks 写入 ~/.workbuddy/settings.json 与 ~/.codebuddy/settings.json（两处都要写，配置前先备份）。WorkBuddy 的状态变化会触发本地 18920 端口的状态接口，宠物据此切换动画。hooks 必须采用 [{hooks:[{type:'command',command:'...'}]}] 的嵌套结构，扁平数组不会触发，且需要完全重启 WorkBuddy 后才生效。

飞行模式的几何实现：右键菜单或 curl -X POST http://127.0.0.1:18920/state -d '{"state":"flying"}' 可触发「倒挂圆锥摆」——宠物倒挂，绕头顶锚点做圆锥摆圆周运动，屏幕投影为椭圆。几个关键约束：椭圆中心是锚点正下方的起飞位置，而不是锚点本身；身体保持竖直不旋转，只通过 scale 实现近大远小；丝线接在宠物背部而非手上（FLY_ATTACH_RATIO 取 0.25，不是 0.95）；pet-flying.png 素材本身必须是倒挂姿势，否则再叠加 rotate(180°) 反而会把它转回正立。

形象生成：需要 5 张 500×500 的 PNG，分别对应待机、开心、无聊、跳舞、生气五种状态。推荐先用 ImageGen 生成待机基准图，再以它为参考做 image-to-image 生成其余四张，保证角色风格一致；脚本会自动把白底抠成透明。