media-processor

# Media Processor

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

## 前置准备
- 依赖说明：本 Skill 依赖以下系统工具
  - FFmpeg：视频处理工具
  - ImageMagick：图像处理工具
- 系统依赖安装：Skill 首次使用时将自动安装系统依赖
  ```bash
  apt-get update && apt-get install -y ffmpeg imagemagick
  ```

## 操作步骤

### 标准流程

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

2. **选择处理方式**
   - 视频处理：调用 `scripts/` 中的视频处理脚本
   - 图像处理：调用 `scripts/` 中的图像处理脚本

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

4. **结果验证**
   - 检查输出文件是否生成
   - 验证文件格式和参数是否符合预期

### 常见操作指南

#### 视频格式转换
- 调用 `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：视频格式转换
```python
# 将 video.avi 转换为 video.mp4
python scripts/video_convert.py \
  --input ./video.avi \
  --output ./video.mp4 \
  --format mp4
```

### 示例2：图像批量转换
```python
# 将所有 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
# 先缩放再压缩
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
```