Codex Pet Creation Guide / Codex 桌宠完整制作指南

这是一套面向 ChatGPT、Codex 和人工制作者的 Codex V2 动画桌宠制作规范。目标不是复刻某一只现有桌宠，而是让用户提供角色与服装后，稳定完成动作设计、图片生成、透明拆帧、V2 图集装配、质量验收和 GitHub 分享包。

This repository documents a reproducible workflow for creating Codex V2 animated desktop pets from a user-specified character and outfit.

给普通用户的最短用法

1. 下载整个仓库。
2. 把仓库文件夹交给支持读取本地文件的 ChatGPT 或 Codex。
3. 发送：

请先完整阅读这个仓库里的 README、docs、templates 和 prompts/CHATGPT_MASTER_PROMPT.md。
然后按该规范为我制作一个 Codex V2 桌宠。开始画图前，先向我确认角色、服装和 11 行动作设计；我批准后再生成图片。

4. 提供角色名称、精确服装版本和可合法使用的高清参考图。
5. 先确认动作方案，再让它正式生成。

文档导航

文件	用途
完整工作流	从需求确认到安装包的全流程技术合同
十套动作案例	十个已完成桌宠的悬停、工作、失败、等待和庆祝设计
质量验收与故障排查	尺寸漂移、方向错误、串帧、色键误删等问题的修复标准
GitHub 分享格式	最终仓库结构、README 预览和发布前检查
ChatGPT/Codex 总提示词	可直接交给模型执行的完整任务模板
角色任务模板	角色、服装、动作和尺寸的唯一事实来源
pet.json 模板	Codex 安装元数据模板
包校验脚本	校验 V2 图集和安装目录
README 预览脚本	从最终图集生成四个 GIF

最终安装包

Codex 实际安装目录只需要两个文件：

.codex/pets/<pet-id>/
├── pet.json
└── spritesheet.webp

其中 spritesheet.webp 必须是 1536×2288、8×11、单格 192×208 的无损 RGBA WebP，pet.json 的 spriteVersionNumber 必须为 2。

环境

• Python 3.10+
• Pillow 10+

python -m pip install -r requirements.txt

校验安装包：

python scripts/validate_pet_package.py path\to\<pet-id>

生成 README 四个预览：

python scripts/render_readme_previews.py path\to\<pet-id> path\to\assets

原则

• 先确认动作设计，后生成图片。
• 官方高清图只作为角色与服装参考，不直接进入安装包。
• 每组动作先生成横向动作条，再拆帧；不要让图像模型直接绘制最终大图集。
• 待机、悬停和其他状态必须使用同一人物视觉尺度，不能用缩放表达动作。
• 左右服装细节不对称时，左右跑必须独立绘制；确认完全对称时才允许镜像。
• 每次返工只替换有问题的动作条，验收通过前不得覆盖已安装版本。
• GitHub 角色仓库只保留最终安装文件和由最终图集导出的预览，不放废片或过程素材。

同人作品与参考图

制作具体角色时应确认参考图来源和使用范围。角色名称、造型、服装与其他原始知识产权归各自权利方所有。公开分享时必须标注非官方、非商业同人作品，不得暗示获得 OpenAI、Codex、出版方或动画制作方授权，也不得把原角色 IP 包装成可商业再许可的原创资产。