Manual de Usuario

manualv1.11.0

Manual de usuario de la plataforma: roles, funcionalidades, plugins y guías paso a paso

Datos y ConocimientomanualayudadocumentaciónguíasoporteNAiOS Team

Funciones

Versión

1.11.0

Licencia

MIT

Servicios

—

Descripción

Centro de ayuda integrado en NAiOS. Explica cómo funciona la plataforma desde cero: primeros pasos, la interfaz del chat y sus modos (chat, imagen, voz, vídeo, música), roles y permisos, planes y límites, Knowledge Base, Proyectos, Conectores, Agentes y el catálogo de plugins instalados. El contenido se adapta al rol de quien lo lee y se mantiene en archivos Markdown editables.

Funcionalidades (5)

Guía completa

Todo lo que necesitas saber para usar la plataforma, paso a paso

Adaptado a tu rol

Muestra solo las secciones relevantes según tus permisos

Buscador integrado

Encuentra cualquier tema al instante

Catálogo de plugins

Descripción de cada plugin instalado, siempre actualizada

Guías por plugin

Cada plugin puede incluir su propia guía de usuario (docs/guide.md) que aparece automáticamente en el manual

Changelog

v1.11.02026-08-29

Ayuda en audio: si el plugin naios-manual-audio está activo y tiene locuciones generadas, cada capítulo y cada guía muestran un reproductor «Escuchar esta página» (con velocidad 1×/1,25×/1,5× y aviso si el texto cambió después de grabarse)
Nuevo seam helpPieces(): expone capítulos y guías (con su minRole y su markdown) para que el plugin de locuciones construya su catálogo sin duplicar el descubrimiento

v1.10.42026-08-05

El índice agrupa los epígrafes de los apéndices bajo su cabecera (Solo administración / Solo superadministración) en vez de mezclarlos con los de la guía de usuario
El resaltado del índice sigue el scroll de verdad: ahora marca también los subpuntos (H3) y no solo los títulos grandes, y acompaña con su propio scroll cuando el epígrafe activo queda fuera de vista
Arreglado de raíz: los listeners de scroll colgaban de window pero en esta página quien scrollea es <body>, así que ni la barra de progreso ni el resaltado se movían nunca

v1.10.32026-08-05

Los apéndices de administración y de superadministración salen PLEGADOS: quien abre una guía viene a lo de usuario, y el índice deja de llenarse de epígrafes internos. Se despliegan con un clic en su banner, y si saltas a uno desde el índice se abre solo
El pie y la navegación Anterior/Siguiente vuelven a la columna del texto: al ocupar también la del índice, el botón Siguiente aparecía pisado por los epígrafes de la derecha
Índice más compacto entre líneas y con aire al final, para que se vean los últimos elementos

v1.10.22026-08-05

El índice «En esta página» hace scroll propio cuando la guía tiene muchos epígrafes: antes la cola quedaba inalcanzable bajo el borde de la ventana y se pisaba con el pie y el botón Siguiente (gotcha de la casa: el core aplica body{zoom:1.25} en ≥1100px y 100vh NO se encoge con el zoom, así que el tope hay que dividirlo entre 1.25)

v1.10.02026-08-05

Banner de frontera de rol en las guías: donde termina lo que ven los usuarios aparece «Solo administración», y a partir de ahí el apéndice admin. Antes solo había una línea horizontal y un admin no podía saber qué parte ve su gente
Nuevo nivel superadmin.md en las guías de plugin: apéndices de operación de la plataforma (motor, claves, variables de entorno) que los administradores de instancia ya no ven; primer uso en la guía de Remote
El export (.md y KB personal) respeta el rol real del que exporta: un admin ya no arrastra los apéndices de superadmin

v1.9.02026-07-26

El pie y la navegación anterior/siguiente ocupan todo el ancho: antes vivían dentro de la columna del texto y quedaban encajonados mientras al lado sobraba sitio
El índice «En esta página» pasa a desplegable a lo ancho mucho antes (1530px de viewport en vez de 900): con el zoom 1.25 de la app seguía robándole una columna al contenido en pantallas grandes
Los botones Anterior/Siguiente muestran el título en dos líneas en vez de recortarlo a una letra

v1.8.02026-07-26

