batch-process

# 批量处理（目录级） > 对整个目录的图片/视频/音频统一套用同一操作。走 `skills/shared/scripts/batch_process.py`， > 逐个委派给对应确定性脚本（image_ops / video_ops / audio_ops）。 > 单文件处理见 image-editing / video-editing / audio-editing；本 SKILL 是它们的**目录批量版**。 ## 输入 | 字段 | 必填 | 说明 | |------|------|------| | 目录 | 是 | 待处理文件所在目录 | | 类型 | 是 | `image` / `video` / `audio`（决定用哪个 ops 脚本 + 文件筛选） | | 操作 | 是 | ops 子命令（如 resize/compress/watermark/aspect/convert/normalize） | | 操作参数 | 视操作 | 写在 `--` 之后，原样透传给 ops 脚本 | ## 输出（默认 `<目录>/batch_out/`） - 处理后的同名文件；报告成功/失败数。 ## 执行 脚本路径（相对项目根）：`skills/shared/scripts/batch_process.py`（`run -h` / `list -h`）。 ```bash # 先预览会处理哪些文件 python skills/shared/scripts/batch_process.py list --dir imgs --type image # 批量压缩图片到 500KB python skills/shared/scripts/batch_process.py run --dir imgs --type image --op compress \ --out-dir out -- --max-kb 500 # 批量加水印 python skills/shared/scripts/batch_process.py run --dir imgs --type image --op watermark \ -- --text "@我的账号" --position bottom-right # 批量视频转竖版 9:16 python skills/shared/scripts/batch_process.py run --dir clips --type video --op aspect \ --out-dir out -- --ratio 9:16 --mode pad # 批量音频转 mp3（改扩展名用 --ext） python skills/shared/scripts/batch_process.py run --dir raw --type audio --op convert \ --out-dir out --ext .mp3 -- --bitrate 192k ``` ## 可用操作（透传给 ops 脚本，`<脚本> <op> -h` 看参数） - **image**（image_ops）：resize / crop / pad / convert / compress / watermark / round / thumbnail - **video**（video_ops）：compress / aspect / watermark / speed / gif / frame - **audio**（audio_ops）：convert / normalize / denoise / fade / speed / trim ## 规则 1. 先 `list` 预览文件范围，确认无误再 `run`。 2. `--` 之后的参数原样透传给 ops 脚本；不确定参数先跑单文件版（image-editing 等）验证一次。 3. 改输出格式用 `--ext`（如 `.mp3`/`.png`），否则沿用原扩展名。 4. 批处理串行执行（避免高负载）；量大时耐心等，失败文件会单独列出不中断整体。 5. 默认输出到 `<目录>/batch_out/`，不覆盖原文件。 ## 参考来源 复用项目既有确定性脚本（image_ops/video_ops/audio_ops），本 SKILL 只做目录遍历 + 逐文件 委派 + 结果汇总，不重复实现处理逻辑。