- 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% | → |
剪辑与分析
编辑与特效
变换与合并
智能决策系统
技能会自动执行以下决策，无需手动干预：
- 内容类型识别：自动检测电影/动漫/屏幕录制/体育/音乐视频/老旧视频，选择最优编码参数。详见 优化指南
- 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 — 所有14个工作流的完整命令和代码
- Smart Cut 指南：smart_cut_guide.md
- 关键帧分析：keyframe_analysis.md
- 优化算法：optimization_guide.md
- 最佳实践：best_practices.md
- API 参考：api_reference.md
- 快速入门：quickstart.md
- 故障排除：troubleshooting.md
工作流程
- 分析用户需求，匹配触发词到对应工作流
- 用
ffprobe分析输入视频（格式、编码、分辨率、码率、时长） - 如有脚本可用（
scripts/），优先执行脚本；否则按详细工作流文档构建 ffmpeg 命令 - 执行转换，验证输出质量
- 批量任务参考 detailed_workflows.md 附录中的批量处理器