--- 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个错误模式详解