Appearance
GPT-Image2 + Codex 桌宠制作指南。把参考图发给 Codex，一句话生成桌宠。附详细规格说明和提示词模板。
Codex 桌宠是什么
Codex 桌宠是显示在 Codex 桌面应用里的小型动画伙伴。
本质上是一套本地宠物资源包：
spritesheet.webp：标准尺寸的动作精灵图pet.json：描述信息
Codex 读取这个资源包后，就能在不同工作状态下播放对应的动作帧。
自定义桌宠适合的形象
| 类型 | 示例 |
|---|---|
| Q版形象 | 根据真人照片生成的可爱版本 |
| 原创角色 | 品牌吉祥物、头像生成的工作伙伴 |
| 工作助手 | 带有编码、等待、报错、庆祝等动作的小助手 |
核心要点
Codex 桌宠的关键不是画一张好看的大图，而是把角色拆成一组可循环播放的小动画。
每个动作都需要在很小的尺寸里保持清楚：
- 轮廓要干净
- 表情要明显
- 道具不能太碎
- 角色身份不能在不同帧之间跑偏
资源包结构
一个标准 Codex 自定义桌宠通常包含：
| 文件 | 说明 | 必须 |
|---|---|---|
pet.json | 宠物的 id、显示名称、描述、素材文件路径 | ✅ 必须 |
spritesheet.webp | 透明背景的 8 列 × 9 行动作 atlas | ✅ 必须 |
contact_sheet.png | 检查用的拼合图 | 可选 |
validation.json | 验证配置 | 可选 |
actions_manifest.json | 动作清单 | 可选 |
制作三原则
| 原则 | 说明 |
|---|---|
| 角色一致性 | 同一个宠物在所有动作里都应该是同一张脸、同一套造型、同一组主色 |
| 透明背景 | 最终安装用的 spritesheet.webp 必须是透明背景，不应保留绿幕、阴影或地面 |
| 标准规格 | Codex 使用固定的单帧尺寸、行数和帧数；创意动作可以自定义，但最终要映射到标准 atlas 结构 |
最快用法：让 Codex 自动生成
把参考图发给 Codex，然后直接说：
帮我把这个图做成 Codex 桌宠。Codex 会自动处理：
- 分析参考图的角色特征
- 生成符合规格的 spritesheet
- 创建 pet.json
- 安装到本地
详细制作流程
Step 1：准备参考图
要求：
- 清晰的角色正面图
- 单个角色（不要多角色）
- 最好有不同角度/表情的参考Step 2：生成基础角色图
用 GPT-Image2 生成 Q 版角色：
提示词模板：
生成一个Q版卡通角色，要求：
- 正面站立姿势
- 简洁的轮廓线
- 清晰的五官
- 透明背景
- 动作姿态：coding、waiting、celebrating
- 风格：扁平化、干净背景Step 3：拆分动作帧
每个动作需要：
- 正面站立
- 等待状态
- 编码状态
- 庆祝状态
- 休息状态
- 思考状态
- 报错状态
- 成功状态
- 加载状态
Step 4：生成 spritesheet
标准 atlas 规格：
| 项目 | 规格 |
|---|---|
| 列数 | 8 列 |
| 行数 | 9 行 |
| 单帧尺寸 | 固定尺寸（参考 Codex 文档） |
| 背景 | 透明 |
| 格式 | WebP |
提示词模板：
生成Codex桌宠spritesheet，要求：
- 8列×9行的动作atlas
- 透明背景
- 每个动作8帧循环
- 角色风格统一
- 尺寸：128x128像素每帧Step 5：创建 pet.json
json
{
"id": "my-custom-pet",
"name": "我的桌宠",
"description": "一个可爱的编程助手",
"spritesheet": "spritesheet.webp",
"frames_per_action": 8,
"actions": {
"idle": { "row": 0, "frames": 8 },
"coding": { "row": 1, "frames": 8 },
"waiting": { "row": 2, "frames": 8 },
"celebrating": { "row": 3, "frames": 8 },
"error": { "row": 4, "frames": 8 }
}
}Step 6：验证资源包
bash
# 检查 spritesheet
codex-pet validate spritesheet.webp
# 检查 pet.json
codex-pet validate pet.json
# 完整验证
codex-pet validate --allStep 7：安装桌宠
bash
# 复制到 Codex 目录
cp -r my-pet ~/.codex/pets/
# 或使用命令安装
codex-pet install ./my-pet9 行动画规格速查
| 行号 | 动作 | 建议帧数 |
|---|---|---|
| 0 | idle（待机） | 8 |
| 1 | coding（编码） | 8 |
| 2 | waiting（等待） | 8 |
| 3 | celebrating（庆祝） | 8 |
| 4 | error（报错） | 8 |
| 5 | success（成功） | 8 |
| 6 | loading（加载） | 8 |
| 7 | thinking（思考） | 8 |
| 8 | rest（休息） | 8 |
角色一致性检查清单
| 检查项 | 通过标准 |
|---|---|
| 脸部特征 | 所有帧都是同一张脸 |
| 颜色 | 主色调一致 |
| 轮廓 | 线宽、风格统一 |
| 尺寸 | 角色大小一致 |
| 方向 | 正面/侧面统一 |
提示词模板库
模板一：Q版角色生成
提示词：
生成一个Q版卡通编程助手，要求：
- 圆脸、大眼睛
- 穿着程序员风格的服装（T恤+牛仔裤）
- 手持笔记本电脑或咖啡杯
- 透明背景
- 风格：扁平化、可爱、现代模板二：动作帧生成
提示词：
生成一组长序列动画帧（8帧），要求：
- 相同的Q版角色
- 执行 [具体动作，如：typing on keyboard]
- 每帧有微小差异形成动画
- 透明背景
- 风格统一模板三：完整spritesheet
提示词：
生成Codex桌宠完整atlas（8列×9行），包含：
- idle、coding、waiting、celebrating、error
- success、loading、thinking、rest
- 每动作8帧循环
- 透明背景
- 角色：[具体描述]常见问题排查
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 角色跑偏 | 提示词不够具体 | 添加更多角色描述细节 |
| 帧不连贯 | 每帧差异太大 | 调整提示词，让每帧更接近 |
| 背景不透明 | 生成时带背景 | 手动去除背景或用去除背景工具 |
| 安装失败 | 文件路径错误 | 检查 pet.json 的 spritesheet 路径 |
| 动作不循环 | 帧数不对 | 确保每动作 8 帧 |
推荐工作流
┌─────────────────────────────────────────────────────────────┐
│ Codex 桌宠制作推荐工作流 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 1. 收集参考图 │
│ └── 正面图、多角度、表情包 │
│ ↓ │
│ 2. GPT-Image2 生成 Q 版角色 │
│ └── 用提示词模板 │
│ ↓ │
│ 3. 拆分动作帧 │
│ └── 每动作生成 8 帧 │
│ ↓ │
│ 4. 拼合 spritesheet │
│ └── 按 8×9 排列 │
│ ↓ │
│ 5. 创建 pet.json │
│ └── 配置动作映射 │
│ ↓ │
│ 6. 验证 + 安装 │
│ └── codex-pet validate + install │
│ │
└─────────────────────────────────────────────────────────────┘一句话总结
GPT-Image2 + Codex 桌宠 = 一句话生成 + 标准规格 + 可爱动画伙伴。
核心步骤：生成 Q 版角色 → 拆分动作帧 → 拼合 spritesheet → 配置 pet.json → 安装。
关键点：透明背景、角色一致、标准 atlas 规格。
