FFmpeg CLI

核心用法

FFmpeg CLI 提供 8 个即用脚本覆盖视频处理全流程：

• cut.sh：精准截取时段，支持 HH:MM:SS 格式时间戳
• merge.sh：多文件拼接，自动统一编码参数
• extract-audio.sh：无损/有损提取音轨，默认 MP3 输出
• thumb.sh：指定时间点截图，适用于封面生成
• gif.sh：片段转 GIF，自动优化调色板与帧率
• convert.sh：跨格式转码（avi/mkv/mov/webm 等互转）
• speed.sh：变速播放（0.5x-2.0x），保持音调或重采样可选
• watermark.sh：图片水印叠加，支持位置与透明度调整

显著优点

1. 格式兼容性极强：支持 100+ 编解码器与容器格式
2. 硬件加速支持：可选 NVENC/VideoToolbox/VA-API 加速编码
3. 脚本封装友好：参数简洁，-h 自文档化，降低 CLI 门槛
4. 无损与有损双模式：满足归档级品质或网络传播压缩需求

潜在局限

• 依赖本地 FFmpeg 二进制，首次需 brew install ffmpeg（约 100MB+）
• 复杂滤镜链（如多轨道混流、动态字幕）仍需手写原始 FFmpeg 命令
• 无内置预览，需配合播放器验证输出效果

适合人群

视频创作者、开发者、运维人员、教育内容制作者——任何需要将原始素材快速转换为交付格式的场景。

常规风险

• 文件覆盖：输出路径若存在同名文件直接覆盖，无二次确认
• 编码耗时：4K/H.265 软编码可能占用大量 CPU/内存资源
• 版权内容：工具本身中立，用户需确保输入素材合法授权

核心用法

ffmpeg-cli 是一套基于 FFmpeg 的本地媒体处理工具集，通过8个精心封装的 Bash 脚本提供视频音频处理的核心能力：

视频处理：cut.sh 精准剪辑片段、merge.sh 多文件无缝合并、convert.sh 格式转码、speed.sh 变速处理（0.5x-2.0x）、watermark.sh 图片水印叠加

音频处理：extract-audio.sh 提取音轨为 MP3

图像生成：thumb.sh 指定时间点截图、gif.sh 视频片段转 GIF

所有脚本均采用 set -e 错误终止模式，支持 -h 帮助提示，输出质量经过平衡优化。

显著优点

• 功能聚焦纯粹：8个脚本覆盖媒体处理80%常见场景，无冗余功能
• 纯本地执行：零网络请求，数据绝不外泄，适合敏感内容处理
• 代码质量优良：使用 mktemp 管理临时文件并自动清理，错误处理规范
• 依赖透明可控：仅依赖系统 ffmpeg 二进制，无隐藏依赖链
• 学习成本极低：命令行参数设计直观，示例即学即用

潜在局限

• 输入验证薄弱：文件路径参数直接透传给 ffmpeg，未做路径遍历防护（如 ../../../etc/passwd 虽会被 ffmpeg 拒绝，但无显式拦截）
• 隐藏依赖未声明：speed.sh 使用 bc 计算器但未在 metadata 中标注
• 无版本兼容性检查：未验证 ffmpeg 版本是否支持特定滤镜
• 输出覆盖无确认：默认直接覆盖同名文件，存在误操作风险

适合人群

• 需要批量处理视频的开发者和内容创作者
• 对数据隐私敏感、拒绝云服务的用户
• 熟悉命令行、追求自动化脚本集成的技术用户
• macOS/Linux 用户（通过 Homebrew 一键安装）

常规风险

• 路径注入风险：恶意构造的输入路径可能导致意外文件访问（低风险，ffmpeg 本身有防护）
• 资源消耗：视频转码可能占用大量 CPU/内存，大文件处理需注意系统负载
• ffmpeg 二进制安全：Skill 本身安全，但需确保系统 ffmpeg 来源可信（建议官方仓库或 Homebrew）
• 格式兼容性：部分老旧或专有格式可能需额外编码器支持