技术参考

Codex Pet 包格式

Codex 自定义宠物包是一个本地目录，至少包含 pet.json 和 spritesheet.webp。

快速事实

宠物目录	`~/.codex/pets/<pet-name>/`
必需清单文件	`pet.json`
必需精灵图	`spritesheet.webp`
图集尺寸	`1536x1872`
网格	`8 列 x 9 行`
单格尺寸	`192x208`
格式	`transparent WebP / RGBA`

清单文件示例

{
  "id": "codie",
  "displayName": "Codie",
  "description": "A tiny pixel robot companion for Codex Pet.",
  "spritesheetPath": "spritesheet.webp"
}

动画行

行	状态	使用帧数
0	`idle`	6
1	`running-right`	8
2	`running-left`	8
3	`waving`	4
4	`jumping`	5
5	`failed`	8
6	`waiting`	6
7	`running`	6
8	`review`	6