# Batch Process

> 批量处理：对一个目录里的一批图片/视频/音频统一套用同一操作——批量压缩、加水印、转格式、缩放、转比例、音量归一化等。当用户说 批量处理、批量压缩、批量加水印、批量转格式、一批图片/视频、给这个文件夹、全部转成、批量缩放、批量转竖版、整个目录 时使用。基于 shared/scripts/batch_process.py（委派 image_ops/video_ops/audio_ops）。与 image-editing/video-editing/audio-editing 区别：那些处理单文件，本 SKILL 批量套用到整个目录。

- **Type:** Skill
- **Install:** `agentstack add skill-zju-real-easel-batch-process`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ZJU-REAL](https://agentstack.voostack.com/s/zju-real)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [ZJU-REAL](https://github.com/ZJU-REAL)
- **Source:** https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/batch-process
- **Website:** https://zju-real.github.io/Easel/

## Install

```sh
agentstack add skill-zju-real-easel-batch-process
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 批量处理（目录级）

> 对整个目录的图片/视频/音频统一套用同一操作。走 `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 脚本，`  -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 只做目录遍历 + 逐文件
委派 + 结果汇总，不重复实现处理逻辑。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ZJU-REAL](https://github.com/ZJU-REAL)
- **Source:** [ZJU-REAL/Easel](https://github.com/ZJU-REAL/Easel)
- **License:** Apache-2.0
- **Homepage:** https://zju-real.github.io/Easel/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zju-real-easel-batch-process
- Seller: https://agentstack.voostack.com/s/zju-real
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.