核心用法
YM MediaToolkit 是一款基于 FFmpeg 的流式视频处理工具集，提供命令行与 HTTP 服务两种调用方式。核心功能包括：
视频压缩：支持通过 target_ratio 设定目标体积比例（默认10%），adaptive 模式自动尝试不同 CRF 值优化压缩效果，也可手动指定 crf、preset 等参数精细控制。
封面提取：专为 MP4/MOV 容器设计，支持 H.264/H.265 视频轨道，可按时间点（time_seconds）或帧号（frame_number）提取，支持自定义输出尺寸与 JPEG 质量。
音频处理：支持 MP3/WAV/AAC/M4A 四种格式转换，可设置比特率、采样率、声道数，支持时间裁剪（start_time + duration）。
批量处理：audio_batch 与 batch 动作支持多视频批量处理，通过 JSON 配置统一参数。
信息查询：info 与 audio_info 可获取视频元数据。
显著优点
- 双模式架构：既可直接命令行调用，也可通过 HTTP 服务集成到现有系统
- 流式处理：支持远程 URL 直接处理，无需预下载完整文件
- 智能压缩：自适应 CRF 调整避免手动试错
- 参数完备：覆盖编码预设、质量、尺寸等常用 FFmpeg 参数
- 批量友好：JSON 驱动的批量任务适合自动化流水线
潜在局限
- 格式限制：封面提取仅支持 MP4/MOV 容器，其他格式可能异常
- 网络依赖：远程 URL 处理依赖网络稳定性，大文件可能超时
- 无内置队列：HTTP 模式为同步处理，高并发场景需外部负载均衡
- 安全沙箱：本地路径限制在当前工作目录，但
overwrite默认为 true 存在误覆盖风险
适合人群
- 需要轻量级视频处理后端的内容创作者工具开发者
- 已有 Python 环境、希望快速集成 FFmpeg 能力的工程团队
- 需要批量处理远程视频资源的自动化运维场景
常规风险
| 风险项 | 说明 |
|--------|------|
| 路径遍历 | 已限制为当前工作目录，但需确保启动目录正确 |
| 资源耗尽 | 视频处理 CPU/内存密集型，无并发限制可能拖垮服务 |
| 网络请求 | 远程 URL 可能指向恶意内容，建议前置 URL 白名单 |
| 依赖缺失 | 系统必须预装 FFmpeg/FFprobe，否则功能完全不可用 |