live-stream-clip-editor 使用说明书

直播切片视频后期流水线 · 把一段长直播/长视频自动切成多条可发布短视频 · 默认抖音/视频号 9:16 竖屏
类型 视频后期 / 长视频切片
输入 1 段长视频(直播回放/长视频)+ 可选 BGM / 关键词
输出 多条独立竖屏 mp4(默认 1080×1920)+ 可选合并长版
触发词 把这段直播切成短视频 / 做个带货切片 / 直播高光剪成几条 / 长视频切片二创

一、你该对我说什么(人话示例)

二、8 步流水线总览

步骤环节自动 / 人工落地脚本
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/
💡 机械可确定的 80%(抽音频、按台词/静音/转场切分、音量归一、9:16 裁剪调色、字幕烧录、变速、批量导出、归档)全自动;保留哪些片段和合规红线两个主观环节必须你拍板。

三、实战范例(照抄即可用)

场景

你有一段 40 分钟的直播回放 直播回放.mp4,想切成若干条 9:16 竖屏带货短片,自动加字幕,把「直播切片」「福利」两个词标绿,铺一段 BGM,最后再合并出一条长版。

第 1 步:分段(自动)

python "/skills/live-stream-clip-editor/scripts/segment.py" ^
       --input 直播回放.mp4 --workdir out/
# 想要更准的转录可加: --model small
# 想切得更多/更少调: --scene-threshold 0.4(越高切得越少)

脚本会:抽音频 → Whisper 转写(词级时间戳)→ 静音检测 + 场景检测 → 合并成候选片段。产出:

第 2 步:粗剪筛选(人工确认,我会帮你改)

你只需告诉我:「保留第 3、5、7 段,第 5 段提速到 1.3,把第 3 段字幕里的『購物』改成『购物』」。我会把 manifest 里对应片段改成下面这样:
{
  "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,一般直接不选即可。

第 3~6、8 步:成片与导出(自动)

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/。

第 7 步:合规校验(人工确认,上线前必过)

对照 references/compliance_checklist.md 逐条核对:医疗疗效词、绝对化用语(最/第一/唯一)、诱导引流(加微信/扫码)、违禁品、竞品水印、画面尺度、BGM 版权。命中片段剪掉 / 替换 /「哔」音遮盖。

四、常用参数速查

参数默认说明
--ratio9:16 (1080×1920)输出比例;支持 16:9 / 3:4 / 1:1
--modelbase转录模型;不够准换 small / medium
--scene-threshold0.4场景切换阈值,越高切得越少
--min-dur1.5s短于此判为无效片段
--silence-db / -dur-35dB / 0.5s静音检测
--bgm-vol0.18BGM 音量(0~1)
--keywords无需绿色高亮的关键词(可多个)
--stabilize关抖动修复(vidstab)
--merge关额外合并导出一条长版

五、⚠️ 必读提醒

Whisper 字幕需逐句人工修正。 中文常出繁体/错字,第 2 步顺手改 manifest 的 text 字段(字幕以此为准)即可。

六、环境与路径(本机已验证)

依赖本机状态
ffmpeg / ffprobe7.1,已在 PATH;脚本内置路径探测回退到 D:/ffmpeg-7.1-essentials_build/ffmpeg-7.1-essentials_build/bin/ ✓
whisper CLI脚本内置路径探测回退到 /binaries/python/envs/default/Scripts/whisper.exe ✓(已实测可运行)
脚本位置/skills/live-stream-clip-editor/scripts/
📌 一句话总结:丢一段长视频给我,我先自动切出候选清单给你挑,你勾选+改错别字后,我一键批量产出多条竖屏成片;发之前别忘了过一遍合规清单。
← 返回 SKILL 库