| 步骤 | 环节 | 自动 / 人工 | 落地脚本 |
|---|---|---|---|
| 1 | 素材提取分段 | 自动 | segment.py |
| 2 | 粗剪筛选 | 人工确认 | 编辑 manifest 的 approved |
| 3 | 音频精细化 | 自动 | build_clips.py |
| 4 | 画面调色 | 自动 | build_clips.py |
| 5 | 转场包装 | 自动 | build_clips.py |
| 6 | 节奏提速 | 半自动 | manifest 的 speed 字段 |
| 7 | 合规校验 | 人工确认 | references/compliance_checklist.md |
| 8 | 导出归档 | 自动 | build_clips.py → clips/ + archive/ |
你有一段 40 分钟的直播回放 直播回放.mp4,想切成若干条 9:16 竖屏带货短片,自动加字幕,把「直播切片」「福利」两个词标绿,铺一段 BGM,最后再合并出一条长版。
python "/skills/live-stream-clip-editor/scripts/segment.py" ^
--input 直播回放.mp4 --workdir out/
# 想要更准的转录可加: --model small
# 想切得更多/更少调: --scene-threshold 0.4(越高切得越少)
脚本会:抽音频 → Whisper 转写(词级时间戳)→ 静音检测 + 场景检测 → 合并成候选片段。产出:
out/segments_manifest.json —— 机器清单,含每段 approved(默认 false)、speed(默认 1.0)、text、words 词级时间戳。out/segments_review.md —— 人读清单(时间戳 + 台词摘要 + 推荐/无效原因),方便你挑。{
"id": 3, "approved": true, "speed": 1.0, "text": "今天给大家推荐一个购物好物...",
...
},
{
"id": 5, "approved": true, "speed": 1.3, ...
},
{
"id": 7, "approved": true, "speed": 1.0, ...
}
无效片段(空镜/杂音、<1.5s、静音占比>60%)已被标 recommended=false,一般直接不选即可。
python "/skills/live-stream-clip-editor/scripts/build_clips.py" ^
--manifest out/segments_manifest.json ^
--bgm bgm.mp3 --bgm-vol 0.18 ^
--keywords 直播切片 福利 --stabilize --merge
对每条 approved=true 的片段自动:音量归一(loudnorm) → 裁剪首尾静音 → 裁剪 9:16 + 统一调色 → 字幕烧录(关键词标绿) → 片头片尾淡入淡出 → speed>1 变速卡点 → 导出 out/clips/clip_XX.mp4;--merge 额外产出 out/clips/merged_all.mp4;源文件归档到 out/archive/。
对照 references/compliance_checklist.md 逐条核对:医疗疗效词、绝对化用语(最/第一/唯一)、诱导引流(加微信/扫码)、违禁品、竞品水印、画面尺度、BGM 版权。命中片段剪掉 / 替换 /「哔」音遮盖。
| 参数 | 默认 | 说明 |
|---|---|---|
--ratio | 9:16 (1080×1920) | 输出比例;支持 16:9 / 3:4 / 1:1 |
--model | base | 转录模型;不够准换 small / medium |
--scene-threshold | 0.4 | 场景切换阈值,越高切得越少 |
--min-dur | 1.5s | 短于此判为无效片段 |
--silence-db / -dur | -35dB / 0.5s | 静音检测 |
--bgm-vol | 0.18 | BGM 音量(0~1) |
--keywords | 无 | 需绿色高亮的关键词(可多个) |
--stabilize | 关 | 抖动修复(vidstab) |
--merge | 关 | 额外合并导出一条长版 |
Whisper 字幕需逐句人工修正。 中文常出繁体/错字,第 2 步顺手改 manifest 的 text 字段(字幕以此为准)即可。
: 误解析。references/ffmpeg_recipes.md 手动补充。| 依赖 | 本机状态 |
|---|---|
| ffmpeg / ffprobe | 7.1,已在 PATH;脚本内置路径探测回退到 D:/ffmpeg-7.1-essentials_build/ffmpeg-7.1-essentials_build/bin/ ✓ |
| whisper CLI | 脚本内置路径探测回退到 |
| 脚本位置 |