Guías

Actualizaciones y solución de problemas

Mantenga YeePilot al día y resuelva problemas comunes de proveedor, modelo, sandbox, Vault, configuración y soporte.

Última actualización: 21 de junio de 2026

Actualizar YeePilot

Para actualizar manualmente:

bash
yeepilot update --check      # comprobar disponibilidad
yeepilot update              # instalar la version disponible
yeepilot update --force      # reinstalar si hace falta
yeepilot update --rollback   # volver a la version anterior

Para ver el estado general:

bash
yeepilot status

YeePilot verifica las actualizaciones públicas antes de reemplazar el binario instalado. Si la verificación falla, la actualización no se aplica y YeePilot intenta conservar o restaurar la versión anterior.

Al iniciar, YeePilot puede mostrar un aviso si hay una versión más nueva para su canal. La instalación sigue siendo una acción explícita con yeepilot update.

Canales de actualización

Los canales habituales son:

  • public
  • canary

Puede configurarlos en ~/.yeepilot/config.yml o con variables de entorno:

  • YEEPILOT_UPDATE_CHANNEL
  • YEEPILOT_UPDATE_CHANNEL_TOKEN

Ajustes de actualización

La sección update suele incluir:

  • auto_check
  • check_interval_hours
  • channel
  • channel_token

Diagnósticos

Comandos útiles:

bash
yeepilot diagnostics pending
yeepilot diagnostics report-last
yeepilot diagnostics report-last --context "vault unlock issue"

Support report

Cuando necesite enviar contexto de soporte:

bash
yeepilot support report --message "describe el problema"

Puede añadir también --title, --context, --severity y --include-debug-log.

Problemas comunes

Login o logout de plataforma

Para rehacer la autenticación de la plataforma:

bash
yeepilot setup --auth
yeepilot logout

yeepilot logout y, en el cliente interactivo, /logout solo cierran la sesión de la plataforma YeePilot. Las claves de proveedores y las entradas del vault se gestionan por separado.

El proveedor o modelo no funciona

Revise:

  • proveedor activo
  • modelo configurado
  • credenciales
  • disponibilidad del proveedor

La sandbox bloquea demasiado

Compruebe la sección sandbox en config.yml, especialmente:

  • enabled
  • network_access
  • max_cpu_seconds
  • max_memory_mb
  • denied_paths

El Vault no desbloquea

Compruebe:

  • método principal activo
  • estado de bloqueo en el HUD
  • recovery key si perdió el método habitual

La configuración parece rota

Primero haga copia del archivo actual y luego vuelva a ejecutar:

bash
yeepilot setup

Si quiere regenerar desde cero, mueva temporalmente ~/.yeepilot/config.yml fuera del directorio y ejecute el asistente de nuevo.

Después de un fallo

El orden recomendado es:

  1. yeepilot status
  2. revisar Settings y Audit en el HUD
  3. yeepilot diagnostics pending
  4. yeepilot diagnostics report-last
  5. yeepilot support report --message "..."
Anterior

Mejores practicas

Guides