故障排查
修复 Codex 宠物问题
大多数安装问题源于文件夹位置错误、文件缺失或精灵图与预期图集不符。
为什么我的自定义宠物没有在 Codex 中显示？
检查文件夹是否位于 ~/.codex/pets/<pet-name>/ 下，且包含 pet.json 和 spritesheet.webp。
为什么动画看起来不对劲？
精灵图可能无法读取、不透明，或者其排列方式导致当前的 Codex 运行时无法清晰地呈现动画。
安装宠物后是否需要重启 Codex？
是的。在放置新的宠物文件夹或安装新技能后，请重启 Codex。
为什么 macOS 上的 Codex 宠物动画会卡住？
macOS 的“减少动态效果”设置可能会停止或降低桌面动画。如果宠物出现但不播放动画，请查看减少动态效果指南。
如何确认安装路径是否正确？
打开你的用户目录，确认宠物包位于 ~/.codex/pets/<pet-name>/，并且 pet.json 与 spritesheet.webp 位于该文件夹顶层。
请将你的宠物包与 包格式规范进行对比。 查看减少动态效果指南