桌宠备份指南：别丢了你的像素伙伴

备份一只桌宠，到底要装什么

要装的是整个桌宠文件夹，不是单独一张图。spritesheet.webp 存着所有帧，pet.json 存着 id、名称和每个状态的播放节奏。缺了 pet.json 的备份还原不了，因为 Codex 是靠它认出这只桌宠的。

判断备份对不对，打开看一眼就够：两个文件都在，文件夹名和 pet.json 里的 name 一致，就能还原。只有一个文件，或者文件夹里还套着一层，就不行。

• spritesheet.webp：所有帧，一般是八到九个状态排在一张图里
• pet.json：id、displayName，以及每个状态的播放节奏
• 装着两者的文件夹，名字跟 displayName 保持一致
• 生成时用的原图，可选，留着以后想重新生成时省一次拍摄

三种能长期坚持的备份方式

选一种然后一直用。坏掉的通常不是方法，而是中途换方法，最后搞不清哪一份是最新的。

• 打包归档：把桌宠文件夹压成 pets-backup-2026-10.zip 这样的压缩包，丢进网盘。适合配好之后基本不动的情况。
• 整个 pets 目录放进同步盘：让 Dropbox、iCloud Drive、OneDrive 或 Syncthing 管着 ~/.codex/pets，让它自己复制。适合经常改桌宠的情况。
• 提交到私有 git 仓库：版本化这个文件夹，每次改动都留记录。适合本来就在管 dotfiles 的人。

备份放在哪才算数

同一台机器上的第二份拷贝不算备份。外接硬盘放在同一个包里勉强多一层，但一起丢的概率仍然很高。最省事的真答案是你已经在付费的网盘目录。

想清楚你在防什么。硬盘坏需要异地的一份；误删需要带历史版本的一份；重装系统需要一份在你重新登录任何账号之前就能拿到的。

• 已经在用的网盘目录：成本最低，扛得住硬盘故障
• 同步的第二台机器：可以，但如果两台都从同一个源同步，就不算独立的一份
• 加密归档放冷存：适合那些原图已经找不回来的桌宠

从备份还原一只桌宠

还原就是安装倒着走一遍。macOS 或 Linux 解压进 ~/.codex/pets，Windows 解压进 C:/Users/<你>/.codex/pets，确认文件夹名和 pet.json 里的 name 对得上，然后彻底退出 Codex 再打开。

Codex 只在启动时读一次这个目录，所以应用开着时放进来的桌宠不会立刻出现。彻底重启之后还是不显示，先查文件夹名。名字对不上不会报错，只是屏幕角落一直是空的。

备份是怎么失效的

备份失效的方式不多，而且翻来覆去就那几种。

• 只备份了图片：pet.json 没带，Codex 认不出这只桌宠
• 备份之后改了文件夹名：归档里的 pet.json 还写着旧名字
• 套了一层目录：你打包的是父目录，还原之后桌宠比 Codex 扫描的层级深了一层
• 从没试过还原：归档看着没问题，直到真要用的那天
• 只备份过一次，还是两年前：现在的桌宠动画节奏已经不一样了

一年十分钟的习惯

生成一只桌宠时备份一次，改动之后再备份一次。这就是全部日程：生成时两分钟，改完三十秒，归档名字带上日期。

至少在一台没有这只桌宠的机器上试一次还原。解压，重启 Codex，确认它会动。从没还原过的备份只是个猜测。

从 / 开始把照片变成像素伙伴；每台系统的具体路径看 /blog/how-to-install-codex-pet；决定归档里放什么之前，先读 /blog/export-formats-explained。