---

name: video-edit-script-engine description: > 自动化剪辑脚本专家决策引擎 v2.0。提供剪辑自动化路由(moviepy/ffmpeg/剪映)、 批量处理完整方案(水印/字幕/转码/拼接)、音频处理(降噪/音量标准化/背景音乐)、 效果自动化(转场/调色/变速)、质量门控三级清单(P0/P1/P2)、10个常见错误模式、 完整SOP流程。当用户需要视频剪辑自动化、批量视频处理、ffmpeg脚本、moviepy脚本时使用此技能。 metadata: author: woodfantasy version: "2.0"

自动化剪辑脚本专家 v2.0

专业的视频剪辑自动化决策引擎，根据用户需求智能推荐最优工具链和脚本方案。

---

一、剪辑自动化路由决策树

1.1 工具选择决策矩阵

| 任务类型 | 推荐工具 | 处理速度 | 质量 | 学习曲线 | 适用场景 | |---------|---------|---------|------|---------|---------| | 简单转码 | FFmpeg | ⚡⚡⚡⚡⚡ | ★★★★ | ★ | 格式转换、压缩、裁剪 | | 水印字幕 | FFmpeg | ⚡⚡⚡⚡ | ★★★★ | ★★ | 批量添加logo、字幕 | | 多轨合成 | FFmpeg Filter | ⚡⚡⚡ | ★★★★ | ★★ | 多视频拼接、画中画 | | 特效动画 | MoviePy | ⚡⚡ | ★★★★ | ★★★ | 动态字幕、特效转场 | | 模板剪辑 | 剪映 | ⚡⚡⚡⚡⚡ | ★★★ | ★ | 批量模板化、AI功能 | | 专业影视 | Premiere | ⚡⚡ | ★★★★★ | ★★★★★ | 复杂剪辑、调色 |

1.2 工具选择决策流程

1.3 工具特性对比表

| 特性 | FFmpeg | MoviePy | 剪映 | Premiere | |------|--------|---------|------|----------| | 性能 | 最快 | 较慢 | 快 | 中等 | | Python集成 | ⚠️ 需subprocess | ✅ 原生支持 | ❌ | ❌ | | 特效能力 | 基础 | 丰富 | AI特效 | 专业完整 | | 批量处理 | ✅ 循环处理 | ⚠️ 需循环 | ✅ 批处理 | ⚠️ 脚本 | | 学习成本 | 低 | 中 | 低 | 高 | | 跨平台 | ✅ | ✅ | ❌ | ✅ | | 自动化程度 | 高 | 高 | 中 | 低 | | 输出格式 | 全部 | 有限 | 抖音格式 | 专业格式 |

---

二、批量处理完整方案

2.1 批量处理框架SOP

2.2 批量处理完整代码框架

2.3 水印批量添加脚本

---

三、音频处理方案

3.1 FFmpeg音频处理命令库

3.2 音频处理Python脚本

---

四、常用FFmpeg命令速查

4.1 基础操作命令

4.2 编码与质量命令

4.3 水印与字幕命令

4.4 音频处理命令

4.5 高级操作命令

---

五、效果自动化方案

5.1 转场效果脚本

5.2 调色自动化

5.3 变速处理

---

六、质量门控三级清单

6.1 P0级门控（上线阻塞级）

| 检查项 | 检查标准 | 检测方法 | 阻断条件 | |--------|---------|---------|---------| | 输出文件存在 | 文件已生成 | os.path.exists() | 无文件=阻断 | | 文件大小合理 | >1KB | os.path.getsize() | 过小=阻断 | | 视频时长正确 | 时长>0 | ffprobe duration | 时长异常=阻断 | | 编码成功 | returncode==0 | subprocess | 失败=阻断 | | 视频流存在 | has video | ffprobe streams | 无视频=阻断 | | 音频流存在 | has audio | ffprobe streams | 无音频(如有要求)=阻断 | | 无致命错误 | stderr无Error | 日志检查 | Error=阻断 |

6.2 P1级门控（质量保证级）

| 检查项 | 检查标准 | 检测方法 | 处理方式 | |--------|---------|---------|---------| | 分辨率正确 | 符合目标尺寸 | ffprobe streams | 警告 | | 码率合理 | 在预期范围 | ffprobe bitrate | 警告 | | 音视频同步 | 相差<1秒 | 音频视频时长差 | 警告 | | 无编码警告 | stderr无warning | 日志检查 | 警告 | | 视频完整性 | 可正常播放 | ffprobe检查 | 警告 | | 音频清晰度 | 无爆音 | loudnorm峰值 | 警告 | | 字幕正确 | 时间轴准确 | 检查VTT/SRT | 警告 | | 水印位置 | 在设定位置 | 截图检查 | 警告 |

6.3 P2级门控（优化建议级）

| 检查项 | 检查标准 | 优化建议 | |--------|---------|---------| | 文件体积优化 | 压缩比合理 | 调整CRF | | 画面质量 | 无明显块效应 | 调整preset | | 编码速度 | 处理速度满意 | 调整preset | | 文件格式 | 符合目标格式 | 调整codec | | 元数据 | metadata完整 | 添加metadata |

6.4 质量检查实现

---

七、常见错误模式详解

错误1: 编码不兼容问题

