用途:该技能用于生产级音视频处理,适合格式转换(如 MOV 转 MP4、AVI 转 WebM)、按目标体积压缩、裁剪片段、提取音频、合并多个媒体文件、按比例缩放以及查看媒体信息。不适合复杂特效剪辑、直播、播放或逐帧分析。
主要能力:提供 convert、compress、trim、extract-audio、merge、resize、info 等命令。convert 支持 MP4、MOV、WebM、MKV、AVI、MP3、AAC、OGG、FLAC、WAV,并有 low/medium/high/lossless 质量档。compress 可按 --size 目标体积自动计算码率,预留 8% 容器开销,不可行时回退 CRF。trim 支持秒、分:秒、时:分:秒及毫秒精度。resize 支持 --width、--height、--scale。info 支持 --json 输出。
使用方式:需先安装 FFmpeg,如 macOS 用 brew install ffmpeg,Ubuntu/Debian 用 sudo apt update && sudo apt install ffmpeg,并用 ffmpeg -version、ffprobe -version 验证。命令形如 {baseDir}/ffmpeg.js convert input.mov --output output.mp4 --quality high。交互终端会显示进度、帧率、已用时间和 ETA。
限制:输入最大 10GB、时长最大 24 小时,需至少 100MB 磁盘空间,单次操作最长 2 小时;合并要求输入编码与分辨率一致;进度显示需 TTY;支持 macOS、Linux 及 WSL 下的 Windows。错误码涵盖无效输入、文件不存在、权限、磁盘满、格式不支持、FFmpeg 错误、超时、中断等。