先确认，是你喜欢的样子
附上一张手办照片，说明想保留的配色与装饰。先看卡通形象，满意之后再制作整套动作。
看起来不像？先调整形象。介绍页与文档提供五种语言，不代表 CLI 输出支持五语，也不保证各语言的生成效果。
OPEN SOURCE SKILL 0.1.0 预览版
桌上玩伴 · ToyPal
把喜欢的手办，
变成你的桌宠。
从一张照片开始，保留你喜欢的特征。先确认形象，再制作动作，最后把认可的小玩伴安装到 Codex。
代码免费开源 · 需要 Codex 图像能力、hatch-pet 与生成额度
01 / 从照片开始
每一步，
都留给你确认。
先把形象做好，再投入动作生成。减少不满意之后整套重做的机会，但不保证一次成功或固定耗时。
再看看，它怎么动起来
生成后检查边缘和动作连续性，再预览动作。技术检查通过之后，仍由你决定形象和动作是否满意。
动作异常？回到修复，不跳过检查。安装，让它留在桌面上
预览满意后说“安装这个桌宠”，再到 Codex 的宠物选择界面选用。同名目录保留，不直接覆盖。
安装完成，不等于已经选用。在 CODEX 中开始
安装依赖和 skill 后，附上照片，再输入：
用 $toypal 把这个手办做成我的桌宠。保留主要配色和装饰，可以卡通化。先让我确认形象，再生成动作；完成后给我预览和安装包。
02 / 适合你吗
喜欢这个想法？
先看使用条件。
目前是面向已有 Codex 图像能力用户的本地工具，不是独立的 Mac 或 Windows 桌宠应用。
一件清晰的手办
单个、全身清晰、不透明，建议正面或三分之四角度。采用卡通重设计，不保证照片原像素的精确抠图。
可用的生成环境
需要 Codex 图像生成能力和额度、官方 hatch-pet、Python 3.10+ 与 Pillow。只运行脚本无法生成角色。
愿意预览和调整
生成参考图可能发送到所用图像服务，生成和重试消耗额度。请先确认形象；不满意时可以停下，不无限重试。
没有 Codex，可以直接使用吗？
当前不能。本项目不提供在线上传生成入口或独立桌宠运行时。你可以先阅读安装说明，确认环境后再开始，不需要在这里注册或付款。
生成失败、动作异常或安装冲突怎么办？
形象不符时先修改基准形象；动作或透明边缘异常时回到生成与修复步骤；同名安装冲突时保留已有目录，不覆盖。 查看检查、预览、打包与安装说明 ↗
03 / 当前验证范围
一个已有案例，
不是所有手办的保证。
已用本机小神鸟成品验证 v2 图集检查、11 个动作 GIF 预览、ZIP 导出与隔离目录安装，并核对安装文件一致。
这些是包工具的验证，不是新手办从照片到成品的完整生成测试。预览使用固定 150ms 帧间隔，不模拟 Codex 的真实播放时序。
- 新手办全流程生成：尚未验证
- Windows 真机与独立用户体验：尚未验证
- 不承诺通用成功率、固定耗时或零生成成本
04 / 照片与许可
你的照片，
不会被默认公开。
原照片不进入导出的宠物 ZIP，也不默认公开；作为生成参考时仍可能发送给所用图像服务。分享照片和角色前，请确认你拥有相应权利。
流程与包工具采用 MIT 许可，部分校验工具保留 Apache-2.0 许可。项目独立维护，非 OpenAI 或任何博物馆官方项目。
先从你喜欢的那一件开始
给手办一个
新的陪伴方式。
反馈失败步骤、重试次数、是否安装成功，以及使用七天后留下或关闭它的原因。不必公开原照片。