本地视频关键帧与分镜整理器

对一个本地视频生成代表帧、联系表和可编辑分镜。只处理用户指定的视频文件，不上传视频，不下载平台视频。

前置条件

• 需要 FFmpeg 和 FFprobe。Windows 可将 ffmpeg.exe 所在目录加入 PATH，或用 --ffmpeg 指定完整路径。
• 先确认用户拥有处理该视频的权利；不要协助绕过平台下载限制或处理受限视频。

使用

python scripts/extract_storyboard.py "C:\\Videos\\demo.mp4" -o "C:\\Videos\\demo-storyboard"

默认每 10 秒抽取一帧，最多 24 帧。用以下参数调整：

python scripts/extract_storyboard.py "C:\\Videos\\demo.mp4" -o output --interval 5 --max-frames 18

若 FFmpeg 不在 PATH：

python scripts/extract_storyboard.py "C:\\Videos\\demo.mp4" -o output --ffmpeg "C:\\path\\to\\ffmpeg.exe"

产物

output/
├── frames/              # 按时间点命名的 JPEG 帧
├── contact-sheet.jpg    # 所有帧的总览图
└── storyboard.md        # 时间点、图片链接与可编辑镜头备注

先检查 contact-sheet.jpg，再在 storyboard.md 的“画面说明/用途”空位补充人工或 AI 的内容。不要把固定间隔抽帧误说成已识别全部镜头边界。

失败处理

• 找不到 FFmpeg：说明安装或路径配置方法，不要替用户下载视频软件。
• 无法读取视频：确认文件路径、文件是否损坏和是否被其他程序占用。
• 视频很长：增大 --interval 或减小 --max-frames；不要一次生成几百张图片。

资源

scripts/extract_storyboard.py 使用 Python 标准库调用 FFmpeg，不需要额外 Python 依赖。