Manual de Usuario

manualv1.11.1

Manual d'usuari de la plataforma: rols, funcionalitats, plugins i guies pas a pas

Inclòs a Bàsic i MAXDatos y ConocimientomanualayudadocumentaciónguíasoporteNAiOS Team

Funcions

Versió

1.11.1

Llicència

MIT

Serveis

—

Descripció

Centre d'ajuda integrat a NAiOS. Explica com funciona la plataforma des de zero: primers passos, la interfície del xat i les seves modes (xat, imatge, veu, vídeo, música), rols i permisos, plans i límits, Knowledge Base, Projectes, Connectors, Agents i el catàleg de plugins instal·lats. El contingut s'adapta al rol de qui el llegeix i es manté en fitxers Markdown editables.

Funcionalitats (5)

Guia completa

Tot el que necessites saber per fer servir la plataforma, pas a pas

Adaptat al teu rol

Mostra només les seccions rellevants segons els teus permisos

Cercador integrat

Troba qualsevol tema a l'instant

Catàleg de plugins

Descripció de cada plugin instal·lat, sempre actualitzada

Guies per plugin

Cada plugin pot incloure la seva pròpia guia d'usuari (docs/guide.md) que apareix automàticament al manual

Changelog

v1.11.02026-08-29

Ajuda en àudio: si el plugin naios-manual-audio està actiu i té locucions generades, cada capítol i cada guia mostren un reproductor «Escoltar aquesta pàgina» (amb velocitat 1×/1,25×/1,5× i avís si el text va canviar després de gravar-se)
Nou seam helpPieces(): exposa capítols i guies (amb el seu minRole i el seu markdown) perquè el plugin de locucions construeixi el seu catàleg sense duplicar el descobriment

v1.10.42026-08-05

L'índex agrupa els epígrafs dels apèndixs sota la seva capçalera (Només administració / Només superadministració) en lloc de barrejar-los amb els de la guia d'usuari
El ressaltat de l'índex segueix el scroll de veritat: ara marca també els subpunts (H3) i no només els títols grans, i acompanya amb el seu propi scroll quan l'epígraf actiu queda fora de vista
Corregit de soca-rel: els listeners de scroll penjaven de window però en aquesta pàgina qui fa scroll és <body>, així que ni la barra de progrés ni el ressaltat es movien mai

v1.10.32026-08-05

Els apèndixs d'administració i de superadministració surten PLEGATS: qui obre una guia arriba a la d'usuari, i l'índex deixa de omplir-se d'epígrafs interns. Es desplegen amb un clic al seu bàner, i si saltes a un des de l'índex s'obre sol
El peu i la navegació Anterior/Següent tornen a la columna del text: en ocupar també la de l'índex, el botó Següent apareixia trepitjat pels epígrafs de la dreta
Índex més compacte entre línies i amb aire al final, perquè es vegin els últims elements

v1.10.22026-08-05

L'índex «A aquesta pàgina» fa scroll propi quan la guia té molts epígrafs: abans la cua quedava inabastable sota la vora de la finestra i es trepitjava amb el peu i el botó Següent (gotcha de la casa: el core aplica body{zoom:1.25} a ≥1100px i 100vh NO es redueix amb el zoom, així que el límit s'ha de dividir entre 1.25)

v1.10.02026-08-05

Bàner de frontera de rol a les guies: on acaba el que veuen els usuaris apareix «Només administració», i a partir d'allà l'apèndix admin. Abans només hi havia una línia horizontal i un admin no podia saber quina part veu la seva gent
Nou nivell superadmin.md a les guies de plugin: apèndixs d'operació de la plataforma (motor, claus, variables d'entorn) que els administradors d'instància ja no veuen; primer ús a la guia de Remote
L'exportació (.md i KB personal) respecta el rol real de qui exporta: un admin ja no arrossega els apèndixs de superadmin

v1.9.02026-07-26

El peu i la navegació anterior/següent ocupen tot l'ample: abans vivien dins la columna del text i quedaven arraconats mentre al costat sobrava espai
L'índex «A aquesta pàgina» passa a desplegable a l'ample molt abans (1530px de viewport en lloc de 900): amb el zoom 1.25 de l'app encara li robava una columna al contingut en pantalles grans
Els botons Anterior/Següent mostren el títol en dues línies en lloc de retallar-lo a una lletra

v1.8.02026-07-26

