by 运行时依赖
安装命令
点击复制技能文档
🫧 Codex Pet — Pro Pack 在 RunComfy runcomfy.com · GPT Image 2 编辑端点 · 文档 Codex Pet 生成器在 RunComfy。将一个源图像转换为兼容的自定义 Codex Pet — pet.json + spritesheet.webp — 放入 ${CODEX_HOME:-$HOME/.codex}/pets//，Codex 将在下一次启动时加载它，除了 8 个内置的 Codex Pets 之外。什么是 Codex Pet OpenAI Codex Pets（于 2026 年 5 月发布）是像素艺术动画伴侣，它们会浮在您的桌面上，当 Codex 编码时，它们会对鼠标交互和 Codex 状态做出反应（当思考时挠头，当任务完成时弹出语音气泡）。Codex 随附 8 个内置的 Codex Pets，并支持自定义的 Codex Pets 作为本地文件夹安装在 ${CODEX_HOME:-$HOME/.codex}/pets/ 下。每个自定义 Codex Pet 文件夹包含两个文件：pet.json — 清单，包含 id、displayName、description、spritesheetPath。spritesheet.webp — Codex Pet 精灵图集，1536x1872 PNG 或 WebP，8 列 x 9 行的 192x208 单元格，透明背景。9 行对应于 Codex 播放的 9 个动画状态。每行使用固定数量的前导帧；尾随单元格保持完全透明。为什么选择这个 Codex Pet 技能（与 OpenAI 的官方 hatch-pet 相比）OpenAI 提供了一个官方的 hatch-pet 技能，它通过 Codex-internal $imagegen 系统技能生成相同的 Codex Pet 文物（需要 Codex Pro + $imagegen 配置）。这个 Codex Pet 技能是一个替代方案，通过 RunComfy CLI 运行：单个 RUNCOMFY_TOKEN 加上 runcomfy 和 magick 二进制文件 — 不需要 Codex Pro、$imagegen 或 OPENAI_API_KEY。输出的 Codex Pet 文物是相同的 — 相同的 pet.json 形状，相同的 spritesheet.webp 1536x1872 图集，相同的 9 个动画行 — 因此，Codex 将这个 Codex Pet 当作由 hatch-pet 制作的文物一样对待。这个技能遵循与 Codex 内置的 Codex Pets 相同的模式：一个规范姿势，通过 ImageMagick 微变换在单元格中复制以实现细微的动画（1-2 像素偏移、眨眼帧、倾斜帧）。这与官方的 hatch-pet 输出实际上看起来一模一样 — Codex 桌面应用程序中的 Codex Pet 动画是故意细微的。选择这个技能的场景：您想要一个自定义的 Codex Pet，但没有 Codex Pro / $imagegen。您想要通过 RunComfy Model API 构建一个自定义的 Codex Pet。您想要从源图像文件夹批量生成 Codex Pet（每个宠物调用一次）。您正在参加 OpenAI Codex Pet 竞赛，使用不同的模型作为视觉效果。您明确地说“codex pet”、“/hatch”、“为我制作一个 codex pet”、“spritesheet.webp”、“codex 桌面宠物”。Codex Pet 动画行 Codex 读取一个固定图集：8 列，9 行，192x208 单元格。每个 Codex Pet 行对应于一个具有特定帧数的动画状态。行 状态 使用列 帧 Codex Pet 行为 0 空闲 0-5 6 平静呼吸/眨眼；Codex Pet 的减少运动第一帧 1 向右跑 0-7 8 Codex Pet 向右移动 2 向左跑 0-7 8 镜像向左移动 3 挥手 0-3 4 打招呼/引起注意的手势 4 跳跃 0-4 5 期待，抬起，峰值，下降，稳定 5 失败 0-7 8 错误/悲伤/萎靡反应 6 等待 0-5 6 耐心等待变体 7 跑步 0-5 6 活跃工作/进行循环（不是脚步跑）8 审查 0-5 6 集中/检查/思考 每行最后一列之后的单元格必须完全透明。Codex Pet 风格 Codex Pet 视觉风格：夸张的 chibi 比例：头部占据总高度的 ~60%；身体和腿部是小小的、短短的。整个图形应该适合一个近似正方形的边界框。像素艺术邻近的低分辨率吉祥物，粗壮的剪影，厚厚的黑色 1-2 像素轮廓，明显的像素边缘，有限的调色板，平坦的 cel 着色，简单的富有表情的脸，微小的肢体，透明的背景。避免：运动线，下降阴影，光环，闪烁，浮动效果，文本标签，场景，白色/黑色背景。先决条件 RunComfy CLI — npm i -g @runcomfy/cli RunComfy 账户 — runcomfy 登录。CI 替代方案：RUNCOMFY_TOKEN=。ImageMagick — brew install imagemagick（macOS）或 apt-get install imagemagick（Linux）。提供 magick 命令用于确定性图集组装。源图像 URL — 公开可获取的 HTTPS，JPEG/PNG/WebP，是 Codex Pet 将要建模的主题。Codex Pet 流水线（1 GPT Image 2 调用，~2 分钟）规范 Codex Pet — 单个 runcomfy 运行 openai/gpt-image-2/edit 调用，生成一个 1024x1024 的 chibi 姿势，位于洋红色色键背景上。单元格归一化 — 色键洋红 → alpha 0，修剪，适合 192x208，带有透明填充。9 行条，程序化 — 对于 9 个动画状态中的每一个，通过 ImageMagick 微变换（转换/掩码/镜像）构建行的 8 个单元格。尾随单元格用透明 192x208 填充。图集 — 将 9 行条垂直堆叠到 1536x1872 的 Codex Pet 图集中。WebP — 将图集 PNG 转换为 WebP。清单 + 安装 — 编写 pet.json，复制