圖片浮水印與尺寸調整技能 (photo-watermark-resizer)
此技能用於批次調整（橫向/縱向像素）部落格文章或相片資料夾中的大量圖片，並合成透明 PNG 浮水印。 AI 代理可根據使用者要求，1) 透過 CLI 腳本立即自動轉換，或 2) 啟動 GUI 應用程式讓使用者以滑鼠預覽並手動放置浮水印。
執行環境與路徑
- Python 執行檔:
C:\Users\쭈니\AppData\Local\Programs\Python\Python313\python.exe（或系統python） - CLI 腳本: cli_resizer.py
- GUI 原始專案:
C:\Users\쭈니\Documents\photo resiging\watermark_resizer.py（執行檔:WatermarkResizer.exe） - 預設浮水印素材參考路徑 (
C:\Users\쭈니\Pictures)：C:\Users\쭈니\Pictures\넥스가드서명.pngC:\Users\쭈니\Pictures\넥스가드서명화이트.pngC:\Users\쭈니\Pictures\서명화이트.pngC:\Users\쭈니\Pictures\안산수암점.png
使用方式（逐步說明）
1. AI 即時背景批次轉換（CLI 模式）
使用者指定資料夾路徑、尺寸與浮水印選項後，即可執行 cli_resizer.py 立即處理。
& "C:\Users\쭈니\AppData\Local\Programs\Python\Python313\python.exe" "C:\Users\쭈니\.gemini\config\skills\photo-watermark-resizer\scripts\cli_resizer.py" `
--input "<目標_資料夾_或_檔案_路徑>" `
--watermark "<浮水印_PNG_路徑>" `
--width 800 `
--height 600 `
--opacity 80 `
--size 20 `
--margin 3 `
--position "右下角" `
--json
主要選項說明
| 選項 | 預設值 | 說明 |
|---|---|---|
-i, --input | （必要） | 內含待轉換圖片的資料夾路徑或單一圖片檔案路徑 |
-w, --watermark | 無 | 要合成的浮水印 PNG 檔案路徑（省略則僅調整尺寸） |
-o, --output | 原始資料夾/processed | 儲存結果的資料夾路徑（未指定時自動存入各圖片資料夾下的 processed/ 子資料夾） |
--width | 800 | 目標橫向 (Width) 像素尺寸（設為 0 則僅根據縱向調整比例） |
--height | 600 | 目標縱向 (Height) 像素尺寸（設為 0 則僅根據橫向調整比例） |
--no-resize | False | 加入此旗標後保持原始解析度，僅合成浮水印 |
--stretch | False | 加入此旗標後關閉長寬比保持，強制調整為指定的 width x height |
--opacity | 80.0 | 浮水印不透明度（10 ~ 100%） |
--size | 20.0 | 結果圖片橫向寬度相對於浮水印橫向尺寸的比例（5 ~ 100%） |
--margin | 3.0 | 邊角邊距比例（0 ~ 50%） |
--position | Bottom-Right | 左上角(Top-Left), 中央上方(Top-Center), 右上角(Top-Right), 左側中央(Middle-Left), 正中央(Center), 右側中央(Middle-Right), 左下角(Bottom-Left), 中央下方(Bottom-Center), 右下角(Bottom-Right), 自訂(Custom) |
--custom-x, --custom-y | 95.0 | --position Custom 時，橫向/縱向相對位置百分比（0 ~ 100%） |
--no-recursive | False | 關閉子資料夾搜尋，僅轉換最上層資料夾中的圖片 |
--json | False | 以易於 AI 解析的 JSON 格式輸出處理結果 |
2. 使用者想透過預覽拖放浮水印時（GUI 模式）
當使用者要求「請啟動視窗」、「我想預覽直接調整位置」時，使用 --gui 選項啟動桌面應用程式：
& "C:\Users\쭈니\AppData\Local\Programs\Python\Python313\python.exe" "C:\Users\쭈니\.gemini\config\skills\photo-watermark-resizer\scripts\cli_resizer.py" --gui
結果驗證 (Verification)
- 命令執行後，檢查輸出的 JSON 中的
"status": "success"及"processed"計數。 - 確認指定目標資料夾內的
processed/子資料夾中已產生轉換後的圖片，並告知使用者儲存路徑與處理數量。