Ecommerce Video Script Generator

视频脚本的生成器（国际化电商视频管线 Skill2）。根据产品卖点、品类、功能属性、用户痛点、目标市场，按爆款镜头结构生成10s/15s分镜脚本。输出JSON（AI管线）+ Markdown（人工审阅）。当需要将商品卖点转化为结构化分镜脚本时触发。

国际化电商视频生成 — Skill2：视频脚本的生成

管线定位

text

Skill1 基图生成器 → product_layer.png + selling_points.json（含product_function + user_pain_point）
                    ↓
Skill2 分镜脚本生成器 ← 本技能
  输入: 产品白底图路径 + 商品卖点 + 视频类型 + 品类 + 功能属性 + 用户痛点 + 国家 + 时长
  输出: storyboard.json (AI管线) + storyboard.md (人工审阅)
                    ↓
Skill3 AI视频渲染 → 最终视频

核心原则

1. 全视频仅一张产品白底图作为参考，无其他产品素材
2. 国家仅管控：人物特征、台词/字幕语种、场景风格辅助修饰
3. 仅支持时长：10秒 / 15秒
4. 人物、背景无图片输入，全部文本生成
5. 功能属性规则优先级高于品类通用规则，实现同一品类内差异化

输入参数

json

{
  "product_white_img": "E:\\path\\product_layer.png",
  "product_name": "商品全称",
  "核心卖点": {
    "主卖点": "核心优势1条",
    "次卖点": ["次卖点1","次卖点2","次卖点3"]
  },
  "适用人群": "目标使用人群",
  "适用场景": "产品标准使用场景",
  "category": "家居日用|美妆护肤|食品零食|服饰鞋包|数码3C",
  "product_function": "功能属性（详见品类×功能矩阵）",
  "user_pain_point": "用户核心痛点（详见痛点映射表）",
  "video_type": "痛点解决|UGC种草|产品演示|开箱种草|CTA带货",
  "hook_points": "开场吸睛点（可空）",
  "details": "细节说明（可选，用户填写后严格参考到脚本画面描述）",
  "angle": "视频想法角度（可选，如'从产品开箱切入'，用户填写后严格参考到镜头结构编排）",
  "target_duration": 10,
  "price": "优惠价格（可空）",
  "target_market": "thailand|cn|jp|kr|us"
}

目标国家作用表

国家	人物硬性约束	台词/字幕语言	场景辅助微调
cn	东亚黄皮、淡妆、含蓄温和	中文	简约居家、ins风、低饱和柔光
thailand	东南亚小麦肤色、清新淡妆、肢体热情	泰语	热带绿植、藤编软装、高饱和亮色
jp	白皮、淡裸妆、小动作温柔	日语	原木极简、大量留白、低对比柔光
kr	白皮水光肌、精致妆容、潮流手势	韩语	马卡龙浅色系、高亮度柔光
us	多元肤色、自然无妆、肢体开放	英语	开放式大空间、硬朗自然光对比

视频类型固定镜头结构

1. 痛点解决（通用投流爆款）

镜头: 痛点冲击 → 产品亮相 → 实操演示 → 效果对比 → [15s增加]推荐CTA 时长: 10s=2/2/3/3s 15s=3/2/3/4/3s

2. UGC种草（生活化博主风）

镜头: 日常代入 → 产品全景 → 上手体验 → 亮点总结 → [15s增加]种草推荐 时长: 10s=2/2/3/3s 15s=3/2/3/4/3s

3. 产品演示（功能向）

镜头: 产品全景特写 → 功能演示1(主卖点) → 功能演示2(次卖点) → 整体效果展示 时长: 10s=2/2/3/3s 15s=3/2/3/4/3s

4. 开箱种草（新品类）

镜头: 开箱动作 → 产品完整露出 → 初次试用 → 细节亮点 → [15s增加]满意推荐 时长: 10s=2/2/3/3s 15s=3/2/3/4/3s

5. CTA带货（短平快转化）

镜头: 产品高光特写 → 核心卖点 → 快速实操 → 价格+下单引导 时长: 10s=2/2/3/3s 15s=3/2/3/4/3s

产品品类专属规则

