技能介绍

要解决什么问题

剪辑前你往往只有一条成片或粗剪素材：镜头边界在哪、哪一帧适合做 Hook、慢转场是否被当成硬切，靠肉眼拖时间轴很慢。混剪还要把镜头和 BGM 节拍对齐，若只有一堆无时间码的截图，回到 NLE 里几乎无法复现切点。

核心能力与工作方式

本技能以 ffmpeg/ffprobe 为底座，主脚本 shot_extract.py 提供 probe / scene / interval / keyframe / timestamps / range 等模式：

scene：检测画面切换，为每个镜头导出代表帧，并生成带 精确 PTS 时间码 的 manifest、分镜 CSV；可选 ffmpeg 或 PySceneDetect 后端，后者能给出镜头起止时码，更适合淡入淡出；--min-dur、--min-len 可合并字幕闪烁等假切点。
interval / keyframe / timestamps / range：按固定间隔、I 帧、指定时间点或时间段抽帧，用于粗拉片或精修某段。
导出与时间线：scene 模式可输出 EDL、FCP XML、OTTO JSON；cut_timeline 从 manifest 生成混剪用 JSON（含 hook/static 候选）；contact_sheet.py 可生成带时间码的故事板。
混剪对接：--tag-file 注入 anime-mashup 八类标签；shot_to_timeline.py 在镜头列表上叠加 BGM 节拍与 beat_delta，便于踩点决策。

适用边界与注意点

未安装 PySceneDetect 时 scenedetect 后端会自动回退 ffmpeg 并提示，不影响基本扒镜。ffmpeg 的 luma 指标对慢转场可能漏切，此时应换 scenedetect 或调阈值。keyframe 最快但不等于镜头切换点；技能只读源视频，帧图写入 --out 目录。中文或含空格路径需加引号；长任务支持进度条与 Ctrl+C 优雅中断，已生成帧会保留。