2D 动画桌宠生成器

要解决的问题

把一张静态角色图变成会动的桌面宠物，通常卡在四处：姿势帧风格漂移、逐帧动画工程化、跨机器交付、行为设置持久化。本技能把流程压缩成可复现的流水线——输入参考图，输出双击即跑的 Catgirl2DPet.exe，目标机无需 Python 环境，也不绑定任何图像厂商或 API Key。

技能如何工作

第 1 步生成姿势帧：references/generate_frames.py 采用插件式后端，PET_GEN_MODEL 选模型、凭据走环境变量。核心技巧是把发色、瞳色、服装颜色写死在角色描述 CHAR_DESC 并逐帧复用，图生图 strength≈0.70；需要 idle/walk/run/laugh/cry/sleep/angry 等帧，失败单帧可单独重跑。

第 2 步预处理：references/preprocess.py 做四角洪水填充去背景（THRESHOLD≈40），每帧缩放并居中垫成透明正方形画布——这是走路不抖的关键。

第 3 步动画引擎：references/pet.py 用 tkinter 无边框窗口加 -transparentcolor 实现透明，资源路径经 sys._MEIPASS 解析。行为含随机状态切换、拖拽让位、长按 500ms 触发开心、Windows 工作区避让与边界夹取；动作库覆盖跳跃、跳舞、转圈、惊讶等变换动画及泪滴、Zzz、抛物线丢键盘等叠层特效。config.json 持久化比例、透明度、性格与提醒，打包后写入 %APPDATA%\CatgirlPet\；定时提醒对齐整分钟触发且须点击才关闭。

第 4–5 步：隔离 venv 中 pyinstaller 打包，--add-data 内嵌 frames；test_fix.py、test_flavors.py 做无头遍历验证。

适用边界

• 依赖 Windows：工作区避让用 SPI_GETWORKAREA，Linux/macOS 需回退全屏夹取；透明色在黑底可能发白。
• 角色漂移需人工检查：参考图不清晰时脸与发色会飘。
• 无头环境无法验证真实鼠标交互与注册表自启，需用户本机确认。