A Regressão Visual compara sua página ativa com uma captura de tela aprovada anteriormente (a baseline) e relata quaisquer diferenças. Pontuação 100 = nada mudou. Pontuações mais baixas = diferenças reais detectadas.

Você pode executar testes de regressão sob demanda ou configurar um monitor que os executa automaticamente de forma agendada e envia um e-mail quando algo muda.

Teste de regressão pontual

Admin do WP → QAProof → Tests → aba Visual Regression.
Insira a URL da página.
Clique em Run Test. Na primeira execução para essa URL, o sistema captura uma baseline. Em cada execução subsequente, ele compara com essa baseline.

Para monitoramento automatizado de longo prazo, use um Monitor — ele faz a mesma coisa de forma agendada.

Configurando um monitor

Admin do WP → QAProof → Monitors → Add Monitor.
Insira a URL da página, a programação (diária / semanal / mensal), o e-mail de notificação e um limite de alerta opcional (padrão: notificar se a pontuação cair abaixo de 90).
Clique em Create. A primeira execução captura a baseline. As execuções agendadas subsequentes são testes de regressão contra ela.

Você pode executar um monitor sob demanda a qualquer momento com o botão Run sem esperar pela programação.

O que a pontuação significa

100 — nenhuma diferença detectável. A página é idêntica à baseline.
90–99 — ruído trivial (renderização sub-pixel, anti-aliasing). Geralmente nada acionável.
75–89 — pequenas mudanças confirmadas (uma palavra adicionada, a cor de um botão ajustada).
50–74 — múltiplas mudanças ou uma regressão significativa de layout/estilo.
25–49 — regressão importante afetando seções principais.
<25 — página fundamentalmente quebrada ou em branco.

Como a comparação funciona

Três sinais independentes determinam se a página mudou:

Comparação de texto do DOM — cada string visível na baseline vs. atual. Capta edições apenas de texto que a comparação de captura de tela poderia não perceber.
Comparação de cores CSS — tokens de cor extraídos (--primary, --accent, fundo de botão, cor de link, etc.) comparados numericamente. Capta mudanças de paleta.
Comparação de cores de pixels — comparação RGB baseada em blocos das capturas de tela. Capta todo o resto.

Se os três sinais relatarem nenhuma mudança, o sistema retorna pontuação 100 sem invocar a IA — rápido e livre do risco de falsos positivos. Se qualquer sinal disparar, a análise por IA é executada para interpretar a mudança e produzir um resumo legível por humanos.

Aprovando uma mudança real

Quando você redesenha uma página intencionalmente, a próxima execução do monitor relatará uma regressão. Isso é esperado — o sistema não tem como saber quais mudanças você pretendia. Abra o resultado, verifique se as mudanças estão corretas e clique em Approve. Isso captura uma nova baseline para que as execuções futuras usem o novo estado como referência.

Resultados "Capture appears unstable"

Às vezes você verá um resultado de regressão com pontuação 100 e um resumo como "Capture appears unstable — page height differs by 60% between baseline and current" ou "… 4 image(s) failed to load during the current capture".

Isso é uma salvaguarda deliberada. O sistema detectou que a captura atual é, ela mesma, não confiável (um carrossel em JS explodiu, o CDN de imagens limitou nossa taxa, etc.) e se recusou a comparar. Relatar uma regressão nesse estado seria enganoso — o site subjacente não mudou. Execute o teste novamente em 1 a 2 minutos; quase sempre tem sucesso na repetição.

Alertas por e-mail

Quando o resultado de um monitor cai abaixo do seu limite de alerta, o plugin envia um e-mail para o endereço que você configurou. O e-mail inclui:

Pontuação e rótulo (Bom / Precisa de Trabalho / Ruim).
Detalhamento da pontuação (4 categorias).
O principal problema encontrado.
Botão Download Full Report — um único clique baixa um PDF com todos os problemas, recomendações e capturas de tela.

Você pode desativar os alertas de monitor globalmente em Profile → Email Notifications, ou por monitor na caixa de diálogo de edição do Monitor.

Histórico de resultados

Cada monitor mantém os últimos 50 resultados. Resultados mais antigos são removidos automaticamente. Abra um monitor em QAProof → Monitors para ver a linha do tempo — pontos verdes são execuções aprovadas, âmbar/vermelho são falhas, e você pode aprofundar em qualquer resultado passado.

Dicas para monitores estáveis

Escolha páginas estáveis. Páginas com conteúdo que muda com frequência (preços de ações ao vivo, feeds de redes sociais) relatarão "regressões" constantes porque o conteúdo realmente muda. Use o mascaramento de conteúdo dinâmico (ativado por padrão) para ocultar cronômetros e rotadores, ou escolha páginas menos voláteis.
Use a programação semanal para sites de baixo tráfego. O disparo do WP-Cron em instalações WordPress de baixo tráfego pode ser não confiável. Configure um cron job em nível de servidor acessando wp-cron.php, ou use uma programação semanal, que é mais tolerante.
Recapture baselines após deploys. Se você publicar mudanças visuais, clique em Approve no próximo resultado de regressão para atualizar a baseline. Caso contrário, toda execução futura continuará sinalizando a mesma mudança intencional.