Manual de Usuario

manualv1.11.1

Manual de usuario da plataforma: roles, funcionalidades, plugins e guías paso a paso

Incluído en Básico e MAXDatos y ConocimientomanualayudadocumentaciónguíasoporteNAiOS Team

Funcións

Versión

1.11.1

Licenza

MIT

Servizos

—

Descrición

Centro de axuda integrado en NAiOS. Explica como funciona a plataforma desde cero: primeiros pasos, a interface do chat e os seus modos (chat, imaxe, voz, vídeo, música), roles e permisos, plans e límites, Knowledge Base, Proxectos, Conectores, Axentes e o catálogo de plugins instalados. O contido adáptase ao rol de quen o le e mantense en ficheiros Markdown editables.

Funcionalidades (5)

Guía completa

Todo o que precisas saber para usar a plataforma, paso a paso

Adaptado ao teu rol

Mostra só as seccións relevantes segundo os teus permisos

Buscador integrado

Atopa calquera tema ao instante

Catálogo de plugins

Descrición de cada plugin instalado, sempre actualizada

Guías por plugin

Cada plugin pode incluír a súa propia guía de usuario (docs/guide.md) que aparece automaticamente no manual

Changelog

v1.11.02026-08-29

Axuda en audio: se o plugin naios-manual-audio está activo e ten locucións xeneradas, cada capítulo e cada guía mostran un reprodutor «Escoitar esta páxina» (con velocidade 1×/1,25×/1,5× e aviso se o texto cambiou despois de gravarse)
Novo seam helpPieces(): expón capítulos e guías (con o seu minRole e o seu markdown) para que o plugin de locucións constrúa o seu catálogo sen duplicar o descubrimento

v1.10.42026-08-05

O índice agrupa os epígrafes dos apéndices baixo a súa cabeceira (Só administración / Só superadministración) en vez de mesturalos cos da guía de usuario
O realce do índice segue o scroll de verdade: agora marca tamén os subpuntos (H3) e non só os títulos grandes, e acompaña con scroll propio cando o epígrafe activo queda fóra de vista
Arranxado de raíz: os listeners de scroll colgaban de window pero nesta páxina quen scrollea é <body>, así que nin a barra de progreso nin o realce se moveron nunca

v1.10.32026-08-05

Os apéndices de administración e de superadministración saen pregados: quen abre unha guía vén ao de usuario, e o índice deixa de encherse de epígrafes internos. Despréganse cun clic no seu banner, e se saltas a un desde o índice ábrese só
O pé e a navegación Anterior/Seguinte volven á columna do texto: ao ocupar tamén a do índice, o botón Seguinte aparecía pisado polos epígrafes da dereita
Índice máis compacto entre liñas e con aire ao final, para que se vexan os últimos elementos

v1.10.22026-08-05

O índice «Nesta páxina» fai scroll propio cando a guía ten moitos epígrafes: antes a cola quedaba inalcanzable baixo o bordo da xanela e pisábase co pé e o botón Seguinte (trampa da casa: o core aplica body{zoom:1.25} en ≥1100px e 100vh NON se encolle co zoom, así que o tope hai que dividilo entre 1.25)

v1.10.02026-08-05

Banner de fronteira de rol nas guías: onde termina o que ven os usuarios aparece «Só administración», e a partir de aí o apéndice de admin. Antes só había unha liña horizontal e un admin non podía saber que parte ve a súa xente
Novo nivel superadmin.md nas guías de plugin: apéndices de operación da plataforma (motor, claves, variables de contorna) que os administradores de instancia xa non ven; primeiro uso na guía de Remote
O export (.md e KB persoal) respecta o rol real de quen exporta: un admin xa non arrastra os apéndices de superadmin

v1.9.02026-07-26

O pé e a navegación anterior/seguinte ocupan todo o ancho: antes vivían dentro da columna do texto e quedaban encaixonados mentres ao lado sobraba espazo
O índice «Nesta páxina» pasa a despregable a lo ancho moito antes (1530px de viewport en vez de 900): co zoom 1.25 da app seguía roubándolle unha columna ao contido en pantallas grandes
Os botóns Anterior/Seguinte mostran o título en dúas liñas en vez de recortalo a unha letra

v1.8.02026-07-26

