故障排查
修复 Codex 宠物问题
多数安装问题来自目录位置、文件缺失，或精灵图不符合预期图集格式。
为什么我的自定义宠物没有显示？
检查目录是否位于 ~/.codex/pets/<pet-name>/，并且包含 pet.json 和 spritesheet.webp。
为什么动画看起来不对？
精灵图可能不符合 1536x1872、8x9 网格或 192x208 单格规范。
安装宠物后需要重启 Codex 吗？
建议在放入新宠物目录或安装新技能后重启 Codex。
可以对照 包格式规范 检查。