Skip to contentSaltar al contenido
Documentación de Kensa

Soluciona problemas de Kensa

Resuelve problemas frecuentes de instalación, inicio de sesión, proveedor, repositorio, conexión y automatización con acciones siguientes acotadas.

Comienza por el mensaje de estado que muestra Kensa. Este diagnóstico identifica la superficie que falló —instalación, cuenta, proveedor, repositorio, conexión o automatización— sin exponer un token ni un stack trace interno. Corrige un límite a la vez y después vuelve a intentar la acción.

Instalación, actualizaciones e inicio de sesión

  • La app no abre en macOS — sigue el paso de la guía de instalación para eliminar la cuarentena y luego inicia de nuevo la aplicación copiada. No ejecutes un comando copiado desde una fuente no confiable.
  • No aparece o no se descarga una actualización — confirma que puedes acceder a la fuente de lanzamientos con el acceso a GitHub configurado; después reinicia Kensa y vuelve a comprobarlo.
  • No puedes iniciar sesión — confirma que el flujo OAuth se completó en el navegador y luego vuelve a la app de escritorio. Si la sesión ya no es válida, inicia sesión de nuevo en vez de reutilizar un token antiguo.

Problemas de CLI de agente o modelo

  • Falta un proveedor — instala la CLI de ese proveedor, vuelve a abrir la comprobación de requisitos y asegúrate de que el ejecutable esté en tu PATH.
  • Un proveedor está instalado pero no está listo — completa la configuración de autenticación de esa CLI y sigue la indicación de preparación que muestre Kensa.
  • Un modelo no puede ejecutarse — selecciona un modelo disponible actualmente para ese proveedor o elimina la fijación obsoleta. Una elección de modelo para una CLI no es transferible a otra.
  • La revisión falla o se detiene — revisa su atribución de proveedor y modelo, y vuelve a intentarlo sólo después de resolver la condición de autenticación, cuota, red o modelo informada.

Problemas de repositorio y conexión

  • Deep Review no está disponible — configura una ruta válida a un clon local. Deep Review y Deep Review programada necesitan un clon; Quick Review no requiere el mismo checkout local.
  • Un diff local está vacío o no se puede obtener — confirma que la comparación seleccionada tiene cambios, comprueba el acceso remoto y usa el indicador de fetch para reintentar. Consulta Revisa cambios locales.
  • Falla una prueba de integración — vuelve a comprobar los campos de host, correo electrónico y credencial que pide el formulario de conexión; después vuelve a autorizar o reemplaza la conexión. Nunca compartas el token en un mensaje de soporte.

Problemas de automatización

  • Run now no encuentra nada — previsualiza los criterios de PR actuales. Los filtros pueden excluir todos los pull requests abiertos u omitir revisiones ya registradas para esos PR.
  • No puede iniciarse una programación — asegúrate de que el repositorio tenga PR remotos y de que no haya otro lote de revisión automática activo.
  • Se bloquea una ejecución Deep Review programada — agrega un clon local o cambia la programación a Quick Review.
  • No se publicó nada — comprueba si la publicación está habilitada y si las severidades seleccionadas coincidieron con algún hallazgo.

Siguiente paso

Vuelve al inicio de la documentación o revisa Configura revisiones, agentes y skills