环境要求
- - 必装:
ffmpeg 和 ffprobe(建议从 ffmpeg.org 或 via winget/choco 安装) - 可选:
nvidia-smi(NVIDIA 加速)、vainfo(Intel QSV)、amdgpu-info(AMD 加速)
首次使用前验证:ffmpeg -version 和 ffprobe -version。
执行建议
执行方式
FFmpeg 处理推荐使用 exec background:true 避免长时间阻塞会话。示例:
CODEBLOCK0
完成后通知(可选)
任务完成后推荐使用 message 工具通知用户:
CODEBLOCK1
注意:仅发送文件名即可,避免暴露完整路径。
文件路径处理
- - 输入/输出路径直接使用用户提供的位置,不做跨分区复制
- 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。使用时提及平台名称即可自动匹配。
参考文档
工作流程
- 1. 分析用户需求,匹配触发词到对应工作流
- 用
ffprobe 分析输入视频(格式、编码、分辨率、码率、时长) - 如有脚本可用(
scripts/),优先执行脚本;否则按详细工作流文档构建 ffmpeg 命令 - 执行转换,验证输出质量
- 批量任务参考 detailed_workflows.md 附录中的批量处理器
环境要求
- - 必装: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 工具通知用户:
✅ 视频处理完成
文件: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、socialmedia、archival、preview、weboptimized。使用时提及平台名称即可自动匹配。
参考文档
工作流程
- 1. 分析用户需求,匹配触发词到对应工作流
- 用 ffprobe 分析输入视频(格式、编码、分辨率、码率、时长)
- 如有脚本可用(scripts/),优先执行脚本;否则按详细工作流文档构建 ffmpeg 命令
- 执行转换,验证输出质量
- 批量任务参考 detailed_workflows.md 附录中的批量处理器