影像處理加工
對既有圖片進行確定性處理:縮放/裁切/補邊/轉格式/壓縮/浮水印/圓角/拼接/縮圖。 所有操作透過
skills/shared/scripts/image_ops.py(純 Pillow),不隨意編寫腳本。
輸入
- 一張或多張已存在的圖片檔案路徑(png/jpg/webp 等 Pillow 支援格式)
- 目標操作與參數(尺寸、比例、品質、浮水印文字、拼接方式等)
輸出
- 處理後的圖片檔案(路徑由使用者指定或預設寫入
outputs/主題名/) - 每條指令回顯
✅ 路徑 (寬x高, 大小KB);info輸出 json
邊界(與 card-* 劃清)
- card-quote / card-xiaohongshu / poster-hero / comparison-card = 設計並渲染新圖(HTML→截圖)
- image-editing = 加工既有圖片,不做視覺設計,不產生內容,只做像素級處理
- 需要「從數據/文字產生圖」→ 使用 chart/infographic/card-*;本 SKILL 只處理現成的圖片檔案
執行步驟
- 確認輸入圖片存在、明確目標操作與參數
- 從專案根目錄執行
image_ops.py對應子指令(見下方) - 需要平台尺寸時,查詢
references/platform-sizes.md取得推薦比例/像素 - 回報輸出路徑與尺寸;多步驟操作可串聯(例如先 resize 再 compress)
指令速查
腳本路徑統一為 skills/shared/scripts/image_ops.py,均支援 -h 查看參數。
# 縮放:依寬/高/百分比,--keep-ratio 在框內等比例不拉伸
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --percent 50
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080 --height 1440 --keep-ratio
# 裁切:座標裁 或 居中裁到指定尺寸
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --box 100,50,900,650
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --width 1080 --height 1080
# 補邊到目標比例(社群媒體適配核心):將任意圖 pad 成 1:1 / 9:16 / 16:9
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 9:16 --background "#ffffff"
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 1:1 --background "20,20,30"
# 格式轉換 png/jpg/webp
python skills/shared/scripts/image_ops.py convert -i in.png -o out.webp --format webp --quality 85
# 壓縮:固定品質 或 逼近目標檔案大小上限(jpg/webp)
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --quality 80
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --max-kb 200
# 浮水印:文字(位置/透明度/字型大小/顏色,自動尋找系統中文字型)或圖片(右下角等)
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --text "@帳號名" --position bottom-right --opacity 0.5 --size 40
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --image logo.png --position bottom-right --scale 0.3 --opacity 0.8
# 圓角(輸出透明 png);--radius-percent 50 得到圓形
python skills/shared/scripts/image_ops.py round -i in.jpg -o out.png --radius 60
python skills/shared/scripts/image_ops.py round -i avatar.jpg -o out.png --radius-percent 50
# 多圖拼接:橫向/縱向/網格 NxM(列x行),--cell-width/height 統一儲存格
python skills/shared/scripts/image_ops.py collage -i a.jpg b.jpg c.jpg -o out.jpg --mode horizontal --gap 12
python skills/shared/scripts/image_ops.py collage -i 1.jpg 2.jpg 3.jpg 4.jpg -o out.jpg --grid 2x2 --gap 10 --cell-width 540 --cell-height 540
# 縮圖(最長邊像素)
python skills/shared/scripts/image_ops.py thumbnail -i in.jpg -o thumb.jpg --size 256
# 讀取圖片資訊(json:尺寸/格式/比例/大小/透明通道)
python skills/shared/scripts/image_ops.py info -i in.jpg
領域知識:平台推薦尺寸
常用平台推薦請見 references/platform-sizes.md。高頻速記:
- 小紅書直版圖文:1080×1440(3:4);小紅書影片/直版海報:1080×1920(9:16)
- 朋友圈單圖 / 通用方圖:1:1(如 1080×1080)
- 橫版金句/封面:16:9(如 1920×1080);微信公眾號首圖 900×383
- 微博配圖:1:1 或 4:3;抖音/影片號封面:9:16(1080×1920)
適配思路:優先 pad(補邊不裁內容、不變形)保全畫面;追求滿版無邊則 crop 居中裁到目標比例;
僅需縮小體積用 resize/compress。
Profile 感知
- 有 Profile:浮水印文字預設用帳號名/handle;輸出比例預設貼合帳號主平台(如小紅書號預設 1080×1440)
- 無 Profile:依使用者明確參數執行,比例預設保持原圖,浮水印需使用者提供文字
相依性與錯誤處理
- 相依性:Pillow(已安裝,
python -c "import PIL"可用),純標準庫無其他第三方 - 腳本內建邊界檢查:檔案不存在 / 裁切框越界 / 非法比例或顏色 → 退出碼 2 並印出
ERROR: - 找不到系統中文字型時降級為 PIL 預設字型並顯示
WARN,可使用--font指定 - 自我檢測:
python skills/shared/scripts/image_ops.py --selftest