Tornada al mòdul des de la seva guia: botó «Tornar a <mòdul>» que torna a la pàgina exacta de la qual vas sortir (via ?from= sanejat), o «Obrir <mòdul>» si hi vas arribar per un altre camí. Només si l'usuari té aquest mòdul actiu
El botó es recalcula en navegar entre guies sense recarregar

v1.7.22026-07-17

Previsualització mòbil: amplada per defecte ampliada a 480px i marc tipus simulador de dispositiu (bisell arrodonit amb notch)
Panell «A aquesta pàgina» mobile-friendly: a la previsualització mòbil i en pantalles estretes passa a desplegable compacte sobre el contingut (abans en mòbil s'amagava)

v1.7.12026-07-17

Previsualització en amplada mòbil redimensionable: nansa d'arrossegament a la vora dreta amb amplada mínima de 320px, doble clic per restablir i amplada recordada entre sessions

v1.7.02026-07-17

Intro de pàgina: portada a pantalla completa opcional per secció amb fons d'imatge o vídeo, títol centrat, frase de benvinguda i chevron animat 'fes clic o desplaça't'
Fons elegible des de la galeria del manual o el KB (imatge i vídeo barrejats al selector); sense fons propi usa la portada de la secció o un degradat de marca
Configuració i previsualització en viu des de Gestionar; els fons en ús queden protegits davant l'esborrat a la galeria

v1.6.02026-07-17

Galeria de mitjans pròpia del manual: tot el que es puja, es genera amb IA o es porta del KB queda registrat (amb origen) i és reutilitzable en qualsevol secció
Selector amb dues pestanyes: Galeria del manual i La meva Knowledge Base
Pujada directa de vídeo (mp4/webm ≤60MB) des del calaix
Deduplicació per contingut (hash): pujar dues vegades el mateix no duplica el fitxer
Esborrat des de la galeria amb bloqueig si l'element està en ús per alguna secció

v1.5.02026-07-17

Cercador en finestra emergent (command palette): Ctrl+K, resultats agrupats per seccions i guies, ressaltat de coincidències i navegació amb teclat
Calaix Gestionar redissenyat com a columna integrada (corregeix el tall inferior amb el zoom de l'app) amb selector del contingut a editar
Portada i vídeo des de la galeria multimèdia del Knowledge Base (el fitxer es copia al manual i queda visible per a tothom)
Personalització per secció: títol i icona propis (presentació, sense tocar el contingut docs-as-code)
Cache-busting d'assets per versió del plugin

v1.4.02026-07-17

Mode Gestionar (admin/superadmin): calaix de presentació per secció amb previsualització en viu sobre la pàgina real
Portada per secció: pujada o generada amb IA, mostrada com a hero sota el títol
Vídeo incrustat (YouTube/Vimeo/mp4) amb validació i previsualització immediata
Nota de l'administrador en markdown (entra també a l'exportació i al corpus d'ajuda global)
Amagar seccions als usuaris i ordre manual; previsualització en amplada mòbil
El text de les guies segueix sent docs-as-code: la UI només gestiona la presentació (overlay per instància)

v1.3.02026-07-17

Exportació restringida a admin i superadmin
Ajuda global de plataforma: el superadmin publica el manual com a corpus de sistema de només lectura, injectat al RAG de tots els usuaris (sense còpies per usuari)
Sincronització delta per hash (només el que ha variat) amb barra de progrés i resum del resultat
El corpus global només inclou contingut visible per al rol user (mai admin.md ni guies d'admin)

v1.2.02026-07-17

UI modernitzada: capçalera sticky amb breadcrumb, pre-peu Anterior/Inici/Següent, peu, barra lateral compacta amb marquee i xip d'icona al títol
Filtre de guies per categoria nativa del plugin, amb modal de targetes i icones
Efecte typewriter en títols i H2 en entrar a la pantalla (respecta prefers-reduced-motion)
Exportació: modal de selecció de continguts amb descàrrega .md combinada
Indexació opcional de l'ajuda a la Knowledge Base de l'usuari (carpeta arrel '<Marca> Help', upsert sense duplicats; detecció en runtime del plugin KB)

v1.1.02026-07-17

Guies per plugin autodescobertes: qualsevol plugin amb docs/guide.md apareix com a pàgina pròpia al manual
Secció opcional docs/admin.md visible només per a admin/superadmin
Imatges de guies servides des de docs/assets/ del plugin
El catàleg enllaça a la guia completa quan existeix i el cercador la indexa

v1.0.02026-06-25

Llançament inicial
Manual adaptatiu per rol
Cercador
Catàleg de plugins autogenerat