下载得到的 ZIP 已经按照完整宠物包整理好了。安装的关键不是复杂操作，而是保持整个文件夹完整，并把它放进 Codex 为你打开的正确目录。
移动之前先解压 ZIP
双击下载的 ZIP，后面只操作解压出来的整个文件夹。不要把文件一个个拖出来，因为配置文件、精灵图和其他文件需要保持在一起。
直接让 Codex 打开正确目录
打开 Codex Settings，进入 Pets，滚动到自定义宠物区域并点击 Open folder。这样不用自己猜 Mac 里隐藏的 .codex 文件夹在哪里。
生成文件应该直接位于宠物文件夹顶层
打开宠物文件夹后，pet.json 和 spritesheet.webp 应该直接出现在顶层。多套一层无关文件夹，是最常见的安装失败原因。
- 不要改名 pet.json
- 不要改名 spritesheet.webp
- 移动整个解压文件夹，不要只移动其中几个文件
刷新列表并选择新宠物
复制完成后回到 Codex，刷新自定义宠物列表并选择新加入的宠物。如果没有出现，重新检查是否不小心形成了双层嵌套文件夹。
先解压，把整个宠物文件夹放进 Codex 打开的 pets 目录，确认 pet.json 和 spritesheet.webp 在顶层，然后刷新 Pets 列表。