用途：这是 Buttercut 中“分析素材（Analyze Video）”工作流步骤的主线程操作手册，属于内部子流程而非独立入口。应在库设置完成后、任何剪辑工作之前运行，为每个片段产出三样东西：音频转录、联系表（contact_sheet）和 Markdown 摘要。粗剪智能体需要台词时，通过 script_extractor.rb 读取转录 JSON，不生成单独的剧本产物。
主要能力：转录（transcripts）与联系表（contact sheets）分两步机械执行，转录先行，不能同时跑，因为 WhisperX 占用内存大；两步都是幂等的，只处理仍缺该产物的片段，可重跑补完。转录的英文用户可见称呼为“footage analysis”。转录后可选用模型对误听专有名词做修订（仅当 transcript_refinement 为 true）。摘要用 Sonnet 子智能体分批滚动生成，每批 10 个片段，最多 10 个并行。静态图片跳过转录和联系表，直接由主线程或 Sonnet 子智能体读图写 3–4 句描述。
用法：转录运行 ruby lib/buttercut/process_footage.rb transcripts <library-name>；联系表运行 ruby lib/buttercut/process_footage.rb contact-sheets <library-name>。可用 --jobs N 覆盖并行数（默认取自 settings.yaml 的 parallel_jobs）。重做某片段用 --force --clips NAME.mov，仅加 --force 会重建全部。开始前可用 AskUserQuestion 询问是否保持唤醒：macOS 用 caffeinate -i -w $$ &；Windows（Git Bash）用 powershell -NoProfile -ExecutionPolicy Bypass -File scripts/keep_awake.ps1 &；完成后用 kill $KEEPAWAKE_PID 2>/dev/null 结束。
适用场景：在库设置完成后、剪辑工作之前，作为 process-library 调用链中的分析步骤；之后供粗剪规划继承上下文。
限制：转录与联系表必须串行，不能同时运行；摘要完成前不应进入下一步；子智能体从不写 library.yaml，只有父线程通过 Library API 写入；转录修订仅在 transcript_refinement 为 true 时执行；若在分析完成前请求粗剪，需先向用户发出警告确认。本资料未提供收费、价格、平台支持范围等更多信息。