Ffmpeg Master Pro

环境要求#

• 必装： ffmpeg 和 ffprobe（建议从 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 工具通知用户：

text

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

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

文件路径处理#

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

核心工作流#

所有工作流的完整命令、参数说明和代码示例见 详细工作流。

转码与优化#

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

剪辑与分析#

#工作流触发词详细文档5Smart Cut 混合剪辑剪辑、裁剪、cut→6关键帧分析关键帧、最佳剪辑点→

编辑与特效#

#工作流触发词详细文档7字幕处理提取/嵌入/烧录字幕→8滤镜与特效水印、旋转、翻转→9GIF 转换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。使用时提及平台名称即可自动匹配。

参考文档#

• 详细工作流： 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

工作流程#

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