直播切片 · Live-Stream Clips
几小时直播 → 一批 15–60 秒竖屏切片。选段可以靠人、靠字幕关键词、或靠停顿自动提议；导出统一交给 scripts/live_clip.py。
Part of ecommerce-video-skills
只切你自己的直播，或已获得主播/品牌授权的直播。
输入 Inputs
- 直播录像（mp4/flv/mov，横屏竖屏都行）
- 可选：字幕/转写 SRT（平台导出或用任意 ASR 工具生成）
- 目标：每条时长、数量、要突出的商品或话题
三种选段方式
bash# A. 已有时间戳（人工或 agent 读转写后挑选） # cuts.csv: start,end,title # 00:12:05,00:12:40,冰块放一晚还在？现场演示 python scripts/live_clip.py live.mp4 --cuts cuts.csv --outdir out/clips # B. 按字幕关键词找片段（每个命中点向前 30% / 向后 70% 取 --window 秒，重叠自动合并） python scripts/live_clip.py live.mp4 --srt live.srt --keywords "演示,对比,上链接,库存" --window 30 --burn-subs # C. 没有字幕：在停顿处切分，输出候选 CSV 再人工/agent 挑选 python scripts/live_clip.py live.mp4 --propose 30 > proposals.csv
步骤 Steps
- 先读转写（有 SRT 时）：让 agent 标出「演示、对比、用户提问被解答、福利说明」等高光点，写进
cuts.csv。 - 每条切片要能独立看懂：开头 3 秒必须有钩子——从「问题/演示开始」切入，而不是从主播寒暄切入。
- 起止点微调：起点落在句子开头、终点落在句子结束后 0.3 秒。
- 导出：横屏自动转 9:16（模糊背景 + 居中画面），可烧标题（
title列）和字幕（--burn-subs）。 - 写切片标题：用
hook-3s-script的钩子类型给每条写 2 个标题，交给cover-title-ab。
高光信号 What makes a good clip
| 信号 | 例子 |
|---|---|
| 现场演示 | 倒水、摔、对比测试 |
| 问答 | 「有人问能不能放洗碗机…」 |
| 情绪峰值 | 惊讶、笑场、观众刷屏 |
| 规则说明 | 赠品、售后、发货（注意：价格/优惠信息以当前实际为准，过期切片要下架或剪掉） |
提示词模板 Prompt template
text下面是直播转写（SRT）。请找出 {8} 个适合做 {20–40} 秒竖屏切片的片段： 每段必须能独立看懂、开头 3 秒有钩子（问题/演示/结果），避免寒暄和长时间沉默； 输出 CSV：start,end,title（title ≤ 14 字，不使用绝对化用语，不承诺具体价格）。 转写：{粘贴 SRT}
检查清单 Checklist
- 每条切片开头 3 秒有钩子、结尾不断句
- 标题与字幕不在底部 UI 区；横屏画面完整可见
- 切片里出现的价格/优惠/库存信息仍然有效，否则剪掉
- 有直播内容的使用授权
常见问题与修复 Failure fixes
| 问题 | 修复 |
|---|---|
--propose 只返回一段 | 背景音乐盖住了停顿；改用 SRT 关键词法，或调低 silencedetect 的 noise 阈值 |
| 字幕与画面不同步 | 确认 SRT 时间轴对应原始录像；脚本使用 -copyts 保持源时间轴 |
| 标题含冒号/引号报错 | 脚本已替换为全角符号 |
| 切点在半句话 | 用 SRT cue 的起止时间作为切点 |
