HELP / ONE-MINUTE CHECKLIST

先别重装，通常只是差一层目录。

从文件位置、重启方式到格式说明，答案都放在这里。先做最短的检查，再决定下一步。

CHECK THESE FIRST

一分钟排查

FAQ

点开问题就能看到答案，全部无需登录。

安装后为什么没有看到宠物？

先确认最终路径是 .codex/pets/<pet-id>/pet.json，pet.json 和 spritesheet.webp 必须在同一目录。然后完整退出 Codex Desktop，而不是只关闭窗口，再重新打开。

同一个宠物可以重新安装吗？

可以。先把现有同名文件夹改名或备份，再重新安装。本站提供的安装指令遇到同名目录会先停止，不会静默覆盖。

macOS 和 Linux 的路径在哪里？

默认路径是 ~/.codex/pets。若你设置了 CODEX_HOME，则使用 CODEX_HOME/pets。

为什么会出现两层同名文件夹？

ZIP 里面已经包含完整的宠物文件夹。请把 ZIP 内那一整层文件夹放入 pets，不要先解压到另一个同名目录。最终应直接看到 pets/<pet-id>/pet.json。

这是 OpenAI 官方宠物库吗？

不是。这是围绕 Codex Desktop 自定义宠物格式制作的独立项目，不代表官方认可或背书。

素材可以重新分发或商用吗？

网站代码与宠物素材采用不同授权。重新使用前请查看 GitHub 仓库中的 LICENSE 与 ASSET-LICENSE.md。

宠物文件说明（高级）

ADVANCED / PET FILES

每只宠物由 manifest 与实际图集组成。网站预览直接读取同一张 spritesheet，不是另做的概念动画。

<pet-id>/
├─ pet.json
└─ spritesheet.webp