Pool de IA, fila e segurança
Para operar com estabilidade em servidores enxutos usando múltiplas chaves gratuitas sem derrubar outros chats nem expor a conta do WhatsApp a bloqueios, a HikariZap separa validação inicial, balanceamento de modelos, enfileiramento e sanitização em quatro camadas.
Validação estrita na inicialização (src/config/validate.js)
Seção intitulada “Validação estrita na inicialização (src/config/validate.js)”Antes de abrir o socket do Baileys ou aceitar mensagens, a inicialização confere os formatos do .env:
- Rejeita telefones inválidos em
WHATSAPP_OWNER_NUMBERS(exige de8a15dígitos com DDI/DDD e recusa placeholders genéricos como5500000000000). - Garante faixas válidas para
WHATSAPP_MAX_MEDIA_MB(1a64), parâmetros vocais (speedde0.5a2.0,temperaturede0a2, caracteres de1a5.000) e rotação de logs (1a90dias e1a50 MB). - Confere a presença de
ffmpegeyt-dlpsem derrubar funções principais caso um recurso opcional esteja ausente, interrompendo o processo apenas em erros críticos de configuração sem vazar valores secretos.
ProviderPool, cascata de modelos e ai-health.json
Seção intitulada “ProviderPool, cascata de modelos e ai-health.json”O ProviderPool intercala Groq, Gemini, HuggingFace, Pollinations (bloqueado sem chave salvo ALLOW_PUBLIC_POLLINATIONS=true) e LM Studio local respeitando AI_PROVIDER_ORDER:
- Cascata sem repetição: quando usa Gemini, aceita múltiplas chaves separadas por vírgula (
GEMINI_API_KEY=k1,k2) e segue a sequência configurável entreGEMINI_MODEL,GEMINI_MODEL_FALLBACK,GEMINI_MODEL_FALLBACK_2eGEMINI_MODEL_FALLBACK_3(pulando entradas duplicadas), caindo para HuggingFace (Qwen/Qwen2.5-72B-Instruct) e Pollinations se necessário. - Preferência recente e limites: prioriza por
1 minutoo último provedor vencedor, executa até8tentativas no total (máximo2por provedor), com timeout de10sna tentativa inicial,35spara conclusão e90sde orçamento total de agente (comLLM_TIMEOUT_MSajustável entre5.000e120.000 ms, padrão30.000 ms). - Rastreio em
ai-health.json: erros429pausam apenas o candidato pelo tempo indicado emRetry-After;5xxmarcam instabilidade temporária;401/402/403sinalizam chave ou crédito;404isola o modelo ausente;400de suporte a ferramentas rebaixa apenas aquela chamada para modo texto mantendo o provedor disponível para conversa comum.
Fila serializada (Queue) e limitador anti-ban (createSendLimiter)
Seção intitulada “Fila serializada (Queue) e limitador anti-ban (createSendLimiter)”- Fila concorrente (
src/whatsapp/queue.js): processa até2chats ao mesmo tempo, mantendo1tarefa ativa por chat, limite de20pendentes globais e4por chat, espera máxima de60se execução máxima de180s, com aborto imediato pelo comando>cancelar(AbortController). - Cadência anti-ban: garante intervalo mínimo obrigatório de
2 segundosentre qualquer envio, teto de20mensagens por minuto global e máximo de6mensagens por minuto dentro do mesmo chat.
Sanitização de logs, SSRF e privacidade
Seção intitulada “Sanitização de logs, SSRF e privacidade”- Sem gravação de chats comuns em log: o logger (
src/utils/logger.js) não escreve conversas privadas ou áudios transcritos comuns nos arquivos de log emlogs/, aplicando rotação automática (LOG_RETENTION_DAYS,LOG_MAX_FILE_MB). - Máscara automática
[REDACTED]: antes de imprimir no console ou gravar em arquivo, tokensAIza...,hf_..., bearers, telefones e LIDs são substituídos por[REDACTED]. O QR Code aparece só no terminal interativo e nunca vai para arquivos ou rotas web. - Anti-SSRF (
ipaddr.js) e dados externos: links informados por usuários passam por verificação de IP bloqueando endereços privados, loopback (127.0.0.1), link-local e faixas CGNAT, e conteúdos extraídos de sites ou imagens entram isolados como dados externos não confiáveis. - Cuidados operacionais: evite conectar um chip recém-criado antes de estabelecer histórico normal de uso manual e mantenha backup seguro de
.whatsapp-auth/caso migre de servidor.
