Referência

Solução de problemas

Encontre o sintoma e depois percorra as causas prováveis.

Um pull request não foi revisado automaticamente

A verificação HeyDeer Review no commit mais recente informa o motivo, com o título Review skipped ou, com Reprovar a verificação quando forem encontrados problemas ativado, Review required. Não há verificação? Consulte Nenhuma verificação HeyDeer Review aparece.

Causa provável	O que fazer
A Frequência de revisão é Somente manual, o padrão em novos espaços de trabalho.	Escolha Uma vez por PR ou A cada push. Consulte Revisões automáticas.
O pull request não corresponde aos seus Filtros de revisão automática, que ignoram rascunhos e forks por padrão.	Marque-o como pronto, altere os filtros ou comente `@heydeer review`.
As revisões automáticas estão pausadas neste pull request.	Comente `@heydeer resume`.
Uma vez por PR já iniciou uma revisão, ou há uma ainda na fila ou em execução; ou o pull request atingiu o Máximo de revisões automáticas por PR.	Comente `@heydeer review`.
O espaço de trabalho ficou sem créditos ou atingiu o limite de uso.	Adicione créditos ou aumente o limite em Controle de gastos e depois solicite uma nova revisão. Consulte Recarga automática e limites de uso.
No teste, o repositório já tinha tido um teste em outro espaço de trabalho.	Escolha um plano e depois solicite uma revisão.
O GitHub App não consegue acessar o repositório.	Confira Configurações da organização → Conexão com o GitHub. Consulte App do GitHub e permissões.
O HeyDeer espera cerca de 30 segundos após um push, ou a revisão está na fila (Review queued).	Aguarde.
O commit já tem uma revisão; mudar os rótulos ou reabrir o pull request não a repete.	Faça push de um novo commit ou comente `@heydeer review`.

A verificação falhou ou a revisão não terminou

Título da verificação	Causa	O que fazer
Review found issues that need attention	Foram encontrados problemas com Reprovar a verificação quando forem encontrados problemas ativado.	Corrija os problemas e faça push, ou resolva os problemas encontrados.
Review incomplete	Uma verificação do repositório ou um problema encontrado anteriormente não foi avaliado.	Solicite outra revisão.
Review could not run	A branch base tem uma configuração de `.agents/checks` inválida.	Corrija-a e depois solicite uma revisão.
Review could not run	A discussão do PR é grande demais: mais de 200 conversas de revisão, 1.000 comentários em uma conversa ou cerca de 180 KB.	Continue em um novo pull request.
Review could not run	O GitHub ou o HeyDeer estava indisponível.	Solicite a revisão novamente.
Review failed, Review timed out	A revisão não foi concluída. Falhas do lado do HeyDeer são reembolsadas.	Solicite outra revisão.
Review cancelled	Alguém cancelou a revisão, o pull request dela foi fechado ou um push mais recente a substituiu (A cada push).	Solicite outra revisão.
No reviewable files	Todos os arquivos alterados estão fora do escopo, como arquivos gerados.	Nada a fazer.

Todas as conclusões estão listadas em A verificação HeyDeer Review.

Nenhuma verificação HeyDeer Review aparece

Causa provável	O que fazer
Publicar verificação do GitHub está desativado no repositório.	Ative-a. Consulte Publicação dos resultados.
O repositório está em Somente manual e nunca foi revisado.	Solicite uma revisão. As versões seguintes passam a receber uma verificação.
O GitHub App não tem Checks: leitura e escrita, ou o repositório não está na instalação dele.	Aprove a permissão ou adicione o repositório no GitHub.
O pull request está fechado.	Reabra-o.

Um comando não recebeu resposta ou recebeu um erro

Causa provável	O que fazer
Sem resposta: o comentário contém mais do que o comando, o comando foi adicionado em uma edição ou um bot o publicou.	Publique um novo comentário apenas com o comando, a partir de uma conta pessoal.
Sem resposta: o GitHub App não tem a permissão de leitura de Issues.	Aprove-a no GitHub.
Você não tem acesso de escrita ou não está em Quem pode iniciar revisões manuais.	Peça a um administrador ou a alguém que tenha acesso.
Solicitações demais, ou a fila de revisões está cheia.	Aguarde e depois publique o comando novamente.
`pause` ou `resume` em um pull request fechado.	Esses comandos só funcionam em pull requests abertos.
Créditos insuficientes, ou o limite de uso foi atingido.	Adicione créditos ou aumente o limite e depois publique o comando novamente.
O GitHub estava indisponível.	Publique o comando novamente em um novo comentário.

