Codex Pet Generator
通过提示词或参考图生成自己的 Codex 数字宠物，预览官方需要的动画状态，并打包 Codex 能直接读取的 pet.json 与 spritesheet.webp。
可选参考图
如果要锁定品牌吉祥物、logo、草图或截图，可以上传参考图作为视觉方向。
正在加载模型...
可安装文件包
生成文件包后复制一条短命令，它会下载 ZIP 并安装到你的 Codex pets 文件夹。命令执行完以后，Codex 不会自动切换当前桌宠。
生成全部状态后即可下载文件并复制短命令安装。运行命令后还要做
- 1打开 Codex Settings > Appearance > Pets 或 Avatar 区域。
- 2点击 Refresh Custom Pets。
- 3按名称选择新生成的自定义 pet。
- 4确认 Codex Avatar 已显示；如果头像浮窗被隐藏，在 Appearance 里重新显示 Avatar。
- 5如果右下角还是旧 pet，重启 Codex 后再刷新并选择一次。
State preview
安装前预览每个 Codex pet 状态
Codex pet 使用固定 8x9 精灵图 atlas。切换状态可以检查帧数、动画意图，以及生成出的宠物是否在整张图里保持同一身份。
Row 0 / 6 frames
Idle
neutral idle loop with subtle breathing and blinking, steady centered pose
AI 工作流
从提示词到 Codex 可用宠物文件
这个页面按真实 Codex custom pet 文件契约设计，不是普通的单图生成器。
描述宠物
先写一个紧凑 mascot brief：形状、颜色、脸部、道具、性格，以及需要保留的参考图。
生成 atlas
生成目标是 1536x1872 的 spritesheet.webp，8 列 9 行、透明格子，并符合各状态帧数。
预览状态
在安装前检查 idle、running、waving、jumping、failed、waiting、review 等循环。
本地安装
把生成后的短安装命令复制到终端运行，然后在 Settings > Appearance > Pets 刷新并选择 Custom Pet，再确认 Avatar 已显示。
文件契约
codex pet generator 会创建什么
一个有效的自定义 pet 是一个很小的本地文件包。$HOME/.codex/pets 下的文件夹名会成为 Codex 可加载的自定义宠物入口。
pet.json manifest
定义 id、displayName、description 和 spritesheetPath。spritesheetPath 通常指向 spritesheet.webp。
spritesheet.webp atlas
透明背景的 1536x1872 WebP 或 PNG atlas，8 列 9 行，每格 192x208。
九行动画状态
行顺序是 idle、running-right、running-left、waving、jumping、failed、waiting、running、review。
本地 Codex 安装
把两个文件放到 $HOME/.codex/pets/<pet-name>/ 后，在 Codex 里刷新 Custom Pets、选择新 pet，并显示 Codex Avatar。
{
"id": "pixel-sprout",
"displayName": "Pixel Sprout",
"description": "A compact Codex digital pet generated from your brief.",
"spritesheetPath": "spritesheet.webp"
}1536x1872 WebP atlas, 8 columns x 9 rows, 192x208 cell, transparent unused slots.
复制粘贴安装
把生成的 pet 安装到 Codex
生成完成后，复制命令会下载生成的 ZIP 文件包，并解压到 Codex 期望的位置。Windows 用户对应的是用户目录下的 .codex 文件夹。
生成文件
从生成器输出中创建完整的 pet.json manifest 和 spritesheet.webp atlas。
粘贴安装命令
运行复制出的 Windows 或 macOS/Linux 命令，下载 ZIP，创建 $HOME/.codex/pets/<pet-name>/ 并解压两个文件。
刷新 Custom Pets
在 Codex 打开 Settings > Appearance > Pets，点击 Refresh Custom Pets，让 Codex 重新扫描安装目录。
选择新宠物
按名称选择刚生成的自定义 pet。安装命令只负责复制文件，不会自动替换当前桌宠。
显示 Avatar
选择后确认 Codex Avatar 浮窗处于显示状态。部分旧说明会提到 /pet，但当前 Codex 版本通常通过 Appearance 里的 Avatar/Pets 设置控制显示。
FAQ
Codex Pet Generator 常见问题
什么是 Codex pet？
Codex pet 是 Codex app 里的小型动画数字伙伴。自定义 pet 会从 Codex home 的 pets 目录加载。
安装 Codex pet 需要哪些文件？
需要同一文件夹里的 pet.json 和 spritesheet.webp。manifest 会告诉 Codex 精灵图文件在哪里。
codex pet generator 应该预览哪些动画状态？
实用的生成器应该预览 idle、running-right、running-left、waving、jumping、failed、waiting、running 和 review。
能不能复制一条命令完成安装？
可以。生成完成后，复制命令会下载生成的 ZIP 包，创建目标 Codex pets 文件夹，并把两个文件解压进去。命令运行完成后，还需要在 Codex Settings 里刷新 Custom Pets、选择新宠物，并确认 Codex Avatar 已显示。
必须登录吗？
必须。这个页面复用当前图片生成积分流程，所以每次基础图或状态行图生成都会被记录并按模型配置扣费。
为什么透明背景重要？
Codex pet 会浮在 app UI 上方，所以未使用格子和状态行背景必须透明。优先使用支持透明背景的模型，其他模型会用 chroma-key 提示词和浏览器清理兜底。