照片水印与调整尺寸技能 (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 | 目标宽度像素（设为 0 时仅按高度比例缩放） |
--height | 600 | 目标高度像素（设为 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/子文件夹中已生成转换后的图片，并向用户告知保存路径和处理数量。