没有 Codex Pro/$imagegen 时，用…

需要 OpenAI Codex 自定义宠物（pet.json + spritesheet.webp）但没有 Codex Pro/$imagegen，且可用 RunComfy 账号时。

适用场景

解决思路

1. 安装技能：npx skills add agentspace-so/runcomfy-agent-skills --skill codex-pet -g。
2. 安装 RunComfy CLI：npm i -g @runcomfy/cli；登录：runcomfy login；CI 中用 RUNCOMFY_TOKEN=<token>。
3. 安装 ImageMagick 以获得 magick：macOS 用 brew install imagemagick，Linux 用 apt-get install imagemagick。
4. 准备一个公开可获取的 HTTPS 源图 URL，格式为 JPEG/PNG/WebP，作为 Codex Pet 的建模主体；宠物、吉祥物、物体、食物等非人主体也可用，基础 prompt 会将其简化为 Codex Pet 风格。
5. 设置变量：PET_NAME、PET_DESC、SOURCE_URL、RUN_DIR="./codex-pet-run/${PET_NAME}"、CHROMA="#FF00FF"，并 mkdir -p "${RUN_DIR}"。
6. 用一次 runcomfy run openai/gpt-image-2/edit 生成 canonical Codex Pet；在 --input JSON 的 prompt 中要求：EXAGGERATED chibi proportions，head 约占 figure height 的 60%，body 和 legs 短粗，整体接近 1:1 near-square bounding box；pixel-art-adjacent low-resolution mascot、chunky whole-body silhouette、thick dark 1-2 px outline、visible stepped pixel edges、limited palette、flat cel shading、simple expressive face、tiny limbs、centered；禁止 polished illustration、painterly render、anime key art、3D render、glossy app-icon polish、realistic detail；背景为 solid flat magenta CHROMA 的 chroma-key fill；宠物本身不能使用 chroma-key 色或接近 magenta 的高光；无 gradients、shadows、halos、scenery、text，并避免 motion lines、drop shadows、glows、sparkles、floating effects、text labels、white/black backgrounds；保留输入图身份。images 设为 [SOURCE_URL]，size 设为 "1024*1024"，--output-dir 设为 ${RUN_DIR}/decoded/。取 ${RUN_DIR}/decoded/*.png 第一个为 BASE。
7. 避免 prompting 反模式：不要写 generic "transparent background"（GPT Image 2 会画近白背景）；不要让模型自由决定比例；不要在一个 prompt 中混合风格；固定一个风格锚点。
8. 规范化 canonical 为 192x208 Codex Pet cell：magick "${BASE}" -fuzz 18% -transparent "${CHROMA}" -alpha set -trim +repage -resize 192x208 -gravity center -background none -extent 192x208 "${RUN_DIR}/cell.png"；若 Codex Pet 有较宽 magenta halos，把 -fuzz 调到 25%；若有接近 magenta 的高光被裁掉，调到 8-10%。
9. 定义 ImageMagick helpers：shift_cell() { magick "$SRC" -background none -roll "+${1}+${2}" -alpha set "$3"; }；rotate_cell() { magick "$SRC" -background none -distort SRT "$1" -alpha set "$2"; }；make_blink() { magick "$SRC" -region 80x6+56+82 -fill "#f4e6d8" -colorize 70% -blur 0x0.5 +region "$1"; }；blank_cell() { magick -size 192x208 xc:none -alpha set "PNG32:$1"; }；build_row() 对每行生成 8 个 cell，未用尾随 cell 填透明，再用 magick "${RUN_DIR}/cells/row${row}-frame"*.png +append -alpha set "${RUN_DIR}/cells/row${row}-strip.png" 拼接为 1536x208 row strip。
10. 按 Codex 契约生成 9 行：row 0 idle 用 base base blink base base blink（6 帧）；row 1 running-right 用 base shift:1:0 shift:2:-1 shift:1:0 base shift:-1:0 shift:-2:-1 shift:-1:0（8 帧）；row 2 running-left 用 row1-strip 的 -flop 镜像生成；row 3 waving 用 base shift:0:-1 base shift:0:-1（4 帧）；row 4 jumping 用 shift:0:2 base shift:0:-8 shift:0:-2 base（5 帧）；row 5 failed 用 base shift:0:1 rotate:1 shift:0:1 shift:0:2 shift:0:1 rotate:-1 base（8 帧）；row 6 waiting 用 base base shift:0:-1 base base shift:0:1（6 帧）；row 7 running 用 base shift:0:-1 base shift:0:-1 base shift:0:-1（6 帧）；row 8 review 用 base rotate:-2 base rotate:2 base base（6 帧）。
11. 保持尾随单元格完全透明：每行在最后一个使用列之后填充透明 192x208 cell；不得改变 Codex 契约槽数：idle=6、running-right/left=8、waving=4、jumping=5、failed=8、waiting/running/review=6。
12. 调微动画：idle bob 把 row0 的 shift:0:-1 改为 shift:0:-2；running 周期增大 row1 水平位移，例如用 shift:3:0 替代 shift:2:-1；jump 峰值把 row4 的 shift:0:-8 改为 shift:0:-12；review 头倾把 rotate:-2/rotate:2 改为 rotate:-4/rotate:4；保持位移 ≤4 px 或旋转 ≤4°。
13. 合成 atlas：按 row0-strip.png 到 row8-strip.png 顺序用 magick ... -append -alpha set "${RUN_DIR}/spritesheet.png" 垂直堆叠为 1536x1872；再运行 magick "${RUN_DIR}/spritesheet.png" "${RUN_DIR}/spritesheet.webp" 转 WebP。
14. 写 manifest：pet.json 包含 id 为 ${PET_NAME}、displayName 为 ${PET_NAME}、description 为 ${PET_DESC}、spritesheetPath 为 "spritesheet.webp"。
15. 安装：DEST="${CODEX_HOME:-$HOME/.codex}/pets/${PET_NAME}"；mkdir -p "${DEST}"；cp "${RUN_DIR}/pet.json" "${RUN_DIR}/spritesheet.webp" "${DEST}/"；重启 Codex 或重载 pet 列表，自定义 Codex Pet 会出现在 8 个内置宠物旁。
16. 若 canonical 身份漂移，重跑第 1 步并在 prompt 中更紧地保留身份，例如指定 hair color、glasses、accessory；第 2-6 步是确定性的，不需修改。
17. 若宠物含 near-magenta 颜色，prompt 和后处理都改用 #00FFFF cyan 或 #00FF00 green 作为 chroma-key。
18. 若要自定义姿势或替换行，修改第 3 步的 build_row 调用；但每行 atlas 槽数必须匹配 Codex 契约，否则 Codex 无法正确播放。
19. 排查退出码：runcomfy 0 成功；64 bad CLI args；65 bad input JSON/schema mismatch（例如 size: "1024_1024" 而不是 "1024*1024"）；69 upstream 5xx；75 retryable timeout/429；77 未登录或 token rejected；magick 返回非 0 检查缺少输入帧或输出路径权限问题。
20. 安全处理：runcomfy login 把 token 写到 ~/.config/runcomfy/token.json，mode 0600；CI 用 RUNCOMFY_TOKEN；输入走 --input JSON，CLI 不做 shell 展开；把源图 URL 视为不可信；仅访问 model-api.runcomfy.net 和 *.runcomfy.net / *.runcomfy.com；CLI 会中止单个 canonical 下载 >2 GiB；最终只写本地 ${CODEX_HOME:-$HOME/.codex}/pets/<pet-name>/，无远程上传。
21. 注意：本方法只生成一个 canonical pose，动画由 ImageMagick 微变换产生，适合 Codex 内置宠物那种微妙动画；不会产生戏剧化逐帧动作；GPT Image 2 不输出 alpha，必须用 chroma-key 后处理；Codex Pets 纯视觉、无音频/语音。

适用边界 · 注意事项

• 当已有 Codex Pro 且 $imagegen 可用时，不适用；应优先使用官方 hatch-pet。
• 不能自托管 GPT Image 2；没有可用的 RunComfy 账号和 RUNCOMFY_TOKEN 时不要用。
• 不适合需要明显逐帧生成动画或音频/语音的 Codex Pet；本方法只有单 canonical pose + ImageMagick 微变换，且 Codex Pets 仅视觉。