Manual de Usuario

manualv1.11.1

Manual do utilizador da plataforma: funções, funcionalidades, plugins e guias passo a passo

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

Funções

Versão

1.11.1

Licença

MIT

Serviços

—

Descrição

Centro de ajuda integrado no NAiOS. Explica como funciona a plataforma desde o início: primeiros passos, a interface do chat e os seus modos (chat, imagem, voz, vídeo, música), funções e permissões, planos e limites, Knowledge Base, Projetos, Conectores, Agentes e o catálogo de plugins instalados. O conteúdo adapta-se à função de quem o lê e mantém-se em ficheiros Markdown editáveis.

Funcionalidades (5)

Guia completo

Tudo o que precisa de saber para usar a plataforma, passo a passo

Adaptado à sua função

Mostra apenas as secções relevantes de acordo com as suas permissões

Pesquisa integrada

Encontre qualquer tema instantaneamente

Catálogo de plugins

Descrição de cada plugin instalado, sempre atualizada

Guias por plugin

Cada plugin pode incluir o seu próprio guia de utilizador (docs/guide.md) que aparece automaticamente no manual

Changelog

v1.11.02026-08-29

Ajuda em áudio: se o plugin naios-manual-audio estiver ativo e tiver locuções geradas, cada capítulo e cada guia mostram um leitor «Ouvir esta página» (com velocidade 1×/1,25×/1,5× e aviso se o texto mudou depois de gravado)
Novo seam helpPieces(): expõe capítulos e guias (com o seu minRole e o seu markdown) para que o plugin de locuções construa o seu catálogo sem duplicar a descoberta

v1.10.42026-08-05

O índice agrupa os subtítulos dos apêndices sob o respetivo cabeçalho (Só administração / Só superadministração) em vez de os misturar com os da guia do utilizador
O destaque do índice acompanha o scroll de verdade: agora marca também os subpontos (H3) e não só os títulos grandes, e acompanha com o seu próprio scroll quando o subtítulo ativo fica fora de vista
Corrigido na raiz: os listeners de scroll estavam ligados a window, mas nesta página quem faz scroll é <body>, por isso nem a barra de progresso nem o destaque se moviam

v1.10.32026-08-05

Os apêndices de administração e de superadministração saem RECOLHIDOS: quem abre uma guia vê a parte do utilizador, e o índice deixa de se encher de subtítulos internos. Expandem-se com um clique no seu banner, e se saltar para um a partir do índice abre-se sozinho
O rodapé e a navegação Anterior/Seguinte voltam à coluna do texto: ao ocupar também a do índice, o botão Seguinte ficava sobreposto pelos subtítulos da direita
Índice mais compacto entre linhas e com espaço no fim, para que se vejam os últimos elementos

v1.10.22026-08-05

O índice «Nesta página» tem scroll próprio quando a guia tem muitos subtítulos: antes a cauda ficava inacessível por baixo da borda da janela e sobrepunha-se ao rodapé e ao botão Seguinte (armadilha típica da casa: o core aplica body{zoom:1.25} em ≥1100px e 100vh NÃO encolhe com o zoom, por isso o limite tem de ser dividido por 1.25)

v1.10.02026-08-05

Banner de fronteira de função nas guias: onde termina o que veem os utilizadores aparece «Só administração», e a partir daí começa o apêndice de admin. Antes existia apenas uma linha horizontal e um admin não podia saber que parte vê a sua equipa
Novo nível superadmin.md nas guias de plugin: apêndices de operação da plataforma (motor, chaves, variáveis de ambiente) que os administradores de instância já não veem; primeiro uso na guia do Remote
A exportação (.md e KB pessoal) respeita a função real de quem exporta: um admin já não arrasta os apêndices de superadmin

v1.9.02026-07-26

O rodapé e a navegação anterior/seguinte ocupam toda a largura: antes viviam dentro da coluna do texto e ficavam encaixados enquanto ao lado sobrava espaço
O índice «Nesta página» passa a desdobrável a largura total muito mais cedo (viewport de 1530px em vez de 900): com o zoom 1.25 da app continuava a roubar uma coluna ao conteúdo em ecrãs grandes
Os botões Anterior/Seguinte mostram o título em duas linhas em vez de o cortar a uma só letra

v1.8.02026-07-26

Regresso ao módulo a partir da sua guia: botão «Voltar a <módulo>» que devolve à página exata de onde saiu (via ?from= sanitizado), ou «Abrir <módulo>» se chegou por outro caminho. Só se o utilizador tiver esse módulo ativo
O botão recalcula-se ao navegar entre guias sem recarregar

