Referencia

Solución de problemas

Busca el síntoma y revisa sus causas probables en orden.

Un pull request no se revisó automáticamente

La comprobación HeyDeer Review del último commit indica el motivo, con el título Review skipped o, con “Marcar la comprobación como fallida si se detectan problemas” activado, Review required. ¿No hay comprobación? Consulta No aparece la comprobación HeyDeer Review.

Causa probable	Qué hacer
La frecuencia de revisión es “Solo manual”, la predeterminada en los espacios de trabajo nuevos.	Elige “Una vez por PR” o “En cada push”. Consulta Revisiones automáticas.
El pull request no coincide con tus Filtros de revisión automática, que de forma predeterminada omiten los borradores y los forks.	Márcalo como listo, cambia los filtros o comenta `@heydeer review`.
Las revisiones automáticas están en pausa en este pull request.	Comenta `@heydeer resume`.
“Una vez por PR” ya inició una revisión, o hay una todavía en cola o en curso; o el pull request alcanzó “Máximo de revisiones automáticas por PR”.	Comenta `@heydeer review`.
El espacio de trabajo se quedó sin créditos o alcanzó su límite de uso.	Añade créditos o aumenta el límite en Control de gastos y luego solicita una nueva revisión. Consulta Recarga automática y límites de uso.
Durante la prueba, el repositorio ya había tenido una prueba en otro espacio de trabajo.	Elige un plan y luego solicita una revisión.
La GitHub App no puede acceder al repositorio.	Revisa Configuración de la organización → Conexión con GitHub. Consulta GitHub App y permisos.
HeyDeer espera unos 30 segundos después de un push, o la revisión está en cola (Review queued).	Espera.
El commit ya tiene una revisión; cambiar las etiquetas o reabrir no la repite.	Haz push de un commit nuevo o comenta `@heydeer review`.

La comprobación falló o la revisión no terminó

Título de la comprobación	Causa	Qué hacer
Review found issues that need attention	Se encontraron problemas con “Marcar la comprobación como fallida si se detectan problemas” activado.	Corrige los problemas y haz push, o resuelve los hallazgos.
Review incomplete	No se evaluó una comprobación del repositorio o un hallazgo anterior.	Solicita otra revisión.
Review could not run	La rama base tiene una configuración de `.agents/checks` no válida.	Corrígela y luego solicita una revisión.
Review could not run	La discusión del PR es demasiado grande: más de 200 hilos de revisión, 1.000 comentarios en un hilo o unos 180 KB.	Continúa en un pull request nuevo.
Review could not run	GitHub o HeyDeer no estaban disponibles.	Vuelve a solicitar la revisión.
Review failed, Review timed out	La revisión no se completó. Los fallos por parte de HeyDeer se reembolsan.	Solicita otra revisión.
Review cancelled	Alguien canceló la revisión, se cerró su pull request o un push más reciente la sustituyó (“En cada push”).	Solicita otra revisión.
No reviewable files	Todos los archivos modificados están fuera del alcance, como los archivos generados.	No hay que hacer nada.

Todas las conclusiones se enumeran en La comprobación HeyDeer Review.

No aparece la comprobación HeyDeer Review

Causa probable	Qué hacer
“Publicar comprobación de GitHub” está desactivada en el repositorio.	Actívala. Consulta Publicación de resultados.
El repositorio está en “Solo manual” y nunca se ha revisado.	Solicita una revisión. Las versiones posteriores recibirán una comprobación.
La GitHub App no tiene Checks: lectura y escritura, o el repositorio no está en su instalación.	Aprueba el permiso o añade el repositorio en GitHub.
El pull request está cerrado.	Reábrelo.

Un comando no recibió respuesta o dio un error

Causa probable	Qué hacer
Sin respuesta: el comentario contiene algo más que el comando, el comando se añadió al editar o lo publicó un bot.	Publica un comentario nuevo que contenga solo el comando, desde una cuenta personal.
Sin respuesta: la GitHub App no tiene el permiso de lectura de Issues.	Apruébalo en GitHub.
No tienes acceso de escritura o no estás en “Quién puede iniciar revisiones manuales”.	Pídeselo a un administrador o a alguien que tenga acceso.
Demasiadas solicitudes, o la cola de revisiones está llena.	Espera y vuelve a publicar el comando.
`pause` o `resume` en un pull request cerrado.	Solo funcionan en pull requests abiertos.
No hay créditos suficientes o se alcanzó el límite de uso.	Añade créditos o aumenta el límite y vuelve a publicar el comando.
GitHub no estaba disponible.	Vuelve a publicar el comando en un comentario nuevo.

