Agent Skills
› ZJU-REAL/Easel
› batch-process
batch-process
GitHub用于对目录内的图片、视频或音频文件执行批量统一操作，如压缩、加水印、转格式等。通过遍历目录并委派给专用脚本处理，支持预览和结果汇总，区别于单文件编辑技能。
Trigger Scenarios
批量处理
批量压缩
批量加水印
批量转格式
一批图片/视频
给这个文件夹
全部转成
批量缩放
批量转竖版
整个目录
Install
npx skills add ZJU-REAL/Easel --skill batch-process -g -y
SKILL.md
Frontmatter
{
"name": "batch-process",
"layer": "general",
"description": "批量处理：对一个目录里的一批图片\/视频\/音频统一套用同一操作——批量压缩、加水印、转格式、缩放、转比例、音量归一化等。当用户说 批量处理、批量压缩、批量加水印、批量转格式、一批图片\/视频、给这个文件夹、全部转成、批量缩放、批量转竖版、整个目录 时使用。基于 shared\/scripts\/batch_process.py（委派 image_ops\/video_ops\/audio_ops）。与 image-editing\/video-editing\/audio-editing 区别：那些处理单文件，本 SKILL 批量套用到整个目录。"
}
批量处理（目录级）
对整个目录的图片/视频/音频统一套用同一操作。走
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）。
# 先预览会处理哪些文件
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
规则
- 先
list预览文件范围，确认无误再run。 --之后的参数原样透传给 ops 脚本；不确定参数先跑单文件版（image-editing 等）验证一次。- 改输出格式用
--ext（如.mp3/.png），否则沿用原扩展名。 - 批处理串行执行（避免高负载）；量大时耐心等，失败文件会单独列出不中断整体。
- 默认输出到
<目录>/batch_out/，不覆盖原文件。
参考来源
复用项目既有确定性脚本（image_ops/video_ops/audio_ops），本 SKILL 只做目录遍历 + 逐文件 委派 + 结果汇总，不重复实现处理逻辑。
Version History
- 69c5928 Current 2026-09-08 17:36
