先选中宠物，再用 /pet 唤醒浮层。
最快的方法是在 Codex 输入框中键入 /pet。这个命令负责显示或收起宠物浮层；设置里选哪只宠物和屏幕上是否显示，是两件不同的事。前者在 Settings → Appearance → Pets 中完成，后者由 /pet 控制。
如果命令菜单里没有 /pet，先确认 Codex 桌面端是否为当前版本，再考虑本地文件。功能开关或应用浮层坏了，不可能靠重新做一张精灵图修好。
- 用 /pet 显示或收起当前宠物。
- 在 Settings → Appearance → Pets 中切换宠物。
- 添加本地包后使用 Refresh custom pets。
- 先测试一只内置宠物，再判断是否是自定义素材问题。
宠物包应该无聊、简单、可检查。
一个本地宠物包只需要清晰的 manifest 和精灵图，并放在独立文件夹里。pet.json 负责名称与图片指向，文件夹名、manifest id、spritesheetPath 和真实文件名必须一致。不要把 JavaScript、Shell、远程加载器或模型设置藏进装饰包。
官方说明中的 v1 精灵图为 1536 × 1872：八列、九行，每格 192 × 208。部分社区工具使用更高的 v2 图集，但它是单独的社区版本，不能和 v1 尺寸混用。
- 使用符合声明版本的透明 PNG 或 WebP。
- 让特效和主体连接，避免单帧被裁掉。
- 在真实浮层尺寸检查等待、失败和完成动作。
- 复制进 Codex 宠物目录前先完成本地校验。
~/.codex/pets/my-companion/
├── pet.json
└── spritesheet.webp宠物不显示时，先区分“没发现”和“没渲染”。
第一步只问一个问题：自定义宠物有没有出现在 Settings 里？没有出现，说明应用还没有发现这个包，应检查当前 Codex Home、文件名、manifest id、spritesheetPath 和真实图片文件。
如果 Settings 能看到宠物，但 /pet 后屏幕上没有东西，改测内置宠物。内置与自定义同时失败，更像浮层窗口、显示缩放或应用功能开关问题；此时重做图片只是浪费时间。
- Settings 里没有：检查目录和 manifest 指向。
- Settings 里有、屏幕上没有：检查 /pet 和内置宠物。
- 只有一只自定义宠物失败：检查尺寸、透明度和帧边界。
- 所有宠物失败：更新 Codex，并按应用或显示问题处理。
宠物被裁切，不一定是图坏了，也可能是窗口把图切了。
已有多份桌面端报告显示，内置和自定义宠物会一起在屏幕边缘、缩放显示器或多屏环境下被裁切。如果两类宠物同时出问题，精灵图就不是共同原因。先把浮层拖离屏幕边缘、改用主显示器并更新应用。
如果只有一只自定义宠物被裁，应逐帧检查内容是否顶到 192 × 208 单元格边缘。优先在单元格内部增加透明留白，不要为了改尺寸去修改 app.asar。
- 在棋盘格、浅色和深色背景检查同一动作。
- 检查平滑插画是否出现强制像素缩放锯齿。
- 确保面部在真实浮层尺寸仍可辨认。
- 调整单元格内部留白时保持图集总尺寸不变。
Windows 和 WSL 要相信正在运行的 Codex 实际读取的目录。
Windows 原生模式和 WSL 支持的 Codex 可能解析到不同 Home。于是两边都存在看似正确的宠物包，但正在运行的应用只读其中一个。优先使用设置页提供的打开目录入口，把包放进当前实际目录。
不要用到处复制文件的方式掩盖路径问题。先记录唯一的包目录和宠物 id，确认原生模式可用，再切换运行模式。现有社区报告表明这是加载路径问题，不是修改精灵图规格的理由。
- 确认当前使用 Windows 原生还是 WSL 模式。
- 能从应用打开宠物目录时，以这个目录为准。
- 让 pet.json 和 spritesheet.webp 留在同一个宠物 id 下。
- 切换运行模式后重新确认当前 Home。
私人素材容易打动人，权利清楚才适合传播。
自己的猫狗或原创角色最容易让别人立刻理解关系。可识别伴侣必须明确同意制作和公开分享。明星照片、游戏角色、体育 Logo 和怀旧软件界面不会因为生成简单就自动获得商业授权。
安全的公开宠物包只有视觉数据与 manifest，不携带行为脚本。除非素材主人同意发布，否则原始参考图继续留在本地。猎奇负责获得点击，透明边界负责让用户敢安装。
- 私人制作同意与公开传播同意要分别确认。
- 长期售卖优先使用原创角色。
- 不要为了怀旧感直接打包第三方 Logo。
- 明确说明宠物不会改变 Codex 的能力和行为。
真正要量的是交接链路，不只是爆款播放量。
高播放并不等于能变现。有效漏斗是：选择创意、打开 Codex 需求、精灵图通过校验、生成安装链接、开始结账。每一步分别回答钩子是否找对人、用户能否完成制作、技术是否可靠以及付费捷径是否值钱。
每条内容只跑一个钩子，并保留落地页链接。狗、猫、Y2K 聊天搭子和原创构建怪应在同一渠道对比。播放高但打开需求低，说明只好笑不承接；打开多但校验失败多，应先修流程，不要继续买量。
- 前置信号：访问宠物制作器后选择创意。
- 激活信号：打开准备好的 Codex 制作需求。
- 质量信号：本地图集通过校验。
- 收入信号：各商品开始结账和 Stripe 实付事件。