Volta ao módulo desde a súa guía: botón «Voltar a <módulo>» que devolve á páxina exacta da que saíches (vía ?from= saneado), ou «Abrir <módulo>» se chegaches por outro camiño. Só se o usuario ten ese módulo activo
O botón recalcúlase ao navegar entre guías sen recargar

v1.7.22026-07-17

Previsualización móbil: ancho por defecto ampliado a 480px e marco tipo simulador de dispositivo (bisel redondeado con notch)
Panel «Nesta páxina» mobile-friendly: na previsualización móbil e en pantallas estreitas pasa a despregable compacto sobre o contido (antes en móbil ocultábase)

v1.7.12026-07-17

Previsualización en ancho móbil redimensionable: asa de arrastre no bordo dereito con ancho mínimo de 320px, dobre clic para restablecer e ancho recordado entre sesións

v1.7.02026-07-17

Intro de páxina: portada a pantalla completa opcional por sección con fondo de imaxe ou vídeo, título centrado, frase de benvida e chevron animado 'fai clic ou desprázate'
Fondo elixible desde a galería do manual ou o KB (imaxe e vídeo mesturados no selector); sen fondo propio usa a portada da sección ou un degradado de marca
Configuración e vista previa en vivo desde Xestionar; os fondos en uso quedan protexidos fronte a borrado na galería

v1.6.02026-07-17

Galería de medios propia do manual: todo o que se sobe, se xera con IA ou se trae do KB queda rexistrado (con orixe) e é reutilizable en calquera sección
Selector con dúas lapelas: Galería do manual e A miña Knowledge Base
Subida directa de vídeo (mp4/webm ≤60MB) desde o panel lateral
Desduplicación por contido (hash): subir dúas veces o mesmo non duplica ficheiro
Borrado desde a galería con bloqueo se o elemento está en uso por algunha sección

v1.5.02026-07-17

Buscador en popup (command palette): Ctrl+K, resultados agrupados por seccións e guías, resaltado de coincidencias e navegación por teclado
Panel Xestionar redeseñado como columna integrada (arranxa o corte inferior co zoom da app) con selector do contido a editar
Portada e vídeo desde a galería multimedia do Knowledge Base (o ficheiro cópiase ao manual e queda visible para todos)
Personalización por sección: título e icona propios (presentación, sen tocar o contido docs-as-code)
Cache-busting de assets por versión do plugin

v1.4.02026-07-17

Modo Xestionar (admin/superadmin): panel de presentación por sección con vista previa en vivo sobre a páxina real
Portada por sección: subida ou xerada con IA, mostrada como hero baixo o título
Vídeo incrustado (YouTube/Vimeo/mp4) con validación e vista previa inmediata
Nota do administrador en markdown (entra tamén no export e no corpus de axuda global)
Ocultar seccións aos usuarios e orde manual; vista previa en ancho móbil
O texto das guías segue sendo docs-as-code: a UI só xestiona presentación (overlay por instancia)

v1.3.02026-07-17

Exportación restrinxida a admin e superadmin
Axuda global de plataforma: o superadmin publica o manual como corpus de sistema de só lectura, inxectado no RAG de todos os usuarios (sen copias por usuario)
Sincronización delta por hash (só o variado) con barra de progreso e resumo do resultado
O corpus global só inclúe contido visible para o rol user (nunca admin.md nin guías de admin)

v1.2.02026-07-17

UI modernizada: cabeceira fixa con breadcrumb, pre-pé Anterior/Inicio/Seguinte, pé, barra lateral compacta con marquee e chip de icona no título
Filtro de guías por categoría nativa do plugin, con modal de tarxetas e iconas
Efecto typewriter en títulos e H2 ao entrar en pantalla (respecta prefers-reduced-motion)
Exportación: modal de selección de contidos con descarga .md combinada
Indexado opcional da axuda na Knowledge Base do usuario (cartafol raíz '<Marca> Help', upsert sen duplicados; detección runtime do plugin KB)

v1.1.02026-07-17

Guías por plugin auto-descubertas: calquera plugin con docs/guide.md aparece como páxina propia no manual
Sección opcional docs/admin.md visible só para admin/superadmin
Imaxes de guías servidas desde docs/assets/ do plugin
O catálogo enlaza á guía completa cando existe e o buscador a indexa

v1.0.02026-06-25

Lanzamento inicial
Manual adaptativo por rol
Buscador
Catálogo de plugins autogenerado