Skip to content

ZJU-REAL/Easel / skills/builtin/batch-process

batch-process

Unverified

批量处理:对一个目录里的一批图片/视频/音频统一套用同一操作——批量压缩、加水印、转格式、缩放、转比例、音量归一化等。当用户说 批量处理、批量压缩、批量加水印、批量转格式、一批图片/视频、给这个文件夹、全部转成、批量缩放、批量转竖版、整个目录 时使用。基于 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

规则

  1. 先 list 预览文件范围,确认无误再 run。
  2. -- 之后的参数原样透传给 ops 脚本;不确定参数先跑单文件版(image-editing 等)验证一次。
  3. 改输出格式用 --ext(如 .mp3/.png),否则沿用原扩展名。
  4. 批处理串行执行(避免高负载);量大时耐心等,失败文件会单独列出不中断整体。
  5. 默认输出到 <目录>/batch_out/,不覆盖原文件。

参考来源

复用项目既有确定性脚本(image_ops/video_ops/audio_ops),本 SKILL 只做目录遍历 + 逐文件 委派 + 结果汇总,不重复实现处理逻辑。

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 318kUpdated Claude CodeCodexUnverifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 318kUpdated Claude CodeCodexUnverifiedInstall