Vuelta al módulo desde su guía: botón «Volver a <módulo>» que devuelve a la página exacta de la que saliste (vía ?from= saneado), o «Abrir <módulo>» si llegaste por otro camino. Solo si el usuario tiene ese módulo activo
El botón se recalcula al navegar entre guías sin recargar

v1.7.22026-07-17

Previsualización móvil: ancho por defecto ampliado a 480px y marco tipo simulador de dispositivo (bisel redondeado con notch)
Panel "En esta página" mobile-friendly: en la previsualización móvil y en pantallas estrechas pasa a desplegable compacto sobre el contenido (antes en móvil se ocultaba)

v1.7.12026-07-17

Previsualización en ancho móvil redimensionable: asa de arrastre en el borde derecho con ancho mínimo de 320px, doble clic para restablecer y ancho recordado entre sesiones

v1.7.02026-07-17

Intro de página: portada a pantalla completa opcional por sección con fondo de imagen o vídeo, título centrado, frase de bienvenida y chevron animado 'haz clic o desplázate'
Fondo elegible desde la galería del manual o el KB (imagen y vídeo mezclados en el picker); sin fondo propio usa la portada de la sección o un degradado de marca
Configuración y preview en vivo desde Gestionar; los fondos en uso quedan protegidos frente a borrado en la galería

v1.6.02026-07-17

Galería de medios propia del manual: todo lo que se sube, se genera con IA o se trae del KB queda registrado (con origen) y es reutilizable en cualquier sección
Picker con dos pestañas: Galería del manual y Mi Knowledge Base
Subida directa de vídeo (mp4/webm ≤60MB) desde el drawer
Deduplicación por contenido (hash): subir dos veces lo mismo no duplica fichero
Borrado desde la galería con bloqueo si el elemento está en uso por alguna sección

v1.5.02026-07-17

Buscador en popup (command palette): Ctrl+K, resultados agrupados por secciones y guías, resaltado de coincidencias y navegación con teclado
Drawer Gestionar rediseñado como columna integrada (arregla el corte inferior con el zoom de la app) con selector del contenido a editar
Portada y vídeo desde la galería multimedia del Knowledge Base (el fichero se copia al manual y queda visible para todos)
Personalización por sección: título e icono propios (presentación, sin tocar el contenido docs-as-code)
Cache-busting de assets por versión del plugin

v1.4.02026-07-17

Modo Gestionar (admin/superadmin): drawer de presentación por sección con preview en vivo sobre la página real
Portada por sección: subida o generada con IA, mostrada como hero bajo el título
Vídeo incrustado (YouTube/Vimeo/mp4) con validación y preview inmediato
Nota del administrador en markdown (entra también al export y al corpus de ayuda global)
Ocultar secciones a los usuarios y orden manual; previsualización en ancho móvil
El texto de las guías sigue siendo docs-as-code: la UI solo gestiona presentación (overlay por instancia)

v1.3.02026-07-17

Exportación restringida a admin y superadmin
Ayuda global de plataforma: el superadmin publica el manual como corpus de sistema de solo lectura, inyectado en el RAG de todos los usuarios (sin copias por usuario)
Sincronización delta por hash (solo lo variado) con barra de progreso y resumen de resultado
El corpus global solo incluye contenido visible para rol user (nunca admin.md ni guías de admin)

v1.2.02026-07-17

UI modernizada: header sticky con breadcrumb, pre-footer Anterior/Inicio/Siguiente, footer, sidebar compacto con marquee y chip de icono en el título
Filtro de guías por categoría nativa del plugin, con modal de cards e iconos
Efecto typewriter en títulos y H2 al entrar en pantalla (respeta prefers-reduced-motion)
Exportación: modal de selección de contenidos con descarga .md combinada
Indexado opcional de la ayuda en la Knowledge Base del usuario (carpeta raíz '<Marca> Help', upsert sin duplicados; detección runtime del plugin KB)

v1.1.02026-07-17

Guías por plugin auto-descubiertas: cualquier plugin con docs/guide.md aparece como página propia en el manual
Sección opcional docs/admin.md visible solo para admin/superadmin
Imágenes de guías servidas desde docs/assets/ del plugin
El catálogo enlaza a la guía completa cuando existe y el buscador la indexa

v1.0.02026-06-25

Lanzamiento inicial
Manual adaptativo por rol
Buscador
Catálogo de plugins auto-generado