一键电商图直出

用途

将用户提供的 1-3 张产品图片转化为一套可执行的电商详情图生产流程：

1. 提取品牌、品类、规格、卖点、设计风格、受众、参数和产品细节。
2. 生成结构化《识别报告》，把“图片可见事实”“合理推断”“联网待核验信息”分开。
3. 根据报告生成严格 15 屏的中文图像提示词，保持同一品牌视觉系统。
4. 默认调用 Prism gpt-image-2，每屏 1 张、1K、2:3 竖版；建议设计尺寸为 680×1020px。
5. 轮询每个任务并输出结果索引、失败原因和可重试任务。

触发条件

遇到以下请求时加载本技能：

• 根据产品图片制作电商详情页、商品长图或 15 屏详情图。
• 用户要求先识别图片中的品牌、卖点、规格，再生成图。
• 用户提供本地图片路径或可访问图片 URL，并要求通过 Prism 生图。
• 用户要求批量生成 15 张、1K、2:3 竖版商品视觉素材。

输入与前置条件

• 接受 1-3 张产品图片。只把用户有权使用的图片用于识别和生成。
• 本地图片只用于视觉识别和任务目录归档；每张本地图片必须有一一对应、可被 Prism 访问的 HTTPS URL，并通过 image_urls 传给每一屏任务。
• 当前 API 文档未提供本地文件上传接口。若宿主环境无法把本地图片上传并获得 HTTPS URL，必须停止生图并说明缺少参考图 URL；严禁降级为文生图。
• 设置环境变量 PRISM_API_TOKEN。不要把 Token 写入 SKILL.md、脚本、日志、ZIP 或输出索引。
• 默认 API Base URL 为 https://lengjing.0c0.cn，可用 PRISM_API_BASE_URL 覆盖。
• 需要具备图片理解能力的对话模型完成识别报告。若模型无法读取本地图片，先要求用户提供可访问 URL 或由宿主环境完成图像注入，不要凭文件名臆测产品信息。
• 若启用联网搜索补充卖点，必须记录来源 URL，并将无法验证的内容标记为“待核验”，不把搜索摘要直接当成产品事实。

第一次获取 API Token 教程

1. 登录 Prism/棱镜控制台。
2. 进入“令牌管理”或 API Token 管理页面。
3. 创建一个用于图片生成的 Token，并按平台要求复制完整值。不要把 Token 发到公开聊天、提交到 Git 或放入技能包。
4. 在 Windows PowerShell 中设置当前会话环境变量：

$env:PRISM_API_TOKEN = "粘贴你的 Token"

5. 若要持久保存到当前用户环境变量，使用：

[Environment]::SetEnvironmentVariable("PRISM_API_TOKEN", "粘贴你的 Token", "User")

设置后重新打开终端或 IDE，使环境变量生效。技能脚本只读取 PRISM_API_TOKEN，不会读取工作区中的 key.txt，也不会回显 Token。

标准工作流

1. 校验图片输入

• 校验图片数量为 1-3 张。
• 记录本地路径和/或参考图 URL，不复制、不修改原图。
• 检查图片是否可读；缺图、损坏或 URL 不可访问时停止生图，只输出需要补充的输入项。
• 将图片中能直接读到的文字作为事实；模糊文字使用“无法确认”，不要补全品牌或参数。

2. 生成产品识别报告

严格按以下结构输出，并保留每项证据状态：

