Processamento de Imagens
Processamento determinístico de imagens existentes: redimensionar, cortar, preencher bordas, converter formato, comprimir, marcas d'água, cantos arredondados, colagens, miniaturas. Todas as operações utilizam
skills/shared/scripts/image_ops.py(Pillow puro), sem scripts improvisados.
Entrada
- Caminho(s) de arquivo(s) de imagem existente(s) (png, jpg, webp e outros formatos suportados pelo Pillow)
- Operação desejada e parâmetros (dimensões, proporção, qualidade, texto da marca d'água, modo de colagem etc.)
Saída
- Arquivo(s) de imagem processado(s) (caminho especificado pelo usuário ou salvo em
outputs/tema-do-projeto/) - Cada comando exibe
✅ caminho (largura×altura, tamanhoKB); o comandoinforetorna JSON
Limites (distinção dos skills card-*)
- card-quote / card-xiaohongshu / poster-hero / comparison-card = criar e renderizar nova imagem (HTML → captura de tela)
- image-editing = processar imagem existente, sem design visual, sem gerar conteúdo, apenas manipulação em nível de pixel
- Se for necessário "gerar imagem a partir de dados/texto" → usar chart / infographic / card-* ; este skill processa apenas arquivos de imagem já existentes
Passos de Execução
- Confirmar que a imagem de entrada existe e definir claramente a operação e os parâmetros
- Executar o subcomando correspondente do
image_ops.pya partir da raiz do projeto (veja abaixo) - Quando forem necessárias dimensões de plataforma, consultar
references/platform-sizes.mdpara obter a proporção/pixels recomendados - Informar o caminho de saída e as dimensões; operações podem ser encadeadas (ex.: redimensionar e depois comprimir)
Referência Rápida de Comandos
O caminho do script é sempre skills/shared/scripts/image_ops.py. Todos os subcomandos aceitam -h para ver os parâmetros.
# Redimensionar: por largura/altura/porcentagem, --keep-ratio mantém proporção sem esticar
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
# Cortar: por coordenadas ou centralizado para dimensão específica
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
# Preencher bordas até a proporção alvo (essencial para mídias sociais): qualquer imagem vira 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"
# Converter formato png/jpg/webp
python skills/shared/scripts/image_ops.py convert -i in.png -o out.webp --format webp --quality 85
# Comprimir: qualidade fixa ou aproximar do tamanho máximo do arquivo (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
# Marca d'água: texto (posição/transparência/tamanho/cor, fonte chinesa automática) ou imagem (canto inferior direito etc.)
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --text "@usuario" --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
# Cantos arredondados (saída png com transparência); --radius-percent 50 produz círculo
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
# Colagem: horizontal/vertical/grid NxM (colunas×linhas), --cell-width/height para células uniformes
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
# Miniatura (baseada no lado mais longo)
python skills/shared/scripts/image_ops.py thumbnail -i in.jpg -o thumb.jpg --size 256
# Ler informações da imagem (json: dimensões/formato/proporção/tamanho/canal alfa)
python skills/shared/scripts/image_ops.py info -i in.jpg
Conhecimento de Domínio: Dimensões Recomendadas para Plataformas
As dimensões recomendadas comuns estão em references/platform-sizes.md. Memorização rápida:
- Xiaohongshu vertical imagem+texto: 1080×1440 (3:4); vídeo/pôster vertical: 1080×1920 (9:16)
- Momento do WeChat / quadrado genérico: 1:1 (ex.: 1080×1080)
- Citação horizontal/capa: 16:9 (ex.: 1920×1080); cabeçalho WeChat: 900×383
- Imagem Weibo: 1:1 ou 4:3; capa Douyin/WeChat Video: 9:16 (1080×1920)
Estratégia de adaptação: priorizar pad (preencher bordas, sem cortar conteúdo nem deformar) para preservar a imagem; se quiser ocupar toda a tela sem bordas, usar crop centralizado para a proporção alvo; apenas reduzir o tamanho do arquivo com resize/compress.
Consciência de Perfil
- Com perfil: marca d'água usa o nome/handle da conta por padrão; proporção de saída alinhada à plataforma principal do perfil (ex.: conta Xiaohongshu → 1080×1440)
- Sem perfil: executar com parâmetros explícitos do usuário; proporção mantida original; marca d'água exige texto do usuário
Dependências e Tratamento de Erros
- Dependências: Pillow (já instalado,
python -c "import PIL"funcional), apenas bibliotecas padrão, sem terceiros - Verificações internas de limites: arquivo inexistente / corte fora dos limites / proporção ou cor inválidos → código de saída 2 e exibição de
ERROR: - Se a fonte chinesa não for encontrada, faz fallback para a fonte padrão do PIL e exibe
WARN; use--fontpara especificar - Autoteste:
python skills/shared/scripts/image_ops.py --selftest