安装
如何安装 hatch-pet
hatch-pet 是用于创建、校验和打包 Codex 自定义动画宠物的技能。安装后，你可以用它从文字描述或参考图生成一个本地宠物包。
安装前确认
你需要使用支持 Skills 的 Codex 环境。这个教程默认你已经能在 Codex 对话里输入以 $ 开头的技能命令。
| 安装命令 | $skill-installer hatch-pet |
|---|---|
| 创建命令 | $hatch-pet |
| 最终安装目录 | ~/.codex/pets/<pet-name>/ |
详细步骤
- 在 Codex 对话中运行 $skill-installer hatch-pet。
- 安装完成后重启 Codex，让新技能生效。
- 在新对话里用 $hatch-pet 加宠物描述或参考图开始制作。
- 等待生成、检查 contact sheet，再把最终包放入 ~/.codex/pets/<pet-name>/。
1. 安装技能
在 Codex 对话框里输入下面这条命令：
$skill-installer hatch-pet如果 Codex 询问是否安装或启用相关技能，按提示确认。安装完成后，建议完全重启 Codex，而不只是刷新当前页面或打开新对话。
2. 验证技能可用
重启后，新开一个 Codex 对话，输入 $hatch-pet。如果命令能被识别，就说明技能已经可用。
$hatch-pet如果 Codex 提示找不到技能，通常是安装没有完成、没有重启，或者当前环境没有启用 Skills。
3. 创建第一只宠物
给 hatch-pet 一个具体、短小、适合像素宠物的描述。比如：
$hatch-pet 创建一个青绿色像素机器人宠物，白色机身，黑色屏幕脸，顶部小天线，风格简洁可爱。如果你有参考图，可以把图片发给 Codex，然后让 hatch-pet 基于参考图制作。描述越稳定，后续动画行越容易保持同一个角色。
4. 检查生成结果
hatch-pet 会生成基础图、动画行、contact sheet、校验结果和最终宠物包。安装前重点检查三件事：
- 每个动画行看起来都是同一只宠物。
- 没有网格线、文字、标签或多余背景。
- 最终目录里至少有
pet.json和spritesheet.webp。
5. 安装到 Codex
把最终生成的宠物目录放到本地 Codex pets 目录下：
~/.codex/pets/<pet-name>/
pet.json
spritesheet.webp放好后重启 Codex，再到 Appearance / Pets 里选择你的宠物。
常见问题
运行命令后没有反应怎么办？
先确认命令是输入在 Codex 对话里，而不是系统终端。技能命令以 $ 开头。
安装后还是找不到 hatch-pet 怎么办？
重启 Codex，再开一个新对话测试 $hatch-pet。如果仍然不可用，说明当前 Codex 环境可能没有启用 Skills 或安装流程没有完成。
宠物生成完但没有显示怎么办？
检查目录是否是 ~/.codex/pets/<pet-name>/，并确认里面有 pet.json 和 spritesheet.webp。也可以对照 包格式规范。
下一步：创建第一个 Codex 宠物。