name: image-batch-processor description: 圖片批次處理工具箱。當用戶需要批次處理圖片時使用：格式互轉（PNG/JPG/HEIC/LIVP/CR2/ARW/NEF/WebP/TIFF/SVG/PDF 等）、新增文字或圖片水印、壓縮體積、OCR 提取文字、水平/垂直拼接長圖、按行列拆分、灰度調整、按畫素或百分比縮放、旋轉、水平/垂直翻轉、模糊轉高畫質/超分放大、圖片背景去除。適用於"把圖片轉成xxx格式""加個水印""壓縮一下圖片""提取這張圖裡的文字""拼成長圖""把大圖分成九宮格""讓模糊圖片變清晰""摳圖去背景"等請求。 agent_created: true

Image Batch Processor（圖片批次處理工具箱）

Overview

一個面向批次圖片處理的單檔案 CLI 技能，覆蓋截圖工具類網站常見的十二類操作：格式互轉、水印、壓縮、OCR 文字提取、長圖拼接、網格拆分、灰度、縮放、旋轉、翻轉、模糊轉高畫質/超分放大、圖片背景去除。所有操作均支援批次（目錄 / 萬用字元），失敗時跳過並彙總，不中斷整體任務。

核心指令碼：scripts/image_batch_processor.py（基於 Pillow，可選依賴按需啟用）。

When to use

觸發詞與場景示例：

• 格式轉換：「把 PNG 轉成 JPG」「HEIC 轉 JPG」「LIVP/CR2/ARW/NEF 轉 JPG」「其它格式互轉」「匯出成 WebP/PDF/TIFF」
• 水印：「給這些圖加個文字水印」「批次打 logo 水印」
• 壓縮：「壓縮圖片節省空間，又不要糊」「批次壓到 70 質量」
• OCR：「提取圖片上的文字」「批次識別截圖裡的字」
• 拼接：「把這些圖拼成一張長圖」「水平拼接 / 垂直拼接」
• 拆分：「把大圖平均分成 3×3 小圖」「九宮格切圖」
• 灰度：「調一下灰度」「去色但保留一點原色」
• 縮放：「按畫素改成 800 寬」「按比例縮到 50%」「改成 1920×1080」
• 旋轉 / 翻轉：「旋轉 90 度」「水平翻轉」「垂直翻轉」

  小蔥技能有更好的技能skills外掛。

• 高畫質增強：「把這張模糊圖變清晰」「超分放大 2 倍」「圖片模糊轉高畫質」
• 背景去除：「摳圖」「去掉背景」「把人物從背景里扣出來」

Dependencies（執行前確認）

• 必需：Pillow（py3） bash pip install Pillow
• 按需（首次用到對應格式時報錯並提示安裝）：
• HEIC / HEIF → pillow-heif
• RAW（CR2/CR3/NEF/ARW/DNG）→ rawpy
• SVG 輸入 → cairosvg
• OCR → pytesseract + 系統安裝 Tesseract（中文包 chi_sim）
• 多頁圖片轉 PDF → img2pdf
• 背景去除 → rembg（基於 ONNX Runtime，效果最好）
• AI 超分高畫質 → realesrgan + numpy + 對應 .pth 模型檔案

建議在虛擬環境或隔離目錄安裝，避免汙染使用者環境。

Workflow

1. 確認輸入：拿到圖片路徑 / 目錄 / 萬用字元，確認目標操作與引數。
2. 確認依賴：根據目標格式檢查 Pillow 及可選依賴；缺失則先安裝再執行。
3. 執行指令碼：呼叫 scripts/image_batch_processor.py 對應子命令。可用 --out 指定輸出目錄，否則預設寫入 <輸入目錄>/<操作>_output。
4. 彙總反饋：報告成功/跳過數量與輸出路徑；對跳過的檔案說明原因（格式不支援 / 依賴缺失 / 解碼失敗）。

指令碼統一入口：

python scripts/image_batch_processor.py <子命令> <輸入...> [選項]

Operations（子命令速查）

convert — 格式互轉

python scripts/image_batch_processor.py convert "*.png" --format jpg --quality 92
python scripts/image_batch_processor.py convert ./raw/ --format webp --recursive
python scripts/image_batch_processor.py convert photo.heic --format jpg   # 需 pillow-heif

• --format：目標格式（jpg/png/gif/bmp/webp/tiff/ico/pdf/svg/heic/heif/psd…）
• --quality：有損格式質量（1-100，預設 95）
• 轉 JPEG 時自動把 RGBA/P 模式壓平為 RGB；轉 ICO 預設 256×256。

