用途：为当前项目生成或编辑位图图像，例如网站素材、游戏素材、UI 模型图、产品模型图、线框图、标志设计、写实照片或信息图。
主要能力：支持两种顶级模式。默认优先使用内置 image_gen 工具，可生成、编辑并处理透明背景图像，不需要 OPENAI_API_KEY。CLI 回退模式脚本为 scripts/image_gen.py，包含 generate、edit、generate-batch 三个子命令，仅在用户明确要求或确认 CLI/API/模型路径时使用，需要 OPENAI_API_KEY。CLI 默认模型为 gpt-image-2，支持 quality 等参数，gpt-image-2 不支持 background=transparent。
使用方式：默认用内置 image_gen 处理普通生成与编辑请求，透明背景需请求真实透明并保留 alpha。编辑仅针对对话上下文中可见的图像；本地文件要先经 view_image 加载。内置模式默认保存到 $CODEX_HOME/generated_images/...，项目所用最终素材需移入工作区，避免只留在默认路径；不要覆盖已有素材，除非用户明确要求，否则创建带版本的新文件名。多素材时逐项调用，不要用 n 代替不同提示词。CLI 回退仅在被明确要求时使用，不要修改 scripts/image_gen.py。提示词可参考 references/prompting.md 与 references/sample-prompts.md。
适用场景：生成新图像、基于参考图生成、编辑现有图像（局部重绘、光照天气、换背景、去物体、合成、透明背景）、批量产出素材或变体。
限制：不适合扩展仓库内已有 SVG/矢量图标、标志系统或插画库，也不适合用 SVG、HTML/CSS、canvas 即可完成的简单图形、图表、线框图或图标。CLI 回退的具体模型、质量、尺寸、掩码、输出格式与路径配置见 references/cli.md 与 references/image-api.md；未提供的信息暂未说明。