O HeyDeer não responde a perguntas. Consulte Comandos em comentários do PR.

A revisão mostra um aviso

Cada aviso desativa a aprovação automática para aquela revisão.

Aviso	O que fazer
Mais de 10 verificações corresponderam; apenas as 10 primeiras por nome de arquivo foram executadas.	Restrinja os padrões ou renomeie arquivos. Consulte Verificações do repositório.
O pull request altera `.agents/`, e a nova configuração de verificações é inválida.	Corrija-a antes do merge, ou as revisões nessa branch param.
Problemas encontrados com menor confiança ficaram de fora; uma revisão mantém no máximo 30.	Resolva os problemas encontrados exibidos e depois solicite outra revisão.
Algumas avaliações de problemas encontrados ou de conversas ficaram incompletas.	Solicite outra revisão.

Uma regra ou verificação parece ser ignorada

Causa provável	O que fazer
A verificação mudou neste pull request; o HeyDeer lê a versão da branch base.	Faça o merge da alteração primeiro.
Os padrões da verificação não correspondem a nenhum arquivo alterado, ou o arquivo não é um arquivo .md diretamente em `.agents/checks/`.	Corrija os padrões ou mova o arquivo. Consulte Verificações do repositório.
A regra do AGENTS.md está em um diretório que não cobre os arquivos alterados.	Mova-a. Consulte AGENTS.md.
As instruções foram salvas depois que a revisão foi solicitada, ou as instruções do repositório as substituem.	Solicite outra revisão ou resolva o conflito. Consulte Instruções de revisão.
O problema encontrado ficou abaixo do Escopo do feedback.	Experimente Equilibrado ou Detalhado. Consulte Escopo do feedback.
O arquivo está marcado como linguist-generated no `.gitattributes`.	Remova o atributo. Consulte O que o HeyDeer lê.
A regra não pode ser avaliada lendo o código.	Reescreva-a como algo visível no diff. Consulte Como escrever verificações eficazes.

Erros de servidor MCP

O formulário explica cada valor rejeitado; consulte Servidores MCP. Depois de alterar um endpoint, informe um novo token ou remova o salvo. Apenas administradores do espaço de trabalho que são proprietários da organização ou da conta no GitHub podem gerenciar servidores.

Login e acesso ao GitHub

Causa provável	O que fazer
Seu login no GitHub expirou, e o HeyDeer mostra Entrar com GitHub.	Selecione essa opção para entrar novamente e voltar à mesma página.
Você está conectado com uma conta do GitHub que não consegue ver a revisão ou a organização.	Selecione Continuar com GitHub ou Autorizar GitHub novamente e depois escolha a conta certa no GitHub.
Uma organização ou um repositório não aparece quando você se conecta.	Em Não encontra uma organização ou repositório?, confira a instalação, entre pelo SSO no GitHub se necessário e depois selecione Autorizar GitHub novamente. Consulte App do GitHub e permissões.

Problemas de cobrança

Causa provável	O que fazer
O cartão foi recusado, ou seu banco pediu para verificar o pagamento.	Para um pagamento da assinatura, selecione Concluir pagamento em Uso e cobrança → Visão geral. Para outras compras, use outro cartão.
Adicionar créditos informa que você precisa de um plano.	Escolha um plano primeiro, ou selecione Concluir pagamento se Visão geral mostrar essa opção. Consulte Planos e créditos adicionais.
A recarga automática está Desativada, com um motivo abaixo.	Corrija a causa e depois ative-a novamente. Consulte Quando uma recarga falha.
O pagamento da renovação está pendente.	Enquanto isso, seu plano continua ativo. Se o pagamento falhou ou precisa da confirmação do seu banco, o HeyDeer envia um e-mail ao espaço de trabalho; selecione Concluir pagamento.
Adicionar créditos ou a recarga automática informa que o limite de 24 horas foi atingido.	Aguarde até haver saldo disponível no limite de compras das últimas 24 horas, ou entre em contato com o suporte.
Os pagamentos e as novas revisões pagas estão pausados.	O HeyDeer está resolvendo um problema de cobrança com o espaço de trabalho. Entre em contato com o suporte.
Um pagamento ainda está em processamento, ou Adicionar créditos pede que você confira uma compra anterior.	Selecione Conferir compra até que ela mostre o resultado. Não inicie outra compra.