品类	节奏	特写重点	运镜	音效	光影
家居日用	中速	功能接触面、对比痕迹	跟拍手部、微距慢动作	工具摩擦、撕拉、水流	均匀室内柔光、侧逆光对比
美妆护肤	前慢后快	质地、皮肤纹理、上脸	微距推镜、环绕产品	开盖、涂抹拍打ASMR	柔和水光、低对比
食品零食	快、入口慢	食材纹理、汤汁、咀嚼	俯拍、微距滴落、慢动作	撕袋、咀嚼、气泡	高饱和暖光、食物光泽
服饰鞋包	全程慢速	面料纹理、logo、版型	环绕、全身平移、平铺	布料摩擦、脚步声	柔和漫射光、真实色彩
数码3C	中快速	按键、屏幕、接口、材质	45°斜推、环绕、固定	按键提示音、科技BGM	冷调产品光、金属反光

产品功能属性 × 品类 专属规则矩阵

当 product_function 有值时，其规则优先级高于品类通用规则，实现同一品类内的差异化。

美妆护肤类

功能属性	代表产品	节奏	特写重点	运镜	音效	光影	差异化关键
遮盖修饰	遮瑕、粉底、眉笔	快→慢	瑕疵before/after、遮盖力	固定对比→微距推镜	轻点拍开声	单侧硬光	before/after对比
色彩表达	口红、眼影、腮红	慢→快	唇部纹理/色泽、晕染	微距推镜→环绕	开盖、涂抹声	柔和水光低对比	多肤色试色
质地体验	精华、面霜、面膜	全程慢速	质地延展、吸收过程	滴管慢动作→延时	挖取、拍打声	柔和侧光	质地变化全过程
工具辅助	美妆蛋、化妆刷	中速	工具材质、手法	手部特写→跟拍	摩擦、弹响声	均匀柔光	手法教学感
持久定妆	散粉、定妆喷雾	中速	刚上脸→持妆状态	慢镜头→时间切换	按压、喷雾声	逆光	时间维度对比

食品零食类

功能属性	代表产品	节奏	特写重点	运镜	音效	光影	差异化关键
即食口感	薯片、巧克力、糖果	快、入口慢	酥脆/丝滑质地、咀嚼	俯拍→微距入口	撕袋脆响、ASMR	高饱和暖光	声音ASMR核心
冲泡过程	咖啡、奶茶、麦片	前慢后快	粉液融合、色泽、蒸汽	俯拍→微距滴落→搅拌	倒水、搅拌声	暖光+蒸汽光晕	过程仪式感
开箱仪式	礼盒、进口零食套装	全程慢速	包装、分层、赠品	开箱→平铺→环绕	撕拉、惊喜声	柔和暖光	价值感知
健康功能	代餐、蛋白棒	中速	成分、质地、效果	成分→食用→对比	轻音乐、咀嚼声	自然光清新	成分信任

家居日用类

功能属性	代表产品	节奏	特写重点	运镜	音效	光影	差异化关键
便捷收纳	收纳盒、挂钩、置物架	快	前后对比、安装	跟拍手部→快速	工具摩擦、卡扣声	均匀柔光	便捷性
清洁效果	清洁剂、拖把、粘毛器	中速	污渍对比、清洁过程	固定对比→微距	水流、摩擦、泡沫	侧逆光对比	before/after强烈
舒适体验	枕头、床垫、拖鞋	慢速	柔软度、姿态、表情	慢动作按压→特写	柔软摩擦、叹息	柔和暖光	舒适传递
耐用品质	刀具、锅具、五金	中速	材质、痕迹、测试	微距→过程→测试	金属碰撞、切割	冷调产品光	耐用证明
效果对比	烘干机、除毛器、清洁工具	快→慢	问题→效果差异	固定对比→微距	问题音→效果音	侧逆光凸显	差异肉眼可见

服饰鞋包类

功能属性	代表产品	节奏	特写重点	运镜	音效	光影	差异化关键
日常百搭	T恤、牛仔裤、基础款	中速	面料、搭配、版型	全身平移→搭配切换	布料摩擦、脚步声	柔和漫射光	百搭性
场景氛围	礼服、运动装、户外服	慢速	氛围融入、细节	环绕→动态→场景切换	环境音、BGM	场景光	情感共鸣
功能实测	防水鞋、防晒衣、登山包	中速	功能细节、过程	特写→测试→对比	雨声、摩擦声	真实环境光	效果证明
品质工艺	皮包、皮鞋、高端服饰	慢速	纹理、缝线、五金	微距→环绕→触摸	皮革摩擦、金属扣	侧光质感冷光	工艺细节

