多设备同步：公司和家里用同一只桌宠

把桌宠拷到另一台电脑，实际在拷什么

一只桌宠就是两个文件：spritesheet.webp 和 pet.json，没有第三样。所谓把桌宠拷到另一台电脑，就是把这个装着两个文件的文件夹整个搬过去，而且文件夹名必须和 pet.json 里的 name 字段一致。机器上其它东西都不相干：没有注册表项，不用重新安装，也不做跟硬件绑定的授权校验。

所以 codex pet sync 比多数人想的省事。没有账号要登录，没有云端存档要恢复。桌宠就是 Codex 启动时会读的一个目录，只要第二台机器上这个目录里放着同样的内容，同样的桌宠就会出现在那儿。

• spritesheet.webp：所有帧，一般是八到九个状态排在一张图里
• pet.json：id、displayName，以及每个状态的播放节奏
• 装着两者的文件夹，名字跟 displayName 保持一致

每台机器上 pets 文件夹在哪

macOS 和 Linux 是 ~/.codex/pets，Windows 是 %USERPROFILE%\.codex\pets。目录不存在就自己建一个。Codex 在启动时读这个目录，所以在打开应用之前放进去的桌宠，第一次运行就能看到。

动手之前先把两台机器的路径写下来。多数同步失败其实不是同步的问题：文件夹进了另一个客户端创建的 .codex 目录，或者多套了一层子目录，而 Codex 根本不会往里扫。

• macOS 和 Linux：~/.codex/pets/
• Windows：C:\Users\<你>\.codex\pets\
• 用 ls ~/.codex/pets 确认，Windows 用 dir %USERPROFILE%\.codex\pets

同步 pets 文件夹的三种做法

选一种，然后一直用它。混着用的结果是两只略有差别的桌宠，各自看着都对，直到你把两张截图摆在一起才发现不一样。

• 打包拷贝：把桌宠文件夹压缩，用 U 盘、隔空投送或邮件搬过去，在第二台机器解压进 pets 目录。适合一次性迁移。
• 同步盘：把 ~/.codex/pets 放进 Dropbox、iCloud Drive、OneDrive 或 Syncthing 管理的目录，让它自己复制。适合两台机器都会改桌宠的情况。
• 私有 git 仓库：提交这个文件夹，在另一台机器上拉取。适合本来就在版本化 dotfiles、想留下改动记录的人。

多台机器会坏在哪

多设备桌宠坏的方式很固定，翻来覆去就那么几种。最常见的是路径漂移：WSL 的家目录和 Windows 的家目录不是一个地方，拷进其中一个，另一个环境里运行的 Codex 就看不见。

第二种是改名之后的名字错位。你在一台机器上改了文件夹名，而同步只搬运了文件内容，另一台机器还留着旧文件夹名，pet.json 里却已经是新名字。Codex 不报错，直接跳过，看上去像桌宠坏了，其实是名字没对上。

第三种是读得太早。Codex 只在启动时读这个目录，开着 Codex 拷进去的桌宠要彻底退出再打开才会出现。

• 只有一台机器看不到：先确认 Codex 实际读的是哪个 .codex 目录
• 先出现又消失：同步客户端正在写入，等它跑完
• 显示成空白方块：spritesheet.webp 没传完整

让 pet.json 在两台机器上保持一致

把 pet.json 当作唯一的事实来源。在一台机器上调了动画节奏或状态名，就重新导出整个文件夹，让同步把整包带过去。两头各改一次，会养出两只悄悄分叉的桌宠；安静的分叉比加载失败更麻烦，因为失败至少看得见。

重新生成桌宠的时候，下载新的 ZIP 覆盖整个文件夹，不要只替换部分文件。生成器输出的精灵图和 pet.json 是一套配套的，新图配旧 JSON，最常见的后果就是帧播速度不对。

一只桌宠，两台机器

生成一次，然后让两台机器指向同一个文件夹。这个习惯的全部内容就是这些，搭起来大概两分钟。

从 / 开始，把照片变成像素伴侣；每台系统的具体路径看 /blog/how-to-install-codex-pet；决定用什么格式在机器之间搬运之前，先读 /blog/export-formats-explained。