v1.7.22026-07-17

Pré-visualização móvel: largura por defeito aumentada para 480px e moldura tipo simulador de dispositivo (contorno arredondado com notch)
Painel «Nesta página» compatível com telemóvel: na pré-visualização móvel e em ecrãs estreitos passa a desdobrável compacto sobre o conteúdo (antes, em telemóvel, ficava oculto)

v1.7.12026-07-17

Pré-visualização em largura móvel redimensionável: pega de arrasto na borda direita com largura mínima de 320px, duplo clique para repor e largura memorizada entre sessões

v1.7.02026-07-17

Introdução de página: capa a ecrã inteiro opcional por secção com fundo de imagem ou vídeo, título centrado, frase de boas-vindas e chevron animado «clique ou desloque-se»
Fundo escolhível a partir da galeria do manual ou do KB (imagem e vídeo misturados no seletor); sem fundo próprio usa a capa da secção ou um gradiente de marca
Configuração e pré-visualização em direto a partir de Gerir; os fundos em uso ficam protegidos contra eliminação na galeria

v1.6.02026-07-17

Galeria de média própria do manual: tudo o que se carrega, se gera com IA ou se traz do KB fica registado (com origem) e é reutilizável em qualquer secção
Seletor com dois separadores: Galeria do manual e A Minha Knowledge Base
Carregamento direto de vídeo (mp4/webm ≤60MB) a partir do painel lateral
Deduplicação por conteúdo (hash): carregar duas vezes o mesmo não duplica o ficheiro
Eliminação a partir da galeria, com bloqueio se o elemento estiver em uso por alguma secção

v1.5.02026-07-17

Pesquisa em pop-up (command palette): Ctrl+K, resultados agrupados por secções e guias, destaque das correspondências e navegação por teclado
Painel Gerir redesenhado como coluna integrada (corrige o corte inferior com o zoom da app) com seletor do conteúdo a editar
Capa e vídeo a partir da galeria multimédia do Knowledge Base (o ficheiro é copiado para o manual e fica visível para todos)
Personalização por secção: título e ícone próprios (apresentação, sem tocar no conteúdo docs-as-code)
Cache-busting dos assets por versão do plugin

v1.4.02026-07-17

Modo Gerir (admin/superadmin): painel lateral de apresentação por secção com pré-visualização em direto sobre a página real
Capa por secção: carregada ou gerada com IA, mostrada como hero por baixo do título
Vídeo incorporado (YouTube/Vimeo/mp4) com validação e pré-visualização imediata
Nota do administrador em markdown (entra também na exportação e no corpus de ajuda global)
Ocultar secções aos utilizadores e ordem manual; pré-visualização em largura móvel
O texto das guias continua a ser docs-as-code: a UI apenas gere a apresentação (sobreposição por instância)

v1.3.02026-07-17

Exportação restrita a admin e superadmin
Ajuda global da plataforma: o superadmin publica o manual como corpus de sistema só de leitura, injetado no RAG de todos os utilizadores (sem cópias por utilizador)
Sincronização delta por hash (só o que variou) com barra de progresso e resumo do resultado
O corpus global inclui apenas conteúdo visível para a função user (nunca admin.md nem guias de admin)

v1.2.02026-07-17

UI modernizada: cabeçalho fixo com breadcrumb, pré-rodapé Anterior/Início/Seguinte, rodapé, barra lateral compacta com marquee e chip de ícone no título
Filtro de guias por categoria nativa do plugin, com modal de cartões e ícones
Efeito de máquina de escrever nos títulos e H2 ao entrar no ecrã (respeita prefers-reduced-motion)
Exportação: modal de seleção de conteúdos com descarga .md combinado
Indexação opcional da ajuda na Knowledge Base do utilizador (pasta raiz '<Marca> Help', upsert sem duplicados; deteção em runtime do plugin KB)

v1.1.02026-07-17

Guias por plugin descobertas automaticamente: qualquer plugin com docs/guide.md aparece como página própria no manual
Secção opcional docs/admin.md visível apenas para admin/superadmin
Imagens das guias servidas a partir de docs/assets/ do plugin
O catálogo liga à guia completa quando existe e a pesquisa indexa-a

v1.0.02026-06-25

Lançamento inicial
Manual adaptativo por função
Pesquisa
Catálogo de plugins gerado automaticamente