Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Hikari WhatsApp

Figurinhas e mídias no WhatsApp

O módulo multimídia da HikariZap (src/services/stickerService.js, download_deezer.py e ferramentas de busca) evita distorções comuns em figurinhas e entrega arquivos dentro dos limites aceitos pelo WhatsApp.

Figurinhas estáticas e animadas (>sticker / >figurinha)

Seção intitulada “Figurinhas estáticas e animadas (>sticker / >figurinha)”

Em vez de cortar cantos ou esticar imagens retangulares em quadrados forçados, o processamento preserva 100% do enquadramento original:

  • Estáticas (Sharp): inspeciona largura e altura da foto, calcula a escala proporcional e centraliza sobre um canvas transparente de 512×512 pixels, exportando em WebP otimizado sem perda visível.
  • Animadas (FFmpeg): aceita vídeos curtos e GIFs de até 10 segundos, aplicando padding transparente (pad=512:512:(512-iw)/2:(512-ih)/2:color=black@0.0) a 24 fps em loop contínuo e comprimindo rigorosamente abaixo do limite de 1 MB exigido pelo WhatsApp. Vídeos verticais ganham faixas transparentes laterais sem cortar o topo ou a base.
  • Metadados EXIF: aceita texto opcional após o comando (>sticker Pacote | Autor até 128 caracteres), gravado nos blocos técnicos do WebP do WhatsApp.

Ao responder a qualquer figurinha no chat usando >toimg ou >sticker2image:

  • Figurinha estática: decodificada pelo Sharp e devolvida em PNG preservando o canal alfa transparente.
  • Figurinha animada: decomposta frame a frame pelo FFmpeg e remontada como arquivo GIF completo, pronta para salvar ou editar fora do WhatsApp.

Visão em fotos e figurinhas (imageVisionHandler.js)

Seção intitulada “Visão em fotos e figurinhas (imageVisionHandler.js)”

Ao enviar ou citar fotos (JPEG, PNG, WEBP de até 10 MB) ou citar uma figurinha junto de uma pergunta (ou usar >anime via Trace.moe), o primeiro quadro é analisado visualmente e inserido na conversa marcado como dado externo não confiável contra tentativas de prompt injection.

  • Deezer (src/services/download_deezer.py): consulta a API oficial do Deezer e utiliza deemix (com cookie DEEZER_ARL no .venv Python) para enviar MP3 a 320 kbps com capa do álbum e tags ID3. O arquivo temporário é apagado do disco imediatamente após o envio.
  • Links da web (>baixar_audio e >baixar_video): >baixar_audio baixa apenas a trilha sonora (bestaudio) economizando banda; >baixar_video envia MP4 compatível respeitando o teto WHATSAPP_MAX_MEDIA_MB (padrão 16 MB). Se precisar de cookies para conteúdos restritos do YouTube, configure YTDLP_COOKIES_PATH.
  • Repacks locais e seleção numerada: ao pesquisar em src/data/fitgirl.json e src/data/dodi.json, retorna até 5 opções com tamanho e data, válidas por 10 minutos apenas naquela conversa. Responda no chat com 1 a 5 (ou primeiro..quinto) para o bot validar o hash criptográfico BTIH do magnet e entregar um arquivo .txt limpo pronto para importar no cliente torrent (ou o próprio .torrent).
  • Câmbio sem cache obsoleto: o comando >moeda consulta ao vivo AwesomeAPI (CURRENCY_PROVIDER=awesomeapi, aceitando AWESOMEAPI_KEY opcional) ou Frankfurter (CURRENCY_PROVIDER=frankfurter, dados oficiais do Banco Central Europeu), informando a fonte e o horário exato da cotação.