# 视频关键帧提取工具使用指南

## 概述

视频关键帧提取工具是一个专业的视频处理工具，基于 FFmpeg 提供高质量的帧提取功能。支持提取视频的第一帧、最后帧、自定义时间点或多个时间点的帧，并提供多种输出格式和批量处理能力。

## 主要功能

### 🎯 核心功能
- **多种提取模式**：第一帧、最后帧、自定义时间点、多时间点批量提取
- **多格式支持**：JPEG、PNG、WebP、BMP 等主流图片格式
- **批量处理**：支持单文件或整个文件夹的批量处理
- **实时预览**：提供帧预览功能，精确选择提取时间点
- **自定义配置**：灵活的输出尺寸、质量和文件命名设置

### 📁 支持的视频格式
- MP4、AVI、MOV、MKV、WMV、FLV、WebM
- M4V、3GP、TS、MTS 等常见视频格式

## 快速开始

### 1. 打开工具
在主界面点击"便捷小工具" → 找到"视频关键帧提取工具"并点击进入。

### 2. 选择视频文件
有两种方式选择视频文件：
- **选择文件**：点击"选择文件"按钮，选择一个或多个视频文件
- **选择文件夹**：点击"选择文件夹"按钮，选择包含视频文件的文件夹

### 3. 配置提取参数
在配置面板中设置：
- **提取类型**：选择第一帧、最后帧、自定义时间或多时间点
- **输出格式**：选择 JPEG、PNG、WebP 或 BMP
- **图片质量**：调整输出图片的质量（1-100）
- **输出目录**：设置保存提取帧的目录

### 4. 开始提取
点击"开始提取"按钮，工具将自动处理所有选中的视频文件。

## 详细功能说明

### 提取类型

#### 第一帧
提取视频的第一帧，通常用于生成视频缩略图。

#### 最后帧
提取视频的最后一帧，适用于需要展示视频结尾内容的场景。

#### 自定义时间
指定具体的时间点（秒）提取帧，支持小数点精度。

#### 多个时间点
支持同时提取多个时间点的帧，时间点格式支持：
- **秒数**：`10, 30, 60`（提取第10秒、30秒、60秒的帧）
- **百分比**：`25%, 50%, 75%`（提取视频25%、50%、75%位置的帧）
- **帧数**：`300f, 900f, 1800f`（提取第300、900、1800帧）

### 输出格式设置

#### JPEG
- 适用于大多数场景
- 文件体积小
- 支持质量调节（1-100）
- 不支持透明度

#### PNG
- 支持透明度
- 无损压缩
- 文件体积较大
- 适用于需要透明背景的场景

#### WebP
- 现代图片格式
- 压缩效率高
- 支持透明度
- 文件体积小

#### BMP
- 无压缩格式
- 文件体积最大
- 兼容性最好

### 输出尺寸配置

#### 自动尺寸
保持视频原始分辨率。

#### 自定义尺寸
- **宽度**：设置输出图片宽度（像素）
- **高度**：设置输出图片高度（像素）
- **保持宽高比**：勾选后会自动调整尺寸以保持原始宽高比

### 文件命名模式

支持使用变量自定义文件名：
- `{name}`：视频文件名（不含扩展名）
- `{frame_type}`：帧类型（first、last、custom、frame）
- `{timestamp}`：时间戳（格式：秒.毫秒）
- `{index}`：索引号（多帧提取时使用，格式：001、002...）

**示例**：
- `{name}_{frame_type}` → `video_first.jpg`
- `{name}_{timestamp}` → `video_15.50.jpg`
- `{name}_{frame_type}_{index}` → `video_frame_001.jpg`

## 预设配置

工具提供了几个常用的预设配置：

### 第一帧高质量
- 提取类型：第一帧
- 格式：JPEG
- 质量：95
- 适用于生成高质量缩略图

### 最后一帧PNG
- 提取类型：最后一帧
- 格式：PNG
- 适用于需要透明度支持的场景

### 中间帧WebP
- 提取类型：自定义时间（50%位置）
- 格式：WebP
- 质量：80
- 适用于现代Web应用

## 批量处理

### 文件夹处理
1. 点击"选择文件夹"
2. 选择包含视频文件的文件夹
3. 工具会自动扫描并列出所有支持的视频文件
4. 配置提取参数
5. 点击"开始提取"进行批量处理

### 进度监控
批量处理时可以查看：
- 总体进度百分比
- 当前处理的文件
- 处理速度
- 成功/失败统计
- 预计剩余时间

## 结果管理

### 查看结果
提取完成后，在"结果"标签页可以：
- 查看所有提取结果
- 筛选成功/失败的结果
- 搜索特定文件
- 预览提取的帧

### 结果操作
对于每个提取结果，可以：
- **预览**：在应用内查看提取的帧
- **下载**：保存到指定位置
- **打开位置**：在文件管理器中打开文件所在目录

## 故障排除

### 常见问题

#### FFmpeg 不可用
**现象**：工具显示"FFmpeg 不可用"
**解决方案**：
1. 工具会自动下载 FFmpeg，请等待下载完成
2. 检查网络连接是否正常
3. 重启应用重试

#### 视频文件无法识别
**现象**：视频文件显示为"无效"
**可能原因**：
- 视频文件损坏
- 不支持的视频格式
- 文件权限问题

#### 提取失败
**现象**：提取过程中出现错误
**解决方案**：
1. 检查输出目录是否有写入权限
2. 确保磁盘空间充足
3. 检查视频文件是否完整

### 性能优化建议

1. **批量处理**：一次处理多个文件比逐个处理更高效
2. **输出格式**：JPEG 格式处理速度最快
3. **输出尺寸**：较小的输出尺寸处理速度更快
4. **磁盘空间**：确保输出目录有足够的磁盘空间

## 技术规格

- **基于技术**：FFmpeg + ffmpeg-sidecar
- **支持平台**：Windows、macOS、Linux
- **最大文件大小**：无限制（取决于系统内存）
- **并发处理**：支持多文件并行处理
- **输出精度**：支持毫秒级时间精度

## 更新日志

### v1.0.0 (2025-08-11)
- 初始版本发布
- 支持基本的帧提取功能
- 提供多种输出格式
- 实现批量处理能力
- 添加实时预览功能