| name | ffmpeg-master-pro |
| description | FFmpeg Master Pro - 全能视频处理技能。当用户需要视频处理时使用，支持视频转换、视频压缩、视频编辑等。当用户要求视频处理, 视频转换, 视频压缩, FFmpeg, 视频编辑, 视频转码, 视频剪辑, 字幕处理, 视频优化, 批量视频处理, GIF转换, 视频翻转, 速度调节, 音频提取, 视频合并, 宽高比, 水印, 截图, 抽帧时使用此技能。 |
环境要求
- 必装：
ffmpeg 和 ffprobe（建议从 ffmpeg.org 或 via winget/choco 安装）
- 可选：
nvidia-smi（NVIDIA 加速）、vainfo（Intel QSV）、amdgpu-info（AMD 加速）
首次使用前验证：ffmpeg -version 和 ffprobe -version。
执行建议
执行方式
FFmpeg 处理推荐使用 exec background:true 避免长时间阻塞会话。示例：
exec background:true command:"ffmpeg -i input.mp4 -c:v libx264 -crf 23 output.mp4"
完成后通知（可选）
任务完成后推荐使用 message 工具通知用户：
✅ 视频处理完成
文件：output.mp4 | 操作：转码压缩
注意：仅发送文件名即可，避免暴露完整路径。
文件路径处理
- 输入/输出路径直接使用用户提供的位置，不做跨分区复制
- Windows 路径（如
C:\Users\...）和 Unix 路径（如 /mnt/c/...）均支持
- 临时文件处理：如有需要可使用系统临时目录，任务结束后清理
核心工作流
所有工作流的完整命令、参数说明和代码示例见 详细工作流。
转码与优化
| # | 工作流 | 触发词 | 详细文档 |
|---|
| 1 | 智能转码与压缩 | 压缩、转码、格式转换、减小文件 | → |
| 2 | 智能参数优化 | 自动识别6种视频类型并优化编码 | → |
| 3 | 预设模板系统 | YouTube/B站/微信/抖音等平台预设 | → |
| 4 | 精确文件大小控制 | 指定目标大小，两遍编码偏差<5% | → |
剪辑与分析
| # | 工作流 | 触发词 | 详细文档 |
|---|
| 5 | Smart Cut 混合剪辑 | 剪辑、裁剪、cut | → |
| 6 | 关键帧分析 | 关键帧、最佳剪辑点 | → |
编辑与特效
| # | 工作流 | 触发词 | 详细文档 |
|---|
| 7 | 字幕处理 | 提取/嵌入/烧录字幕 | → |
| 8 | 滤镜与特效 | 水印、旋转、翻转 | → |
| 9 | GIF 转换 | GIF、动图 | → |
| 10 | 翻转与镜像 | 镜像、左右/上下翻转 | → |
变换与合并
| # | 工作流 | 触发词 | 详细文档 |
|---|
| 11 | 速度调节 | 加速、慢动作、倍速 | → |
| 12 | 音频提取与移除 | 提取音频、去音频、静音 | → |
| 13 | 视频合并 | 合并、拼接、concat | → |
| 14 | 宽高比调整 | 16:9、9:16、竖屏、横屏 | → |
智能决策系统
技能会自动执行以下决策，无需手动干预：
- 内容类型识别：自动检测电影/动漫/屏幕录制/体育/音乐视频/老旧视频，选择最优编码参数。详见 优化指南
- GPU 加速：自动检测 NVIDIA NVENC / AMD AMF / Intel QSV 并优先使用
- 质量验证：自动校验输出文件的分辨率、时长、码率，可选 VMAF/SSIM/PSNR 评估
预设模板
内置 8+ 平台预设（assets/presets/）：youtube、bilibili、wechat、douyin、social_media、archival、preview、web_optimized。使用时提及平台名称即可自动匹配。
参考文档
工作流程
- 分析用户需求，匹配触发词到对应工作流
- 用
ffprobe 分析输入视频（格式、编码、分辨率、码率、时长）
- 如有脚本可用（
scripts/），优先执行脚本；否则按详细工作流文档构建 ffmpeg 命令
- 执行转换，验证输出质量
- 批量任务参考 detailed_workflows.md 附录中的批量处理器
