用途:通过 Codex 完成文本→图像(text→image)与图像→图像(image→image)生成。生成文件默认写入当前工作目录下的 ./images/,首次运行自动创建该目录。生成模式可用 --out-dir <path> 覆盖输出目录,编辑模式用 --out <path> 指定输出文件。
前置条件:需已安装 Node.js ≥ 18,并完成 Codex 登录(npx @openai/codex login)。若缺失,应引导用户查阅 reference/installation.md,不代为安装或登录。
主要能力与参数:
- 生成:node <skill-root>/scripts/generate.js --prompt "描述" --quality high --size 1024x1024 --n 2。--prompt 必填;--n 取值 1–8,默认 1;--size 仅支持 1024x1024(1:1)、1024x1536(2:3,默认)、1536x1024(3:2);--quality 为 low|medium|high,默认 medium;--format 为 png|jpeg|webp,默认 png。
- 编辑/重绘:node <skill-root>/scripts/edit.js --input ./photo.png --prompt "转为水彩画" --quality high --out ./images/photo-watercolor.png。必填 --input、--prompt、--out,可选 --quality、--size、--format;编辑会保留构图与主体姿态。
- 校验:node <skill-root>/scripts/verify.js --input ./images/result.png,用于排查输出被截断;generate.js 与 edit.js 会自动调用并打印结果。
使用方式:从项目根目录运行脚本,使 ./images 指向预期目录;技能位于 <skill-root>/scripts/(常见为 Claude Code 的 .claude/skills/imagine/)。提示词尽量沿用用户原始表述,脚本已内置质量增强与负向提示,勿重复包装。运行后按脚本打印的路径如实报告;若出现校验失败,可对同一提示重跑一次,再次失败则直接反馈错误。未经用户要求,不要另行编辑图像或转交其他工具。
限制:出现 No OAuth session found、代理未响应、401/403 或限流时,需用户自行在终端处理凭证或配额问题。平台、收费与价格信息资料未提供。