AYJUNY/photo-watermark-resizer

Skill de Marca de Agua y Redimensionado de Fotos (photo-watermark-resizer)

Este skill permite redimensionar por lotes (ajustando píxeles de ancho/alto) y componer marcas de agua PNG transparentes sobre múltiples fotos o carpetas de imágenes, ideal para publicaciones de blog. El agente de IA puede, según la solicitud del usuario: 1) realizar la conversión automática inmediata mediante script CLI o 2) ejecutar una aplicación GUI para que el usuario pueda previsualizar y colocar la marca de agua con el ratón.

---

Entorno y rutas de ejecución

• Ejecutor de Python: C:\Users\쭈니\AppData\Local\Programs\Python\Python313\python.exe (o python del sistema)
• Script CLI: cli_resizer.py
• Proyecto GUI original: C:\Users\쭈니\Documents\photo resiging\watermark_resizer.py (ejecutable: WatermarkResizer.exe)
• Ruta de referencia para assets de marca de agua (C:\Users\쭈니\Pictures) :
  • C:\Users\쭈니\Pictures\넥스가드서명.png
  • C:\Users\쭈니\Pictures\넥스가드서명화이트.png
  • C:\Users\쭈니\Pictures\서명화이트.png
  • C:\Users\쭈니\Pictures\안산수암점.png

---

Instrucciones de uso (Paso a paso)

1. Cuando la IA realiza la conversión por lotes inmediata en segundo plano (modo CLI)

Cuando el usuario indica la ruta de la carpeta y las opciones de tamaño/marca de agua, se ejecuta cli_resizer.py para procesar inmediatamente.

& "C:\Users\쭈니\AppData\Local\Programs\Python\Python313\python.exe" "C:\Users\쭈니\.gemini\config\skills\photo-watermark-resizer\scripts\cli_resizer.py" `
  --input "<ruta_de_carpeta_o_archivo_destino>" `
  --watermark "<ruta_PNG_marca_de_agua>" `
  --width 800 `
  --height 600 `
  --opacity 80 `
  --size 20 `
  --margin 3 `
  --position "inferior-derecha" `
  --json

Descripción de las opciones principales

Opción	Valor por defecto	Descripción
-i, --input	(obligatorio)	Ruta de la carpeta que contiene las imágenes a convertir, o ruta de un archivo de imagen individual
-w, --watermark	Ninguno	Ruta del archivo PNG de marca de agua a componer (si se omite, solo se redimensiona)
-o, --output	carpeta_origen/processed	Ruta de la carpeta para guardar los resultados (si no se especifica, se guarda automáticamente en la subcarpeta processed/ de cada carpeta de imágenes)
--width	800	Tamaño de ancho (Width) en píxeles objetivo (si se pone 0, solo se ajusta la proporción según la altura)
--height	600	Tamaño de alto (Height) en píxeles objetivo (si se pone 0, solo se ajusta la proporción según el ancho)
--no-resize	False	Si se añade esta bandera, se mantiene la resolución original y solo se compone la marca de agua
--stretch	False	Si se añade esta bandera, se desactiva la conservación de la relación de aspecto y se fuerza el ajuste al width x height especificado
--opacity	80.0	Opacidad de la marca de agua (10 ~ 100%)
--size	20.0	Proporción del tamaño de la marca de agua con respecto al ancho de la imagen resultante (5 ~ 100%)
--margin	3.0	Proporción del margen desde la esquina (0 ~ 50%)
--position	Bottom-Right	superior-izquierda(Top-Left), superior-centro(Top-Center), superior-derecha(Top-Right), centro-izquierda(Middle-Left), centro(Center), centro-derecha(Middle-Right), inferior-izquierda(Bottom-Left), inferior-centro(Bottom-Center), inferior-derecha(Bottom-Right), personalizado(Custom)
--custom-x, --custom-y	95.0	Porcentaje de posición relativa horizontal/vertical cuando --position Custom (0 ~ 100%)
--no-recursive	False	Desactiva la exploración de subcarpetas y solo convierte imágenes de la carpeta raíz
--json	False	Muestra los resultados en JSON para que la IA los analice fácilmente

---

2. Cuando el usuario quiere previsualizar y colocar la marca de agua manualmente arrastrándola (modo GUI)

Si el usuario solicita "muéstrame la ventana", "quiero colocar la posición manualmente con vista previa", se ejecuta la aplicación de escritorio con la opción --gui:

& "C:\Users\쭈니\AppData\Local\Programs\Python\Python313\python.exe" "C:\Users\쭈니\.gemini\config\skills\photo-watermark-resizer\scripts\cli_resizer.py" --gui

---

Verificación de resultados (Verification)

1. Después de ejecutar el comando, verificar que el JSON de salida contenga "status": "success" y el número de "processed" correcto.
2. Confirmar que las imágenes convertidas se hayan generado en la subcarpeta processed/ dentro de la carpeta de destino especificada, e informar al usuario la ruta de guardado y el número de imágenes procesadas.