用途:通过 HappyCode 的 OpenAI 兼容 GPT Image 2 API 生成或编辑位图图像。当用户要求使用 HappyCode,或项目将其作为图像生成后端时使用。
主要能力:无输入图时执行生成;对已有图像提出修改时执行编辑。可识别编辑目标、参考图、蒙版与辅助输入,用重复的 --image 传入相关非蒙版图像,用 --mask 传入蒙版。支持批量生成 2-5 张新图,每张派生一个提示词并使用批量客户端。
使用方式:仅使用 <SKILL_DIR>/scripts 下的 HappyCode 客户端,不调用内置 image_gen 工具或其他提供方。Node 优先:node "<SKILL_DIR>/scripts/imagegen.mjs" --prompt "<request>";编辑:node "<SKILL_DIR>/scripts/imagegen.mjs" --image "<target>" --prompt "<edit>";批量:node "<SKILL_DIR>/scripts/imagegen-batch.mjs" --prompt "<derived prompt 1>" --prompt "<derived prompt 2>"。协议允许回退时可用 Python 3 客户端:python "<SKILL_DIR>/scripts/imagegen.py" --prompt "<same request>"。仅在用户指定其他目标时加 --out;否则在支持图像的界面使用默认 <working-directory>/output,其他界面先询问目标。客户端网络超时为 600 秒。
限制:提示词按用户请求原样传入,不翻译、改写、扩写、审查或添加风格、内容、负面或保留指令。超过 5 张输出时不启动客户端,要求用户减少数量;数量不明确时先询问。若返回 CONFIG_REQUIRED,检查配置路径是否存在,缺失则复制 <SKILL_DIR>/config.example.json,提示用户在本地设置 api_key,通常保持 base_url 与 model 不变,proxy 设为 URL 或空字符串,等待确认后仅重试一次。不得读取、显示或修改已有配置值,也不要求用户在对话中粘贴 API 密钥。SAVED 仅表示文件已保存;仅在用户要求审查、任务需要视觉验证或下次编辑需要视觉理解时检查结果。其他细节暂未提供。