Manual de Usuario
manualv1.11.0Benutzerhandbuch der Plattform: Rollen, Funktionen, Plugins und Schritt-für-Schritt-Anleitungen
Beschreibung
Integriertes Hilfezentrum in NAiOS. Erklärt, wie die Plattform von Grund auf funktioniert: erste Schritte, die Chat-Oberfläche und ihre Modi (Chat, Bild, Sprache, Video, Musik), Rollen und Berechtigungen, Pläne und Grenzen, Wissensdatenbank, Projekte, Connectoren, Agenten und das Katalog der installierten Plugins. Der Inhalt wird an die Rolle der lesenden Person angepasst und in bearbeitbaren Markdown-Dateien gespeichert.
Funktionen (5)
Alles, was Sie wissen müssen, um die Plattform Schritt für Schritt zu nutzen
Zeigt nur die relevanten Abschnitte gemäß Ihren Berechtigungen
Finden Sie jedes Thema sofort
Beschreibung jedes installierten Plugins, stets aktuell
Jedes Plugin kann seine eigene Benutzeranleitung (docs/guide.md) enthalten, die automatisch im Handbuch erscheint
Changelog
- Audiohilfe: Wenn das Plugin naios-manual-audio aktiv ist und Sprachaufnahmen generiert wurden, zeigt jedes Kapitel und jede Anleitung einen Player "Diese Seite anhören" (mit Geschwindigkeiten 1×/1,25×/1,5× und einer Warnung, wenn sich der Text nach der Aufnahme geändert hat)
- Neuer seam helpPieces(): stellt Kapitel und Anleitungen (mit ihrem minRole und ihrem Markdown) zur Verfügung, damit das Sprachplugin sein Katalog ohne Duplizierung des Entdeckens aufbauen kann
- Das Inhaltsverzeichnis gruppiert die Überschriften der Anhänge unter ihrer Überschrift (Nur Verwaltung / Nur Superverwaltung), anstatt sie mit denen der Benutzeranleitung zu vermischen
- Die Hervorhebung des Inhaltsverzeichnisses folgt dem echten Scrollen: jetzt markiert es auch die Unterpunkte (H3) und nicht nur die großen Titel und begleitet mit seinem eigenen Scrollen, wenn der aktive Abschnitt aus dem Sichtfeld gerät
- Grundlegend behoben: Die Scroll-Listener hingen am Fenster, aber auf dieser Seite scrollt <body>, sodass weder die Fortschrittsanzeige noch die Hervorhebung sich jemals bewegten
- Die Anhänge für Verwaltung und Superverwaltung sind ZUSAMMENGEFALTET: Wer eine Anleitung öffnet, kommt zur Benutzeranleitung, und das Inhaltsverzeichnis füllt sich nicht mehr mit internen Überschriften. Sie entfalten sich mit einem Klick auf ihr Banner, und wenn Sie von der Inhaltsübersicht zu einem springen, öffnet es sich automatisch
- Die Fußzeile und die Navigation Vorher/Nächster kehren zur Textspalte zurück: da sie auch die des Inhaltsverzeichnisses einnahmen, war der Button Nächster von den rechten Überschriften überlagert
- Kompakteres Inhaltsverzeichnis zwischen den Zeilen und mit Luft am Ende, damit die letzten Elemente sichtbar sind
- Das Inhaltsverzeichnis "Auf dieser Seite" hat ein eigenes Scrollen, wenn die Anleitung viele Überschriften hat: zuvor war das Ende unerreichbar unter dem Fensterrahmen und überlappte mit der Fußzeile und dem Button Nächster (Hausproblem: der Kern wendet body{zoom:1.25} bei ≥1100px an und 100vh schrumpft NICHT mit dem Zoom, sodass die Obergrenze durch 1.25 geteilt werden muss)
- Banner für Rollen-Grenzen in den Anleitungen: wo das endet, was die Benutzer sehen, erscheint "Nur Verwaltung", und ab da der Anhang Admin. Zuvor gab es nur eine horizontale Linie, und ein Admin konnte nicht wissen, welchen Teil seine Leute sehen
- Neues Level superadmin.md in den Plugin-Anleitungen: Anhänge zur Plattformbetrieb (Motor, Schlüssel, Umgebungsvariablen), die die Instanzadministratoren nicht mehr sehen; erste Verwendung in der Anleitung für Remote
- Der Export (.md und persönliche KB) respektiert die tatsächliche Rolle des Exportierenden: ein Admin zieht die Anhänge des Superadmins nicht mehr mit
- Die Fußzeile und die Navigation vorher/nächster nehmen die gesamte Breite ein: zuvor lebten sie innerhalb der Textspalte und waren eingeengt, während daneben Platz übrig war
- Das Inhaltsverzeichnis "Auf dieser Seite" wird viel früher (1530px Viewport anstelle von 900) zu einem Dropdown: mit dem Zoom 1.25 der App nahm es weiterhin eine Spalte vom Inhalt auf großen Bildschirmen weg
- Die Buttons Vorher/Nächster zeigen den Titel in zwei Zeilen an, anstatt ihn auf einen Buchstaben zu kürzen
- Rückkehr zum Modul von seiner Anleitung: Button "Zurück zu <Modul>" der zur genauen Seite zurückführt, von der Sie ausgegangen sind (über ?from= bereinigt), oder "Öffnen <Modul>", wenn Sie auf anderem Weg angekommen sind. Nur wenn der Benutzer dieses Modul aktiv hat
- Der Button wird beim Navigieren zwischen Anleitungen ohne Neuladen neu berechnet
- Mobile Vorschau: Standardbreite auf 480px erweitert und Rahmen im Gerätesimulator-Stil (abgerundeter Rand mit Notch)
- Panel "Auf dieser Seite" mobilfreundlich: in der mobilen Vorschau und auf schmalen Bildschirmen wird es zu einem kompakten Dropdown über dem Inhalt (zuvor wurde es auf Mobilgeräten ausgeblendet)
- Mobile Vorschau in anpassbarer Breite: Ziehgriff am rechten Rand mit einer Mindestbreite von 320px, Doppelklick zum Zurücksetzen und Breite wird zwischen den Sitzungen gespeichert
- Seitenintro: Vollbild-Cover optional pro Abschnitt mit Hintergrundbild oder -video, zentriertem Titel, Willkommenssatz und animiertem Chevron 'klicken oder scrollen'
- Hintergrund wählbar aus der Galerie des Handbuchs oder der KB (Bild und Video gemischt im Picker); ohne eigenen Hintergrund wird das Cover des Abschnitts oder ein Markenverlauf verwendet
- Einstellungen und Live-Vorschau von Verwalten; die verwendeten Hintergründe sind vor Löschung in der Galerie geschützt
- Eigene Mediengalerie des Handbuchs: Alles, was hochgeladen, mit KI generiert oder aus der KB entnommen wird, wird registriert (mit Ursprung) und kann in jedem Abschnitt wiederverwendet werden
- Picker mit zwei Tabs: Galerie des Handbuchs und Meine Wissensdatenbank
- Direktes Hochladen von Videos (mp4/webm ≤60MB) aus dem Drawer
- Deduplication durch Inhalt (Hash): Zwei Mal dasselbe hochladen dupliziert keine Datei
- Löschen aus der Galerie mit Sperre, wenn das Element in irgendeinem Abschnitt verwendet wird
- Suchfunktion im Popup (Befehlspalette): Ctrl+K, Ergebnisse gruppiert nach Abschnitten und Anleitungen, Hervorhebung von Übereinstimmungen und Navigation mit der Tastatur
- Drawer Verwalten neu gestaltet als integrierte Spalte (behebt den unteren Schnitt mit dem Zoom der App) mit Auswahl des zu bearbeitenden Inhalts
- Cover und Video aus der Multimedia-Galerie der Wissensdatenbank (die Datei wird ins Handbuch kopiert und ist für alle sichtbar)
- Personalisierung pro Abschnitt: eigener Titel und eigenes Icon (Präsentation, ohne den Inhalt docs-as-code zu berühren)
- Cache-Busting von Assets nach Version des Plugins
- Verwalten-Modus (Admin/Superadmin): Drawer der Präsentation pro Abschnitt mit Live-Vorschau über der echten Seite
- Cover pro Abschnitt: Hochgeladen oder mit KI generiert, als Hero unter dem Titel angezeigt
- Eingebettetes Video (YouTube/Vimeo/mp4) mit Validierung und sofortiger Vorschau
- Hinweis des Administrators in Markdown (geht auch in den Export und in das globale Hilfecorpus)
- Abschnitte vor Benutzern verbergen und manuelle Anordnung; Vorschau in mobiler Breite
- Der Text der Anleitungen bleibt docs-as-code: die UI verwaltet nur die Präsentation (Overlay pro Instanz)
- Export nur für Admin und Superadmin eingeschränkt
- Globale Plattformhilfe: Der Superadmin veröffentlicht das Handbuch als Systemkorpus im Nur-Lese-Modus, injiziert in das RAG aller Benutzer (ohne Kopien pro Benutzer)
- Delta-Synchronisation nach Hash (nur das Variierte) mit Fortschrittsanzeige und Ergebniszusammenfassung
- Das globale Korpus enthält nur Inhalte, die für die Rolle Benutzer sichtbar sind (niemals admin.md oder Anleitungen für Admin)
- Modernisierte UI: Sticky Header mit Breadcrumb, Pre-Footer Vorher/Start/Nächster, Footer, kompaktes Sidebar mit Marquee und Chip-Icon im Titel
- Filter von Anleitungen nach nativer Kategorie des Plugins, mit Modal von Karten und Icons
- Schreibmaschinen-Effekt in Titeln und H2 beim Betreten des Bildschirms (respektiert prefers-reduced-motion)
- Export: Modal zur Auswahl von Inhalten mit kombinierter .md-Download
- Optionales Indizieren der Hilfe in der Wissensdatenbank des Benutzers (Stammverzeichnis '<Marke> Hilfe', upsert ohne Duplikate; Runtime-Erkennung des KB-Plugins)
- Automatisch entdeckte Anleitungen pro Plugin: Jedes Plugin mit docs/guide.md erscheint als eigene Seite im Handbuch
- Optionale Sektion docs/admin.md nur für Admin/Superadmin sichtbar
- Bilder von Anleitungen werden aus docs/assets/ des Plugins bereitgestellt
- Der Katalog verlinkt zur vollständigen Anleitung, wenn diese existiert, und die Suche indiziert sie
- Erstveröffentlichung
- Anpassungsfähiges Handbuch nach Rolle
- Suchfunktion
- Automatisch generierter Plugin-Katalog