app-console-keys es el chasis base siempre instalado de os-console. Todos los demás módulos de la consola — correo electrónico, contenido, monitorización de modelos de inferencia y el resto — son cartuchos opcionales que se conectan al marco que define app-console-keys. El módulo es obligatorio: un binario de os-console construido sin él no compilará.

Nota de nomenclatura: "keys" en app-console-keys hace referencia a las teclas de función del teclado — la barra F1 a F12 que navega entre los slots de cartuchos. No hace referencia a claves criptográficas. El emparejamiento criptográfico y la autorización basada en máquina son implementados por system-gateway-mba, un crate separado.

El rasgo Cartridge

app-console-keys define el rasgo Cartridge — la interfaz que debe implementar cada módulo app-console-*. El rasgo es mínimo: un módulo declara qué slot de tecla de función ocupa, qué renderizar cuando ese slot está activo y cómo manejar la entrada del teclado mientras está activo. El chasis gestiona todo lo demás: registro de slots, despacho de entrada, gestión del foco y la barra de estado.

Dado que los cartuchos se compilan directamente en el binario de os-console en lugar de cargarse en tiempo de ejecución, el rasgo es un contrato en tiempo de compilación. Un módulo que no lo implementa produce un error de compilación, no un fallo en tiempo de ejecución.

La barra de navegación de teclas de función

El elemento de interfaz principal gestionado por app-console-keys es la barra horizontal de pestañas de teclas de función en la parte superior de la consola. La barra muestra un slot por cartucho registrado. El slot activo está resaltado; los slots inactivos aparecen en gris cuando no están instalados.

La barra no reordena los slots en tiempo de ejecución. La posición de cada cartucho está fijada en el número de tecla de función que reclama. app-console-input está permanentemente fijado en F12 según SYS-ADR-10.

La barra de estado

La barra de estado de app-console-keys se ejecuta a lo largo de la parte inferior de la consola y es siempre visible, independientemente del slot de cartucho activo. Muestra:

Componente	Contenido
Identidad	Nombre de usuario y tenant establecidos durante la ceremonia de emparejamiento
Estado de autorización	MBA LINK ACTIVE, MBA LINK INACTIVE <razón> o MBA LINK PENDING
Slot activo	Nombre del cartucho enfocado actualmente
Nivel de modelo	Nivel A (local), Nivel B (ráfaga en nube) o Nivel C (API de frontera)
Duración de la sesión	Tiempo transcurrido desde el inicio de la consola

El indicador de nivel refleja la última decisión de enrutamiento tomada por la puerta de enlace de inferencia. No consulta la puerta de enlace continuamente — se actualiza cuando se enruta una solicitud.

Cliente de autorización

app-console-keys mantiene las conexiones de autorización basada en máquina salientes a los servicios os-* emparejados. Cada emparejamiento es independiente: la consola puede mantener un enlace activo con os-totebox mientras el enlace con os-privategit está inactivo.

Cuando un enlace de autorización está inactivo, el cartucho afectado degrada con elegancia. El contenido almacenado en caché localmente sigue siendo accesible; las solicitudes al backend fallan con un estado explícito en lugar de hacerlo silenciosamente. Ningún cartucho hace caer el chasis cuando su backend es inalcanzable.

Configuración

La configuración basada en perfiles se almacena en ~/.config/os-console/config.toml. El archivo de configuración controla a qué servicios de backend intenta emparejarse la consola al inicio, las preferencias de visualización y el puerto del servidor SSH (si la función de servidor SSH está compilada).

Renderización de PDF y soporte gráfico

app-console-keys proporciona la infraestructura gráfica utilizada por los cartuchos que renderizan imágenes o PDFs. Las páginas PDF se renderizan como mapas de bits RGB usando la biblioteca pdfium-render. La ruta de visualización usa el protocolo de gráficos Kitty como camino principal, con la codificación Sixel como alternativa y un mensaje de error para entornos de terminal que no admiten ninguno de los dos.

Véase también

• console-os — descripción general del producto os-console, incluida la superficie de teclas de función y los modos de operación
• os-console-platform — la arquitectura completa de cartuchos y el mapa de teclas de función
• app-console-input — la puerta de entrada obligatoria F12; siempre compilada junto a app-console-keys
• machine-based-auth — el mecanismo de autorización que gestiona el cliente del chasis
• three-ring-architecture — la arquitectura Ring 1/2/3 a la que se conecta el cliente de autorización