用途：TGravity Work 的视频素材索引与切片表执行入口，把视频文件、逐字稿整理成可复核的素材索引与切片草稿表，服务于活动归档、短视频切片、课程复盘、素材筛选、客户交付等目标。
主要能力：扫描视频文件并提取时长、分辨率、音频轨、拍摄时间；按文件名、元数据和逐字稿绝对时间做粗对齐；生成关键帧与 contact sheet；从现成逐字稿抽取候选话题、时间码与金句；输出 CSV/Excel 草稿表；做表格完整性与时间码验收。
使用方式：先定义项目目标并确认项目根目录，缺少根目录时禁止执行 init、run、frames、export、validate。检查环境：python3 scripts/video_pipeline.py check --json；初始化：python3 scripts/video_pipeline.py init --workspace "<项目根目录>"；跑草稿表：python3 scripts/video_pipeline.py run --workspace "<项目根目录>"；导出与验收：python3 scripts/video_pipeline.py export --workspace "<项目根目录>"、python3 scripts/video_pipeline.py validate --workspace "<项目根目录>"。默认跳过 ASR，需本机 Whisper 时先获用户确认再加 --with-transcribe。输出默认在项目根目录的“视频素材工作区/”，含 video_inventory.csv、transcript_utterances.csv、video_material_draft.csv、contact_sheets/、视频素材切片表.xlsx 等；无 pandas/openpyxl 时只导出 CSV。
适用场景：视频素材盘点、逐字稿对齐、候选切片与金句线索整理、表格验收。
限制：不承诺自动识别所有画面内容，画面判断优先 contact sheet 加人工或多模态复核；不承诺嘈杂多人场景 ASR 准确，低置信 ASR 只能找线索；涉及隐私或未公开商业信息先提醒敏感性；联网模型、云端上传或第三方转写须先说明并征得确认，默认本机处理；不登录平台后台拉取私域数据、不绕过平台限制下载受保护视频、不自动发布到平台、不替代最终剪辑与法务确认。主题、金句、可用性、切片建议均需标注置信度或待人工复核。