技能介绍

要解决什么问题

在 Agent 或本地工作流里做文生图和改图时，常见痛点是：既要对接 OpenAI 风格的 POST /v1/images/generations 与 POST /v1/images/edits，又要在对话里从自然语言里抽出 prompt、尺寸、画质等参数，还要处理 IMG_API / IMG_KEY 未配置时进程读不到新环境变量的问题。本技能把「任务分类 → 参数提取 → 调用 Node 脚本 → 落盘」串成一条可重复的路径。

技能如何工作

任务类型：无图片来源、只有描述时走文生图；有本地路径、URL 或 data URL（含多图 --image）时优先走改图。
调用方式：支持自然语言自动触发，也可用 /gen-images 手动调用；底层执行 scripts/gen_images.js，默认模型 gpt-image-2，生成结果写入 ./gen-images/（可用 --output 自定义路径）。
参数：必填为文生图的 prompt，或改图的 prompt + 图片来源；可选项如 --size、--quality、--background、--output-format、--n 等从用户表述映射，缺省不追问。
环境：通过 IMG_API、IMG_KEY 读取接口地址与令牌，不绑定固定配置文件；调用前应先检查变量，缺失时引导用户提供并由助手配置，当前会话内需临时注入后再跑脚本。

适用边界与注意点

需要 Node.js 与后端真实支持上述两个图像接口；单次任务可能耗时 2～10 分钟，调用宜设较长超时（如 10 分钟）。不要在缺少必填参数时猜测意图；未在接口中定义的参数不要擅自添加。若密钥不宜出现在对话中，应改用用户自行 export / $env: / setx 等方式配置。