Saltar al contenido principal
Empieza por aquí:

La app no llega a su host

La app de escritorio ejecuta su propio host. Si el host se detiene después de estar listo, la app lo reinicia, hasta tres veces en cinco minutos. Si se detiene mientras arranca, la app dice por qué, con Try Again y Show Log.
  • Reinícialo a mano con Archivo → Reiniciar Archetype.
  • Si la app dice El host se reinició. Vuelve a abrir Archetype para reconectar., cierra y abre la app.
  • Un host en un servidor: la app se conecta con el ssh de tu sistema, que debe funcionar desde una terminal sin pedir contraseña. Usa Reconectar (en Archivo o en Gestionar → Ajustes → Servidores). A un servidor más antiguo se le ofrece Actualizar y reconectar. Si aun así no puede conectarse, Usar este ordenador abre el host local.
  • Un teléfono: si dice No se pudo llegar a tu ordenador, comprueba que el ordenador está encendido y que la app o su host se ejecutan allí. Si Archetype dice que un puerto está ocupado, pon otro en phones.port en el archivo de configuración. Consulta Dispositivos.

Los chats, las programaciones o los disparadores no reciben respuesta

Se ejecutan en el servicio en segundo plano, también con la app cerrada.
Si la app dice El servicio en segundo plano está instalado pero no se está ejecutando, así que los chats quedan sin respuesta., pulsa Reiniciarlo. El servicio no recibe el entorno de tu shell. Pon las claves y los tokens en ~/.config/archetype/env, un NAME=value por línea, que solo tú puedas leer (chmod 600): el servicio se niega a arrancar si otros pueden leerlo.

Un inicio de sesión ha caducado

Un servidor MCP falla

Un servidor al que no se puede llegar en un turno se deja fuera de ese turno, y los demás siguen. Un servidor con "disabled": true no se ejecuta. Consulta Servidores MCP.

Un plugin está desactivado o no aparece

  • Revisa Gestionar → Plugins. Borradores y Comidas están desactivados hasta que los activas.
  • Un plugin desactivado en ~/.config/archetype/config.json ("plugins": { "name": false }) sigue desactivado.
  • En el host de una empresa, un administrador elige qué roles ven un plugin y tienen sus herramientas. Si el tuyo no, pídeselo a un administrador. Consulta Alojar una empresa.
  • Música solo funciona en un Mac y necesita que macOS permita a Archetype controlar la app. Consulta Música.

No llegan las notificaciones

  • Abre Gestionar → Mis ajustes → Ajustes de notificaciones. Cada dispositivo indica si las recibe: Desactivado en los ajustes del sistema, Desactivado en este navegador, Bloqueado por este navegador o No accesible dicen por qué no.
  • Actívalas para Archetype en los ajustes del sistema y vuelve a comprobarlo.
  • Las Horas de silencio retienen los avisos, y las Sesiones silenciadas no reciben ninguno.
  • No se muestra un aviso mientras su conversación está en pantalla en una ventana activa.
  • Las menciones, respuestas y decisiones de un equipo siguen las preferencias propias de ese equipo.

Dónde están los logs

Los logs no incluyen los tokens de acceso. Revisa un log por si tiene algo privado antes de enviarlo.

Informar de un problema

Escribe a help@archetype.ing con:
  • qué hiciste, qué esperabas y qué pasó;
  • el ordenador y el sistema, y archetype --version;
  • la salida de archetype --doctor y las líneas del log alrededor del problema;
  • en el caso de una app conectada o un plugin, su nombre.