> ⚠️ 美术必读 — 尺寸限制：Codex CLI 最大输出约 1.57MP（1254×1254 级别），所有尺寸都会被卡在这个上限内。4K/FHD/2K 都会降级，不会真的输出那些尺寸。详见下方安全尺寸表。
>
> ⏱️ 超时注意：Codex CLI 生图耗时较长（约 30~90 秒），调用时 timeout 应设不低于 180 秒，避免 agent 误判为失败而中断重试。
> 完成后看一眼生成的图对不对：Codex CLI 报错信息不一定准——报“failed N times with a server error”不一定真没生成。Agent 有视觉能力就调一下 image 工具看一眼生成的图是否对需求；没生成或内容不对，重试即可。
| 用途 | 推荐尺寸 | 实际输出 | 风险 |
|---|---|---|---|
| ------ | --------- | --------- | ------ |
| 方图素材（安全） | 1K / 1:1 / square | 1254×1254 | ✅ 无缩放 |
| 横版大图（安全） | 1536x1024 | 1536×1024 | ✅ 无缩放（唯一精确大尺寸） |
| 竖版素材（安全） | 9:16 | 941×1672 | ✅ 无缩放 |
| 横版4:3（安全） | 4:3 | 1448×1086 | ✅ 无缩放 |
| 16:9 横版 | 2K / FHD / 16:9 | 1672×941 | ⚠️ 实际只有 HD 级 |
| 4K / 1080p / 720p | ❌ 勿用 | 全部降级至 1672×941 | ❌ 严重缩水 |
| 小图如 512×512 | ❌ 勿用 | 膨胀至 1254×1254 | ❌ 严重放大 |
结论：游戏 UI 素材推荐用 1K（方图）或 1536x1024（横版），不要用 FHD/4K/720p 等标识。
| 任务 | 命令 |
|---|---|
| ------ | ------ |
| 单张图片 | bash ~/.openclaw/skills/codex-imggen/scripts/generate.sh " |
| 指定尺寸 | bash ~/.openclaw/skills/codex-imggen/scripts/gen_size.sh |
| 批量游戏 UI | bash ~/.openclaw/skills/codex-imggen/scripts/batch_generate.sh " |