数码3C类

功能属性	代表产品	节奏	特写重点	运镜	音效	光影	差异化关键
性能参数	手机、电脑、显卡	中快速	跑分、帧率、加载	屏幕录制→45°斜推	科技BGM	冷调产品光	参数可视化
便捷易用	智能家居、穿戴设备	中速	一键操作、连接	手部特写→场景	连接提示音	柔和室内光	易用性
外观设计	耳机、手表、配件	慢速	材质、色彩、佩戴	环绕→佩戴→光影	轻音乐	多光位质感	颜值为王
耐用品质	充电宝、数据线、保护壳	中速	强度、接口、测试	微距→测试→场景	测试声	均匀产品光	耐用证明

用户痛点 → 镜头策略映射表

痛点	镜头策略
遮不住	强化before/after对比，单侧硬光凸显遮盖效果
太干卡纹	展示质地延展性，强调滋润保湿度
不知道色号	多肤色试色对比，自然光下真实效果
容易掉色	持久测试（喝水/擦拭），时间维度对比
不好吃	强化口感可视化，咀嚼ASMR放大
不会用	手法教学式展示，分步骤操作特写
太贵	价值感知强化，日常使用成本拆分
不耐用	耐用测试展示，长时间使用对比
充电慢	充电速度实测对比，时间线可视化
发热严重	散热功能展示，温度实测对比
收纳乱	使用前后空间对比，收纳效果可视化
清洁难	清洁过程展示，去污效果对比
操作复杂	简化操作步骤，一键式演示
效果不明显	使用前后强烈对比，周期效果呈现
占空间	收纳前后对比，折叠/拆卸展示
不贴合	贴合度特写，多角度贴合测试
噪音大	静音效果对比，分贝数值可视化
伤皮肤	温和成分展示，敏感肌适用测试
宠物抗拒	展示宠物舒适放松状态，低噪静音效果
烘干耗时	快速烘干对比，时间可视化

执行步骤

Step1 输入解析

• 读取 product_white_img，绑定图片路径
• 解析 target_market → 确定人物特征、语种、场景修饰
• 解析 video_type → 调取对应镜头结构
• 解析 category → 匹配品类基础规则
• 解析 product_function → 匹配功能属性专属规则，覆盖品类通用规则中的冲突项
• 解析 user_pain_point → 调整镜头重点（痛点解决类强化对比，UGC种草类强化真实感等）
• 解析卖点 → 转化为可视化画面动作，按功能属性分配至镜头

Step2 时长分配

按视频类型 + 时长(10/15s) + 镜头数自动分配，严格遵循时长表

Step3 生成基础模块

• 项目基础信息
• 人物设定文本（仅由国家生成）
• 产品视觉基准说明
• 功能属性规则说明
• 用户痛点镜头策略说明

Step4 生成镜头表格（核心）

每镜强制规则：

• 出现产品时直接用产品名称，不使用 @product_ref
• 台词/字幕使用目标语种
• 光影/音效/特写优先匹配功能属性规则，其次匹配品类规则
• 场景由视频类型+品类决定，仅轻叠加国家修饰

Step5 输出双文件

• storyboard.json — AI管线机器读取（含产品功能属性+用户痛点元数据）
• storyboard.md — 人工审阅表格

输出格式

JSON结构（3段式+可选元数据）

json

{
  "{产品名称}产品参考图": "@产品白底图路径",
  "人物形象特征参考": "人物外貌/妆容/穿搭文本描述",
  "镜头脚本": [...],
  "产品功能属性": "功能属性值（可选）",
  "用户痛点": "痛点值（可选）"
}

Markdown结构（3段式+可选元数据）

text

### {产品名称}产品参考图
@产品白底图路径

### 细节说明（可选）
### 视频角度（可选）
### 产品功能属性（可选）
### 用户痛点（可选）
### 人物形象特征参考
### 镜头脚本

环境变量

变量	必填	说明
SUDOCODE_API_KEY	是	Sudocode API Key（用于AI分镜脚本生成，无则降级规则驱动）

