Imagegen 命令行工具

# CLI 参考 (`scripts/image_gen.py`) 此文件包含捆绑的图像生成 CLI 的“命令目录”。保持 `SKILL.md` 为概览优先；将详细的 CLI 细节放在此处。 ## 此 CLI 的功能 - `generate`：根据提示词生成新图像 - `edit`：编辑现有图像（可选遮罩）— 重绘 / 背景替换 / “仅更改 X” - `generate-batch`：从 JSONL 文件运行多个任务（每行一个任务） 实时 API 调用需要 **网络访问** + `OPENAI_API_KEY`。`--dry-run` 不需要。 ## 快速开始（适用于任何仓库） 设置技能 CLI 的稳定路径（默认 `CODEX_HOME` 为 `~/.codex`）： export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}" export IMAGE_GEN="$CODEX_HOME/skills/imagegen/scripts/image_gen.py" 空运行（无 API 调用；无需网络；不需要 `openai` 包）： python "$IMAGE_GEN" generate --prompt "Test" --dry-run 生成（需要 `OPENAI_API_KEY` + 网络）： uv run --with openai python "$IMAGE_GEN" generate --prompt "A cozy alpine cabin at dawn" --size 1024x1024 未安装 `uv`？使用你当前的 Python 环境： python "$IMAGE_GEN" generate --prompt "A cozy alpine cabin at dawn" --size 1024x1024 ## 防护栏（重要） - 使用 `python "$IMAGE_GEN" ...`（或等效的完整路径）进行生成/编辑/批量工作。 - **不要**创建一次性运行脚本（例如 `gen_images.py`），除非用户明确要求自定义包装器。 - **永远不要修改** `scripts/image_gen.py`。如果缺少某些功能，请在执行任何操作前先询问用户。 ## 默认值（除非被标志覆盖） - 模型：`gpt-image-1.5` - 尺寸：`1024x1024` - 质量：`auto` - 输出格式：`png` - 背景：未指定（API 默认）。如果你设置 `--background transparent`，同时设置 `--output-format png` 或 `webp`。 ## 质量 + 输入保真度 - `--quality` 适用于 `generate`、`edit` 和 `generate-batch`：`low|medium|high|auto`。 - `--input-fidelity` 仅适用于 `edit`：`low|high`（对于身份或布局锁定等严格编辑，请使用 `high`）。 示例： python "$IMAGE_GEN" edit --image input.png --prompt "Change only the background" --quality high --input-fidelity high ## 遮罩（编辑） - 使用 **PNG** 遮罩；强烈建议包含 Alpha 通道。 - 遮罩应与输入图像尺寸匹配。 - 在编辑提示词中，重复不变项（例如，“仅更改背景；保持主体不变”）以减少偏移。 ## 可选依赖 推荐使用 `uv run --with ...` 进行开箱即用的运行