SuperAPI AI 工具集

video-clipper

设计与创作

查看项目

更新于 10-16 09:44

技能介绍

用途:从直播回放、会议录像、播客等长视频中批量生成短视频切片,基于转写文稿精确定位观点边界,输出音画同步的短视频。

依赖:ffmpeg/ffprobe(系统已安装);whisperx venv(scripts/.venv-whisperx/,用于二次质检);video-to-text skill 输出的带 word_segments 时间戳转写 JSON。脚本位于 workspace/scripts/。

流程分四阶段(另有最终检查):Phase 1 素材准备;Phase 2 基于转写 JSON 校准切片边界;Phase 3 用 batch-clip-v4.sh 批量切片(去静音 + 去口吃 + crossfade);Phase 4 用 batch-postcheck.sh 结合 WhisperX 二次质检并修复残留口吃。

主要能力:长静音(≥0.5s)完全跳过,短静音(0.25-0.5s)压缩至 0.12s;基于原始转写 JSON 检测重复词/短语口吃并跳切;每个拼接点加 20ms acrossfade 消除咔哒声;clip-postcheck.py 对切片重转写,检测单字重复、短语重复和低置信度簇并自动修复;iterate-until-clean.py 单条迭代直到零问题。

用法要点:含 CJK 文件名需先建英文 symlink,如 ln -sf "/path/to/直播回放.mp4" /tmp/livestream-input.mp4;批量任务须用 nohup 后台运行,脚本内部切片列表为 batch-clip-v4.sh 的 clips=() 数组,格式 "start|end|name";时间戳超过 59:59 必须用 H:MM:SS。输出为 workspace/clips/<编号>-<名称>.mp4,H.264 CRF23 + AAC 128kbps + faststart,比原始切片平均短 20-30%。

限制:依赖前置转写 JSON;WhisperX 二次转写按 CPU 约 60-90 秒/1 分钟 clip,批量耗时较长;原始转写可能漏识口吃,需 Phase 4 补检;不可用 select/aselect 滤镜以免音画漂移;macOS zsh 无 mapfile。性能参考:14 条约 35 分钟原始时长,Phase 3 约 20 分钟、Phase 4 约 20 分钟。字幕添加等后续步骤资料未提供具体方案。