Codex 桌面端更新，宠物功能有哪些变化

一次更新到底动了哪些东西

codex pet update 是跟着 Codex 桌面端一起来的，没有单独的宠物升级包，也没有要重装的东西。你装上新版本，画精灵图的那部分代码跟着一起换掉，这次改动在绘制路径上留下的痕迹，下次启动就能看到。

这里最容易搞错的一点是：很多人去找宠物的发布说明，其实没有这个东西。一只宠物等于你自己的两个文件（spritesheet.webp 和 pet.json）加上读取它们的应用代码，而换掉的只有后半部分。

• 你的 pets 文件夹：安装器不碰
• 你生成的精灵图和 pet.json：不碰
• 你自定义的配色和动画状态：不碰
• 渲染器、动画计时器、默认宠物：随新版本换掉

升级时宠物文件放在哪儿

属于你的东西全在你用户目录下的 pets 文件夹里：macOS 是 ~/.codex/pets/，Windows 是 %USERPROFILE%/.codex/pets/。安装器写的是应用程序目录，两个地方不同，所以升级没有理由进到 pets 文件夹里。

有一个例外值得知道：有些版本会换掉应用自带的默认宠物。如果你从来没自己生成过，看到的就可能被换成新版挑的那只。生成过一次就不会受影响，因为你那只放在用户目录里，不在应用里面。

• macOS：~/.codex/pets/<宠物名>/
• Windows：%USERPROFILE%/.codex/pets/<宠物名>/
• 每个文件夹里放一个 spritesheet.webp 和一个 pet.json
• 目录结构、备份和同步分别写在 /blog/codex-pets-folder-structure、/blog/backup-codex-pets-guide 和 /blog/sync-codex-pet-across-machines

怎么从更新日志里挑出跟宠物有关的行

更新日志是写给整个应用的，跟宠物有关的几行藏在中间。值得扫的词是渲染器、窗口、素材、精灵图。讲模型路由或者 API key 的那几行，不会让你在屏幕角落里看到任何变化。

发布说明真的提到宠物时，通常是这几类：动画帧数的预算、默认宠物集合，或者 pet.json 写错时的处理方式。你注意到的其它变化，多数是更大的界面改动带来的副作用，不是宠物本身改了。

• 动画或帧数预算改动：精灵图照常能用，节奏可能不一样
• 默认宠物集合改动：只影响从没自己生成过的人
• pet.json 校验改动：之前能加载的宠物现在可能被拒，多半是少了一个字段
• 窗口或托盘改动：宠物占的那个角会挪位置，看起来像宠物没了

报「更新把宠物搞坏了」之前先查这四项

大多数「更新之后宠物坏了」的报告，最后都落在下面四类里，而每一类一分钟之内就能排除。按顺序跑一遍再写反馈。

• 把 Codex 完全退出再打开。热重载不一定会重启动画计时器。
• 确认 pets 目录里的文件夹名和 pet.json 里的 name 字段完全一致，大小写也算。
• 用图片查看器打开精灵图。打不开就说明文件在更新之前就已经坏了。
• 确认 Codex 窗口在你正在看的那块屏幕上。宠物不会跟着你的视线走。

接下来去哪儿

在 codexpetgenerator.com 生成一只，把文件夹留在用户目录里，更新就不再是件事。生成器不管你是哪个桌面版本都写出同样的两个文件，所以今天做的宠物，下个版本照样会动。

更大的图景在 /blog/codex-pet-ecosystem，/blog/pets-library-explained 讲一个文件夹里怎么摆好几只宠物，/blog/backup-codex-pets-guide 是花十分钟买的一份保险。其余内容从 /blog 进去。