Un pull request no se revisó automáticamente
La comprobación HeyDeer Review del último commit indica el motivo. Su título empieza por Revisión omitida, o por Revisión necesaria cuando Marcar la comprobación como fallida si se detectan problemas está activado, seguido del motivo. ¿No hay comprobación? Consulta No aparece la comprobación HeyDeer Review.
Con Publicar comprobación de GitHub desactivado, HeyDeer comenta en el pull request en su lugar, una vez por cada motivo, cuando el pull request alcanza el Máximo de revisiones automáticas por PR o HeyDeer no puede ejecutar la revisión. Estos comentarios solo se publican mientras Publicar comentarios de revisión en el PR está activado.
| Causa probable | Qué hacer |
|---|
| Frecuencia de revisión está en Solo manual. | 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, los forks y las actualizaciones de dependencias. | Márcalo como listo, cambia los filtros o comenta @heydeer review. |
| La revisión está en cola porque no hay capacidad disponible (Revisión en cola). | Espera. |
| “Una vez por PR” ya tiene una revisión completada correctamente, o el pull request alcanzó el “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. | Espera a la próxima asignación de créditos de Free, elige un plan de pago o añade créditos, o aumenta el límite en Uso y facturación → Resumen → Control de gastos. Después, solicita una nueva revisión. Consulta Recarga automática y límites de uso. |
| Las revisiones automáticas están en pausa en este pull request. | Comenta @heydeer resume. |
| El commit ya tiene una revisión; cambiar las etiquetas o reabrir no la repite. | Sube un commit nuevo o comenta @heydeer review. |
| El acceso de HeyDeer a GitHub no incluye el repositorio. | Revisa Configuración del espacio de trabajo → Conexión con GitHub. Consulta GitHub App y permisos. |
| El repositorio está vinculado a créditos gratuitos en otro espacio de trabajo. | Elige un plan y luego solicita una revisión. |
La comprobación falló o la revisión no terminó
| Título de la comprobación | Causa | Qué hacer |
|---|
| La revisión encontró problemas que atender | La revisión informó de hallazgos o problemas anteriores abiertos con Marcar la comprobación como fallida si se detectan problemas activado. | Corrígelos y sube los cambios. Para descartar uno, alguien con acceso de escritura explica la decisión o resuelve la conversación, y después comenta @heydeer review. |
| Revisión cancelada | Alguien canceló la revisión, se cerró su pull request o un push más reciente la sustituyó. | Solicita otra revisión. |
| Revisión incompleta | No se ejecutó una comprobación del repositorio o no se volvió a comprobar un problema anterior. | Solicita otra revisión. |
| La revisión falló / La revisión superó el tiempo límite | La revisión no se completó. HeyDeer devuelve sus créditos, salvo que haya llamado a un conector. | Solicita otra revisión. |
| No se pudo ejecutar la revisión | GitHub o HeyDeer no estaban disponibles. | Vuelve a solicitar la revisión. |
| No hay archivos para revisar | 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.
HeyDeer no aprobó un pull request
Cuando la aprobación automática está activada, la página de la revisión en HeyDeer muestra No se aprobó automáticamente con el motivo. Todos los requisitos están en Aprobación automática.
| Causa probable | Qué hacer |
|---|
| La aprobación automática está desactivada, que es el valor predeterminado. | Activa Aprobación automática en Publicar resultados, dentro de Reglas de revisión. Consulta Activar la aprobación automática. |
| Quedan hallazgos o problemas anteriores. | Corrígelos y sube los cambios, o descártalos. Para aprobar cuando solo quedan hallazgos de gravedad baja, configura Problemas que pueden quedar pendientes en Permitir problemas de gravedad baja. |
| PR que HeyDeer puede aprobar: el nivel de riesgo del pull request supera tu configuración. | Una persona lo aprueba en GitHub; la revisión indica el nivel y el motivo. Para que HeyDeer apruebe esos pull requests, elige un nivel más alto en PR que HeyDeer puede aprobar. |
| Requiere aclaración: HeyDeer tiene una pregunta que el código no puede responder. | Respóndela en un comentario nuevo del PR que incluya @heydeer review. Consulta Añadir el contexto que falta. |
| La revisión tiene notas de la revisión; por ejemplo, no se ejecutó una comprobación del repositorio. | Corrige lo que describe la nota y solicita otra revisión. |
| No se pudieron comprobar por completo los problemas anteriores. | Solicita otra revisión. |
| Publicar comentarios de revisión en el PR está desactivado. | Actívalo. HeyDeer aprueba publicando una revisión. |
Cuando el pull request cambió, es un borrador o lo abrió HeyDeer
| Causa probable | Qué hacer |
|---|
| Se subieron commits nuevos, o la rama base avanzó, después de la revisión. | Solicita o espera una revisión del último commit. |
| El pull request es un borrador. | Márcalo como listo para revisión y solicita una revisión. |
| HeyDeer abrió el pull request; por ejemplo, un PR de corrección. | Tiene que aprobarlo una persona. |
No aparece la comprobación HeyDeer Review
| Causa probable | Qué hacer |
|---|
| El repositorio está en “Solo manual” y nunca se ha revisado. | Solicita una revisión. Las versiones posteriores recibirán una comprobación. |
| Publicar comprobación de GitHub está desactivado en el repositorio. | Actívalo. Consulta Publicación de resultados. |
| HeyDeer no tiene el permiso Checks de lectura y escritura en GitHub, o su acceso a GitHub no incluye el repositorio. | Un propietario de GitHub selecciona Revisar solicitud de permisos o Añadir repositorios en Configuración del espacio de trabajo → Conexión con GitHub. |
| El pull request está cerrado. | Reábrelo. |
Un comando no recibió respuesta o dio un error
| Causa probable | Qué hacer |
|---|
| Sin respuesta ni reacción 👀: el comando está en código, un bloque de cita o un comentario HTML, se añadió al editar o lo publicó un bot. | Publica el comando como texto normal en cualquier parte de un comentario nuevo del PR o de revisión en línea, desde una cuenta personal. |
| No tienes acceso de escritura o no figuras en Acceso a revisiones manuales. | Pídeselo a un administrador o a alguien que tenga acceso. |
| No hay créditos suficientes o se alcanzó el límite de uso. | Elige un plan, añade créditos o aumenta el límite y vuelve a publicar el comando. |
| Demasiadas solicitudes, o la cola de revisiones está llena. | Espera y vuelve a publicar el comando. |
| No aparece la reacción 👀: puede que HeyDeer no tenga el permiso Issues de lectura y escritura para los comentarios de la conversación del PR o el permiso Pull requests de lectura y escritura para los comentarios de revisión en línea. | Un propietario de GitHub selecciona Revisar solicitud de permisos en Configuración del espacio de trabajo → Conexión con GitHub y la aprueba en GitHub. |
pause o resume en un pull request cerrado. | Solo funcionan en pull requests abiertos. |
| GitHub no estaba disponible. | Vuelve a publicar el comando en un comentario nuevo. |
Todos los comandos aparecen en Comandos en comentarios de PR.
Parece que se ignora una convención o una comprobación
| Causa probable | Qué hacer |
|---|
Los patrones de la comprobación no coinciden con ningún archivo modificado, su frontmatter no tiene files o el archivo no es un archivo .md situado directamente en .agents/checks/. | Corrige el frontmatter o los patrones, o mueve el archivo. Consulta Comprobaciones del repositorio. |
| El hallazgo quedaba fuera del alcance de los comentarios. | Prueba con Equilibrado o Detallado. Consulta Alcance de los comentarios. |
| La convención de AGENTS.md está en un directorio que no abarca los archivos modificados. | Muévela. Consulta AGENTS.md. |
| El REVIEW.md está en un directorio que no abarca los archivos modificados. | Muévelo. Consulta REVIEW.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. |
| La comprobación pide algo que HeyDeer no puede verificar leyendo el código. | Reescríbela como una condición que HeyDeer pueda verificar leyendo el código. Consulta Escribir una comprobación eficaz. |
El archivo está marcado como linguist-generated en .gitattributes, o es un archivo de bloqueo que la rama base ya tiene. | Quita el atributo, o marca el archivo de bloqueo con -linguist-generated. Consulta Qué lee HeyDeer. |
La revisión tiene notas de la revisión
HeyDeer enumera en Notas de la revisión lo que limitó una revisión. Cada nota de la revisión desactiva la aprobación automática para esa revisión. Consulta Notas de la revisión.
| Nota de la revisión | Qué hacer |
|---|
| Se omitieron algunos hallazgos | Corrige o descarta los hallazgos mostrados y solicita otra revisión. |
| Coincidieron demasiadas comprobaciones del repositorio | Acota los patrones de archivos de las comprobaciones y solicita otra revisión. Consulta Comprobaciones del repositorio. |
| Algunas comprobaciones del repositorio no son válidas | Corrige las comprobaciones que indica la nota de la revisión y solicita otra revisión. Consulta Comprobaciones del repositorio. |
| No se pudieron completar algunas comprobaciones del repositorio | Solicita otra revisión. |
| No se pudieron evaluar por completo algunos hallazgos o problemas anteriores | Solicita otra revisión. |
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 iniciar sesión en GitHub y elige la cuenta correcta en GitHub. |
| Falta una organización o un repositorio al conectar. | Las organizaciones aparecen cuando HeyDeer está instalado en ellas, así que selecciona Instalar en GitHub o Instalar en otra cuenta y elige la organización en GitHub. Si falta una que tiene HeyDeer, inicia sesión con SSO en GitHub si hace falta, abre ¿No ves tu cuenta? y selecciona Volver a iniciar sesión en 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. |
| Añadir 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 la recarga automática. |
| Pago de renovación pendiente. | Mientras tanto, tu plan sigue activo. Si el pago falló o requiere la confirmación de tu banco, HeyDeer envía un correo al espacio de trabajo; selecciona Completar pago. |
| Un pago aún se está procesando, o Añadir créditos te pide que compruebes una compra anterior. | Selecciona Comprobar compra hasta que muestre el resultado. No inicies otra compra. |
| Añadir créditos o la recarga automática indica que se alcanzó un límite de compras. | Vuelve a intentarlo más tarde o contacta con HeyDeer. |
| 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 HeyDeer. |
Problemas con conectores
Solo los administradores marcados como Propietario de GitHub o Propietario de la cuenta pueden gestionar conectores. Consulta Conectores.
| Causa probable | Qué hacer |
|---|
| HeyDeer no puede cargar las herramientas. | Comprueba que el punto final sea la dirección Streamable HTTP pública del servidor y que los encabezados contengan credenciales válidas. |
| Las revisiones y tareas no usan conectores sin un plan de pago activo. | Los conectores están incluidos en los planes de pago. Elige un plan; los conectores guardados se aplicarán entonces a las nuevas revisiones y tareas. |
| La revisión o tarea empezó antes de que guardaras el conector. | La configuración se aplica a las revisiones y tareas que empiezan después de guardarla. Inicia una nueva. |
| La página de la revisión o tarea muestra un conector como no disponible. | El repositorio es público, o el cambio proviene de un fork o de alguien sin acceso de escritura. Elige También repositorios públicos y forks solo para datos públicos. |
| Una revisión no usó ninguna herramienta de un conector. | Las revisiones solo llaman a herramientas de solo lectura permitidas. Permite una en Herramientas de solo lectura o pide al proveedor del servidor que marque sus herramientas de solo lectura. |
| Una revisión falló después de llamar a un conector. | Sus créditos no se devuelven. Solicita una nueva revisión. |
