前言¶

做电商图、社媒素材或文档配图时，抠图、统一尺寸、加水印往往要反复打开桌面软件或在线服务。在线工具要上传原图，批量处理还要排队；纯 Pillow 脚本能裁剪和水印，抠图和换背景又得另找方案。下面介绍 SkillHub 上的 image-studio图片处理（坐标 @user_3b76b7e2/image-studio-pro）：在 Agent 里用自然语言或斜杠命令触发，由本地 Python CLI image_studio.py 完成批量处理，依赖装好后无需 API Key，也不依赖外网推理。

这是什么¶

image-studio图片处理 是社区发布（community）、分类为 design-media 的 Agent Skill，版本 1.0.0，发布者为 user_3b76b7e2。SkillHub 页面简介为：批量抠图、换背景、水印添加、尺寸裁剪；标签 requires_api_key=false。

Skill 本体是通用 SKILL.md 加同目录下的 image_studio.py。处理在本机执行，基于 rembg（抠图/换背景）与 Pillow（水印、缩放裁剪等）；依赖安装完成后，常规操作不需要联网，也不向第三方传图。

核心功能¶

以下能力与 Skill 文档及 CLI 实现一致，可按单张或整目录批量执行。

1. 抠图（remove-bg / 别名 抠图）
   使用 rembg（默认模型 u2net）。未安装 rembg 时会回退到 OpenCV GrabCut，精度较低。

2. 换背景（replace-bg）
   先抠主体，再合成到背景图（-b）或纯色（--bg-color，十六进制）。-b 与 --bg-color 互斥。

3. 水印（watermark）
   文字（-t）或图片（--image）水印，可设位置、透明度、字号/颜色或缩放；支持平铺（tile）。文字与图片水印互斥。

4. 尺寸裁剪（resize）
   模式：resize（拉伸）、cover、contain（可设 --bg-color 留边）、crop；可指定输出 --format 为 png 或 jpg。

5. 信息（info）
   查看尺寸、色彩模式、文件大小等元数据。

支持格式（输入扫描扩展名）：PNG、JPG、JPEG、WEBP、BMP、TIFF（及 .tif）。默认输出多保留透明通道时倾向 PNG。

安装与启用¶

安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可按 SkillHub 官方说明执行完整安装或仅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。官方页面给出的安装提示为：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3b76b7e2/image-studio-pro`。

命令行等价示例（将 <skills 目录> 换成你的环境路径）：

skillhub install @user_3b76b7e2/image-studio-pro --dir <skills 目录>

常见 skills 目录（摘自 SkillHub 安装文档，以你实际使用的客户端为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后，CLI 脚本位于该目录下类似
<skills 目录>/@user_3b76b7e2/image-studio-pro/image_studio.py
（Skill 文档中示例路径为 ~/.agents/skills/image-studio/image_studio.py，请以你 --dir 安装后的实际路径为准。）

安装 Python 依赖¶

首次使用建议执行 Skill 自带的安装子命令，或手动安装 rembg（抠图/换背景需要）：

python <skills 目录>/@user_3b76b7e2/image-studio-pro/image_studio.py install

或：

pip install rembg

watermark、resize、info 仅需 Pillow（脚本启动时会检查 Pillow）。remove-bg / replace-bg 在无 rembg 时会尝试 GrabCut 回退，仍可能需要 opencv-python。

在 Agent 中启用¶

用户可通过 /image-studio 或触发词（如抠图、换背景、水印、裁剪等）唤起 Skill。Agent 按任务拼装并执行 python .../image_studio.py <子命令> ...，再汇报处理张数与输出目录。

典型用法¶

下面命令将 <CLI> 替换为你的 image_studio.py 绝对路径。

依赖检查与元数据：

python <CLI> install
python <CLI> info -i photo.jpg

单张抠图：

python <CLI> remove-bg -i input.jpg -o ./output

目录批量抠图：

python <CLI> remove-bg -i ./images/ -o ./output_nobg

换背景（图片或纯色）：

python <CLI> replace-bg -i portrait.jpg -b beach_background.jpg -o ./output

python <CLI> replace-bg -i product.jpg --bg-color "#3498db" -o ./output

文字水印：

python <CLI> watermark -i photo.jpg -t "© 2024 Your Name" \
  -p bottom-right --opacity 0.6 --font-size 48 --font-color "#ffffff" -o ./output

缩放到 1920×1080（cover，适合做横幅）：

python <CLI> resize -i photo.jpg -w 1920 -h 1080 --mode cover -o ./output

流水线示例（先抠图 → 换背景 → 统一尺寸 → 水印）：

DIR=./batch
python <CLI> remove-bg -i $DIR/photos -o $DIR/step1_nobg
python <CLI> replace-bg -i $DIR/step1_nobg -b bg.jpg -o $DIR/step2_newbg
python <CLI> resize -i $DIR/step2_newbg -w 1920 -h 1080 --mode cover -o $DIR/step3_resize
python <CLI> watermark -i $DIR/step3_resize -t "© 2024" -p bottom-right -o $DIR/final

适用场景与注意¶

适合谁

• 需要在对话里快速批量处理素材、又不想把原图上传到云端的开发者或运营。
• 已有 Cursor、Claude Code、Codex 等支持 Skills 的环境，愿意用本地 CLI 做 repeatable 流水线。

限制与注意

• rembg 首次运行可能下载模型，与「装依赖后日常离线」并不矛盾，部署环境需预留磁盘与一次联网。
• 输入目录下无支持扩展名时会退出并提示 No supported image files found.；不支持的格式会被跳过。
• 抠图质量依赖 rembg 模型；无 rembg 时 GrabCut 仅作兜底。
• SkillHub 统计（以抓取资料为准）：评分 100000，下载 2207；安装数在页面上为 0，仅作商店参考，不代表本地不可用。

结尾¶

image-studio图片处理 把抠图、换背景、水印和尺寸裁剪收敛到同一套本地 CLI，由 Agent 根据 SKILL.md 拼命令、跑批处理，适合对隐私和批量效率有要求的图像预处理环节。

• SkillHub 页面：https://www.skillhub.cn/skills/user_3b76b7e2/image-studio-pro
• API 条目：https://api.skillhub.cn/user_3b76b7e2/image-studio-pro
• 安装说明：https://skillhub.cn/install/skillhub.md