Codex 宠物皮肤：九组一致状态的完整指南

Codex 宠物到底是什么

Codex 宠物是随任务状态变化外观的装饰陪伴。它不改变 Codex 阅读、写入或执行工作的方式。视觉系统才是产品：待机、倾听、思考、工作、成功、出错、睡觉、庆祝、警觉，是九种不同的工作，不是同一张图复制九次。

上游格式需要一张包含所有帧的图集，再加元数据描述状态名和布局。具体尺寸和状态名取决于当前上游契约。所以校验很重要：一张看起来完美的通用精灵图，也可能过不了包检查。

先写角色契约

生成之前，写下绝对不能变的东西：物种、毛色或表面色、独特斑纹、眼睛颜色、身体比例和一个标志性配饰。这是你退掉坏图的依据。没有它，你会留下那张悄悄换了角色的可爱图。

好的契约短到能粘进提示词，又具体到能用眼睛检查。比如：短毛橘猫、白下巴、左耳一个缺口、青色项圈。每组状态都要保留四个细节。姿态遮住耳朵，就换姿态。

准备源照片

用清晰、光线正常、你拥有权利的照片。裁到角色，不要把整个房间带进去。脸看不清就是源图不对，换一张，别浪费生成。原创角色就用干净的设定图，不要用照片硬凑。

不要上传别人的宠物、可识别角色或没有授权的图库照片。宠物仍然是衍生作品，小和可爱不改变权利。

小批量生成九状态

一次生成两到三组，按契约检查，再继续。一张九宫格效率高但难改：一帧坏了可能污染整组。小批量多几次点击，省更多时间。

任何改变物种、斑纹、眼睛颜色或比例的图都退掉，哪怕它更有表现力。一致性优先于单张魅力。宠物是作为一个系统被看的；一帧不一致，整套陪伴就不可靠。

安装前校验图集

图集是视觉和工程交界的地方。检查图片尺寸、帧网格、状态名、帧数和元数据。图里有、pet.json 里没有的状态永远不会出现；状态名和上游契约不一致，会静默失败。

CodexSkin 的浏览器校验器会检查包结构并预览九组状态。它判断不了角色可不可爱，但能抓住浪费安装的无聊错误。分享前跑一遍。

安装与恢复

安装走上游宠物流程，不是通用 ZIP 导入。读对应平台的当前说明。macOS 流程更完整；Windows 的安装和恢复可用，但用户图片定制还没到同一水平。

继续定制前先练一次恢复。撤不掉的宠物是支持问题。把原始包和恢复说明放在一起，让下一个人能回到官方状态。

我们用的 QA 清单

清单跑两遍：一遍在原始文件上，一遍在安装后。第二遍才会暴露缓存、权限和路径问题。工作室里对、应用里不对，通常是安装问题，不是美术问题。

• 九组状态都存在，命名与上游契约完全一致。
• 每组状态都保留物种、斑纹、眼睛颜色和比例。
• 小尺寸下轮廓可读，细节没有变成噪声。
• 图集尺寸和帧网格与 pet.json 一致。
• 包内没有脚本、Shell 命令或可执行文件。
• 目标平台上的安装和恢复都能跑通。

免费工作室还是付费手册

免费工作室足够准备需求、预览状态和校验包。4.99 美元的宠物孵化手册增加九状态分镜、QA 清单和发布文案。它是一条生产捷径，不是使用工具的前提。

只给自己做一个宠物，先免费用。打算发布、售卖或做多个宠物，手册省下的时间比价格多。无论哪种，都别买承诺可执行安装器或一键魔法的包。

FAQ