ffmpeg-master-pro

## 环境要求

- **必装**：`ffmpeg` 和 `ffprobe`（建议从 [ffmpeg.org](https://ffmpeg.org) 或 via winget/choco 安装）
- **可选**：`nvidia-smi`（NVIDIA 加速）、`vainfo`（Intel QSV）、`amdgpu-info`（AMD 加速）

首次使用前验证：`ffmpeg -version` 和 `ffprobe -version`。

## 执行建议

### 执行方式

FFmpeg 处理推荐使用 `exec background:true` 避免长时间阻塞会话。示例：

```bash
exec background:true command:"ffmpeg -i input.mp4 -c:v libx264 -crf 23 output.mp4"
```

### 完成后通知（可选）

任务完成后推荐使用 `message` 工具通知用户：

```
✅ 视频处理完成
文件：output.mp4 | 操作：转码压缩
```

> 注意：仅发送文件名即可，避免暴露完整路径。

### 文件路径处理

- 输入/输出路径直接使用用户提供的位置，不做跨分区复制
- Windows 路径（如 `C:\Users\...`）和 Unix 路径（如 `/mnt/c/...`）均支持
- 临时文件处理：如有需要可使用系统临时目录，任务结束后清理

## 核心工作流

所有工作流的完整命令、参数说明和代码示例见 [详细工作流](references/detailed_workflows.md)。

### 转码与优化

| # | 工作流 | 触发词 | 详细文档 |
|---|--------|--------|----------|
| 1 | 智能转码与压缩 | 压缩、转码、格式转换、减小文件 | [→](references/detailed_workflows.md#工作流1智能转码与压缩) |
| 2 | 智能参数优化 | 自动识别6种视频类型并优化编码 | [→](references/detailed_workflows.md#工作流2智能参数优化) |
| 3 | 预设模板系统 | YouTube/B站/微信/抖音等平台预设 | [→](references/detailed_workflows.md#工作流3预设模板系统) |
| 4 | 精确文件大小控制 | 指定目标大小，两遍编码偏差<5% | [→](references/detailed_workflows.md#工作流4精确文件大小控制) |

### 剪辑与分析

| # | 工作流 | 触发词 | 详细文档 |
|---|--------|--------|----------|
| 5 | Smart Cut 混合剪辑 | 剪辑、裁剪、cut | [→](references/smart_cut_guide.md) |
| 6 | 关键帧分析 | 关键帧、最佳剪辑点 | [→](references/keyframe_analysis.md) |

### 编辑与特效

| # | 工作流 | 触发词 | 详细文档 |
|---|--------|--------|----------|
| 7 | 字幕处理 | 提取/嵌入/烧录字幕 | [→](references/detailed_workflows.md#工作流7字幕处理) |
| 8 | 滤镜与特效 | 水印、旋转、翻转 | [→](references/detailed_workflows.md#工作流8滤镜与特效) |
| 9 | GIF 转换 | GIF、动图 | [→](references/detailed_workflows.md#工作流9gif转换) |
| 10 | 翻转与镜像 | 镜像、左右/上下翻转 | [→](references/detailed_workflows.md#工作流10翻转与镜像) |

### 变换与合并

| # | 工作流 | 触发词 | 详细文档 |
|---|--------|--------|----------|
| 11 | 速度调节 | 加速、慢动作、倍速 | [→](references/detailed_workflows.md#工作流11速度调节) |
| 12 | 音频提取与移除 | 提取音频、去音频、静音 | [→](references/detailed_workflows.md#工作流12音频提取与移除) |
| 13 | 视频合并 | 合并、拼接、concat | [→](references/detailed_workflows.md#工作流13视频合并) |
| 14 | 宽高比调整 | 16:9、9:16、竖屏、横屏 | [→](references/detailed_workflows.md#工作流14宽高比调整) |

## 智能决策系统

技能会自动执行以下决策，无需手动干预：

- **内容类型识别**：自动检测电影/动漫/屏幕录制/体育/音乐视频/老旧视频，选择最优编码参数。详见 [优化指南](references/optimization_guide.md)
- **GPU 加速**：自动检测 NVIDIA NVENC / AMD AMF / Intel QSV 并优先使用
- **质量验证**：自动校验输出文件的分辨率、时长、码率，可选 VMAF/SSIM/PSNR 评估

## 预设模板

内置 8+ 平台预设（`assets/presets/`）：youtube、bilibili、wechat、douyin、social\_media、archival、preview、web\_optimized。使用时提及平台名称即可自动匹配。

## 参考文档

- **详细工作流**：[detailed_workflows.md](references/detailed_workflows.md) — 所有14个工作流的完整命令和代码
- **Smart Cut 指南**：[smart_cut_guide.md](references/smart_cut_guide.md)
- **关键帧分析**：[keyframe_analysis.md](references/keyframe_analysis.md)
- **优化算法**：[optimization_guide.md](references/optimization_guide.md)
- **最佳实践**：[best_practices.md](references/best_practices.md)
- **API 参考**：[api_reference.md](references/api_reference.md)
- **快速入门**：[quickstart.md](references/quickstart.md)
- **故障排除**：[troubleshooting.md](references/troubleshooting.md)

## 工作流程

1. 分析用户需求，匹配触发词到对应工作流
2. 用 `ffprobe` 分析输入视频（格式、编码、分辨率、码率、时长）
3. 如有脚本可用（`scripts/`），优先执行脚本；否则按详细工作流文档构建 ffmpeg 命令
4. 执行转换，验证输出质量
5. 批量任务参考 detailed_workflows.md 附录中的批量处理器