视频帧提取器

概述

本技能指导 LLM 智能体使用 FFmpeg 从视频文件中提取帧。它提供完整的帧提取工作流，涵盖环境搭建、参数配置及命令执行等环节。

主用方法：FFmpeg（快速且可靠）
备用方法：OpenCV（当 FFmpeg 不可用时）

工作流

步骤 1：验证 FFmpeg 安装状态

开始提取帧前，请先检查 FFmpeg 是否已安装：

ffmpeg -version

若未安装 FFmpeg，请参阅下方的 FFmpeg 安装 章节。

步骤 2：确定提取参数

提取帧前，LLM 必须与用户确认以下参数：

参数计算指南：

• 每 X 秒提取 1 帧 → frame_rate = 1/X
• 示例：每 4 秒提取 1 帧 → frame_rate = 0.25
• 示例：每 10 秒提取 1 帧 → frame_rate = 0.1
• 示例：每秒提取 1 帧 → frame_rate = 1

步骤 3：执行 FFmpeg 命令

生成并执行 FFmpeg 命令：

基础命令（不缩放）：

ffmpeg -hide_banner -loglevel error -i "{video_path}" -vf "fps={frame_rate}" -fps_mode vfr -q:v 2 -f image2 "{output_path}/%06d.jpg"

带短边缩放（推荐用于分析任务）：

ffmpeg -hide_banner -loglevel error -thread_queue_size 512 -i "{video_path}" -vf "fps={frame_rate},scale='if(gt(iw,ih),-2,{scale}):if(gt(iw,ih),{scale},-2)':flags=lanczos" -fps_mode vfr -q:v 2 -f image2 -atomic_writing 1 "{output_path}/%06d.jpg"

参数说明：

步骤 4：验证输出结果

完成提取后，请验证输出内容：

• 统计帧数量：ls {output_path}/*.jpg | wc -l
• 查看前 5 帧尺寸：ls -lh {output_path}/*.jpg | head -5

FFmpeg 安装

Windows

选项 1：winget（推荐）

winget install ffmpeg

选项 2：Chocolatey

choco install ffmpeg

选项 3：手动下载

1. 从 https://www.gyan.dev/ffmpeg/builds/ 下载
2. 解压至永久路径（例如：C:\tools\ffmpeg）
3. 添加到系统 PATH：setx PATH "$PATH;C:\tools\ffmpeg\bin"
4. 重启终端

验证安装：

ffmpeg -version

Linux（Ubuntu / Debian）

sudo apt update
sudo apt install ffmpeg

验证安装：

ffmpeg -version

Linux（CentOS / RHEL / Fedora）

sudo dnf install ffmpeg

macOS

brew install ffmpeg

常见使用场景

每 4 秒提取 1 帧，并缩放至短边 640 像素

frame_rate = 0.25
scale = 640

每 10 秒提取 1 帧，保持原始尺寸

frame_rate = 0.1
scale = 0（不缩放）

对一段 10 分钟的视频（600 秒）每秒提取 1 帧（共 600 帧）

frame_rate = 1
video_duration = 600 seconds
expected_frames = 600

输出目录结构

帧以顺序编号方式保存：

output_path/
├── 000001.jpg
├── 000002.jpg
├── 000003.jpg
└── ...

顺序命名格式（%06d）确保帧按时间顺序排列，不受原始视频帧编号影响。

错误处理

注意事项

• FFmpeg 在帧提取方面比 OpenCV 快得多（快 10–100 倍）
• 缩放滤镜中使用 -2 而非 -1，以确保输出尺寸可被 2 整除（提升编码器兼容性）
• -fps_mode vfr（可变帧率）在定位过程中会跳过重复帧
• -q:v 2 可生成高质量 JPEG（取值范围为 1–31，默认值为 31）