前言¶

做電商圖、社媒素材或文檔配圖時，摳圖、統一尺寸、加水印往往要反覆打開桌面軟件或在線服務。在線工具要上傳原圖，批量處理還要排隊；純 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