QuickAI 电商套图
用户提供商品图和商品信息。你负责理解商品、选图种、给每张图写提示词、确认数量，然后调用脚本生成并交付。脚本负责上传参考图、提交任务、查询进度、下载图片和生成预览页。
下面命令中的路径都相对本 Skill 目录（本文件所在目录）。macOS / Linux 用 python3，Windows 用 python。需要 Python 3.8 及以上，无第三方依赖。
1. 检查配置
python3 scripts/ecommerce_image_set.py check
报告缺少 AccessKey 时，告诉用户：
- 登录 https://openclaw.aisupermarket.top/?page=access-keys ，创建一个带"图片生成"权限的 AccessKey。
- 任选一种方式配置：把
config.example.json复制为config.json并填入access_key；或设置环境变量QUICKAI_ACCESS_KEY；OpenClaw 用户也可以在openclaw.json的skills.entries.quickai-ecommerce-image-set.apiKey中填写。
不要在回复、日志或生成的文件中显示 AccessKey。
2. 收集信息
必需：
- 商品图 1–6 张（本地路径或链接），第一张是主视角。没有商品图时先向用户要。用户坚持只用文字描述时，提醒生成的外观可能与实物不符。
- 商品名称和主要卖点。
可选，用户没给就不要编：规格参数、目标人群、平台、画面语言、风格偏好、风格参考图（最多用 2 张）、价格和活动、认证、真实评价、包装清单。
亲自查看商品图，用一句话写出 product.identity：外形、颜色、材质、Logo 位置和关键部件。脚本会把这句话附加到每张图的提示词里，用来保持商品一致。
3. 选图种
python3 scripts/ecommerce_image_set.py structures
- 用户只说"做一套主图"或"做详情页"时，按平台选预设，平台对照见
references/platforms.md。 trust、review、promo、size、detail_specs、detail_certification、detail_reviews、detail_cta需要用户提供真实材料。缺材料时跳过，并告诉用户原因。- 同一图种可以重复，如两张不同场景的
scene。
4. 写计划文件
把 templates/plan.example.json 复制到用户的工作目录（不要写进本 Skill 目录），再按下面的规则填写：
- 写每张图之前，先读
references/structure-guide.md中对应图种的小节。 prompt只描述画面：用途、商品位置和占比、场景、光线、文字区位置、质感。- 画面上要出现的文字逐段写进
text，不写进prompt。text使用language指定的语言；不需要文字时设为空数组。 style写整套统一的配色和光线，让整套图看起来是一个系列。- 比例默认取图种的比例。需要整套统一比例时（如小红书 3:4）在顶层写
size，单张也可以用size覆盖。 - 质量默认
low、分辨率默认 1K，最省积分。计划里不写quality时脚本也按low生成。只有用户明确要更好的画质或上架终稿时，才把quality调到medium/high、分辨率调到 2K，并先说明会多消耗积分。
| 字段 | 说明 |
|---|---|
name |
套图名称，用作默认输出目录名 |
platform |
平台，如 taobao、amazon、xiaohongshu |
language |
画面文字语言，默认 zh-CN |
product.name / identity |
商品名称；商品外观的一句话描述 |
product.selling_points / specs / audience |
供你写提示词用，脚本不直接使用 |
style |
整套风格 |
size |
可选，整套统一比例 |
product_images |
商品图，本地路径相对计划文件 |
style_images |
可选，风格参考图 |
defaults |
model、quality（low / medium / high，默认 low）、resolution（1K / 2K / 4K，默认 1K）、max_reference_images（默认 6） |
items[].structure |
图种 id；自定义图种写 custom，并提供 title 和 size |
items[].prompt |
画面描述 |
items[].text |
画面文字，最多 6 段 |
items[].size / resolution / quality / model |
可选，单张覆盖 |
model 省略时使用平台默认模型。可用模型以 QuickAI 平台为准，gpt-image-2 渲染文字效果较好。
5. 预览并确认
python3 scripts/ecommerce_image_set.py generate --plan <计划文件> --dry-run
--dry-run 只校验计划并输出最终提示词，不调用接口、不扣费。
每张图都会单独消耗积分。开始生成前，把张数、质量、分辨率和清单（序号、图种、一句话画面）告诉用户，等用户确认。用户已经明确说"直接生成"时可以跳过确认。
用户对风格没把握时，建议先只生成第一张（加 --only 1）。用户满意后再加 --resume 生成其余，第一张不会重复生成。
6. 生成
python3 scripts/ecommerce_image_set.py generate --plan <计划文件> --out <输出目录>
- 默认同时进行 3 个任务，单张最长等待 600 秒。进度输出到 stderr，最终结果 JSON 输出到 stdout。
- 单次新生成超过 15 张会被拦下。向用户确认后加
--max-items N。 - 输出目录已有结果时，必须选择一种方式：
--resume只补生成未完成或改动过的图片；--force全部重新生成；或用--out换一个目录。--resume不会重复扣已完成的图，生成中的任务会继续查询原任务。 - 修改某一张图：改计划文件中该项的
prompt或text，再运行--resume，只会重做改动过的那张。
退出码：0 表示全部完成，2 表示有图片未完成，1 表示配置、计划或参考图上传出错。
7. 交付
回复用户时包含：
- 预览页
index.html的路径（用浏览器打开）和图片目录。 - 每张图的序号、图种、文件名和状态。
- 这套图累计消耗的积分（
summary.credits_charged，包含续跑前已完成的图片），返回了余额时一并说明。 - 失败或未完成的图片：说明出错阶段（
submit提交、generate生成、poll查询、download下载）、原因和下一步，如"充值后用--resume继续"。 - 提醒用户核对画面中的文字、数字和参数。AI 渲染文字可能出错。
规则
- 认证、检测、销量、评价、价格、活动只能使用用户提供的材料，不要编造。不点名竞品，避免广告法极限词（见
references/platforms.md）。 - 计划文件和输出目录放在用户的工作目录，不要写进本 Skill 目录。
- 接口细节和错误排查见
references/api.md。
