DIY 自己的 Codex 电脑桌面宠物教程
Codex App 的桌宠不是只能用内置那几只。官方留了完整的自定义入口：只要按规格准备一张精灵图和一个 pet.json，放进本机目录，你画的任何角色都能住到桌面上。更省事的是，官方还出了一个叫 hatch-pet 的技能，丢几张参考图片给它，整套动画它替你画。这篇把两条路都讲清楚，最后用一个真实例子收尾：两张水豚表情包，怎么变成一只能跑的桌宠。
这是官方玩法吗
是。hatch-pet 收录在 OpenAI 的官方技能仓库 openai/skills 的 curated（精选）目录里，宠物的画布规格、9 行动画状态、逐行帧数和时长，都由官方合同文件写死。需要留意的一点：这个仓库目前已标注迁移，新的技能生态在 openai/plugins，但 hatch-pet 本身仍在原处可装可用。
宠物的本体简单到超出多数人预期——就两个文件：
~/.codex/pets/你的宠物id/
├── pet.json # 4 个字段的元数据
└── spritesheet.webp # 1536×1872 精灵图(PNG 也行)规格细节（每行动画用几帧、哪些格子必须留空透明）我们整理成了速查表，见精灵图规格详解。
路线一：hatch-pet，让 AI 替你画
适合想要精致手绘质感、且已经在用 Codex App 的人。前提是 Codex 里装有官方图像生成技能（$imagegen，新版一般自带）。
- 安装：在 Codex 对话里输入
$skill-installer hatch-pet，装完重启 Codex； - 下需求：直接说「帮我孵一只 ___ 宠物」。可以只给文字描述，也可以附参考图片——自家吉祥物、手绘草稿、甚至一张宠物照片。风格可选
pixel（像素）、plush（毛绒）、clay（粘土）、sticker（贴纸）、3d-toy（3D 玩具）等，不指定就自动推断； - 等它干活：hatch-pet 会先生成一张基准形象让你确认，然后逐行生成 9 种动画（待机、左右跑、挥手、跳跃、失败、等待、工作、审查），自动拼成 1536×1872 大图、抠透明底、跑校验脚本；
- 启用：产物直接落在
~/.codex/pets/，去宠物设置里选中就行。
给参考图时的实用经验：一次给 1-3 张、角色完整全身、背景干净的图效果最好；要求它保持「同一张脸、同一套配色」贯穿所有动作行——这是官方 QA 标准里权重最高的一条。
路线二：用代码逐帧画
不想抽卡、想要 100% 可控的人走这条。本站 91 只宠物全部是 Python + Pillow 程序化生成的：在小网格上用色块拼出身体，按状态给每帧套参数，最后拼成规格大图。写好一个绘制引擎之后，加一只新宠物只要十行配置。完整思路和帧数设计写在使用指南的自制章节。
实战：两张表情包，一只桌宠
有读者发来两张水豚表情包问「这样也能做吗」。能，而且这正是看图定制的标准流程。我们的做法分三步：
- 提特征，不是描图：从参考图里提取的是特征清单——奶茶色圆身、占半张脸的深色椭圆口鼻、小圆耳、腮红、整体慵懒躺平的姿态、暖棕色描边；
- 按特征重画：用这份清单在像素网格上画一只原创水豚，9 行动画（躺平系的跳跃也认真跳了）；
- 过官方校验：用官方仓库的 validate_atlas.py 验一遍尺寸、帧数、透明度，全绿才上架。
成品叫 Paka 躺平水豚，页面上能直接预览 9 种状态、免费下载。
最容易翻车的五个点
- 每行帧数不一样：待机 6 帧、挥手 4 帧、跳跃 5 帧、跑步和失败 8 帧、其余 6 帧——多画的格子必须整格透明，不然过不了校验；
- 跳跃别顶出格子：整只宠物（含耳朵帽子）任何一帧都得完整待在 192×208 里；
- 透明要干净：不能留半透明投影、地面阴影、速度线，透明像素里也不能藏 RGB 残值；
- 目录层级：pet.json 必须直接在
pets/宠物id/下，解压时多套一层文件夹是最常见的「宠物不出现」原因； - working 行不是跑步：官方明确这一行表现「专注干活」，画成迈腿跑会被判不合格。
更完整的规格表（含官方逐行播放时长）在这里。
不想动手？
本站已经备好 91 只：原创图鉴 50 只 + 灵感系列 41 只，全部过了官方校验脚本、免费下载、随便改。每只详情页都带 PowerShell 一行安装命令，30 秒就能让 卡皮巴拉或赛博猫住进你桌面。