Skip to content
Back to search

ecom-details-image

Create visual concepts, image-generation prompts, and optional AI-generated images for product hero images, marketing creatives, social posts, ads, ecommerce PDP visuals, and general visual design tasks. Use when the user asks for visual strategy, image prompt writing, product/marketing image direction, or direct text-to-image generation. In Codex environments use the built-in imagegen tool; elsewhere use the bundled script, which prefers the dreamina-canvas CLI (Seedream 5.5) and falls back to the apiz CLI.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/liangdabiao--ecom-details-image/badge.svg)](/listings/liangdabiao--ecom-details-image)

HTML

<a href="/listings/liangdabiao--ecom-details-image"><img src="/api/listings/liangdabiao--ecom-details-image/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 675 lines
  1. ---
  2. name: ecom-details-image
  3. description: Create visual concepts, image-generation prompts, and optional AI-generated images for product hero images, marketing creatives, social posts, ads, ecommerce PDP visuals, and general visual design tasks. Use when the user asks for visual strategy, image prompt writing, product/marketing image direction, or direct text-to-image generation. In Codex environments use the built-in imagegen tool; elsewhere use the bundled script, which prefers the dreamina-canvas CLI (Seedream 5.5) and falls back to the apiz CLI.
  4. ---
  5. # ecom-details-image Skill
  6. 当用户需要视觉策略、图片 Prompt、商品主图、营销图、社媒图、广告图、电商 PDP 视觉,或要求直接 AI 生图时,使用这个 Skill。
  7. 这个 Skill 有两种模式:
  8. 1. **Brief / Prompt 模式**:只输出视觉简报和可执行图片 Prompt。
  9. 2. **Generate 模式**:当用户明确要求“生图、生成图片、出图、render image”时,先输出最终 Prompt,再按下方**生图通道判断**选择生成方式。
  10. 不要暴露、索要、写入、提交或回显真实 API key。使用者必须通过自己的环境变量配置 API。
  11. ---
  12. ## 生图通道判断(Generate 模式必读)
  13. 直接生图前必须先判断当前运行环境,选择对应通道:
  14. ### 通道 A:Codex 环境 → agent 内置 imagegen
  15. **判断方法**:检查你自己(agent)当前会话中是否具备内置的 `imagegen` 工具。有,说明你在 Codex 环境。
  16. 执行方式:
  17. 1. 不要调用 `scripts/generate_image.py`,直接调用内置 `imagegen` 工具。
  18. 2. 把最终 Prompt(含 Campaign Style Lock)作为 `prompt` 传入;工具如支持比例/尺寸参数,传入对应比例。
  19. 3. 如果用户提供了参考产品图,按 imagegen 工具的参考图/编辑参数传入。
  20. 4. 把返回的图片文件记录为 Generated Files;建议将文件移动或复制到 `generated-images/<产品slug>/` 目录,与本 Skill 的输出习惯保持一致。
  21. 5. imagegen 不可用或调用失败时,回退到通道 B。
  22. ### 通道 B:非 Codex 环境 → 即梦 dreamina-canvas CLI(默认优先)
  23. claude code / OpenClaw 等其他环境使用 `scripts/generate_image.py`,默认(`--channel auto`)优先走**即梦通道**:脚本转交 `scripts/generate_image_dreamina.py`,内部调用 **dreamina-canvas CLI** 在即梦画布内生成,默认模型 **Seedream 5.5**。
  24. 前置条件(本机通常已就绪):
  25. 1. 已安装 dreamina-canvas CLI(`dreamina-canvas --version` 可执行)。
  26. 2. 已登录:`dreamina-canvas auth login` 完成 OAuth。认证完全由 CLI 处理,脚本不接触密钥。
  27. 可选配置(通过 `.env` 或环境变量,全部可省略):
  28. ```dotenv
  29. DREAMINA_IMAGE_MODEL=seedream_5.5
  30. # DREAMINA_CANVAS_ID=<画布UUID> # 不设置时用当前画布或自动创建 ecom-details-image 画布
  31. DREAMINA_RESOLUTION=2K
  32. DREAMINA_CREDIT_CEILING=10
  33. # DREAMINA_BIN=C:\path\to\dreamina-canvas.exe
  34. ```
  35. 能力要点:
  36. - 模型用 `dreamina-canvas model list --type image` 实时查询;Seedream 5.5 支持文生图/图生图、`1:1/3:4/4:3/16:9/9:16/2:3/3:2/21:9`、`1.5K/2K`、单节点 1-8 张、参考图最多 10 张、Prompt 上限 5000 字符。
  37. - 不支持的比例如 `4:5` 脚本会自动换算到最接近的支持比例(`3:4`)并说明。
  38. - **多参考图是即梦通道的优势**:用户提供了多角度产品图时,用多个 `--image` 传入(最多 10 张),产品一致性显著更好。
  39. - 计费按即梦积分:Seedream 5.5 实测 2K 约 **6 积分/张**(`dreamina-canvas auth account` 查余额)。批量出图前先报预计积分消耗并经用户确认。
  40. - 国内版产物左上角带「AI生成」合规水印,交付前提醒用户。
  41. - 即梦 CLI 未安装或未登录时回退通道 C,不要阻塞:返回完整 Prompt 包和 `dreamina-canvas auth login` 指引。
  42. ### 通道 C:非 Codex 环境 → apiz CLI(回退)
  43. 即梦 CLI 不可用,或显式 `--channel apiz` / `ECOM_IMAGE_CHANNEL=apiz` 时,脚本内部调用 **apiz CLI**(https://apiz.ai)提交生成任务并下载结果,不再直连任何 HTTP API。
  44. 前置条件(本机通常已就绪):
  45. 1. 已安装 apiz CLI(`apiz --version` 可执行)。
  46. 2. 已登录:`apiz auth login` 保存过 API key,或设置了 `APIZ_API_KEY` 环境变量。认证完全由 CLI 处理,脚本不接触密钥。
  47. 可选配置(通过 `.env` 或环境变量,全部可省略):
  48. ```dotenv
  49. APIZ_IMAGE_MODEL=apiz/gpt-image-2.5-flare
  50. # APIZ_API_KEY=sk-xxx # 仅未使用 apiz auth login 时需要
  51. # APIZ_BASE_URL=https://api.apiz.ai
  52. # APIZ_BIN=C:\path\to\apiz.exe
  53. ```
  54. - `APIZ_IMAGE_MODEL`:apiz 图片模型 id,默认 `apiz/gpt-image-2.5-flare`(GPT Image 2.5,支持参考图编辑、10 种比例、1K/2K/4K)。兼容旧别名 `IMG_MODEL`、`OPENAI_IMAGE_MODEL`、`OPENAI_MODEL`。
  55. - 其他可用模型用 `apiz models list` 查看(category=image),如 `fal-ai/nano-banana-pro`、`apiz/gpt-image-2.5-sunburst`。
  56. - 旧变量 `IMG_API_KEY`、`IMG_BASE_URL` 仍被兼容读取。
  57. 生图脚本:
  58. ```bash
  59. python3 scripts/generate_image.py --prompt "clean product hero image..." --size 1:1
  60. python3 scripts/generate_image.py --prompt-file prompt.txt --output-dir outputs
  61. python3 scripts/generate_image.py --env-file .env --prompt-file prompt.txt
  62. ```
  63. **参考图片**:如果用户提供了本地产品照片路径,使用 `--image` 参数传入;脚本会先 `apiz upload` 上传到 apiz CDN 换取公网 URL,再走图生图,这对保证产品外观准确非常有效。已有公网 URL 时用 `--image-url` 直接传入。
  64. **注意**:生图会消耗 apiz 账户积分(`apiz account balance` 查看)。批量出图前先把 Image Pack Plan 报给用户确认。
  65. 如果 apiz CLI 未安装或未登录,不要阻塞:返回完整 Prompt 包,并给出安装/登录指引(`apiz auth login`),方便用户稍后自行运行。
  66. ---
  67. ## 核心流程
  68. 1. 判断视觉任务类型和场景(见下方**场景模板系统**)。
  69. 2. 从 `references/templates/` 匹配对应模板,读取 `prompt_template`、`variants`、`category_tips` 作为 Prompt 基础结构。
  70. 3. 只收集会实质影响图片结果的缺失信息。
  71. 4. 构建视觉简报。
  72. 5. 如果任务包含多张图,先建立 **Campaign Style Lock**,锁定整套图的色板、冷暖调、字体、背景、光线、布局和图标风格。
  73. 6. 写出可执行图片 Prompt(**保持简洁**,见下方 Prompt 精简原则);多图任务必须把同一段 Campaign Style Lock 原样放进每张 Prompt。
  74. 7. 如果任务是商品图、详情页图或营销图,先做转化驱动力诊断。
  75. 8. 如果用户要求电商详情页、PDP、主图堆栈或整套商品图,默认输出 **5 张主图 + 7-9 张详情页图片** 的图片包。
  76. 9. 如果用户要求直接出图,按**生图通道判断**执行:Codex 环境用内置 imagegen;其他环境调用 `scripts/generate_image.py`(默认即梦 Seedream 5.5,回退 apiz)。用户提供了参考产品图时,Codex 传给 imagegen,脚本通道传 `--image`(即梦支持多张 `--image` 重复传入)。
  77. 10. 返回 Prompt、生成文件路径和关键假设。
  78. ---
  79. ## 最小输入
  80. 任何视觉任务都优先确认这些信息:
  81. - 目标:图片要达成什么效果。
  82. - 用途:商品主图、广告图、社媒图、Banner、PDP 模块、缩略图、概念图等。
  83. - 主体:产品、人物、场景、物体或抽象概念。
  84. - 受众和使用语境。
  85. - 风格:真实摄影、编辑部风格、高级棚拍、UGC、3D 渲染、插画等。
  86. - 构图、比例、平台尺寸。
  87. - 是否需要图片内文字。
  88. - 负面约束:避免 logo、避免文字、避免杂乱、避免医疗承诺等。
  89. 如果缺少非关键字段,明确假设后继续,不要无谓阻塞。
  90. ---
  91. ## 通用图片 Prompt 结构
  92. 默认用英文写 Prompt,除非用户要求其他语言。
  93. Prompt 按这个结构组织:
  94. 1. Campaign Style Lock,多图任务必填且每张图完全一致。
  95. 2. 主体和场景。
  96. 3. 图片目的和情绪意图。
  97. 4. 构图、镜头和取景。
  98. 5. 光线、颜色、材质和纹理。
  99. 6. 风格和真实感等级。
  100. 7. 平台限制和画幅比例。
  101. 8. 图片内文字处理。
  102. 9. 负面约束。
  103. Prompt 要足够具体,可以直接执行;也不要过度规定无关细节,避免和用户目标冲突。
  104. ---
  105. ## GPT-Image-2 Prompt 铁律(必须遵守)
  106. 以下规则来自大量实战验证,每条 Prompt 都必须逐条检查。
  107. ### 1. 颜色用 hex 码,不用形容词
  108. "白底"出来是淡灰,"金色"出来有 8 种金。必须写 hex:
  109. - 白底 → `#FFFFFF`
  110. - 深灰文字 → `#2D2D2D`
  111. - 金色强调 → `#D4AF37`
  112. - 浅米色背景 → `#F5F1E8`
  113. - 深绿背景 → `#1A3A2E`
  114. ### 2. 产品占比必须数字化
  115. 不同图型的产品占比黄金区间:
  116. | 图型 | 产品占比 | 说明 |
  117. |---|---|---|
  118. | 白底主图 | 35-40% | 太小显廉价,太大显拥挤 |
  119. | 卖点副图 | 25-30% | 左图右文布局,产品在左 |
  120. | 场景氛围图 | 20-25% | 场景图不是产品图,氛围才是主角 |
  121. | 信息流广告 | 40% | 环境干扰多,产品要更突出 |
  122. | 搜索广告 | 45% | 搜索图比信息流再大一点 |
  123. | SKU 多规格卡 | 60-70%(整体) | 多个产品横排 |
  124. ### 3. 留白必须显式声明
  125. 不写留白,AI 一定把画面填满。每张图必须写:
  126. - 白底主图 / 卖点副图 / 广告图:`留白至少 45%`
  127. - 场景氛围图:`留白至少 50%`
  128. - 详情页长图:`留白 50%+`
  129. ### 4. 否定清单不能省
  130. 每条 Prompt 结尾必须加负面约束,写具体禁止项而不是笼统的"不要多余的":
  131. ```
  132. 不要添加:道具、手、水印、假 logo、额外文字、装饰元素、渐变背景
  133. ```
  134. ### 5. 平台预留空间
  135. 国内电商主图必须预留:
  136. - `顶部中央 200×100 区域留空(平台价格叠加区)` — 不写产品会把整个画面填满
  137. - `左上角 200×100 像素区域完全留白` — logo 区域(如需要)
  138. ### 6. 3 层信息架构
  139. 电商图内文字必须遵循:
  140. - 核心承诺 ≤15 字(主标题)
  141. - 关键证据 2-3 个(图标 + 短标签)
  142. - 行动指令 ≤8 字(CTA 按钮)
  143. ### 7. 批量出图优于反复调参
  144. 一次批量出图,让 CTR 数据选风格,不要凭审美反复调参。
  145. ---
  146. ## Prompt 精简原则
  147. **GPT-Image-2 在结构清晰、信息具体的 Prompt 下表现最佳。**
  148. - 只包含核心信息,去除冗余约束和重复描述。
  149. - 自然语言优于关键词堆砌。
  150. - 明确描述材质纹理(磨砂玻璃、拉丝金属、哑光饰面、丝绸光泽)。
  151. - 始终包含光线方向和质量,场景图指定色温(如 `色温 5500K`)。
  152. - 不要在一个 Prompt 里塞入太多场景、风格、情绪要求。
  153. - 如果用户提供了参考产品图,传入 `--image` 比文字描述更有效。
  154. - 中文字用「」中文引号包裹,渲染准确率明显高于英文引号或无引号。
  155. - 复杂笔画的中文字(赢、鬱、餮等)尽量换成简单同义字,95% 准确率不是 100%。
  156. ---
  157. ## 场景模板系统
  158. `references/templates/` 目录包含 25 个场景模板,每个模板提供 `prompt_template`、`variants`(风格变体)、`category_tips`(品类建议)、`examples` 和 `anti_ai_tips`。
  159. ### 模板匹配表
  160. | 触发词 | 模板文件 |
  161. |---|---|
  162. | 白底图, 主图, hero image, packshot | `01-hero-image.json` |
  163. | 场景图, 生活图, lifestyle | `02-lifestyle-scene.json` |
  164. | 平铺图, flat lay, 俯拍 | `03-flat-lay.json` |
  165. | 细节图, 微距, macro, 特写 | `04-detail-macro.json` |
  166. | 海报, poster, banner, 促销 | `05-poster-banner.json` |
  167. | 社交媒体, 小红书, Instagram, TikTok | `06-social-media.json` |
  168. | UGC, 买家秀, GRWM | `07-ugc-style.json` |
  169. | 模特, model, 人物展示 | `08-model-showcase.json` |
  170. | 对比, before after, 前后 | `09-before-after.json` |
  171. | 包装, packaging, 礼盒 | `10-packaging.json` |
  172. | 信息图, A+, 详情页 | `11-infographic.json` |
  173. | 创意, 概念, creative | `12-creative-concept.json` |
  174. | 尺寸, 规格, 使用步骤 | `13-size-spec.json` |
  175. | 套装, 组合, bundle | `14-multi-product.json` |
  176. | 直播, livestream | `15-livestream.json` |
  177. | 试穿, 融入, try on | `16-try-on-virtual.json` |
  178. | 拆解图, 爆炸图, exploded view | `17-exploded-view.json` |
  179. | 隐形模特, ghost mannequin, 3D服装 | `18-ghost-mannequin.json` |
  180. | 多角度, 网格, grid, 多色展示 | `19-multi-angle-grid.json` |
  181. | 杂志, 封面, editorial, magazine | `20-magazine-editorial.json` |
  182. | 季节, 四季, campaign, 春夏秋冬 | `21-seasonal-campaign.json` |
  183. | 奢华, 氛围, 烟雾, luxury, atmospheric | `22-luxury-atmospherics.json` |
  184. | 设备模型, 界面, mockup, SaaS, APP | `23-device-mockup.json` |
  185. | 店铺, 门面, 空间, storefront, 实体店 | `24-storefront.json` |
  186. | 运动, 健身, sports, fitness | `25-sports-campaign.json` |
  187. 无匹配 → 默认 `01-hero-image.json`。**只读取匹配到的模板文件**,不要一次性加载全部。
  188. ### 模板使用方式
  189. 1. 取 `prompt_template` 作为 Prompt 基础结构。
  190. 2. 用用户产品信息替换 `{variables}`。
  191. 3. 用户指定风格变体 → 应用 `variants.<name>.overrides`。
  192. 4. 已知产品品类 → 应用 `category_tips.<category>`。
  193. 5. 简化:只保留有值的字段,输出简洁的自然语言 Prompt。
  194. ### 风格变体速查
  195. 每个模板通常包含 3-4 个风格变体,常用变体类型:
  196. - **luxury** — 高端奢华(Rembrandt 光线、金色点缀、深色渐变)
  197. - **minimal** — 极简现代(纯白/浅色、干净线条、大留白)
  198. - **fresh** — 清新自然(明亮自然光、柔和粉彩、通透感)
  199. - **tech** — 科技感(戏剧性侧光、深色背景、金属质感)
  200. ---
  201. ## Anti-AI 技巧(UGC / 直播 / 社媒场景)
  202. 生成 UGC、直播或社媒内容时,必须遵循以下规则让图片看起来真实:
  203. - 指定具体手机型号:`iPhone 14 Pro`、`iPhone 15 Pro`。
  204. - 添加可见瑕疵:毛孔、轻微噪点、暖色偏移、不完美构图。
  205. - 使用真实感语言:`NOT professional photography`、`NOT AI-generated look`。
  206. - 展示真实环境:略微凌乱、真实物品、水渍、用过的毛巾。
  207. - 参考胶片色调:`Kodak Portra 400 color feel`。
  208. - 明确声明:`NOT retouched, NOT smoothed`。
  209. - 避免典型 AI 词汇:不用 `perfect`、`flawless`、`stunning`、`hyper-realistic`。
  210. - 各模板中如有 `anti_ai_tips` 字段,生成对应场景时必须遵循。
  211. ---
  212. ## 整套图片风格一致性规则
  213. 当生成主图 + 详情页、PDP 图片包、广告组图、社媒组图或任何多张图片时,必须先定义一个 **Campaign Style Lock**。这是整套图的视觉合同,不是灵感描述。
  214. ### Campaign Style Lock 必填字段
  215. 1. **视觉方向**:例如 premium tech ecommerce、clean household care、warm gift editorial。
  216. 2. **固定色板**:限制为 2-3 个主色 + 1 个强调色;写清楚背景色、文字色、强调色,不要每张图重新配色。
  217. 3. **冷暖调**:明确 warm / cool / neutral,并要求全套一致。
  218. 4. **字体系统**:统一为一种字体风格,例如 modern geometric sans-serif;禁止混用衬线、手写、复古、卡通字体。
  219. 5. **背景系统**:统一背景材质、空间和深浅,例如 clean light gray studio background 或 deep navy premium tech background。
  220. 6. **光线系统**:统一光源方向、阴影强度、反光质感和氛围。
  221. 7. **布局系统**:统一留白、圆角、分栏、标签、编号和信息图组件风格。
  222. 8. **图标 / 插画系统**:如果用图标,统一线宽、形状、颜色和复杂度。
  223. 9. **产品呈现规则**:产品角度、大小比例、材质表现和是否居中必须稳定。
  224. 10. **禁止漂移项**:明确禁止 changing color palette, mixed fonts, inconsistent lighting, random backgrounds, mismatched icon styles。
  225. ### 默认 Style Lock 模板
  226. 如果用户没有给品牌规范,使用保守统一的电商视觉系统:
  227. ```text
  228. Campaign Style Lock: consistent premium ecommerce visual system across the entire image set; fixed palette of clean off-white background, deep charcoal text, one product-matched accent color, and one soft secondary accent; neutral-cool studio lighting; modern geometric sans-serif headline placeholders only; consistent rounded rectangular info labels; consistent thin-line icon style; clean high-end product photography mixed with minimal infographic elements; stable product scale and placement; generous whitespace; no color palette changes, no mixed fonts, no random backgrounds, no inconsistent lighting, no mismatched icon styles.
  229. ```
  230. ### 多图 Prompt 强制规则
  231. - 每张图 Prompt 的第一段必须是同一段 Campaign Style Lock,不能改写、缩短或换同义词。
  232. - 单张图只能改变:画面目的、主体动作、局部构图和短文案。
  233. - 单张图不能改变:色板、冷暖调、字体风格、背景系统、光线系统、图标风格和信息标签样式。
  234. - 如果用户要求重生其中一张图,必须复用原来的 Campaign Style Lock。
  235. - 如果已生成图片风格不一致,优先重写 Prompt 包,而不是逐张随意补描述。
  236. ---
  237. ## 商品和营销转化流程
  238. 商品主图、电商图片、广告图和 PDP 视觉不要从固定模板开始,要先判断转化驱动力。
  239. 选择一个主要驱动力:
  240. ### A. 视觉驱动型
  241. 适用于购买决策依赖外观、风格匹配、光洁度、质感、前后对比或礼品属性的产品。
  242. 重点:
  243. - 一眼抓住产品吸引力。
  244. - 质感、细节、工艺和质量信号。
  245. - 使用场景和视觉层级。
  246. - 简短利益点。
  247. ### B. 痛点驱动型
  248. 适用于买家有明确摩擦、风险、时间损失、不适或反复烦恼的产品。
  249. 强制顺序:
  250. 1. 痛点挖掘 / 风险触发。
  251. 2. 利益 / 解决方案。
  252. 3. 信任和证明。
  253. 4. 优惠 + CTA。
  254. 重点是具体问题、缓解机制、证据和风险逆转。
  255. ### C. 情感价值驱动型
  256. 适用于购买和身份、信心、归属、地位、关怀、快乐、新奇或冲动相关的产品。
  257. 重点:
  258. - 情绪钩子。
  259. - 身份或向往。
  260. - 产品作为实现方式。
  261. - 社交证明和低摩擦行动。
  262. ---
  263. ## 商品图序列模板
  264. 当用户提到“详情页、PDP、Amazon A+、Shopify 商品页、主图堆栈、整套商品图、商品详情图片”时,不要只停留在 5 张主图。必须追加详情页图片序列,并把每一屏都写成可单独生图的 Prompt。
  265. ### 视觉驱动主图序列
  266. 1. 一眼可懂的视觉主张。
  267. 2. 核心功能或质感特写。
  268. 3. 使用场景匹配。
  269. 4. 普通方案 vs 升级方案对比。
  270. 5. 优惠、物流、保障或 CTA 画面。
  271. ### 痛点驱动主图序列
  272. 1. 问题快照。
  273. 2. 解决机制。
  274. 3. 利益证明。
  275. 4. 信任画面。
  276. 5. 优惠 + 紧迫 CTA。
  277. ### 情感价值主图序列
  278. 1. 情绪场景钩子。
  279. 2. 身份 / 价值表达。
  280. 3. 产品作为实现方式。
  281. 4. 归属、地位或社交信号。
  282. 5. 带情绪强化的优惠 + CTA。
  283. ---
  284. ## 详情页图片序列模板
  285. 详情页图片用于移动端纵向浏览,默认每张图独立成屏,尺寸优先使用 `2:3` 或平台指定竖版比例。除非用户明确只要文案,否则每个模块都要输出对应图片 Prompt。
  286. ### 通用 PDP 详情页图片序列
  287. 1. 首屏承接:延续主图卖点,说明产品为谁解决什么问题。
  288. 2. 痛点放大:展示用户当前的不便、损失、风险或反复烦恼。
  289. 3. 机制解释:用视觉化结构说明产品如何发挥作用,避免虚构无法证明的数据。
  290. 4. 核心利益:把 2-4 个主要利益做成易扫读的信息图。
  291. 5. 使用步骤:用 3-4 步说明怎么用,降低理解成本。
  292. 6. 场景覆盖:展示典型使用场景、适用对象或使用前后状态。
  293. 7. 对比选择:普通方案 vs 本产品,突出可观察差异和体验差异。
  294. 8. 信任背书:展示材料、包装、质检、保障、真实评价等已有证据;没有证据就写“proof placeholder”,不要编造认证。
  295. 9. FAQ / 风险逆转 / CTA:处理残留、适用范围、售后、组合优惠等临门疑虑。
  296. ### 驱动力适配
  297. - 视觉驱动型:增加质感细节、尺寸比例、使用场景和礼品感。
  298. - 痛点驱动型:严格按“问题严重性 → 解决机制 → 利益证明 → 信任 → CTA”推进。
  299. - 情感价值驱动型:增加生活方式、身份表达、社交场景和情绪回报。
  300. ### 图片内文字规则
  301. - 详情页图片可以有短文案,但必须短、清楚、适合移动端。
  302. - 每屏主标题建议 3-7 个英文词或 6-12 个中文字。
  303. - 说明性文字用 2-4 个短标签,不要生成大段小字。
  304. - 每一区文字量严格控制:标题 + 副标题 + 小标注不超过 50 个字。
  305. - 中文字用「」中文引号包裹,如「修护屏障」「72h 深层锁水」,渲染准确率更高。
  306. - 指定字体大小:标题 28-48pt,副标题 16-20pt,标注 10-14pt。
  307. - 颜色用 hex 码:深灰标题 `#2D2D2D`,浅灰标注 `#888888`,金色强调 `#D4AF37`。
  308. - 如果模型容易生成乱码,Prompt 中明确要求 “clean layout with short readable headline placeholders, no dense body text”。
  309. - 出图后必须放大 200% 逐字核对中文笔画,复杂字换简单同义字。
  310. ### 视觉节奏规则(多图任务)
  311. 连续多张图的背景色不能完全一样,否则消费者视觉疲劳。多图任务必须交替使用 2-3 种背景色:
  312. - 白底主图 / 卖点副图:`#FFFFFF`
  313. - 成分解析 / 质地展示:`#F5F1E8`(浅米色)
  314. - 品牌主视觉 / 促销图:品牌深色(如 `#1A3A2E`)
  315. ### 多角度镜头规则(多图任务)
  316. **全套图片绝不能全部使用同一个拍摄角度。** AI 生图默认倾向生成正面 3/4 角度,如果不显式指定镜头角度,整套图会看起来千篇一律。多图任务必须在 Prompt 中为每张图分配不同的镜头角度和景别。
  317. #### 角度清单(按用途选择 4-6 种组合)
  318. | 角度 | Prompt 写法 | 适用场景 |
  319. |---|---|---|
  320. | 正面 3/4 | `at a slight 3/4 angle showing full front facade` | 主图、首图 |
  321. | 正上方俯视 | `photographed directly from above at a 90-degree overhead angle` | 展示布局、内部结构、平铺 |
  322. | 侧面 90° | `photographed from a clean 90-degree side profile` | 展示深度、层次、侧面细节 |
  323. | 后侧 45° | `photographed from behind at a 45-degree rear angle` | 展示背面细节、码头、尾部构造 |
  324. | 仰视低角度 | `photographed from a very low angle looking upward` | 英雄镜头、气势感、儿童视角 |
  325. | 高角度俯视 | `photographed from a high 45-degree angle looking down` | 展示顶部、整体规模、桌面视角 |
  326. #### 景别清单(按用途选择 2-3 种组合)
  327. | 景别 | Prompt 写法 | 适用场景 |
  328. |---|---|---|
  329. | 全景 | `full product visible, product occupies 35-40%` | 主图、场景图 |
  330. | 中景 | `showing the [section name] area, product occupies 45-50%` | 功能展示、结构说明 |
  331. | 特写 | `tight zoom on [specific detail], product detail occupies 55-60%` | 材质纹理、工艺细节、按钮/接口 |
  332. | 微距 | `extreme close-up macro shot, shallow depth of field` | 面料编织、接缝工艺、表面纹理 |
  333. | 局部 | `close-up detail shot focusing on [specific part]` | 灯塔信标、大炮、拉链、标签 |
  334. #### 多角度分配原则
  335. 1. **主图序列(5 张)**:至少使用 3 种不同角度,其中 1 张必须是特写或微距。
  336. 2. **详情页序列(7-9 张)**:至少使用 4 种不同角度,其中 2 张必须是特写/微距。
  337. 3. **不能连续 3 张图使用相同角度**,否则消费者视觉疲劳。
  338. 4. **全景图不超过整套的 40%**,必须穿插中景、特写和微距增加节奏感。
  339. 5. **仰视和俯视各至少 1 张**,打破平视拍摄的单一感。
  340. 6. 每张 Prompt 必须显式写明角度关键词(如 `side profile`、`from above`、`low angle`),不要假设模型会自动变换角度。
  341. #### 角度 Prompt 模板
  342. 在每张图片 Prompt 的「构图、镜头和取景」段落中,直接嵌入角度描述:
  343. ```text
  344. # 俯视图
  345. Bird's eye top-down view. The [product] photographed directly from above at a 90-degree overhead angle, showing the full layout [specific details visible from above]. Deep even lighting from directly above minimizing shadows.
  346. # 侧视图
  347. Side profile view. The [product] photographed from a clean 90-degree side profile, showing [what's visible from side]. Strong side lighting from the left creating dramatic depth.
  348. # 仰视图
  349. Dramatic low-angle hero shot. The [product] photographed from a very low angle looking upward, making [tower/building] appear tall and imposing. Strong upward lighting creating heroic dramatic shadows.
  350. # 微距特写
  351. Extreme close-up macro shot. Tight zoom on the [specific detail], showing [texture/mechanism/individual elements]. Shallow depth of field with the foreground in sharp focus and background slightly blurred. Warm directional side lighting highlighting surface texture.
  352. # 后侧角度
  353. Rear angled view. The [product] photographed from behind at a 45-degree rear angle, revealing [back details not visible from front]. This angle shows construction details not visible from the front.
  354. ```
  355. ### 详情页信息图结构规则(关键!)
  356. **详情页图片 ≠ 多角度产品照片。** 详情页图片必须是电商信息图格式,包含卖点文案、图标、标签、对比、步骤、信任徽章等信息图元素,产品在不同信息图中展示不同角度。多角度是为信息图服务的展示手段,不是目的。
  357. #### 错误做法(只换角度,没有信息图结构)
  358. ```
  359. # 错误:这只是"同一产品换个角度拍",缺少电商转化元素
  360. Prompt: Side profile view of the product on white background. Product occupies 38%. Whitespace 50%+.
  361. ```
  362. #### 正确做法(电商信息图 + 多角度产品展示)
  363. ```
  364. # 正确:有标题、卖点图标、标签、信息图布局,产品在其中展示特定角度
  365. E-commerce infographic benefits screen on #FAF7F2 background.
  366. Top headline in #2D2D2D at 28pt reading 「Core Benefits」.
  367. Left side: the product shown from an elevated overhead angle.
  368. Right side: four benefit rows stacked vertically with thin-line icons:
  369. (1) icon + 「Feature One」 in #7A9E7E
  370. (2) icon + 「Feature Two」 in #8B6F47
  371. (3) icon + 「Feature Three」 in #7A9E7E
  372. (4) icon + 「Feature Four」 in #8B6F47
  373. Clean two-column layout. Product occupies 35%. Whitespace 48%+.
  374. ```
  375. #### 详情页每屏必须包含的信息图元素
  376. | 屏幕 | 电商结构 | 信息图元素 | 产品角度建议 |
  377. |---|---|---|---|
  378. | 首屏承接 | 标题 + 产品 + 4个特色图标 + 副标题 | 图标+标签环绕产品 | Front 3/4 |
  379. | 痛点对比 | 3个痛点图标 → 3个解决方案 + 产品 | 上下对比布局 | Side profile |
  380. | 核心特色 | 多栏并列展示 + 每栏标签和描述 | 网格/三栏布局 | 各元素独立特写 |
  381. | 核心利益 | 左产品 + 右利益列表(图标+短文案) | 双栏信息图 | Elevated overhead |
  382. | 使用步骤 | 4步时间线/编号圆 + 最终成品展示 | 步骤流程图 | Low-angle (最终效果) |
  383. | 场景覆盖 | 3个场景照片 + 场景标签 | 三行场景卡 | 不同使用环境 |
  384. | 信任/工艺 | 微距细节图 + 标注圆 + 信任徽章 | 细节标注图 | Macro特写 |
  385. | CTA/礼品 | 标题 + 产品 + 卖点徽章 + CTA按钮 | 转化闭合布局 | Front 3/4 |
  386. #### 信息图 Prompt 必须包含的要素
  387. 1. **布局关键词**:`e-commerce infographic`, `structured grid layout`, `two-column layout`, `three-row layout`, `timeline`, `comparison layout`
  388. 2. **标题和文案**:`headline in #2D2D2D at 28pt reading 「...」`, `label in #7A9E7E at 14pt reading 「...」`
  389. 3. **信息图元素**:`feature callout icons`, `thin connecting lines`, `numbered circles`, `trust badges`, `CTA button placeholder`
  390. 4. **产品角度**:每张信息图中产品从不同角度展示,但角度是为信息图内容服务的
  391. 5. **电商 Prompt 开头**:每张详情页 Prompt 必须以 `E-commerce infographic [screen type]` 开头,而不是 `Close-up shot` 或 `Side view`
  392. ### 字体搭配规则
  393. - 主标题用衬线体(如 Didot),副标题和正文用无衬线体(如 SF Pro Display)。
  394. - 这是奢侈品画册的标准组合,高级感强。
  395. - 整套图只能用这 2 种字体,禁止混用第三种。
  396. ---
  397. ## 多图生成执行规则
  398. 当用户要求直接生成整套电商图片:
  399. 1. 先建立 Campaign Style Lock,并写入图片包计划。
  400. 2. 再为每张图建立编号、用途、画幅、图片内短文案和独立 Prompt。
  401. 3. 主图默认 `1:1`;详情页图片默认 `2:3`,适合移动端纵向浏览。
  402. 4. 每张图使用独立 Prompt 文件,避免一次 Prompt 生成多屏拼图。
  403. 5. 每张独立 Prompt 必须以同一段 Campaign Style Lock 开头。
  404. 6. 输出目录用产品英文 slug,例如 `generated-images/laundry-detergent-pods-pdp/`。
  405. 7. 如果模型不支持某个比例,改用最接近的支持比例,并在结果中说明。
  406. 8. 如果即梦 CLI 和 apiz CLI 均不可用(未安装/未登录)且不在 Codex 环境,只输出完整 Prompt 包,不调用脚本。
  407. 9. 不要虚构认证、实验数据、评分、销量、真实评价或品牌授权。
  408. ---
  409. ## 直接生图规则
  410. 当用户要求生成图片:
  411. 1. 先输出最终 Prompt。
  412. 2. 按**生图通道判断**选择通道:Codex 环境直接调用内置 imagegen;其他环境运行 `scripts/generate_image.py`(默认走即梦 Seedream 5.5,回退 apiz)。
  413. 3. 短 Prompt 用 `--prompt`,长 Prompt 用 `--prompt-file`。
  414. 4. 根据平台选择 `--size`(比例格式),没有要求时默认 `1:1`。
  415. 5. 只有用户指定目录时才使用 `--output-dir`,否则使用 `generated-images/`。
  416. 6. 如果即梦和 apiz CLI 均未安装或未登录,不要调用脚本;返回 Prompt 和登录指引。
  417. 7. 批量出图前先报 Image Pack Plan 和预计积分消耗(即梦 Seedream 5.5 约 6 积分/张,apiz 见 `apiz account balance`),经用户确认再执行。
  418. 命令形状(非 Codex 环境):
  419. ```bash
  420. python3 scripts/generate_image.py --prompt "..." --size 1:1
  421. ```
  422. 脚本支持(即梦 / apiz 通用):
  423. - `--channel`:`auto / dreamina / apiz`,默认 `auto`(优先即梦,回退 apiz;可用 `ECOM_IMAGE_CHANNEL` 覆盖)
  424. - `--prompt` / `--prompt-file`
  425. - `--output-dir`
  426. - `--size`:比例格式(`1:1`、`16:9`、`2:3` 等,兼容 `1024x1024` 像素写法;即梦不支持的比例自动换算)
  427. - `--model`:即梦默认 `seedream_5.5`,apiz 默认 `apiz/gpt-image-2.5-flare`
  428. - `--image`:本地参考产品图片路径(即梦可重复传入最多 10 张);apiz 另支持 `--image-url`
  429. - `--timeout`:单任务等待上限秒数,默认即梦 600 / apiz 420
  430. - `--format`:保存格式的默认扩展名,默认 `png`
  431. - 即梦通道额外参数:`--count`(单节点 1-8 张)、`--resolution`(`1.5K/2K`)、`--canvas-id`、`--credit-ceiling`
  432. ---
  433. ## QA 检查
  434. 最终输出前确认:
  435. - Prompt 符合用户真实目标。
  436. - 已匹配正确的场景模板,Prompt 基于模板的 `prompt_template` 组装。
  437. - Prompt 保持简洁,只包含核心信息,没有冗余约束。
  438. - 主体、构图、风格和用途明确。
  439. - 商品 / 营销任务包含转化驱动力诊断。
  440. - 证据缺失时不虚构效果、认证或数据。
  441. - 图片内文字短且必要。
  442. - UGC / 直播 / 社媒场景已应用 anti-AI 技巧(模板中的 `anti_ai_tips` 字段)。
  443. - 已按**生图通道判断**选择通道:Codex 环境用内置 imagegen,其他环境用 `scripts/generate_image.py`(默认即梦,回退 apiz)。
  444. - 如有用户参考图片,Codex 通道已传给 imagegen,脚本通道已传入 `--image` / `--image-url` 参数。
  445. - 负面约束覆盖常见失败点。
  446. - 输出和文件里没有 API key 或私密凭据。
  447. - 已应用 GPT-Image-2 铁律:hex 颜色、数字占比、显式留白、否定清单、平台预留空间。
  448. - 多图任务已分配不同角度和景别,无连续 3 张相同角度,全景图占比 ≤ 40%。
  449. - **详情页图片必须是电商信息图格式**(含标题、图标、标签、利益点、步骤或信任徽章),不是单纯的多角度产品照片。每张详情页 Prompt 以 `E-commerce infographic` 开头。
  450. - 出图后提醒用户放大 200% 逐字核对中文笔画。
  451. ---
  452. ## 常见翻车点与防护
  453. | 翻车 | 原因 | 防护 |
  454. |---|---|---|
  455. | 中文字笔画错 | 模型中文准确率约 95%,复杂字容易少笔画 | 放大 200% 逐字核对;复杂字换简单同义字 |
  456. | 品牌色漂移 | 写"金色"出来 8 种金 | 全部用 hex 码(`#D4AF37`) |
  457. | Logo 区域被填满 | 写"留空间"模型当没看见 | 写精确坐标:`左上角 200×100 像素区域完全留白` |
  458. | 背景不是纯白 | 写"白底"出来是淡灰 | 写 `#FFFFFF` |
  459. | 产品太大或太小 | 没指定占比 | 写具体百分比:`产品占画面 38%` |
  460. | 画面填满无留白 | 没写留白要求 | 显式声明:`留白至少 50%` |
  461. | 连续多张视觉疲劳 | 背景色全部一样 | 交替使用 2-3 种背景色 |
  462. | 全套图角度雷同 | AI 默认生成正面 3/4 角度,不指定就千篇一律 | 每张 Prompt 显式写明角度关键词;主图 ≥3 种角度,详情页 ≥4 种,穿插特写/微距 |
  463. | 衣服/3C 翻车率高 | 对面料垂坠感、人体比例、接口按键细节要求太高 | 优先测护肤品、家居、食品等稳定品类;衣服用参考图 `--image` 提升一致性 |
  464. | 详情页变成纯产品图 | 只写了多角度关键词,没有电商信息图结构(标题、图标、标签、卖点列表) | 每张详情页 Prompt 以 `E-commerce infographic` 开头,包含布局、文案、图标等电商元素;多角度是信息图内的展示手段而非目的 |
  465. ---
  466. ## 输出格式
  467. Brief / Prompt 模式返回:
  468. 1. **匹配模板**:使用的模板文件名和场景类型
  469. 2. **Visual Brief**
  470. 3. **Final Image Prompt**
  471. 4. **Negative Constraints**
  472. 5. **Assumptions**
  473. 商品或营销任务追加:
  474. 1. **Conversion Driver Diagnosis**
  475. 2. **Campaign Style Lock**,当任务包含多张图片
  476. 3. **Hero Image Sequence**(标注每张图对应的模板文件)
  477. 4. **PDP Detail Image Sequence**,当请求涉及详情页、PDP 或整套商品图
  478. 5. **Copy Lines**,如果图片需要文字
  479. 6. **Test Priorities**
  480. Generate 模式返回:
  481. 1. **匹配模板**:使用的模板文件名和场景类型
  482. 2. **Final Image Prompt**
  483. 3. **Campaign Style Lock**,多图任务必须返回
  484. 4. **Image Pack Plan**,包含每张图的编号、用途、尺寸、对应模板和短文案
  485. 5. **Generated Files**
  486. 6. **Assumptions / Notes**
README.md · README · 436 lines
  1. # ecom-details-image Skill
  2. 一个面向 claude code / Codex / workbuddy 的跨境电商和国内电商通用视觉创作 Skill。GPT-Image-2 /Seedream 5.5 上线以来,电商圈已经被刷屏了。图像生成的边界,如今又被推了一大步。下面是我精选的 25个高质量案例,涵盖纯色底产品主图、场景化生活图、平铺图、电商详情图、真实场景等等,全部配完整提示词,都可以利用 GPT-Image-2 /Seedream 5.5 API生成最终效果。
  3. 一键生成电商相关图片:
  4. 输入产品图片和需求描述,自动生成完整的电商主图、详情页图片、社媒推广图、直播间场景图等全套视觉素材。
  5. 与众不同之处是:Campaign Style Lock 机制 和 强推广和重视转化效果。
  6. 它可以做两件事:
  7. - 生成可执行的视觉简报和 AI 生图 Prompt。
  8. - 直接生成图片:Codex 环境使用 agent 内置 `imagegen` 工具;其他环境(claude code / workbuddy 等)默认走 **即梦 dreamina-canvas CLI(Seedream 5.5)**,如果使用 gpt image2 则安装 `apiz` CLI 生图。
  9. 未安装任何生图 CLI 时,它仍然可以正常输出 Prompt;CLI 就绪后,可以直接出图。 建议请先安装[apiz](https://apiz.ai) 官方 CLI 或即梦 [dreamina-canvas CLI](https://jimeng.jianying.com/ai-tool/install?from_page=explore) 。
  10. ### 兄弟项目 - 跨境电商调研skill:
  11. https://github.com/liangdabiao/Amazon-Skills-Liang
  12. https://github.com/liangdabiao/ecom-details-image-ui
  13. ## 实战案例:陶瓷手冲滤杯整套 PDP(即梦 Seedream 5.5 实测)
  14. 2026-11-14 用本 Skill + 即梦 `dreamina-canvas` CLI + Seedream 5.5,从一张参考图出发生成的完整电商图片包(5 主图 + 8 详情图),Prompt 全部保留在 [`prompts/pour-over-dripper/`](prompts/pour-over-dripper/),统一 Campaign Style Lock(暖米白 `#F7F4EF` + 深炭 `#2D2D2D` + 木色 `#B08350` + 灰绿 `#8A9B8E`)。
  15. ### 主图(Hero Images)
  16. | 主图 1 · 白底 Packshot | 主图 2 · 木纹特写 | 主图 3 · 生活场景 |
  17. |---|---|---|
  18. | ![主图1](docs/case/hero-01-packshot.jpg) | ![主图2](docs/case/hero-02-feature-closeup.jpg) | ![主图3](docs/case/hero-03-lifestyle.jpg) |
  19. | 主图 4 · 竞品对比 | 主图 5 · 促销 CTA |
  20. |---|---|
  21. | ![主图4](docs/case/hero-04-comparison.jpg) | ![主图5](docs/case/hero-05-offer-cta.jpg) |
  22. ### 详情页(PDP Infographics)
  23. | 首屏承接 | 痛点放大 | 机制解释 | 核心利益 |
  24. |---|---|---|---|
  25. | ![首屏](docs/case/detail-01-opening.jpg) | ![痛点](docs/case/detail-02-pain-points.jpg) | ![机制](docs/case/detail-03-mechanism.jpg) | ![利益](docs/case/detail-04-benefits.jpg) |
  26. | 使用步骤 | 场景覆盖 | 信任背书 | 收尾 CTA |
  27. |---|---|---|---|
  28. | ![步骤](docs/case/detail-05-steps.jpg) | ![场景](docs/case/detail-06-scenes.jpg) | ![信任](docs/case/detail-07-trust.jpg) | ![收尾](docs/case/detail-08-cta.jpg) |
  29. ### 本次实测数据
  30. | 指标 | 数值 |
  31. |---|---|
  32. | 生成张数 | 13 张(含 2 张单图测试 + 1 张返修)|
  33. | 积分消耗 | 90 积分(Seedream 5.5 @2K 实扣 6 积分/张)|
  34. | 单张耗时 | 约 60–90 秒(含参考图上传、报价、生成、下载)|
  35. | 中文渲染 | 信息图中文标题/标签**全部正确**(「一杯好咖啡 从好滤杯开始」等 30+ 处)|
  36. | 参考图 | i2i 模式挂 1 张参考图,13 张图产品形态一致性保持良好 |
  37. | 交付物 | 2K PNG(2048×2048 / 1664×2496)|
  38. ### 实测踩坑与经验
  39. 1. **i2i 通道容易生成乱码装饰文字**:即使 Prompt 写了 `no text`,图生图模式仍倾向添加海报式英文乱码。解法:把负面约束升级为整段 `Strictly forbidden: any text, any letters, any words, any numbers, any typography, any labels...`(见 [`prompts/pour-over-dripper/hero-02.txt`](prompts/pour-over-dripper/hero-02.txt)),实测一次修复。
  40. 2. **t2i 反而更干净**:纯白底 Packshot 用文生图(不挂参考图)出图最干净;图生图留给需要产品一致性的场景。
  41. 3. **中文短文案渲染可靠**:Seedream 5.5 对 `「」` 包裹的 6–10 字中文标题渲染准确率非常高,适合详情页信息图。
  42. 4. **国内版合规水印**:产物左上角自带「AI生成」浅色水印,上线前需裁切或修补。
  43. 5. **报价即实扣**:CLI 通道报价上限 = 实扣积分(2K 6 积分/张),批量前用 `dreamina-canvas auth account` 查余额即可精确预算。
  44. ## 场景模板轮测:同一只滤杯 × 17 个电商场景(Seedream 5.5)
  45. 对 `references/templates/` 中适配非服装类目的 17 个场景做了全量实测(剔除试穿、隐形模特、设备 mockup、门店门面 4 个服装/SaaS 专属场景),全部挂在**同一张参考图**上出图。Prompt 见 [`prompts/pour-over-dripper/templates/`](prompts/pour-over-dripper/templates/)。
  46. | 场景 | 示例 | 一句话结论 |
  47. |---|---|---|
  48. | 03 平铺图 flat-lay | ![t03](docs/case/templates/t03-flat-lay.jpg) | ✅ 俯拍构图、道具搭配稳定,可直接用 |
  49. | 04 细节微距 macro | ![t04](docs/case/templates/t04-detail-macro.jpg) | ✅ 木纹/釉面质感极强,最惊艳的场景之一 |
  50. | 05 海报 Banner | ![t05](docs/case/templates/t05-poster.jpg) | ✅ 「上新 8 折」「马上抢」中文全对,可直接用 |
  51. | 06 社媒图 小红书 | ![t06](docs/case/templates/t06-social.jpg) | ⚠️ 版式好看,但 bullet 标签出现重复文案 |
  52. | 07 UGC 买家秀 | ![t07](docs/case/templates/t07-ugc.jpg) | ✅ 初版出现双人四手+木圈乱码刻字,改用小云雀通道单图重选修复,现单人双手、无刻字 |
  53. | 08 模特展示 | ![t08](docs/case/templates/t08-model-showcase.jpg) | ✅ 手持产品、浅景深、人物自然,可用 |
  54. | 09 before/after 对比 | ![t09](docs/case/templates/t09-before-after.jpg) | ✅ 上下分层+标签全对,叙事清楚 |
  55. | 10 礼盒包装 | ![t10](docs/case/templates/t10-packaging.jpg) | ✅ 牛皮礼盒+丝带质感好,可直接用 |
  56. | 12 创意概念 | ![t12](docs/case/templates/t12-creative.jpg) | ⚠️ 悬浮水螺旋视觉冲击强,但木圈有小畸形 |
  57. | 13 尺寸规格图 | ![t13](docs/case/templates/t13-size-spec.jpg) | ✅ 标注线+「高 12cm」「口径 8.5cm」等 5 处文字全对 |
  58. | 14 多规格 SKU 卡 | ![t14](docs/case/templates/t14-multi-product.jpg) | ✅ 三色木圈变体+标签全对,SKU 卡一步到位 |
  59. | 15 直播间场景 | ![t15](docs/case/templates/t15-livestream.jpg) | ✅ 首次大标题「专」字渲染错误,按逐字约束重做一次修复,现文字全对 |
  60. | 17 爆炸图 | ![t17](docs/case/templates/t17-exploded.jpg) | ✅ 三层拆分+标注全对,产品结构清晰 |
  61. | 19 多角度网格 | ![t19](docs/case/templates/t19-multi-angle.jpg) | ⚠️ 2×2 网格规整,但四个角度差异偏小 |
  62. | 20 杂志封面 | ![t20](docs/case/templates/t20-magazine.jpg) | ✅ 中英文刊头+光影氛围,质感最高级 |
  63. | 21 季节 campaign | ![t21](docs/case/templates/t21-seasonal.jpg) | ✅ 「冬季暖冬限定」+节日氛围到位 |
  64. | 22 奢华氛围 | ![t22](docs/case/templates/t22-luxury.jpg) | ✅ 低调棚拍+烟雾光束,高级感强 |
  65. ### 轮测数据与结论
  66. | 指标 | 数值 |
  67. |---|---|
  68. | 测试场景数 | 17 个(一次通过 17/17,无任务失败)|
  69. | 积分消耗 | 即梦 108 积分(17 张 + t15 返修)+ 小云雀 1 次(t07 重做,4 候选挑 1)|
  70. | 单张耗时 | 约 60–90 秒,批量串行约 30 分钟 |
  71. | 产品一致性 | 17 张全部挂同一参考图,木圈位置/陶瓷形态保持稳定 |
  72. | 中文渲染 | 14 处标题/标签正确(t15 重做一次修复);t06 标签重复待返修 |
  73. | 主要风险 | 人手持/场景类(UGC、直播、创意)仍会出现局部乱码刻字或小畸形,需人工筛选或重做 |
  74. **场景难度分级(实测)**:纯产品摄影(平铺/微距/包装/SKU/多角度)≈ 信息图(规格/爆炸/对比)> 氛围图(杂志/季节/奢华/海报)> 人物场景(模特/UGC/直播)——人物场景文字和细节翻车率最高,建议出 2–4 张候选挑最好的。
  75. ## 适用场景
  76. - 商品主图、详情页视觉、Amazon / Shopify / TikTok Shop 图片。
  77. - 广告图、社媒图、活动 Banner、缩略图。
  78. - 品牌视觉方向、创意概念、图像模型 Prompt。
  79. - 跨境电商 PDP 转化视觉:诊断视觉驱动、痛点驱动、情感价值驱动。
  80. - 电商整套图片包:默认规划 5 张主图 + 7-9 张详情页图片。
  81. ## 它的工作方式
  82. ### 1. Prompt / Brief 模式
  83. 当你只需要策略、视觉方向或 Prompt 时,Skill 会输出:
  84. 1. 视觉简报。
  85. 2. 最终图片 Prompt。
  86. 3. 负面约束。
  87. 4. 假设说明。
  88. 如果是商品或营销图,还会补充:
  89. - 转化驱动力诊断。
  90. - Campaign Style Lock,用来锁定整套图的色板、冷暖调、字体、背景、光线和布局。
  91. - 主图 / 创意序列。
  92. - PDP 详情页图片序列。
  93. - 图片内文案建议。
  94. - 测试优先级。
  95. ### 2. Generate 模式
  96. 当你明确要求“生图、生成图片、出图、render image”时,Skill 会:
  97. 1. 先生成最终 Prompt。
  98. 2. 如果是电商详情页或整套商品图,先建立 Campaign Style Lock。
  99. 3. 再拆成独立图片 Prompt,并把同一段 Campaign Style Lock 原样放进每张 Prompt。
  100. 4. 按**生图通道判断**出图:Codex 环境直接调用 agent 内置 `imagegen`;其他环境调用 `scripts/generate_image.py`(默认走即梦 Seedream 5.5,自动回退 apiz)。
  101. 5. 输出生成文件路径。
  102. ## 生图通道(Codex imagegen / 即梦 dreamina / apiz CLI)
  103. 这个 Skill 不内置任何 API,也不共享任何密钥。生图前先判断环境:
  104. ### 通道速查
  105. | | 通道 A · Codex imagegen | 通道 B · 即梦(默认)| 通道 C · apiz(回退)|
  106. |---|---|---|---|
  107. | 环境 | Codex 内置工具 | claude code / workbuddy 等 | 同左 |
  108. | 默认模型 | — | Seedream 5.5 | apiz/gpt-image-2.5-flare |
  109. | 参考图 | 按工具参数 | **最多 10 张**(多角度一致性更强)| 1 张 |
  110. | 比例 | 按工具参数 | 8 种,`4:5` 等自动换算 | 10 种 |
  111. | 分辨率 | — | 1.5K / 2K | 1K / 2K / 4K |
  112. | 批量 | — | 单节点 1–8 张 | 单次 1 张 |
  113. | 计费 | — | 约 6 积分/张(2K)| 约 30–90 积分/张 |
  114. | 选择方式 | 自动 | `--channel dreamina` 或默认 auto | `--channel apiz` |
  115. ### 通道 A:Codex 环境 → agent 内置 imagegen
  116. 如果 agent 会话中具备内置 `imagegen` 工具(即 Codex 环境),直接调用它生成图片:
  117. - 把最终 Prompt(含 Campaign Style Lock)作为 prompt 传入,工具支持比例参数时传入对应比例。
  118. - 用户提供了参考产品图时,按 imagegen 工具的参考图/编辑参数传入。
  119. - 不运行 Python 脚本。
  120. ### 通道 B:其他环境 → 即梦 dreamina-canvas CLI(默认优先)
  121. claude code / workbuddy 等环境通过 `scripts/generate_image.py` 生图,`--channel auto`(默认)时优先走即梦通道,脚本转交 `scripts/generate_image_dreamina.py` 执行:
  122. 1. 解析目标画布:`DREAMINA_CANVAS_ID` → 当前画布 → 自动创建 `ecom-details-image` 画布。
  123. 2. 本地参考图先经 `resource upload` 登记为画布素材(支持最多 10 张)。
  124. 3. `node create image --run --wait` 保存节点、报价(不超过积分上限)、运行并等待终态。
  125. 4. `resource download` 把节点产物下载到本地输出目录。
  126. 前置条件:
  127. ```bash
  128. dreamina-canvas --version # 确认已安装
  129. dreamina-canvas auth login # OAuth 登录(认证由 CLI 处理,脚本不接触密钥)
  130. dreamina-canvas auth account # 查看积分余额
  131. ```
  132. 可选配置(在 Skill 目录放 `.env`,全部可省略):
  133. ```dotenv
  134. DREAMINA_IMAGE_MODEL=seedream_5.5
  135. # DREAMINA_CANVAS_ID=<画布UUID> # 不设置时用当前画布或自动创建
  136. DREAMINA_RESOLUTION=2K
  137. DREAMINA_CREDIT_CEILING=10
  138. # DREAMINA_BIN=C:\path\to\dreamina-canvas.exe
  139. ```
  140. 能力边界(以 `dreamina-canvas model list --type image` 实时结果为准):
  141. - 默认模型 `seedream_5.5`:文生图 + 图生图,比例 `1:1 / 3:4 / 4:3 / 16:9 / 9:16 / 2:3 / 3:2 / 21:9`,分辨率 `1.5K / 2K`,单节点 1-8 张,参考图最多 10 张(单张 ≤50MB / 8192px),Prompt 上限 5000 字符。
  142. - 不支持的比例如 `4:5` 会自动换算到最接近的支持比例(`3:4`)并在日志中说明。
  143. - 计费按积分:**Seedream 5.5 实测 2K 约 6 积分/张**(报价为上限,实扣以节点 `creditsAmount` 为准)。
  144. - 国内版产物左上角带「AI生成」合规水印,上线前需自行裁切或修补。
  145. ### 通道 C:其他环境 → apiz CLI
  146. 即梦 CLI 未安装/未登录,或显式 `--channel apiz` 时,脚本内部调用 [apiz](https://apiz.ai) 官方 CLI:
  147. 1. 本地参考图先经 `apiz upload` 上传到 apiz CDN 换取公网 URL。
  148. 2. `apiz generate <prompt> --model <model> --aspect-ratio <ratio> --wait --json` 提交并等待任务完成。
  149. 3. 脚本解析任务 JSON,把 `result.images[].url` 下载到本地输出目录。
  150. 前置条件:
  151. ```bash
  152. apiz --version # 确认已安装
  153. apiz auth login # 登录并保存 API key(本机通常已就绪)
  154. apiz account balance # 查看积分余额
  155. ```
  156. 认证由 CLI 自行处理(`apiz auth login` 保存的配置文件,或 `APIZ_API_KEY` 环境变量),脚本不接触密钥。
  157. 可选配置(在 Skill 目录放 `.env`,全部可省略):
  158. ```dotenv
  159. APIZ_IMAGE_MODEL=apiz/gpt-image-2.5-flare
  160. # APIZ_API_KEY=sk-xxx # 仅未使用 apiz auth login 时需要
  161. # APIZ_BASE_URL=https://api.apiz.ai
  162. # APIZ_BIN=C:\path\to\apiz.exe
  163. ```
  164. - `APIZ_IMAGE_MODEL`:图片模型 id,默认 `apiz/gpt-image-2.5-flare`;`apiz models list` 可查看全部图片模型(如 `openai/gpt-image-2`、`fal-ai/nano-banana-pro`、`apiz/gpt-image-2.5-sunburst`)。兼容旧别名 `IMG_MODEL`、`OPENAI_IMAGE_MODEL`、`OPENAI_MODEL`。
  165. - `APIZ_API_KEY`:未登录时使用。兼容旧别名 `IMG_API_KEY`、`OPENAI_API_KEY`。
  166. - `APIZ_BIN`:apiz 不在 PATH 时指定可执行文件路径。
  167. 不要把真实 API key 写进 README、`SKILL.md`、脚本、Git 提交或聊天记录。
  168. ### 费用与异步机制
  169. - 生图按 apiz 积分计费,单张图约 30–90 秒完成;脚本用 `--wait` 阻塞等待任务结束后自动下载。
  170. - 任务状态可用 `apiz tasks get <task_id>` / `apiz tasks wait <task_id>` 查询。
  171. - 执行 `apiz account balance` 查看积分余额;批量出图前先确认 Image Pack Plan 与预计消耗。
  172. ## 生图脚本用法
  173. 统一入口(`--channel auto` 默认优先即梦,apiz 回退;`ECOM_IMAGE_CHANNEL` 环境变量可覆盖):
  174. ```bash
  175. python3 scripts/generate_image.py --prompt "clean product hero image, premium studio lighting, white background" --size 1:1
  176. ```
  177. 即梦通道(Seedream 5.5,支持多参考图与单节点批量):
  178. ```bash
  179. python3 scripts/generate_image_dreamina.py --prompt-file prompt.txt --size 1:1
  180. python3 scripts/generate_image_dreamina.py --prompt "..." --size 2:3 \
  181. --image data/product-front.jpg --image data/product-side.jpg --count 4
  182. python3 scripts/generate_image_dreamina.py --prompt "..." --size 1:1 \
  183. --canvas-id <画布UUID> --resolution 1.5K
  184. ```
  185. apiz 通道:
  186. ```bash
  187. python3 scripts/generate_image.py --channel apiz --prompt "clean product hero image, premium studio lighting, white background" --size 1:1
  188. ```
  189. 从文件读取 Prompt:
  190. ```bash
  191. python3 scripts/generate_image.py --prompt-file prompt.txt --output-dir outputs
  192. ```
  193. 带参考产品图(图生图模式,本地文件自动上传 apiz CDN):
  194. ```bash
  195. python3 scripts/generate_image.py --prompt "..." --size 1:1 --image data/product.jpg
  196. ```
  197. 已有公网参考图 URL 时:
  198. ```bash
  199. python3 scripts/generate_image.py --prompt "..." --size 4:5 --image-url https://cdn.example.com/product.jpg
  200. ```
  201. 更多参数:
  202. ```bash
  203. python3 scripts/generate_image.py \
  204. --prompt-file prompt.txt \
  205. --output-dir generated-images \
  206. --size 4:5 \
  207. --model apiz/gpt-image-2.5-flare \
  208. --image data/product.jpg \
  209. --timeout 420
  210. ```
  211. 指定其它 `.env` 文件:
  212. ```bash
  213. python3 scripts/generate_image.py --env-file .env --prompt-file prompt.txt
  214. ```
  215. 脚本参数:
  216. - `--prompt`:直接传入 Prompt。
  217. - `--prompt-file`:从文本文件读取 Prompt。
  218. - `--output-dir`:输出目录,默认 `generated-images/`。
  219. - `--env-file`:指定 `.env` 配置文件;不指定时从当前目录向上查找(可选)。
  220. - `--size`:图片比例,默认 `1:1`,如 `16:9`、`9:16`、`2:3`、`4:5`;也兼容 `1024x1024` 这类像素写法(自动换算成比例)。
  221. - `--model`:apiz 图片模型 id,默认 `apiz/gpt-image-2.5-flare`(可用 `APIZ_IMAGE_MODEL` 覆盖)。
  222. - `--image`:本地参考产品图片路径,传入后自动上传并走图生图模式,提升产品一致性。
  223. - `--image-url`:参考图公网 URL(与 `--image` 二选一,URL 优先)。
  224. - `--timeout`:单个生成任务等待上限秒数,默认 `420`。
  225. - `--format`:保存格式的默认扩展名(实际以后缀/类型为准),默认 `png`。
  226. - `--channel`:生图通道 `auto / dreamina / apiz`,默认 `auto`(优先即梦,回退 apiz)。
  227. ### 常用图片比例
  228. | size | 建议用途 |
  229. |---|---|
  230. | `1:1` | 主图、Amazon / 淘宝主图 |
  231. | `4:5` / `2:3` | 详情页竖屏、移动端信息流 |
  232. | `3:4` | 详情页、社媒竖图 |
  233. | `16:9` | Banner、官网 Hero、直播间封面 |
  234. | `9:16` | 短视频封面、Story |
  235. | `3:2` / `4:3` | 场景图、 lifestyle 图 |
  236. 实际输出像素由所选模型决定(默认 `apiz/gpt-image-2.5-flare` 支持 1K/2K/4K 三档,最高 4K)。
  237. 脚本只使用 Python 标准库,不需要安装第三方依赖。
  238. ## 电商 PDP 图片包规则
  239. 当用户提到“详情页、PDP、Amazon A+、Shopify 商品页、主图堆栈、整套商品图、商品详情图片”时,Skill 默认不会只生成 5 张主图,而是输出完整图片包:
  240. - 5 张主图:首图卖点、机制/功能、利益证明、对比或场景、优惠/保障。
  241. - 7-9 张详情页图片:首屏承接、痛点放大、机制解释、核心利益、使用步骤、场景覆盖、对比选择、信任背书、FAQ/风险逆转/CTA。
  242. - 主图默认 `1:1`。
  243. - 详情页图片默认 `2:3`,适合移动端纵向浏览。
  244. - 每张图都使用独立 Prompt 文件,避免把多屏详情页挤在一张拼图里。
  245. 如果没有真实证据,Skill 只允许使用占位式证明表达,不编造认证、实验数据、评分、销量或真实评价。
  246. ## 多图风格一致性
  247. 整套图片生成前必须先创建 **Campaign Style Lock**,并把同一段风格锁定文本放进每一张图的 Prompt。它用于固定:
  248. - 色板:背景色、文字色、强调色保持一致。
  249. - 冷暖调:全套统一为冷调、暖调或中性调。
  250. - 字体:统一一种字体风格,不混用衬线、手写、复古或卡通字体。
  251. - 背景:统一棚拍背景、桌面场景或室内空间逻辑。
  252. - 光线:统一光源方向、阴影强度和反光质感。
  253. - 布局:统一留白、圆角、标签、编号、信息图组件。
  254. - 图标:统一线宽、颜色和复杂度。
  255. 如果用户没有品牌规范,Skill 会使用一个保守的高级电商默认风格锁:
  256. ```text
  257. Campaign Style Lock: consistent premium ecommerce visual system across the entire image set; fixed palette of clean off-white background, deep charcoal text, one product-matched accent color, and one soft secondary accent; neutral-cool studio lighting; modern geometric sans-serif headline placeholders only; consistent rounded rectangular info labels; consistent thin-line icon style; clean high-end product photography mixed with minimal infographic elements; stable product scale and placement; generous whitespace; no color palette changes, no mixed fonts, no random backgrounds, no inconsistent lighting, no mismatched icon styles.
  258. ```
  259. ## 输入示例
  260. 商品营销图:
  261. ```text
  262. 产品:自发热眼罩
  263. 类别:睡眠与健康
  264. 价格区间:19–29 美元
  265. 受众:压力大的上班族
  266. 差异化点:40 分钟持续发热,无香可选,皮肤安全材料
  267. 证明资产:4.7 星评价,皮肤科测试报告,30 天保障
  268. 渠道:亚马逊 PDP + 主图堆栈
  269. 当前弱点:点击量尚可,加购率低
  270. 目标:提高转化率和信任感知
  271. 要求:生成 1 张主图 Prompt,并在已配置 API 时直接出图
  272. ```
  273. 电商整套详情页图片:
  274. ```text
  275. 产品:洗衣凝珠
  276. 类别:家居清洁
  277. 受众:忙碌家庭、租房用户、宿舍用户
  278. 差异化点:一颗一洗,预配比,减少倒液和脏手,香味清新
  279. 渠道:Shopify PDP + 商品主图
  280. 目标:让详情页也生成独立图片,不只生成 5 张主图
  281. 要求:生成完整图片包,并在已配置 API 时直接出图
  282. ```
  283. 通用视觉图:
  284. ```text
  285. 为一个 AI 写作工具生成官网首屏视觉。
  286. 风格:干净、现代、轻量科技感。
  287. 主体:笔记、文档、自动整理的知识卡片。
  288. 用途:官网 Hero 背景图。
  289. 尺寸:16:9。
  290. 不要出现可读文字。
  291. ```
  292. ## 输出示例
  293. ```text
  294. 1. Visual Brief
  295. - 目标:突出轻量、可信、自动整理
  296. - 主体:文档、知识卡片、柔和界面层次
  297. - 风格:现代 SaaS、干净、低噪声
  298. 2. Final Image Prompt
  299. Clean modern SaaS hero background image...
  300. 3. Negative Constraints
  301. No readable text, no logos, no clutter...
  302. 4. Generated Files
  303. generated-images/image-20260506-180000-01.png
  304. ```
  305. ## 安全说明
  306. - 每个使用者使用自己的 apiz 账户和凭据;认证由 apiz CLI 的配置文件或 `APIZ_API_KEY` 处理。
  307. - 仓库不会保存 API key。
  308. - 不要提交 `.env` 文件;仓库已用 `.gitignore` 忽略 `.env` 和 `.env.*`。
  309. - 分享 Skill 时,只分享代码和文档,不分享任何真实密钥。
  310. - 如果你在公共终端或录屏环境中操作,不要直接展示 `APIZ_API_KEY`。
  311. ## 局限性
  312. - apiz 生成为异步任务,单张图通常 30–90 秒完成;脚本通过 `--wait` 阻塞等待后自动下载。
  313. - 实际输出像素由所选模型决定;默认 `apiz/gpt-image-2.5-flare` 支持 1K/2K/4K 三档。
  314. - 单个任务每次返回 1 张图;参考图走 `--image` / `--image-url` 单张传入。
  315. - 生图质量、速度和积分消耗取决于所选模型。
  316. - 结果 URL 有时效,脚本会自动下载到本地。
  317. - 商品营销图中的效果承诺必须有证据支持;不要让图片文案虚构资质、认证或结果。
  318. ## 推荐工作流
  319. 1. 先让 Skill 生成视觉简报和 Prompt。
  320. 2. 人工确认画面目标、主体、平台尺寸和禁用内容。
  321. 3. Codex 环境直接用内置 imagegen 出图;其他环境 `apiz auth login` 后生成图片。
  322. 4. 对商品或广告图保留 2–3 个创意变体做 A/B 测试。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.