Codex 宠物 FAQ：读者每月都在问的十个问题

关于图片和文件的 codex 宠物问题

每个月都会到大约二十个重复的问题，其中五六个占了绝大部分。这份 codex 宠物 FAQ 就是把月底那摞邮件集中答一遍，而不是一封封回。

排在最先的是上传，而问题几乎都出在原图身上，不在生成器。Codex 读的是 WebP，JPG 和 PNG 可以上传，转换后出来的就是 WebP。长边两千像素左右出图最干净，比手机原图直接丢上去强得多；上传前先把动物裁出来，比事后调任何参数都管用。

• Codex 读 WebP，JPG 和 PNG 都能传
• 先把动物裁出来再上传，别事后补
• 长边两千像素上下就够用
• 精灵图放不出来，多半是文件被改过名，不是转换坏了

宠物排错 FAQ：它怎么不见了

宠物不显示基本就三种原因，没有一种是宠物文件本身坏了。少数机器上，Codex 桌面端更新会把宠物目录的查找路径挪走；有些版本的屏幕共享自动隐藏是默认开的；还有一种是手动替换过 WebP 文件，结果什么都不显示，也不报错。

按这个顺序查一遍，两分钟能省掉一次重装。

• 先关掉屏幕共享自动隐藏，栽在这上面的人最多
• 确认文件夹还在那台机器的宠物目录里
• 重装宠物，别自己编辑那个 WebP
• 每次更新都掉的话，备份就别放在应用目录里

读者问答里的隐私问题

照片隐私是第二大块。上传走 TLS，在任务队列里等精灵图渲染完，然后按 24 小时定时删除，不挂任何账号。文件夹落到你机器上之后，里面没有任何东西会发网络请求。

但有两类图我自己是坚决不传的：画面里有能认出来的小孩，或者有证件。任何服务、任何一次上传，都等于多了一份你控制不了的副本，而 24 小时仍然是 24 小时。

• 上传前自己先清掉 EXIF
• 传裁剪图，别传完整原图
• 默认传上去的东西在别处仍然存在
• 复制出去会有风险的照片就别上传

读者问答：一台机器养几只合适

硬性上限没有，宠物目录就是个文件夹。但超过四五只之后，多出来的那些人自己都不会再看，而且只要有东西动，几张精灵图就开始互相抢注意力。折腾过一轮的人大多停在两只。

还有一件早点知道比较好：宠物状态是按机器算的。公司机器上装的宠物就留在公司，除非你把文件夹复制过来，而这也就是唯一存在的同步方式。

• 试过一轮之后，大家多半停在两只
• 每只都要多渲染九个动画状态的帧
• 没有自动同步，复制文件夹就是全部
• 留着旧宠物不花钱，花的是注意力

这个月值得一留的怪问题

有两三个读者问答我觉得应该留下来，因为问得比我的回答好。能不能用画代替照片做宠物？可以，而且平涂插画转出来的效果比大多数照片干净。宠物会不会拖慢模型？不会，它画在对话旁边，不碰请求链路。

能不能让宠物对构建失败有反应？目前没有我信得过的方式。自定义状态钩子是有的，但几乎没人接，包括我。

• 平涂插画比杂乱照片转换效果好
• 宠物在模型旁边，不在模型里面
• 开着宠物，token 消耗不会变
• 自定义状态钩子有，基本没人用

接下来

格式的横向对比在 /blog/codex-pet-image-formats-jpg-png-webp，宠物不显示的排查步骤在 /blog/installation-troubleshooting。如果你问的是照片而不是宠物，答案在 /blog/is-the-pet-generator-private。

其余归档在 /blog。月底这类问答的选题直接从收件箱里捞，这次如果你的问题没被挑进来，下次再问一遍就好。