用途:该技能面向音视频文件的处理与转换,适合在需要转换、裁剪、合并、压缩、转码、提取音频、抽帧、加字幕或水印时使用。若目标是理解视频内容(总结、描述、找场景)而非转换,应改用 parsing-video 技能。
主要能力:环境预装 ffmpeg 6.1.1 完整构建,并提供 ffprobe(媒体分析)与 ffplay(容器内播放受限)。支持格式转换(如 H.265、VP9 WebM、AV1、JPEG XL)、音频转换(MP3、Opus、AAC、FLAC、WAV)、从视频提取音频、裁剪与切割、拼接合并、缩放、帧率调整、生成 GIF/WebP、抽帧、字幕烧录与软字幕、文字与水印叠加、音量与响度处理、视频防抖、交叉淡化转场、波形与频谱图、压缩减小体积。可用编码器包括 libx264、libx265、libvpx-vp9、libsvtav1、libjxl、gif、libwebp 等,音频含 aac、libmp3lame、libopus、flac 等,共 426 种格式、562 个滤镜。
使用方式:先用 ffprobe 检查媒体信息,例如 ffprobe -v quiet -print_format json -show_format -show_streams input.mp4。转换示例:ffmpeg -i input.avi -c copy output.mp4(不重编码换容器)。裁剪示例:ffmpeg -i input.mp4 -ss 00:01:30 -to 00:03:00 -c copy clip.mp4。合并同编码文件可用 concat 解复用器,不同格式用 filter_complex。压缩示例:ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset faster -c:a aac -b:a 128k smaller.mp4。CRF 越低质量越高,preset 在编码速度与压缩效率间权衡。
适用场景:批量转码、网页视频交付、音频提取与格式统一、短视频剪辑、字幕嵌入、缩略图与抽帧、音频可视化等。
限制:无 GPU 加速,CUDA 设备数为 0,vaapi/vulkan/opencl 仅列出但无硬件可用,全部为 CPU 编码;容器为临时环境,任务间会重置,建议在 /home/claude/ 工作并输出到 /mnt/user-data/outputs/;4 核 CPU、9 GB 内存,大文件建议用 -preset faster 或 veryfast 避免超时;ffplay 无显示环境,仅用于探测;无 GPU 滤镜,需使用 CPU 滤镜。场景检测基于帧差,能捕捉硬切但会漏掉渐变转场,稳健镜头检测建议用 PySceneDetect。