media-processor

Media Processor

任务目标

• 本 Skill 用于：处理视频和图像文件，进行格式转换、分辨率调整、压缩等操作
• 能力包含：
• 视频格式转换（MP4/AVI/MOV/MKV 等）
• 视频分辨率调整和压缩
• 图像格式转换（JPG/PNG/GIF/WebP 等）
• 图像分辨率调整和压缩
• 批量处理支持
• 触发条件：当用户需要处理视频或图像文件时触发

前置准备

• 依赖说明：本 Skill 依赖以下系统工具
• FFmpeg：视频处理工具
• ImageMagick：图像处理工具
• 系统依赖安装：Skill 首次使用时将自动安装系统依赖

  apt-get update && apt-get install -y ffmpeg imagemagick

操作步骤

标准流程

1. 需求分析

• 识别输入文件类型（视频/图像）
• 确定目标格式、分辨率、质量要求
• 评估是否需要批量处理

1. 选择处理方式

• 视频处理：调用 scripts/ 中的视频处理脚本
• 图像处理：调用 scripts/ 中的图像处理脚本

1. 执行处理

• 对于简单操作（如单一格式转换）：直接调用相应脚本
• 对于复杂操作（如多步骤处理）：智能体将调用多个脚本组合使用

1. 结果验证

• 检查输出文件是否生成
• 验证文件格式和参数是否符合预期

常见操作指南

视频格式转换

• 调用 scripts/video_convert.py
• 参数：input_path（输入路径）、output_path（输出路径）、output_format（目标格式）
• 示例：将 AVI 转换为 MP4

视频压缩

• 调用 scripts/video_compress.py
• 参数：input_path、output_path、bitrate（目标码率）、crf（质量控制系数）
• 示例：压缩视频到 2Mbps

视频分辨率调整

• 调用 scripts/video_scale.py
• 参数：input_path、output_path、width、height
• 示例：调整到 1920x1080

图像格式转换

• 调用 scripts/image_convert.py
• 参数：input_path、output_path、output_format、quality
• 示例：将 PNG 转换为 JPG

图像缩放

• 调用 scripts/image_scale.py
• 参数：input_path、output_path、width、height、maintain_aspect
• 示例：等比缩放到 1024x768

图像压缩

• 调用 scripts/image_compress.py
• 参数：input_path、output_path、quality、method（压缩方法）
• 示例：质量设置为 85%

批量处理

• 当需要处理多个文件时，智能体将循环调用相应脚本
• 使用通配符模式匹配文件（如 .avi、images/.png）
• 为每个文件生成对应的输出路径

资源索引

• 视频处理脚本：
• [scripts/video_convert.py](scripts/video_convert.py) - 视频格式转换
• [scripts/video_compress.py](scripts/video_compress.py) - 视频压缩
• [scripts/video_scale.py](scripts/video_scale.py) - 视频分辨率调整
• 图像处理脚本：
• [scripts/image_convert.py](scripts/image_convert.py) - 图像格式转换
• [scripts/image_scale.py](scripts/image_scale.py) - 图像缩放
• [scripts/image_compress.py](scripts/image_compress.py) - 图像压缩
• 参考文档：
• [references/ffmpeg_guide.md](references/ffmpeg_guide.md) - FFmpeg 参数参考（需要高级参数时读取）
• [references/imagemagick_guide.md](references/imagemagick_guide.md) - ImageMagick 参数参考（需要高级参数时读取）

注意事项

• 确保输入文件路径正确，使用相对路径（./ 开头）
• 输出路径需要包含完整文件名和扩展名
• 质量参数范围：图像质量 1-100，视频 CRF 18-28（数值越小质量越高）
• 处理大文件时请耐心等待，智能体会持续监控执行状态
• 如果需要自定义参数（如编码器、帧率等），请参考相应参考文档

使用示例

示例1：视频格式转换

# 将 video.avi 转换为 video.mp4
python scripts/video_convert.py \
  --input ./video.avi \
  --output ./video.mp4 \
  --format mp4

示例2：图像批量转换

# 将所有 PNG 转换为 JPG
for file in ./images/*.png; do
  output="${file%.png}.jpg"
  python scripts/image_convert.py \
    --input "$file" \
    --output "$output" \
    --format jpg \
    --quality 85
done

示例3：视频压缩与缩放

# 先缩放再压缩
python scripts/video_scale.py \
  --input ./input.mp4 \
  --output ./temp.mp4 \
  --width 1280 \
  --height 720

python scripts/video_compress.py \
  --input ./temp.mp4 \
  --output ./output.mp4 \
  --bitrate 2M