用途:通过 Codex 内置的 image_gen 工具生成或编辑位图图像(照片、插画、样机、标志、产品图、游戏/UI 素材、纹理、信息图等),无需 OPENAI_API_KEY,也不按图计费,使用的是 ChatGPT/Codex 登录(~/.codex/auth.json)。
主要能力:generate 子命令可按提示词生成图片,-n 3 可生成 3 张不同图;edit 子命令可对本地已有图片做修改(换背景、改光照、替换物体、重绘风格等)。输出 PNG,默认写入当前目录并按提示词命名,支持 --out 指定文件或目录,--force 覆盖,否则写 -v2 副本。每次运行约 30–90 秒,脚本会打印 [codex-imagegen] wrote <path> 及绝对路径。
使用方式:需 codex CLI 在 PATH 且已 codex login。命令示例:python3 scripts/codex_imagegen.py generate --prompt "..." --out ./hero.png;python3 scripts/codex_imagegen.py edit --image ./photo.png --prompt "..." --out ./photo-sunset.png。提示词建议按场景→主体→细节→约束结构化,编辑时说明不变项。
限制:内置工具无原生透明背景控制,简单不透明主体可用 #00ff00 色键本地抠除(remove_chroma_key.py);头发、毛皮、玻璃等需要真正透明的场景须用需 OPENAI_API_KEY 的 OpenAI API CLI 回退方案,超出本技能范围。矢量/SVG 图标、HTML/CSS 图表不应使用本技能。若报 codex exec exited non-zero 或认证错误,请运行 codex login;找不到生成图像时查看 Codex 输出,慢属正常,可用 --timeout 调整(默认 300s)。