Manual de Usuario
manualv1.11.0User manual of the platform: roles, functionalities, plugins, and step-by-step guides
Description
Integrated help center in NAiOS. Explains how the platform works from scratch: first steps, chat interface and its modes (chat, image, voice, video, music), roles and permissions, plans and limits, Knowledge Base, Projects, Connectors, Agents, and the catalog of installed plugins. The content adapts to the role of the reader and is maintained in editable Markdown files.
Features (5)
Everything you need to know to use the platform, step by step
Shows only the relevant sections according to your permissions
Find any topic instantly
Description of each installed plugin, always updated
Each plugin can include its own user guide (docs/guide.md) that automatically appears in the manual
Changelog
- Audio help: if the plugin naios-manual-audio is active and has generated voiceovers, each chapter and guide shows a 'Listen to this page' player (with speed 1×/1.25×/1.5× and a notice if the text changed after recording)
- New seam helpPieces(): exposes chapters and guides (with their minRole and markdown) so that the voiceover plugin can build its catalog without duplicating discovery
- The index groups the headings of the appendices under their header (Admin only / Superadmin only) instead of mixing them with those of the user guide
- The index highlighting follows the actual scroll: now it also marks subpoints (H3) and not just the big titles, and accompanies with its own scroll when the active heading goes out of view
- Fixed from the root: the scroll listeners were hanging from window but on this page the one scrolling is <body>, so neither the progress bar nor the highlighting ever moved
- The administration and superadministration appendices are COLLAPSED: whoever opens a guide comes to the user section, and the index stops filling up with internal headings. They expand with a click on their banner, and if you jump to one from the index it opens automatically
- The footer and Previous/Next navigation return to the text column: since they also occupied the index column, the Next button appeared overlapped by the headings on the right
- More compact index between lines and with space at the end, so that the last elements are visible
- The 'On this page' index scrolls independently when the guide has many headings: before the tail was unreachable under the window edge and overlapped with the footer and the Next button (house gotcha: the core applies body{zoom:1.25} at ≥1100px and 100vh does NOT shrink with the zoom, so the limit must be divided by 1.25)
- Role border banner in guides: where what users see ends, 'Admin only' appears, and from there the admin appendix. Before there was only a horizontal line and an admin could not know what part their people see
- New superadmin.md level in plugin guides: appendices for platform operation (engine, keys, environment variables) that instance administrators no longer see; first use in the Remote guide
- The export (.md and personal KB) respects the actual role of the exporter: an admin no longer drags the superadmin appendices
- The footer and previous/next navigation occupy the entire width: before they lived within the text column and were boxed in while there was extra space next to them
- The 'On this page' index becomes a dropdown much earlier (1530px viewport instead of 900): with the app's 1.25 zoom it still stole a column from the content on large screens
- The Previous/Next buttons show the title in two lines instead of cutting it to one letter
- Return to the module from its guide: 'Back to <module>' button that returns to the exact page you left (via ?from= sanitized), or 'Open <module>' if you arrived by another path. Only if the user has that module active
- The button recalculates when navigating between guides without reloading
- Mobile preview: default width expanded to 480px and device simulator frame (rounded bezel with notch)
- Panel 'On this page' mobile-friendly: in mobile preview and on narrow screens it becomes a compact dropdown over the content (before it was hidden on mobile)
- Resizable mobile width preview: drag handle on the right edge with a minimum width of 320px, double click to reset and width remembered between sessions
- Page intro: optional full-screen cover per section with image or video background, centered title, welcome phrase, and animated chevron 'click or scroll'
- Background selectable from the manual gallery or the KB (image and video mixed in the picker); without a custom background, it uses the section cover or a brand gradient
- Configuration and live preview from Manage; backgrounds in use are protected from deletion in the gallery
- Manual's own media gallery: everything uploaded, generated with AI, or brought from the KB is recorded (with origin) and reusable in any section
- Picker with two tabs: Manual gallery and My Knowledge Base
- Direct video upload (mp4/webm ≤60MB) from the drawer
- Deduplication by content (hash): uploading the same thing twice does not duplicate the file
- Deletion from the gallery with a lock if the item is in use by any section
- Popup search (command palette): Ctrl+K, results grouped by sections and guides, highlighted matches, and keyboard navigation
- Manage drawer redesigned as an integrated column (fixes the bottom cut with the app's zoom) with selector of the content to edit
- Cover and video from the multimedia gallery of the Knowledge Base (the file is copied to the manual and is visible to everyone)
- Customization by section: own title and icon (presentation, without touching the docs-as-code content)
- Cache-busting of assets by plugin version
- Manage mode (admin/superadmin): presentation drawer by section with live preview over the real page
- Cover by section: uploaded or generated with AI, shown as hero under the title
- Embedded video (YouTube/Vimeo/mp4) with validation and immediate preview
- Admin note in markdown (also enters the export and the global help corpus)
- Hide sections from users and manual order; mobile width preview
- The text of the guides remains docs-as-code: the UI only manages presentation (overlay by instance)
- Export restricted to admin and superadmin
- Global platform help: the superadmin publishes the manual as a read-only system corpus, injected into the RAG of all users (no copies per user)
- Delta synchronization by hash (only the varied) with progress bar and result summary
- The global corpus only includes content visible to user role (never admin.md or admin guides)
- Modernized UI: sticky header with breadcrumb, pre-footer Previous/Home/Next, footer, compact sidebar with marquee and icon chip in the title
- Filter guides by native plugin category, with modal of cards and icons
- Typewriter effect on titles and H2 when entering the screen (respects prefers-reduced-motion)
- Export: content selection modal with combined .md download
- Optional indexing of help in the user's Knowledge Base (root folder '<Brand> Help', upsert without duplicates; runtime detection of the KB plugin)
- Plugin guides auto-discovered: any plugin with docs/guide.md appears as its own page in the manual
- Optional section docs/admin.md visible only to admin/superadmin
- Guide images served from docs/assets/ of the plugin
- The catalog links to the complete guide when it exists and the search engine indexes it
- Initial release
- Role-adaptive manual
- Search engine
- Auto-generated plugin catalog