输出目录规则

• 默认路径：桌面 AI视频脚本 文件夹（自动创建）
• 自定义路径：通过 --output 参数指定
• 聊天环境：同时输出 Markdown 结果到聊天窗口 + 保存文件到输出目录

脚本使用

bash

# 基础用法（默认输出到桌面AI视频脚本文件夹）
python {baseDir}/scripts/generate_storyboard.py \
  --product-img "./product_layer.png" \
  --config "./selling_points.json" \
  --video-type "痛点解决" \
  --category "家居日用" \
  --market "thailand" \
  --duration 15

# 显式指定功能属性和痛点（覆盖config中的值）
python {baseDir}/scripts/generate_storyboard.py \
  --product-img "./product_layer.png" \
  --config "./selling_points.json" \
  --video-type "UGC种草" \
  --category "美妆护肤" \
  --product-function "遮盖修饰" \
  --pain-point "遮不住" \
  --details "强调产品环保材质，可回收包装" \    # 可选，严格参考到画面描述
  --angle "从用户日常护肤流程切入" \            # 可选，严格参考到镜头结构
  --market "thailand" \
  --duration 15

# ArkClaw 聊天环境（使用{baseDir}变量）
python {baseDir}/scripts/generate_storyboard.py \
  --product-img "{baseDir}/output/product_layer.png" \
  --config "{baseDir}/output/selling_points.json" \
  --video-type "痛点解决" \
  --category "家居日用" \
  --market "thailand" \
  --duration 15

AI驱动说明

输入 → AI生成链路（优化后）

text

用户输入参数
    ↓
脚本构造结构化Prompt：
  ├─ 商品信息（产品名称、卖点、适用人群、场景）
  ├─ 国家配置（人物特征、语种、场景修饰）
  ├─ 视频类型框架（镜头结构、时长分配）
  ├─ 品类基础规则（节奏、运镜、音效、光影基线）
  ├─ 功能属性规则（覆盖品类通用规则中的差异化项）
  ├─ 用户痛点指令（调整镜头重点和情感曲线）
  ├─ 细节说明（--details，可选，用户填写后严格参考到画面描述）
  ├─ 视频角度（--angle，可选，用户填写后严格参考到镜头结构编排）
  └─ 画面提示（产品白底图引用、真实约束）
    ↓
调用 gpt-5.4-mini → 生成JSON格式镜头脚本
    ↓
解析 + 格式化 → 输出JSON + Markdown

规则备份

当AI API不可用时，脚本自动降级为规则驱动备份，确保管线不中断。功能属性和用户痛点规则同样应用在备份中。

额外说明字段（严格参考）: --details（细节说明）和 --angle（视频想法角度）为可选填字段。用户填写时必须严格参考：

• --details → 融入对应镜头的画面描述，不忽略不替换
• --angle → 按该角度编排镜头结构，不随意改变方向
• 上游 Skill1 传入的 usage_instructions 通过 --config 读取，同样严格参考

---

管线串联（重要 — AI 执行流程）

本 Skill 是国际化电商视频生成管线的 第二环节。执行完成后必须按以下流程操作：

执行前检查

本 Skill 依赖 Skill1 的输出：

• product_layer.png — 产品白底图（通过 --product-img 传入）
• selling_points.json — 结构化卖点（通过 --config 传入，含 usage_instructions 字段）

如果这些文件不存在，提示用户先执行 Skill1。

执行完成后

1. 告知用户结果：输出目录、生成文件列表、脚本摘要
2. 询问是否继续：

   "分镜脚本已生成，是否继续执行 Skill3（AI视频生成）？"

如果用户选择继续 Skill3

将本 Skill 的输出与 Skill1 的输出一起传递给 Skill3：

bash

python {baseDir}/../ecommerce-video-generator/scripts/generate_video.py \
  --script "{output_dir}/storyboard.json" \
  --product "{skill1_output_dir}/product_layer.png" \
  --submit

上下游说明

方向	技能	仓库
⬆ 上游	ecommerce-product-info-generator	https://github.com/BStory28/ecommerce-product-info-generator
⬇ 下游	ecommerce-video-generator	https://github.com/BStory28/ecommerce-video-generator