做内容创作的程序员大概都有同一种感受剪一条二十分钟上下的中长视频真正耗时间的往往不是“拖动时间线”本身而是反复听素材、找有效镜头、对字幕、导出不同平台比例。操作剪辑软件可能只占三分之一的时间剩下的时间都消耗在素材检索和重复劳动上。针对这个痛点我用 Python 和 FFmpeg 自研了一个偏“客户端”形态的本地 AI 剪辑流水线目标是把一条中长视频从整理素材到输出成片的时间压到一次完整流程 54 分钟左右。这篇文章不是来吹“AI 一键成片”的。我的核心判断是AI 剪辑的关键不在“自动生成画面”而在于把剪辑流水线里的重复环节全部自动化把人的时间留给判断。语音转写、字幕对位、静音裁剪、响度统一、多版本导出这些工作无比琐碎却占掉大量时间创作者的真正价值在于选择讲什么、不讲什么、先说什么、后说什么。这套 AI 剪辑客户端要解决的就是让前者尽可能少占用创作精力。读完这篇文章你可以带走四样东西一整条可落地的中长视频剪辑流水线设计可以改来直接用的核心 Python 脚本用 FFmpeg 实现自动粗剪、字幕压制、响度标准化的具体命令以及我在实践中踩过的问题和对应的排查方式。不管后续你是想做一个带界面的桌面客户端还是只要一套批处理脚本都可以按这个思路往下走。1. 为什么中长视频剪辑需要自研工具1.1 时间到底花在哪里先做一个简单的拆分。一条中长视频的制作通常包含这么几个环节素材管理、粗剪、精剪、字幕、音频处理、多版本导出。真正属于“创意判断”的其实只有粗剪和精剪中的选题、排布、节奏。剩下的事情都有一个共同特征高度重复、规则明确、对准确性要求极高但几乎没有创造性。以真实项目为例很多时候最耗时的不是“这段要不要”而是“这段话在第几条素材里出现过”。过去纯粹靠人肉拉时间线找一个素材可能要反复预览好几遍。语音转写出来之后一切就变了你可以直接搜索关键词可以直接看文字可以在文本层面“剪”一遍再回到画面去确认。这也是为什么我会把语音转写放在整个流水线的最前面而不是最后。另一个被严重低估的时间杀手是字幕对齐。视频里配音和字幕偏差零点几秒观看体验就会非常明显。如果完全手打时间轴二十分钟的片子可能要用掉一个下午。这部分是典型可以让机器做的事情。1.2 现有工具的三个短板如果用现成的剪辑软件比如 Pr、达芬奇、Final Cut Pro能不能解决上面这些问题能但不够。它们更强调“剪辑操作”本身而不是“剪辑前准备”和“导出交付”这两端的自动化。再看在线剪辑网站和通用 AI 短视频工具。它们解决的场景偏短素材时长很有限最多支持十分钟以内的视频对本地海量素材的批量处理能力弱上传下载大文件依赖网速对隐私也比较敏感。更重要的是很多在线 AI 工具只能输出“一次性成片”中间过程是黑盒没法在每个环节停下来检查、修改也没法把中间产物给专业剪辑软件继续精修。还有一类是各类脚本化剪辑工具。它们很灵活但通常只覆盖单点能力比如“批量加字幕”“自动剪静音”。单独用的时候都很好使但放在一条完整的生产链路里就会出现断层素材没有统一索引、步骤之间的数据格式不兼容、出了问题不知道在哪一步。1.3 客户端方案的优势所以我的选择是做一个本地 AI 剪辑客户端。它不追求取代 Pr 或达芬奇而是承担“剪辑前中后三段”的自动化工作剪辑前自动扫描素材、读取元数据、生成索引让“找素材”变成“查索引”。剪辑中通过语音转写生成带时间戳的剧本自动生成粗剪决策表把片段列表交给剪辑软件或 FFmpeg。剪辑后自动生成字幕、统一响度、导出版本把交付成本降到最低。这种“客户端”形态意味着所有素材默认留在本地不需要全部上传处理大文件只受机器性能约束不受带宽和平台限制并且每一步中间结果都落盘成 JSON可以随时中断、继续、复盘。对一个需要长期生产内容的团队来说这套东西的价值不在于“省掉剪辑师”而在于把剪辑师从重复劳动里解放出来。2. 整体架构与核心设计思路2.1 流水线不是“一键出片”很多人听到 AI 剪辑第一反应是“我丢一堆素材进去AI 直接给我一条成片”。这个预期很美好但至少在当前阶段它更适合当作科幻片看。中长视频的成片需要有主题、有结构、有观点表达全自动生成的结果往往缺乏稳定的信息逻辑。更靠谱的设计是把剪辑过程拆成一条流水线每个环节有明确的输入输出人在关键节点做判断。这套客户端的流水线可以概括为六个模块素材索引模块扫描素材目录读取媒体元数据。语音转写模块抽取音频生成带时间戳的转写文本。语义分段模块把连续转写文本切成分镜级别的段落甚至可以补上标题和摘要。剪辑决策模块根据分段结果、目标时长、静音分布生成粗剪片段列表。执行渲染模块调用 FFmpeg 完成片段抽取、拼接、字幕压制、响度处理。交付导出模块按目标平台比例导出或生成 EDL 给专业剪辑软件继续精修。2.2 数据流转与断点续跑这套流水线能够稳定的关键在于每个模块之间都用JSON文件做中间产物。每一步做完都会把结果写到work/目录。这样有几点好处任意一步失败可以回去修完再继续不用从头跑。人工可以打开 JSON 检查中间结果确认后再进入下一步。模块之间完全解耦以后把 Whisper 换成其他 ASR 服务或者把 FFmpeg 换成其他渲染器只影响单个模块。数据流转大致是这样raw/ 素材 → index.json 素材索引 → transcript.json 带时间戳的语音转写 → storyboard.json 分段后的剧本结构 → cutlist.json 粗剪片段列表 → workprint.mp4 工作样片 → final.mp4 最终成片每个文件都是下一个模块的输入。这种设计最大的好处是你可以在任何一步停下来用 Pr 或者达芬奇打开中间产物人工修改改完再让自动化流程继续走。2.3 为什么选“客户端”而不是纯 Web一句话因为素材在本地中间结果也需要长期保留。剪辑项目不像网页应用所有数据都要立刻保存而且很多素材动辄几十 GB重复上传不现实。客户端形态天然适合本地文件处理同时还能方便地接入本地模型。隐私上素材不离开本机敏感内容更可控。技术选型上客户端主体用 Python 编写底层调用 FFmpeg 和 Whisper。这套组合的好处是生态成熟、命令稳定并且每一步都能用脚本复现很适合被包装成命令行工具或桌面程序。如果你需要图形界面后续可以用 PySide6 或 WebView 包一层壳但核心流水线其实不需要界面也能跑。3. 环境准备与项目目录3.1 环境依赖在开始之前先把环境准备好。我推荐 Python 3.10 及以上版本FFmpeg 需要包含ffprobe命令语音识别使用 openai-whisper。版本建议以实际项目为准不必完全跟随某个固定版本但大版本尽量保持稳定。创建虚拟环境并安装依赖python3.10 -m venv .venv source .venv/bin/activate pip install --upgrade pip pip install openai-whisper tqdm检查 FFmpeg 是否可用ffmpeg -version ffprobe -version如果系统提示找不到命令需要先把 FFmpeg 安装并加入 PATH。不同操作系统安装方式不同这里不展开。3.2 项目目录结构建议所有项目文件按下面结构组织ai-editor-client/ ├── raw/ # 原始素材按日期分子目录 │ └── 20240615/ ├── assets/ # 音乐、图片、包装素材 ├── work/ # 中间产物JSON、WAV、字幕 ├── export/ # 最终导出文件 ├── scripts/ │ ├── index_media.py # 素材索引 │ ├── transcribe.py # 语音转写 │ ├── generate_cutlist.py # 剪辑决策表生成 │ └── pipeline.py # 总流水线 └── requirements.txt这样的好处是work/目录里的所有内容都可以随时删除重建raw/目录始终保存原始素材脚本出错不会碰到原始文件。依赖文件requirements.txt可以写成openai-whisper tqdm如果你后续要调用外部大模型做语义分段需要用到 OpenAI SDK 或者其他大模型 SDK再按需补充不用一上来就把所有依赖都装上。3.3 跑通一次的最小闭环实战中不建议一上来就追求完整功能。先跑通“索引 → 转写 → 粗剪 → 导出”这条最小闭环确认每个环节都能输出正确结构再逐步加入语义分段、多版本导出、EDL 等能力。下面几节就按这条闭环展开。4. 素材整理与元数据索引4.1 素材目录规范素材管理的痛点通常不是“文件太多”而是“没有规则”。如果素材文件名五花八门、目录层级混乱任何自动化工具都很难处理。所以第一步不是写代码而是先把素材目录规范下来。我的建议是raw/下按拍摄日期建子目录例如raw/20240615/同一场戏或同一期节目的多机位素材文件名加上场景前缀例如20240615A_01.mp4。这样既方便脚本扫描也方便人工按时间线检索。4.2 用 ffprobe 生成素材索引素材索引脚本做的事情很简单扫描raw/目录下的视频文件调用ffprobe读取每个文件的时长、分辨率、编码格式、修改时间然后输出到work/index.json。文件路径scripts/index_media.pyimport argparse import json import shutil import subprocess from pathlib import Path def probe_media(file_path: str) - dict: cmd [ ffprobe, -v, quiet, -print_format, json, -show_format, -show_streams, file_path, ] result subprocess.run(cmd, capture_outputTrue, textTrue, checkTrue) return json.loads(result.stdout) def scan(raw_dir: Path): videos [] for ext in (.mp4, .mov, .mkv, .mxf, .avi): videos.extend(raw_dir.rglob(f*{ext})) return sorted(videos) def main(): parser argparse.ArgumentParser(description素材索引) parser.add_argument(--raw, defaultraw, help原始素材目录) parser.add_argument(--output, defaultwork/index.json, help索引输出路径) args parser.parse_args() if shutil.which(ffprobe) is None: raise RuntimeError(未找到 ffprobe请先安装 FFmpeg并加入 PATH) raw_dir Path(args.raw) work_dir Path(args.output).parent work_dir.mkdir(parentsTrue, exist_okTrue) entries [] for video in scan(raw_dir): try: meta probe_media(str(video)) video_stream next( (s for s in meta.get(streams, []) if s.get(codec_type) video), {}, ) fmt meta.get(format, {}) entries.append({ path: str(video), duration: float(fmt.get(duration, 0)), width: video_stream.get(width), height: video_stream.get(height), codec: video_stream.get(codec_name), modified: video.stat().st_mtime, }) except Exception as exc: print(f[warn] 处理失败: {video} - {exc}) entries.sort(keylambda x: x[modified]) with open(args.output, w, encodingutf-8) as f: json.dump(entries, f, ensure_asciiFalse, indent2) print(f索引完成共 {len(entries)} 个文件输出到 {args.output}) if __name__ __main__: main()运行命令python scripts/index_media.py --raw raw --output work/index.json4.3 索引结果的意义index.json表面上看只是素材清单但它把后续所有环节的“查找成本”降到了零。转写模块直接从index.json里读取第一个素材剪片时按关键词搜文本就能定位到具体文件和时间点。你可以用任意文本编辑器打开index.json检查确认素材信息读取正确。如果这一步输出为空多半是目录路径写错或ffprobe没有安装成功。这里有一个需要提醒的点ffprobe读取的时长是容器信息不一定和实际画面完全对齐。对于绝大多数剪辑场景误差可接受但如果要做精确到帧的剪辑后续还是建议在专业剪辑软件里确认。5. 语音转写与语义分段5.1 转写前的音频预处理语音转写是整个流水线的“理解”基础。为了让转写更稳定要先从视频里抽取音频统一转成单声道 16kHz 的 WAV 文件。这样做的原因有两个一是去掉视频容器格式对音频解码带来的不确定性二是 16kHz 采样率对语音识别来说足够同时能降低后续计算量。使用 FFmpeg 抽取音频ffmpeg -y -i raw/20240615/01.mp4 -ac 1 -ar 16000 work/01_16k.wav5.2 Whisper 转写脚本文件路径scripts/transcribe.pyimport argparse import json import shutil import subprocess from pathlib import Path def extract_audio(video: str, wav_path: str): cmd [ ffmpeg, -y, -i, video, -ac, 1, -ar, 16000, wav_path, ] subprocess.run(cmd, checkTrue, capture_outputTrue) def write_srt(segments, srt_path): lines [] for i, seg in enumerate(segments, start1): lines.append(str(i)) lines.append(f{format_ts(seg[start])} -- {format_ts(seg[end])}) lines.append(seg[text]) lines.append() with open(srt_path, w, encodingutf-8) as f: f.write(\n.join(lines)) def format_ts(seconds: float) - str: seconds max(0, seconds) ms int(round((seconds - int(seconds)) * 1000)) sec int(seconds) % 60 minute (int(seconds) // 60) % 60 hour int(seconds) // 3600 return f{hour:02d}:{minute:02d}:{sec:02d},{ms:03d} def main(): parser argparse.ArgumentParser(description语音转写) parser.add_argument(--video, requiredTrue, help视频文件) parser.add_argument(--model, defaultmedium, helpWhisper 模型大小) parser.add_argument(--output, defaultwork/transcript.json, help转写结果输出路径) args parser.parse_args() for cmd in (ffmpeg, ffprobe): if shutil.which(cmd) is None: raise RuntimeError(f未找到 {cmd}请先安装 FFmpeg) import whisper video_path Path(args.video) work_dir Path(args.output).parent work_dir.mkdir(parentsTrue, exist_okTrue) wav_path work_dir / f{video_path.stem}_16k.wav extract_audio(str(video_path), str(wav_path)) model whisper.load_model(args.model) result model.transcribe(str(wav_path), languagezh, verboseFalse) transcript { source: str(video_path), language: result.get(language, zh), duration: result.get(duration, 0), segments: [], } for seg in result.get(segments, []): transcript[segments].append({ start: round(seg[start], 2), end: round(seg[end], 2), text: seg[text].strip(), }) with open(args.output, w, encodingutf-8) as f: json.dump(transcript, f, ensure_asciiFalse, indent2) srt_path args.output.replace(.json, .srt) write_srt(transcript[segments], srt_path) print(f转写完成: {args.output}) print(f字幕文件: {srt_path}) if __name__ __main__: main()运行python scripts/transcribe.py --video raw/20240615/01.mp4 --model medium --output work/transcript.json转写完成后你应该能看到一份transcript.json里面每个segment都带有start、end、text。这相当于把视频里说的话全部变成了“可搜索的文字时间轴”。5.3 从转写文本到“剧本时间轴”转写出来的原始段落通常比较碎一句话可能被拆成好几段。所以要做一个合并操作如果相邻段落的时间间隔很小比如小于 0.8 秒就把它们合并成同一个语义片段。这样得到的段落会更接近一个人正常说完整一句话、一个意思的粒度。这个合并逻辑可以在生成粗剪片段时一起处理不需要单独写一个大脚本下一节的generate_cutlist.py就会包含这个逻辑。5.4 用大模型做语义分段与标题如果你希望 AI 不只是转写文字还能理解内容结构可以接入一个可选的“语义分段”步骤。把转写结果发给大模型让它按主题切分段落、给出每段的小标题、甚至提炼全文摘要。这一步对访谈类、口播类视频尤其有用因为它直接决定“先讲什么、后讲什么”。一个用于分段和标题生成的提示词模板你是一个视频剪辑助理。下面是一段带时间戳的访谈转写文本 {segments_text} 任务 1. 按内容主题把文本分成若干段落 2. 每个段落给出 8 字以内的小标题 3. 按段落顺序输出 JSON 数组格式为 [{title: 标题, start: 开始秒, end: 结束秒}] 要求 - 不要修改原文 - 不要输出任何解释 - 只输出 JSON。调用大模型时建议在后端做一次 JSON 结构校验。模型偶尔会输出多余的解释文字或格式漂移直接透传给下游脚本容易报错。校验可以通过json.loads加上字段检查完成。另外如果素材涉及隐私内容优先使用本地部署模型或提前对文本脱敏。6. 剪辑决策表与自动粗剪6.1 什么是剪辑决策表剪辑决策表简单说就是“哪些片段要保留按什么顺序拼接”。它是一份 JSON并不直接是成片而是一个可以被机器执行、也可以被人工修改的中间产物。你可以把它理解为AI 用文字看完素材之后给出的“粗剪建议”。一个典型的cutlist.json结构{ source: raw/20240615/01.mp4, target_seconds: 1800, cuts: [ {start: 12.4, end: 45.8, text: 开场介绍}, {start: 58.5, end: 132.3, text: 核心观点说明}, {start: 150.0, end: 260.7, text: 案例讲解} ] }在这份决策表里start和end是相对原素材的时间点text是这段内容对应的文本摘要。人工拿到这份 JSON可以
做内容创作的程序员大概都有同一种感受剪一条二十分钟上下的中长视频真正耗时间的往往不是“拖动时间线”本身而是反复听素材、找有效镜头、对字幕、导出不同平台比例。操作剪辑软件可能只占三分之一的时间剩下的时间都消耗在素材检索和重复劳动上。针对这个痛点我用 Python 和 FFmpeg 自研了一个偏“客户端”形态的本地 AI 剪辑流水线目标是把一条中长视频从整理素材到输出成片的时间压到一次完整流程 54 分钟左右。这篇文章不是来吹“AI 一键成片”的。我的核心判断是AI 剪辑的关键不在“自动生成画面”而在于把剪辑流水线里的重复环节全部自动化把人的时间留给判断。语音转写、字幕对位、静音裁剪、响度统一、多版本导出这些工作无比琐碎却占掉大量时间创作者的真正价值在于选择讲什么、不讲什么、先说什么、后说什么。这套 AI 剪辑客户端要解决的就是让前者尽可能少占用创作精力。读完这篇文章你可以带走四样东西一整条可落地的中长视频剪辑流水线设计可以改来直接用的核心 Python 脚本用 FFmpeg 实现自动粗剪、字幕压制、响度标准化的具体命令以及我在实践中踩过的问题和对应的排查方式。不管后续你是想做一个带界面的桌面客户端还是只要一套批处理脚本都可以按这个思路往下走。1. 为什么中长视频剪辑需要自研工具1.1 时间到底花在哪里先做一个简单的拆分。一条中长视频的制作通常包含这么几个环节素材管理、粗剪、精剪、字幕、音频处理、多版本导出。真正属于“创意判断”的其实只有粗剪和精剪中的选题、排布、节奏。剩下的事情都有一个共同特征高度重复、规则明确、对准确性要求极高但几乎没有创造性。以真实项目为例很多时候最耗时的不是“这段要不要”而是“这段话在第几条素材里出现过”。过去纯粹靠人肉拉时间线找一个素材可能要反复预览好几遍。语音转写出来之后一切就变了你可以直接搜索关键词可以直接看文字可以在文本层面“剪”一遍再回到画面去确认。这也是为什么我会把语音转写放在整个流水线的最前面而不是最后。另一个被严重低估的时间杀手是字幕对齐。视频里配音和字幕偏差零点几秒观看体验就会非常明显。如果完全手打时间轴二十分钟的片子可能要用掉一个下午。这部分是典型可以让机器做的事情。1.2 现有工具的三个短板如果用现成的剪辑软件比如 Pr、达芬奇、Final Cut Pro能不能解决上面这些问题能但不够。它们更强调“剪辑操作”本身而不是“剪辑前准备”和“导出交付”这两端的自动化。再看在线剪辑网站和通用 AI 短视频工具。它们解决的场景偏短素材时长很有限最多支持十分钟以内的视频对本地海量素材的批量处理能力弱上传下载大文件依赖网速对隐私也比较敏感。更重要的是很多在线 AI 工具只能输出“一次性成片”中间过程是黑盒没法在每个环节停下来检查、修改也没法把中间产物给专业剪辑软件继续精修。还有一类是各类脚本化剪辑工具。它们很灵活但通常只覆盖单点能力比如“批量加字幕”“自动剪静音”。单独用的时候都很好使但放在一条完整的生产链路里就会出现断层素材没有统一索引、步骤之间的数据格式不兼容、出了问题不知道在哪一步。1.3 客户端方案的优势所以我的选择是做一个本地 AI 剪辑客户端。它不追求取代 Pr 或达芬奇而是承担“剪辑前中后三段”的自动化工作剪辑前自动扫描素材、读取元数据、生成索引让“找素材”变成“查索引”。剪辑中通过语音转写生成带时间戳的剧本自动生成粗剪决策表把片段列表交给剪辑软件或 FFmpeg。剪辑后自动生成字幕、统一响度、导出版本把交付成本降到最低。这种“客户端”形态意味着所有素材默认留在本地不需要全部上传处理大文件只受机器性能约束不受带宽和平台限制并且每一步中间结果都落盘成 JSON可以随时中断、继续、复盘。对一个需要长期生产内容的团队来说这套东西的价值不在于“省掉剪辑师”而在于把剪辑师从重复劳动里解放出来。2. 整体架构与核心设计思路2.1 流水线不是“一键出片”很多人听到 AI 剪辑第一反应是“我丢一堆素材进去AI 直接给我一条成片”。这个预期很美好但至少在当前阶段它更适合当作科幻片看。中长视频的成片需要有主题、有结构、有观点表达全自动生成的结果往往缺乏稳定的信息逻辑。更靠谱的设计是把剪辑过程拆成一条流水线每个环节有明确的输入输出人在关键节点做判断。这套客户端的流水线可以概括为六个模块素材索引模块扫描素材目录读取媒体元数据。语音转写模块抽取音频生成带时间戳的转写文本。语义分段模块把连续转写文本切成分镜级别的段落甚至可以补上标题和摘要。剪辑决策模块根据分段结果、目标时长、静音分布生成粗剪片段列表。执行渲染模块调用 FFmpeg 完成片段抽取、拼接、字幕压制、响度处理。交付导出模块按目标平台比例导出或生成 EDL 给专业剪辑软件继续精修。2.2 数据流转与断点续跑这套流水线能够稳定的关键在于每个模块之间都用JSON文件做中间产物。每一步做完都会把结果写到work/目录。这样有几点好处任意一步失败可以回去修完再继续不用从头跑。人工可以打开 JSON 检查中间结果确认后再进入下一步。模块之间完全解耦以后把 Whisper 换成其他 ASR 服务或者把 FFmpeg 换成其他渲染器只影响单个模块。数据流转大致是这样raw/ 素材 → index.json 素材索引 → transcript.json 带时间戳的语音转写 → storyboard.json 分段后的剧本结构 → cutlist.json 粗剪片段列表 → workprint.mp4 工作样片 → final.mp4 最终成片每个文件都是下一个模块的输入。这种设计最大的好处是你可以在任何一步停下来用 Pr 或者达芬奇打开中间产物人工修改改完再让自动化流程继续走。2.3 为什么选“客户端”而不是纯 Web一句话因为素材在本地中间结果也需要长期保留。剪辑项目不像网页应用所有数据都要立刻保存而且很多素材动辄几十 GB重复上传不现实。客户端形态天然适合本地文件处理同时还能方便地接入本地模型。隐私上素材不离开本机敏感内容更可控。技术选型上客户端主体用 Python 编写底层调用 FFmpeg 和 Whisper。这套组合的好处是生态成熟、命令稳定并且每一步都能用脚本复现很适合被包装成命令行工具或桌面程序。如果你需要图形界面后续可以用 PySide6 或 WebView 包一层壳但核心流水线其实不需要界面也能跑。3. 环境准备与项目目录3.1 环境依赖在开始之前先把环境准备好。我推荐 Python 3.10 及以上版本FFmpeg 需要包含ffprobe命令语音识别使用 openai-whisper。版本建议以实际项目为准不必完全跟随某个固定版本但大版本尽量保持稳定。创建虚拟环境并安装依赖python3.10 -m venv .venv source .venv/bin/activate pip install --upgrade pip pip install openai-whisper tqdm检查 FFmpeg 是否可用ffmpeg -version ffprobe -version如果系统提示找不到命令需要先把 FFmpeg 安装并加入 PATH。不同操作系统安装方式不同这里不展开。3.2 项目目录结构建议所有项目文件按下面结构组织ai-editor-client/ ├── raw/ # 原始素材按日期分子目录 │ └── 20240615/ ├── assets/ # 音乐、图片、包装素材 ├── work/ # 中间产物JSON、WAV、字幕 ├── export/ # 最终导出文件 ├── scripts/ │ ├── index_media.py # 素材索引 │ ├── transcribe.py # 语音转写 │ ├── generate_cutlist.py # 剪辑决策表生成 │ └── pipeline.py # 总流水线 └── requirements.txt这样的好处是work/目录里的所有内容都可以随时删除重建raw/目录始终保存原始素材脚本出错不会碰到原始文件。依赖文件requirements.txt可以写成openai-whisper tqdm如果你后续要调用外部大模型做语义分段需要用到 OpenAI SDK 或者其他大模型 SDK再按需补充不用一上来就把所有依赖都装上。3.3 跑通一次的最小闭环实战中不建议一上来就追求完整功能。先跑通“索引 → 转写 → 粗剪 → 导出”这条最小闭环确认每个环节都能输出正确结构再逐步加入语义分段、多版本导出、EDL 等能力。下面几节就按这条闭环展开。4. 素材整理与元数据索引4.1 素材目录规范素材管理的痛点通常不是“文件太多”而是“没有规则”。如果素材文件名五花八门、目录层级混乱任何自动化工具都很难处理。所以第一步不是写代码而是先把素材目录规范下来。我的建议是raw/下按拍摄日期建子目录例如raw/20240615/同一场戏或同一期节目的多机位素材文件名加上场景前缀例如20240615A_01.mp4。这样既方便脚本扫描也方便人工按时间线检索。4.2 用 ffprobe 生成素材索引素材索引脚本做的事情很简单扫描raw/目录下的视频文件调用ffprobe读取每个文件的时长、分辨率、编码格式、修改时间然后输出到work/index.json。文件路径scripts/index_media.pyimport argparse import json import shutil import subprocess from pathlib import Path def probe_media(file_path: str) - dict: cmd [ ffprobe, -v, quiet, -print_format, json, -show_format, -show_streams, file_path, ] result subprocess.run(cmd, capture_outputTrue, textTrue, checkTrue) return json.loads(result.stdout) def scan(raw_dir: Path): videos [] for ext in (.mp4, .mov, .mkv, .mxf, .avi): videos.extend(raw_dir.rglob(f*{ext})) return sorted(videos) def main(): parser argparse.ArgumentParser(description素材索引) parser.add_argument(--raw, defaultraw, help原始素材目录) parser.add_argument(--output, defaultwork/index.json, help索引输出路径) args parser.parse_args() if shutil.which(ffprobe) is None: raise RuntimeError(未找到 ffprobe请先安装 FFmpeg并加入 PATH) raw_dir Path(args.raw) work_dir Path(args.output).parent work_dir.mkdir(parentsTrue, exist_okTrue) entries [] for video in scan(raw_dir): try: meta probe_media(str(video)) video_stream next( (s for s in meta.get(streams, []) if s.get(codec_type) video), {}, ) fmt meta.get(format, {}) entries.append({ path: str(video), duration: float(fmt.get(duration, 0)), width: video_stream.get(width), height: video_stream.get(height), codec: video_stream.get(codec_name), modified: video.stat().st_mtime, }) except Exception as exc: print(f[warn] 处理失败: {video} - {exc}) entries.sort(keylambda x: x[modified]) with open(args.output, w, encodingutf-8) as f: json.dump(entries, f, ensure_asciiFalse, indent2) print(f索引完成共 {len(entries)} 个文件输出到 {args.output}) if __name__ __main__: main()运行命令python scripts/index_media.py --raw raw --output work/index.json4.3 索引结果的意义index.json表面上看只是素材清单但它把后续所有环节的“查找成本”降到了零。转写模块直接从index.json里读取第一个素材剪片时按关键词搜文本就能定位到具体文件和时间点。你可以用任意文本编辑器打开index.json检查确认素材信息读取正确。如果这一步输出为空多半是目录路径写错或ffprobe没有安装成功。这里有一个需要提醒的点ffprobe读取的时长是容器信息不一定和实际画面完全对齐。对于绝大多数剪辑场景误差可接受但如果要做精确到帧的剪辑后续还是建议在专业剪辑软件里确认。5. 语音转写与语义分段5.1 转写前的音频预处理语音转写是整个流水线的“理解”基础。为了让转写更稳定要先从视频里抽取音频统一转成单声道 16kHz 的 WAV 文件。这样做的原因有两个一是去掉视频容器格式对音频解码带来的不确定性二是 16kHz 采样率对语音识别来说足够同时能降低后续计算量。使用 FFmpeg 抽取音频ffmpeg -y -i raw/20240615/01.mp4 -ac 1 -ar 16000 work/01_16k.wav5.2 Whisper 转写脚本文件路径scripts/transcribe.pyimport argparse import json import shutil import subprocess from pathlib import Path def extract_audio(video: str, wav_path: str): cmd [ ffmpeg, -y, -i, video, -ac, 1, -ar, 16000, wav_path, ] subprocess.run(cmd, checkTrue, capture_outputTrue) def write_srt(segments, srt_path): lines [] for i, seg in enumerate(segments, start1): lines.append(str(i)) lines.append(f{format_ts(seg[start])} -- {format_ts(seg[end])}) lines.append(seg[text]) lines.append() with open(srt_path, w, encodingutf-8) as f: f.write(\n.join(lines)) def format_ts(seconds: float) - str: seconds max(0, seconds) ms int(round((seconds - int(seconds)) * 1000)) sec int(seconds) % 60 minute (int(seconds) // 60) % 60 hour int(seconds) // 3600 return f{hour:02d}:{minute:02d}:{sec:02d},{ms:03d} def main(): parser argparse.ArgumentParser(description语音转写) parser.add_argument(--video, requiredTrue, help视频文件) parser.add_argument(--model, defaultmedium, helpWhisper 模型大小) parser.add_argument(--output, defaultwork/transcript.json, help转写结果输出路径) args parser.parse_args() for cmd in (ffmpeg, ffprobe): if shutil.which(cmd) is None: raise RuntimeError(f未找到 {cmd}请先安装 FFmpeg) import whisper video_path Path(args.video) work_dir Path(args.output).parent work_dir.mkdir(parentsTrue, exist_okTrue) wav_path work_dir / f{video_path.stem}_16k.wav extract_audio(str(video_path), str(wav_path)) model whisper.load_model(args.model) result model.transcribe(str(wav_path), languagezh, verboseFalse) transcript { source: str(video_path), language: result.get(language, zh), duration: result.get(duration, 0), segments: [], } for seg in result.get(segments, []): transcript[segments].append({ start: round(seg[start], 2), end: round(seg[end], 2), text: seg[text].strip(), }) with open(args.output, w, encodingutf-8) as f: json.dump(transcript, f, ensure_asciiFalse, indent2) srt_path args.output.replace(.json, .srt) write_srt(transcript[segments], srt_path) print(f转写完成: {args.output}) print(f字幕文件: {srt_path}) if __name__ __main__: main()运行python scripts/transcribe.py --video raw/20240615/01.mp4 --model medium --output work/transcript.json转写完成后你应该能看到一份transcript.json里面每个segment都带有start、end、text。这相当于把视频里说的话全部变成了“可搜索的文字时间轴”。5.3 从转写文本到“剧本时间轴”转写出来的原始段落通常比较碎一句话可能被拆成好几段。所以要做一个合并操作如果相邻段落的时间间隔很小比如小于 0.8 秒就把它们合并成同一个语义片段。这样得到的段落会更接近一个人正常说完整一句话、一个意思的粒度。这个合并逻辑可以在生成粗剪片段时一起处理不需要单独写一个大脚本下一节的generate_cutlist.py就会包含这个逻辑。5.4 用大模型做语义分段与标题如果你希望 AI 不只是转写文字还能理解内容结构可以接入一个可选的“语义分段”步骤。把转写结果发给大模型让它按主题切分段落、给出每段的小标题、甚至提炼全文摘要。这一步对访谈类、口播类视频尤其有用因为它直接决定“先讲什么、后讲什么”。一个用于分段和标题生成的提示词模板你是一个视频剪辑助理。下面是一段带时间戳的访谈转写文本 {segments_text} 任务 1. 按内容主题把文本分成若干段落 2. 每个段落给出 8 字以内的小标题 3. 按段落顺序输出 JSON 数组格式为 [{title: 标题, start: 开始秒, end: 结束秒}] 要求 - 不要修改原文 - 不要输出任何解释 - 只输出 JSON。调用大模型时建议在后端做一次 JSON 结构校验。模型偶尔会输出多余的解释文字或格式漂移直接透传给下游脚本容易报错。校验可以通过json.loads加上字段检查完成。另外如果素材涉及隐私内容优先使用本地部署模型或提前对文本脱敏。6. 剪辑决策表与自动粗剪6.1 什么是剪辑决策表剪辑决策表简单说就是“哪些片段要保留按什么顺序拼接”。它是一份 JSON并不直接是成片而是一个可以被机器执行、也可以被人工修改的中间产物。你可以把它理解为AI 用文字看完素材之后给出的“粗剪建议”。一个典型的cutlist.json结构{ source: raw/20240615/01.mp4, target_seconds: 1800, cuts: [ {start: 12.4, end: 45.8, text: 开场介绍}, {start: 58.5, end: 132.3, text: 核心观点说明}, {start: 150.0, end: 260.7, text: 案例讲解} ] }在这份决策表里start和end是相对原素材的时间点text是这段内容对应的文本摘要。人工拿到这份 JSON可以
