lujiaheng-artpivot A/B测试变体生成 Skill
基于原始广告素材自动生成多个测试变体，支持文案、色调、运镜、时长等多个维度的变化，用于A/B测试效果对比。
使用方法
python3 scripts/generate_variants.py \
--base-video ./ad_video.mp4 \
--base-copy ./ad_copy.json \
--dimensions copy,color,motion \
--count 4 \
--output-dir ./variants
参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
--base-video |
string | ✅ | 原始广告视频路径 |
--base-copy |
string | ✅ | 原始广告文案JSON路径 |
--dimensions |
string | ✅ | 变体维度，多个用逗号分隔：copy/color/motion/duration/subtitle |
--count |
number | 生成的变体数量，默认4 | |
--output-dir |
string | 输出目录，默认 ./variants | |
--keep-original |
boolean | 是否在输出中保留原始版本，默认true | |
--generate-metadata |
boolean | 是否生成变体元数据报告，默认true |
支持的变体维度
| 维度 | 说明 | 变化范围 |
|---|---|---|
copy |
文案变体 | 不同的标题、描述、CTA |
color |
色调变体 | 冷色调、暖色调、复古色调、高对比度 |
motion |
运镜变体 | 不同的镜头运动方式和速度 |
duration |
时长变体 | 7秒、10秒、15秒、30秒 |
subtitle |
字幕变体 | 不同的字幕样式、位置、内容 |
输出目录结构
variants/
├── original/ # 原始版本（可选）
│ ├── video.mp4
│ └── copy.json
├── variant_1/ # 变体1
│ ├── video.mp4
│ ├── copy.json
│ └── metadata.json
├── variant_2/ # 变体2
│ ├── video.mp4
│ ├── copy.json
│ └── metadata.json
└── variants_report.json # 变体总报告
事件发布
生成完成后会发布 variants.generated 事件到消息总线。
变体报告格式
{
"taskId": "task_123456",
"baseVideo": "./ad_video.mp4",
"dimensions": ["copy", "color"],
"count": 4,
"variants": [
{
"id": "variant_1",
"dimensions": {"copy": "variant_A", "color": "warm"},
"videoPath": "./variants/variant_1/video.mp4",
"description": "文案变体A，暖色调"
}
],
"generatedAt": "2026-03-11T12:00:00Z"
}
使用建议
- 一次测试不要超过3个维度，避免变量过多难以分析
- 变体数量建议4-6个，包含原始版本作为对照
- 测试时保持投放渠道、时间、预算一致
- 重点关注转化率、完播率、点击率等核心指标