| 错误信息 | 原因 | 解决方案 | |---------|------|---------| | Invalid NAL unit size | H.264/H.265编码参数不兼容 | 添加 -bsf:v h264_mp4toannexb 或 -tag:v avc1 | | Unsupported codec with豆腐 | 缺少编解码器 | 安装 libx264、libmp3lame | | Non-monotonous DTS | 帧顺序问题 | 添加 -vsync cfr | | B frames not supported | B帧不兼容 | 添加 -flags -cgop | | Encoder (codec xxx) not found | 编码器未安装 | 安装对应编解码器 |

解决代码:

错误2: 音画不同步

| 症状 | 原因 | 解决方案 | |------|------|---------| | 播放时音画完全错位 | 时间戳错误 | 重新封装 ffmpeg -i input -c copy | | 播放快进快退 | 关键帧间隔过大 | 设置 -g 30 -keyint_min 30 | | 音画逐步漂移 | 音视频时长不一致 | 使用 -itsoffset 调整 | | 音画突然跳变 | PTS/DTS问题 | 添加 -async 1 -vsync cfr |

解决代码:

错误3: 内存溢出 (OOM)

| 错误信息 | 原因 | 解决方案 | |---------|------|---------| | Killed signal terminated | 大文件内存不足 | 分段处理 + 降低缓存 | | Cannot allocate memory | 并行任务过多 | 减少 max_workers | | malloc error | 临时文件过大 | 设置 -threads 1 |

解决代码:

错误4: 水印位置问题

| 问题 | 原因 | 解决方案 | |------|------|---------| | 水印位置偏移 | 视频尺寸变化 | 使用相对位置 | | 水印被裁剪 | 位置超出画面 | 调整margin | | 水印不显示 | 坐标计算错误 | 使用固定像素测试 |

解决代码:

错误5: 字幕乱码

| 问题 | 原因 | 解决方案 | |------|------|---------| | 字幕显示为方块 | 字体不支持 | 添加字体路径 | | 字幕乱码 | 编码不匹配 | 指定编码 utf-8 | | 字幕位置错误 | 分辨率不匹配 | 调整坐标 |

解决代码:

错误6: 批量处理卡死

| 问题 | 原因 | 解决方案 | |------|------|---------| | 任务无响应 | 单个任务超时 | 设置 timeout | | 并发过高 | 资源耗尽 | 减少 max_workers | | 内存泄漏 | 缓存未释放 | 定期清理 |

解决代码:

错误7: 输出文件损坏

| 问题 | 原因 | 解决方案 | |------|------|---------| | 文件不完整 | 覆盖冲突 | 使用 -y 前确认 | | 文件损坏 | 中断写入 | 原子写入 | | 权限错误 | 目录不可写 | 检查权限 |

解决代码:

错误8: 权限错误

| 问题 | 原因 | 解决方案 | |------|------|---------| | Permission denied | 目录不可写 | chmod 755 | | Read-only | 文件系统只读 | 检查挂载 | | 所有者错误 | 操作无权限 | sudo 或修改权限 |

解决代码:

错误9: 进度追踪丢失

| 问题 | 原因 | 解决方案 | |------|------|---------| | 进度丢失 | 意外中断 | 状态持久化 | | 重复处理 | 未标记完成 | 断点续传 | | 统计不准 | 并发计数冲突 | 线程安全 |

解决代码:

错误10: 资源清理失败

| 问题 | 原因 | 解决方案 | |------|------|---------| | 临时文件残留 | 程序异常退出 | 使用context manager | | 端口占用 | 进程未关闭 | 信号处理 | | 内存泄漏 | 资源未释放 | finally清理 |

解决代码:

---

八、快速参考速查表

8.1 常见场景命令速查

| 场景 | 推荐命令 | |------|---------| | 批量转MP4 | for f in *.avi; do ffmpeg -i "$f" "${f%.avi}.mp4"; done | | 添加水印 | ffmpeg -i input.mp4 -i logo.png -filter_complex "overlay=10:10" output.mp4 | | 提取音频 | ffmpeg -i video.mp4 -vn -acodec libmp3lame audio.mp3 | | 压缩大小 | ffmpeg -i input.mp4 -c:v libx265 -crf 28 -c:a copy output.mp4 | | 添加字幕 | ffmpeg -i input.mp4 -vf "ass=subtitle.ass" output.mp4 | | 剪切片段 | ffmpeg -i input.mp4 -ss 0 -t 60 -c copy output.mp4 | | 合并视频 | ffmpeg -f concat -safe 0 -i list.txt -c copy output.mp4 | | 音量标准化 | ffmpeg -i input.mp4 -af "loudnorm=I=-16:TP=-1.5:LRA=11" -c:v copy output.mp4 |

8.2 参数说明

| 参数 | 说明 | 常用值 | |------|------|--------| | -crf | 质量因子（越小越清晰） | 18-28 | | -preset | 编码速度 | ultrafast, fast, medium, slow | | -b:v | 视频码率 | 2000k, 5000k | | -c:v | 视频编码器 | libx264, libx265, copy | | -c:a | 音频编码器 | libmp3lame, aac, copy | | -vf | 视频滤镜 | scale, overlay, eq | | -af | 音频滤镜 | volume, amix, loudnorm |

---

版本: 2.0
更新内容: 完整批量处理框架、断点续传支持、错误恢复机制、质量门控检查、10个错误模式详解