用途：TGW Video Indexer 是视频素材索引与切片表执行入口，面向活动归档、短视频切片、课程复盘、素材筛选、客户交付等场景，生成可复核的素材索引而非最终剪辑决策。
主要能力：扫描视频文件，提取时长、分辨率、音频轨、拍摄时间；按文件名、元数据和逐字稿绝对时间做粗对齐；生成关键帧与 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。
输出：项目根目录下生成 视频素材工作区/，含 tgw-video-project.json、video_inventory.csv、transcript_utterances.csv、transcript_chapters.csv、aligned_transcript_segments.csv、video_material_draft.csv、visual-review-notes.csv、contact_sheets/、thumbs_raw/、视频素材切片表.xlsx。无 pandas/openpyxl 时只导出 CSV，不强行安装依赖。
限制：画面可用性、版权/肖像/隐私风险、金句是否符合品牌、嘈杂多人场景转写准确性、是否允许公开发布均需人工复核；不登录平台后台拉取私域数据，不绕过平台限制下载受保护视频，不把未授权素材上传第三方云端，不自动发布到小红书、抖音、视频号，不替代最终剪辑、法务与客户确认。默认本机处理，联网或云端上传需先说明并征得确认。