WorkBuddy 桌宠工厂

它解决什么问题

桌面宠物常见做法是把一只角色的动作、路径和启动方式写死，换角色就要重新维护一份脚本。workbuddy-pet 把桌宠拆成可安装的资产：给一张角色图、一个 codex.pet 链接、一份精灵表或已下载的 codex 桌宠，都能变成 ~/.workbuddy/pets/<id>/ 下可启停、可切换的实例，并用 pet.json 描述布局、状态和启动方式。

它如何工作

• 安装来源：支持 image、URL、codex、sheet 四类来源；图片链路需要先规格化成精灵表，再写入 spritesheet.webp 并清理 _needs_sprite。
• 精灵表约定：默认总尺寸为 1536×1872，按 9 行 × 8 列 排布，每帧 192×208；不同行数/帧数可由 pet.json 的 layout 覆盖。
• 状态联动：运行时每 pollIntervalMs 默认 2000ms 读 ~/.workbuddy/workbuddy.db，将 working、Pending、Completed、Failed 等状态映射为 running、waiting、jumping、review 等动画，结束后回 idle。
• 进程策略：macOS 下使用 frameless、always-on-top、NSStatusWindowLevel 与 accessory 策略，尽量不抢焦点、不进 Dock；同一时刻只保留一只活跃桌宠，start / switch 会自动停掉其它实例。
• 交互方式：除命令启停外，右键菜单可切换已安装桌宠、手动测试动作、隐藏 30 秒或退出。

适用边界

它更像桌面宠物运行时与安装工厂，不是通用 GUI 自动化框架。精灵表需要符合约定或提供 layout；图片源依赖后续规格化流程；若目标环境缺少 macOS 焦点 API 或 pyobjc，置顶、不抢焦点等策略可能不可用。