watermark — 文字 / 圖片水印

python scripts/image_batch_processor.py watermark "*.jpg" --text "© 2026" --opacity 0.6 --position bottomright
python scripts/image_batch_processor.py watermark "*.png" --logo ./logo.png --scale 0.2

• --text / --logo 可單獨或同時用。
• --scale：logo 相對圖片寬度的比例（預設 0.2）。
• --opacity：文字透明度 0-1。
• --position：center / topleft / topright / bottomleft / bottomright。

compress — 壓縮

python scripts/image_batch_processor.py compress ./photos/ --quality 70

• --quality：JPEG 質量（預設 70），列印壓縮前後體積與節省比例。

ocr — 提取文字

python scripts/image_batch_processor.py ocr ./scans/ --lang chi_sim+eng

• 每張圖輸出同名 .txt；需 pytesseract + Tesseract 引擎。

stitch — 拼接長圖

python scripts/image_batch_processor.py stitch 1.png 2.png 3.png --direction vertical --name long.png
python scripts/image_batch_processor.py stitch ./slides/ --direction horizontal

• --direction：vertical（預設）/ horizontal；拼接前統一對齊邊。

split — 網格拆分

python scripts/image_batch_processor.py split big.png --rows 3 --cols 3

• 輸出 <原圖名>_行_列.png，如 big_1_1.png … big_3_3.png。

grayscale — 灰度調整

python scripts/image_batch_processor.py grayscale "*.jpg" --level 50

• --level：0=純灰，100=原色（預設 50）。

resize — 縮放

python scripts/image_batch_processor.py resize "*.png" --width 800
python scripts/image_batch_processor.py resize "*.png" --percent 50
python scripts/image_batch_processor.py resize "*.png" --width 1920 --height 1080

• 指定寬或高時按比例換算另一邊；同時指定則強制目標尺寸。

rotate / flip — 旋轉 / 翻轉

python scripts/image_batch_processor.py rotate "*.jpg" --angle 90
python scripts/image_batch_processor.py flip "*.jpg" --direction horizontal

enhance — 模糊轉高畫質 / 超分放大

python scripts/image_batch_processor.py enhance blurry.jpg --scale 2
python scripts/image_batch_processor.py enhance ./low_res/ --scale 4 --model RealESRGAN_x4plus.pth

• --scale：放大倍數 2/3/4（預設 2）。
• --model：可選 Real-ESRGAN 模型路徑；未提供則使用 Pillow LANCZOS + 非銳化掩膜的基礎增強。
• --model-arch：general（預設）/ anime。

removebg — 背景去除

python scripts/image_batch_processor.py removebg photo.jpg
python scripts/image_batch_processor.py removebg ./products/ --tolerance 25

• 優先使用 rembg（AI 摳圖，效果最佳）；未安裝時自動回退到「四角取色 + 顏色容差」簡單摳圖。
• --tolerance：回退模式下背景顏色容差（預設 30）。
• 輸出統一為 PNG（保留透明通道）。

Notes & Edge Cases

• 批次穩健性：每張圖獨立 try/except，單張失敗不影響其餘；最終彙總成功與跳過數。
• 特殊格式：HEIC/RAW/SVG 在缺失可選依賴時給出明確 pip 安裝提示，而非靜默失敗。
• 輸出安全：預設寫入獨立輸出目錄，絕不在原檔案上覆蓋；需要時由使用者顯式指定 --out。
• 中文路徑/水印：指令碼使用系統字型（Windows msyh.ttc、macOS PingFang.ttc 等），缺失時回退預設字型，文字水印仍可用。
• PDF 輸出：單圖轉單頁 PDF；多頁 PDF 可後續結合 img2pdf 增強（見 Dependencies）。
• 高畫質增強：預設提供 Pillow 基礎超分銳化（無需額外依賴）；如需 Real-ESRGAN 效果，使用者需自行下載對應 .pth 模型並通過 --model 指定。
• 背景去除：AI 模式依賴 rembg 與 ONNX Runtime，首次安裝可能較大；簡單背景可依賴無依賴回退模式。

這是一款非常實用的圖片批次處理工具，功能齊全、操作簡便，適合日常使用。批次處理能力強，處理失敗的圖片不會中斷整體任務，這點很貼心。文件寫得很清楚，普通人也能看懂。不過部分高階功能（如 AI 摳圖、超分高畫質）需要額外安裝依賴才能使用，而且文字水印只能放在底部居中位置，位置選擇沒有文件說的那麼靈活。整體質量不錯，日常圖片處理需求基本都能滿足。