Communitygithub.com

490437477-sys/codex-skills-backup

Respaldo de habilidades de Codex + habilidades de plugins + configuración de herramientas

¿Qué es codex-skills-backup?

Esta habilidad proporciona una herramienta de segmentación de imágenes a través de la plataforma de inteligencia visual de Alibaba Cloud (Aliyun). Permite generar fondos blancos, imágenes PNG con fondo transparente o recortes de objetos a partir de imágenes. Es especialmente útil para desarrolladores y usuarios de asistentes de IA como Claude Code, Cursor o Codex que necesitan procesar imágenes en lote o de forma individual, con soporte para múltiples modelos de segmentación (productos, personas, comida, animales, etc.). La herramienta se ejecuta mediante un script de Python (`scripts/aliyun_seg.py`) y requiere credenciales de la API de Alibaba Cloud. El script maneja automáticamente la comprobación y redimensionamiento de imágenes a un máximo de 2000×2000 píxeles, llama a la API avanzada de segmentación, descarga el resultado desde una URL firmada y lo guarda localmente. La salida predeterminada se almacena en un subdirectorio `白底图` dentro del directorio de origen, pero se puede redirigir con el flag `-o`. Es compatible con formatos PNG, JPG, JPEG, WebP y BMP.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add 490437477-sys/codex-skills-backup

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Fondo Blanco

Segmenta el sujeto principal de una imagen a través de la plataforma de inteligencia visual de Alibaba Cloud, generando un fondo blanco, PNG transparente o un recorte. Comportamiento predeterminado: crea un subdirectorio fondo_blanco en el directorio de origen (o en el mismo directorio del archivo) para almacenar los resultados, se puede sobrescribir con -o.

Ubicación de salida predeterminada

EntradaDirectorio de salida predeterminado
Directorio ./fotos/./fotos/fondo_blanco/
Archivo ./fotos/a.jpg./fotos/fondo_blanco/a.jpg

Para enviar la salida a otra ubicación, usa -o /ruta/de/salida explícitamente.

Requisitos previos

pip install alibabacloud_imageseg20191230 alibabacloud_tea_openapi alibabacloud_tea_util Pillow

Configurar credenciales

Se priorizan las variables de entorno; si no están configuradas, se usan valores internos en el script (en producción, usa siempre variables de entorno):

setx ALIBABA_CLOUD_ACCESS_KEY_ID "TuKey"
setx ALIBABA_CLOUD_ACCESS_KEY_SECRET "TuSecret"

Modo de uso

Ejecuta directamente scripts/aliyun_seg.py.

Procesamiento por lotes de directorios (salida predeterminada en directorio_origen/fondo_blanco)

python scripts/aliyun_seg.py ./fotos                      # Segmentación de productos + fondo blanco
python scripts/aliyun_seg.py ./fotos -m body              # Segmentación de personas
python scripts/aliyun_seg.py ./fotos -f mask              # PNG con fondo transparente
python scripts/aliyun_seg.py ./fotos -o ./salida -f crop  # Recorta al área del sujeto, salida en ./salida

Imagen individual (salida predeterminada en mismo_directorio_del_archivo/fondo_blanco)

python scripts/aliyun_seg.py ./fotos/a.jpg                # → ./fotos/fondo_blanco/a.jpg
python scripts/aliyun_seg.py ./fotos/a.jpg -o resultado.png  # → ./resultado.png

Herramientas

python scripts/aliyun_seg.py --list-models                 # Enumera todos los modelos compatibles

Modelos compatibles

ModeloDescripciónFormato de retorno
commoditySegmentación de productos (recomendado para fondo blanco)whiteBK / mask / crop
commonSegmentación generalwhiteBK / mask / crop
bodySegmentación de personaswhiteBK / mask / crop
foodSegmentación de alimentoswhiteBK / mask / crop
animalSegmentación de animaleswhiteBK / mask / crop
hd_commonSegmentación general en alta definiciónSolo imagen segmentada
clothSegmentación de ropaSolo imagen segmentada
logoSegmentación de logotiposSolo imagen segmentada
vehicleSegmentación de vehículosSolo imagen segmentada
skySegmentación de cieloSolo imagen segmentada

Formatos de retorno

  • whiteBK — Fondo blanco (predeterminado, el más usado)
  • mask — PNG con fondo transparente
  • crop — Recorta al cuadro delimitador del sujeto

Flujo interno (útil en caso de errores)

  1. Pillow verifica el lado más largo de la imagen; si supera los 2000px, la escala proporcionalmente (límite estricto de Alibaba Cloud: ≤ 2000×2000)
  2. Sube el binario usando *AdvanceRequest.image_urlobject = open(...)
  3. Llama a client.segment_xxx_advance(req, runtime)
  4. resp.body.data.image_url es una URL firmada de OSS CDN; se descarga con urllib.request.urlretrieve
  5. El nombre del archivo de salida conserva el nombre original; la extensión depende del formato de retorno (mask→png, de lo contrario igual que la entrada)

Notas

  • Las imágenes mayores de 2000×2000 se redimensionan automáticamente; la resolución original no se conserva
  • La salida de fondo transparente (mask) tiene extensión .png; las demás conservan la extensión de entrada
  • Las credenciales codificadas en el script son solo marcadores de posición; en producción se recomienda usar variables de entorno
  • Formatos de entrada compatibles: PNG / JPG / JPEG / WebP / BMP
  • Red: el script descarga la URL firmada devuelta por Alibaba Cloud; la máquina debe tener acceso a Internet público

Skills relacionados