HeyDeer no responde preguntas. Consulta Comandos en comentarios de PR.

La revisión muestra una advertencia

Cada advertencia desactiva la aprobación automática para esa revisión.

Advertencia	Qué hacer
Coincidieron más de 10 comprobaciones; solo se ejecutaron las 10 primeras por nombre de archivo.	Acota los patrones o cambia el nombre de los archivos. Consulta Comprobaciones del repositorio.
El pull request cambia `.agents/` y la nueva configuración de comprobaciones no es válida.	Corrígela antes de fusionar o se detendrán las revisiones en esa rama.
Se omitieron hallazgos con menor grado de confianza; una revisión conserva como máximo 30.	Atiende los hallazgos mostrados y luego solicita otra revisión.
Algunos hallazgos o evaluaciones de hilos estaban incompletos.	Solicita otra revisión.

Una regla o comprobación parece ignorada

Causa probable	Qué hacer
La comprobación cambió en este pull request; HeyDeer lee la versión de la rama base.	Fusiona antes el cambio.
Los patrones de la comprobación no coinciden con ningún archivo modificado, o el archivo no es un archivo .md situado directamente en `.agents/checks/`.	Corrige los patrones o mueve el archivo. Consulta Comprobaciones del repositorio.
La regla de AGENTS.md está en un directorio que no cubre los archivos modificados.	Muévela. Consulta AGENTS.md.
Las instrucciones se guardaron después de solicitar la revisión, o las instrucciones del repositorio las anulan.	Solicita otra revisión o resuelve el conflicto. Consulta Instrucciones de revisión.
El hallazgo quedó fuera del Alcance de los comentarios.	Prueba con Equilibrado o Detallado. Consulta Alcance de los comentarios.
El archivo está marcado como linguist-generated en `.gitattributes`.	Quita el atributo. Consulta Qué lee HeyDeer.
La regla no se puede evaluar leyendo el código.	Reescríbela como algo visible en el diff. Consulta Cómo escribir comprobaciones eficaces.

Errores de servidores MCP

El formulario explica cada valor rechazado; consulta Servidores MCP. Después de cambiar un punto final, introduce un token nuevo o elimina el guardado. Solo los administradores del espacio de trabajo que son propietarios de la organización o la cuenta de GitHub pueden gestionar servidores.

Inicio de sesión y acceso a GitHub

Causa probable	Qué hacer
Tu sesión de GitHub caducó y HeyDeer muestra Iniciar sesión con GitHub.	Selecciónalo para volver a iniciar sesión y regresar a la misma página.
Iniciaste sesión con una cuenta de GitHub que no puede ver la revisión o la organización.	Selecciona Continuar con GitHub o Volver a autorizar GitHub y luego elige la cuenta correcta en GitHub.
Falta una organización o un repositorio al conectar.	En ¿Falta una organización o un repositorio?, revisa la instalación, inicia sesión mediante SSO en GitHub si es necesario y luego selecciona Volver a autorizar GitHub. Consulta GitHub App y permisos.

Problemas de facturación

Causa probable	Qué hacer
La tarjeta fue rechazada o tu banco pidió verificar el pago.	Para un pago de la suscripción, selecciona Completar pago en Uso y facturación → Resumen. Para otras compras, usa otra tarjeta.
Agregar créditos indica que necesitas un plan.	Elige primero un plan, o selecciona Completar pago si aparece en Resumen. Consulta Planes y créditos adicionales.
La recarga automática está Desactivada, con un motivo debajo.	Corrige la causa y vuelve a activarla. Consulta Cuando falla una recarga.
Pago de renovación pendiente.	Mientras tanto, tu plan sigue activo. Si el pago falló o necesita la confirmación de tu banco, HeyDeer envía un correo al espacio de trabajo; selecciona Completar pago.
Agregar créditos o la recarga automática indica que se alcanzó el límite de 24 horas.	Espera a que haya margen en el límite de compras de las últimas 24 horas o contacta con soporte.
Los pagos y las nuevas revisiones de pago están pausados.	HeyDeer está resolviendo un problema de facturación con el espacio de trabajo. Contacta con soporte.
Un pago sigue procesándose, o Agregar créditos te pide comprobar una compra anterior.	Selecciona Comprobar compra hasta que muestre el resultado. No inicies otra compra.