codex 安装 hatch pet skill 需区分桌面版与 cli 版：桌面版须用 v26.602+ 版本，右键打开终端执行 $skill-installer hatch-pet；cli 版执行 codex skill add hatch-pet；均需登录在线、重启应用并验证响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想给 Codex 装上 Hatch Pet 这类能生成桌宠的 Skill，但卡在「找不到安装入口」「提示 skill 不存在」「装完重启没反应」——不是你操作错了，是官方 Skill 仓库路径变了、CLI 和桌面版行为不一致、或者没触发重载机制。
确认 Codex 已正确登录并联网
打开 Codex 桌面应用，左下角状态栏必须显示绿色「Online」且用户名可见。如果显示「Offline」或「Signing in…」，点击右上角头像→「Sign out」，重新用 OpenAI 账号登录。这一步跳过会导致后续所有 skill 安装命令被静默忽略。
终端用户请先运行 codex status，确认输出含 status: online 和 user: your@email.com。若显示 Not authenticated，必须先执行 codex login 并完成浏览器授权。
安装 Hatch Pet Skill（桌面版专用）
桌面版不支持直接 npm 安装 Skill，必须通过内置命令行调用 Skill Installer。
在 Codex 主界面任意位置右键 → 选择「Open terminal」→ 输入：
$skill-installer hatch-pet
回车后等待终端返回绿色「✅ Installed hatch-pet successfully」。如果提示「Command not found」，说明你当前处于「Chat」模式而非「Terminal」模式——务必关闭聊天窗口，从主界面右键唤出终端。
【关键前提】 此命令仅在 Codex 桌面应用 v26.602 及以上版本有效。旧版本会报错「Unknown command」，需先去官网下载最新安装包覆盖更新。
安装通用 Skill（CLI 用户路径）
如果你用的是 codex CLI（即终端里敲 codex 启动），Skill 安装方式完全不同：
第一步：进入项目目录（任意空文件夹即可）
第二步：执行 codex skill add hatch-pet
第三步：等待下载完成，出现 Added skill: hatch-pet 提示
第四步：运行 codex skill list 确认 hatch-pet 出现在已启用列表中
注意：CLI 版本的 Skill 不会自动出现在桌面版界面里，两者配置完全隔离。你在 CLI 装的 Skill，桌面版里看不见也用不了。
验证 Skill 是否生效
重启 Codex 桌面应用——不是关闭再点图标，而是菜单栏点击「Codex → Quit Codex」，再双击图标重新启动。
启动后，在主输入框直接输入：
「你现在可以使用 hatch-pet 吗？」
如果返回类似「是的，我已加载 hatch-pet 技能，支持根据参考图生成桌宠角色与动作序列」，说明安装成功。如果回复「我不了解这个技能」，说明重载失败，需检查是否跳过了重启步骤。
此时上传一张清晰正面人像图，再输入「用这张图生成一个 Q 版桌宠角色设定」，Hatch Pet 就会开始处理。生成过程约耗时 1 小时，期间不要关闭 Codex 或切换任务。