【识别报告】
品牌名称：[中文] / [英文]
品牌证据：[图片可见 / 用户提供 / 无法确认]
产品类型：[大类] - [具体产品]
产品规格：[具体规格，无法确认的字段标记待核验]
核心卖点：
1. [卖点1 - 中文 / English]（证据：包装文字/图标/视觉推断/待核验）
2. [卖点2 - 中文 / English]（证据：...）
3. [卖点3 - 中文 / English]（证据：...）
4. [卖点4 - 中文 / English]（证据：...）
5. [卖点5 - 中文 / English]（证据：...）
主色调：[颜色名称] (#HEX) + [颜色名称] (#HEX)
辅助色：[颜色名称] (#HEX)
设计风格：[风格描述]
目标受众：[用户画像]
品牌调性：[调性描述]
包装亮点：[特殊设计元素]
产品细节：[材质、结构、接口、部件、包装配件]
使用说明/注意事项：[仅填写图片可见或用户提供内容]
推荐视觉风格：[视觉风格名称]
推荐文字效果：[文字排版效果名称]
特殊需求：[模特/场景/数据可视化/其他]
图片链接：[参考图 URL；本地图片写明“本地路径，未提供 URL”]
联网核验：[查询结论、来源 URL、仍待确认的点]
风险提示：[不得虚构的功效、认证、销量、评价、参数]

识别报告完成后再进入提示词阶段。报告中涉及功效、认证、医疗、食品营养、销量、用户评价、专利或“第一/最好”等宣传内容时，除非有明确证据，否则只能写成待核验或建议文案，不能直接用于生成确定性承诺。

3. 生成 15 屏中文提示词

将每一屏写成独立条目，提示词和负面提示词均使用中文。统一追加以下全局约束：

• 2:3 竖版，建议 680×1020px，1K 输出。
• 产品外观、包装文字、Logo、颜色和结构以参考图为准；不得擅自改品牌名、规格、配色或部件。
• 采用统一的品牌色、字体气质、光线方向、材质表现和留白规则。
• 每一屏必须把同一组 image_urls 作为参考图发送给 API；不得只在提示词中写“参考原图”却不传参考图。
• 产品身份锁定为硬约束：包装轮廓、尺寸比例、Logo 位置、品牌文字、主色、图案、材质、封口、部件数量和结构必须与参考图一致；只允许改变背景、角度、光线、构图和信息排版。
• 重要中文文字尽量使用后期排版；若模型直接生成文字，必须提示“文字清晰、无乱码、无错别字”，并在结果索引中提示人工校对。
• 不生成无法证实的功效、认证、评价、销量、对比结论或促销价格。

固定屏幕规划：

1. 产品主图：白底或简洁背景，正面完整展示。
2. 核心卖点爆炸头：最强已核实卖点的大字报式呈现。
3. 产品细节特写 1：材质、工艺、质感。
4. 产品细节特写 2：功能部件、创新点或结构。
5. 使用场景图 1：生活化真实场景。
6. 使用场景图 2：第二个真实使用场景。
7. 功能对比图：仅对比可证实的使用差异，不夸大效果。
8. 规格参数图：尺寸、容量、重量、功率等已确认参数。
9. 卖点分解图 1：第一个核心功能详解。
10. 卖点分解图 2：第二个核心功能详解。
11. 卖点分解图 3：第三个核心功能详解。
12. 用户好评/信任背书：仅使用真实授权评价、荣誉或合规背书；缺少素材时改为“品质细节/服务承诺”版，不伪造截图。
13. 包装展示：外箱、礼盒、配件全家福。
14. 品牌故事：仅使用用户提供或可核验的品牌理念、工艺、产地信息。
15. 购买引导：只放用户提供的套餐、促销和行动号召；缺失价格时使用中性“了解更多/咨询客服”。

每屏格式：

第X屏：[屏幕主题]
提示词：[构图、主体、产品一致性、色调、光线、信息层级、文字区域、风格、2:3、1K、中文要求]
负面提示词：[变形、错误 Logo、乱码、虚假认证、虚假评价、无关产品、过度装饰、裁切、低清晰度等]

4. Prism 能力发现与 Schema 校验

先读取 references/api_reference.md，再按真实接口执行：

1. GET /v1/capabilities?type=image，确认 gpt-image-2 是否可用。
2. GET /v1/capabilities/gpt-image-2/schema，确认 aspect_ratio=2:3、image_size=1K、n、image_urls 和 prompt 是否支持。
3. 若能力列表没有 gpt-image-2，停止提交并报告可用图片能力，不擅自切换模型。
4. 若 Schema 不支持某个默认参数，按 Schema 调整并在结果中记录调整项。

5. 并发提交、超时重试与归档

使用 scripts/generate_set.py。每次运行必须传入 1-3 个 --original 原图路径：

$env:PRISM_API_TOKEN = "粘贴你的 Token"
& "C:\Users\Administrator\.workbuddy\binaries\python\versions\3.13.12\python.exe" `
  ".\一键电商图直出\scripts\generate_set.py" `
  --prompts ".\outputs\chaye-test\prompts-15.json" `
  --output ".\outputs\ecommerce-runs" `
  --original ".\chaye.jpg" `
  --image-url "https://your-upload-host.example/chaye.jpg"

脚本行为：

• 默认要求恰好 15 条提示词；缺少或多于 15 条直接失败。
• 15 屏通过线程池并发提交，默认 15 个并发 worker；可用 --workers 降低并发数。
• 每屏每次尝试从提交开始计算总预算 90 秒；超时、服务端失败或无结果 URL 时，重新提交该屏。
• 每屏最多提交 3 次，3 次均失败后才判定该屏失败；每次尝试的任务编号、耗时、状态和错误都会写入 manifest。
• 每次重试必须继续携带同一组 image_urls，不得因重试而丢失参考图或切换成文生图。
• 请求头使用 Authorization: <PRISM_API_TOKEN> 和 Content-Type: application/json。
• 提交参数固定包含 prompt、aspect_ratio: 2:3、image_size: 1K、n: 1 和非空 image_urls；任何一屏缺失参考图 URL 都必须拒绝提交。
• --original 和 --image-url 必须各提供 1-3 个且数量一致，按输入顺序一一对应。
• 不保存 Token，不把认证头写入日志。
• 每次运行在 --output 下创建一个 YYYYMMDD_HHMMSS 独立目录；目录内复制原图，保存 15 屏生成图片和 manifest.json。
• 生成图片按设计顺序命名为 01-主题.png 至 15-主题.png，自动清理 Windows 非法文件名字符。
• 任务状态成功时从 data.result.url 或 data.result.urls[0] 提取结果；成功任务会自动下载到本次运行目录。
• 超时重试不重复使用已完成任务；每次重新提交都会生成新的任务编号并独立记录。

6. 交付与人工检查

交付以下内容：

• 产品识别报告。
• 15 屏中文提示词 JSON 或 Markdown。
• 15 屏任务结果索引 manifest.json。
• 成功图片 URL；如需本地下载，必须由宿主环境在用户确认后执行。
• 文字、Logo、规格、价格、评价和合规宣传语的人工复核清单。

不要宣称“已下载”或“已生成成功”，除非任务状态确实为 success 且结果 URL 已返回。

错误处理

• 401：Token 无效或过期，提示重新创建/更新 PRISM_API_TOKEN，不重试相同请求。
• 403：账号或能力无权限，停止并报告。
• 404：模型、Schema 或任务不存在，重新检查能力编码，不猜编码。
• 429：退避后有限重试，超过上限保留任务编号和失败屏。
• 400：根据响应定位字段问题，重新读取 Schema 后再提交。
• 500：保留已完成屏和服务端错误信息，可稍后重试失败屏。
• 识别阶段缺少可读图片时，不进入生图阶段。
• 缺少 HTTPS 参考图 URL、URL 数量与原图数量不一致、Schema 不支持 image_urls 或 payload 中 image_urls 为空时，立即停止，不允许文生图兜底。
• 任何疑似违法、侵权、虚假宣传或未经授权的品牌素材，暂停相关屏并要求用户确认授权或替换文案。

资源

• references/api_reference.md：从 prism-api-docs.md 整理的实际接口、字段和错误码。
• scripts/generate_set.py：能力发现、Schema 校验、15 屏并发提交、90 秒超时重试、结果下载和 manifest 生成脚本。