Lars/mindnet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 21 Wiki Activity
620858a575
mindnet/docs/01_User_Manual/01_chat_usage_guide.md
Lars 620858a575
All checks were successful
Deploy mindnet to llm-node / deploy (push) Successful in 4s
Details
neue Dokumentationstruktur - (QS geprüft)
2025-12-13 18:38:37 +01:00

4.8 KiB
Raw Blame History

doc_type audience scope status version context
user_manual user, mindmaster chat, ui, feedback active 2.6 Anleitung zur Nutzung der Web-Oberfläche, der Chat-Personas und des Feedbacks.

Chat Usage Guide

Quellen: user_guide.md

1. Was Mindnet für dich tut

Mindnet ist ein assoziatives Gedächtnis mit Persönlichkeit. Es unterscheidet sich von einer reinen Suche dadurch, dass es kontextsensitiv agiert.

Das Gedächtnis (Der Graph): Wenn du nach "Projekt Alpha" suchst, findet Mindnet auch:

  • Abhängigkeiten: "Technologie X wird benötigt".
  • Entscheidungen: "Warum nutzen wir X?".
  • Ähnliches: "Projekt Beta war ähnlich".

Der Zwilling (Die Personas): Mindnet passt seinen Charakter an: Mal ist es der neutrale Bibliothekar, mal der strategische Berater, mal der empathische Spiegel.

2. Die Oberfläche (Web UI)

Seit Version 2.3.1 bedienst du Mindnet über eine grafische Oberfläche im Browser.

2.1 Der Chat-Bereich

  • Intent-Badge: Über jeder Antwort siehst du ein Label (z.B. ⚖️ Intent: DECISION).
  • Quellen-Karten: Unter der Antwort findest du ausklappbare Karten ("Expanders").
    • Grüner Punkt: Hohe Relevanz (Score > 0.8).
    • Klick darauf: Zeigt den Textauszug und die Begründung (Explanation Layer).

2.2 Die Sidebar

  • Modus-Wahl: Umschalten zwischen "💬 Chat" und "📝 Manueller Editor".
    • Feature: Der Editor nutzt ein "Resurrection Pattern" – deine Eingaben bleiben erhalten, auch wenn du den Tab wechselst.
  • Settings: Hier kannst du Top-K (Anzahl der Quellen) und Explanation Layer steuern.

3. Den Chat steuern (Intents)

Du steuerst die Persönlichkeit von Mindnet durch deine Wortwahl. Der Hybrid Router v5 unterscheidet intelligent:

3.1 Frage-Modus (Wissen abrufen)

Ausgelöst durch ? oder W-Wörter.

  • Entscheidung ("Soll ich?"): Der Berater.
    • Mindnet lädt deine Werte (type: value) und Ziele (type: goal).
    • Beispiel: "Soll ich Tool X nutzen?" -> "Nein, Tool X speichert Daten in den USA. Das verstößt gegen dein Prinzip 'Privacy First'."
  • Empathie ("Ich fühle..."): Der Spiegel.
    • Mindnet lädt deine Erfahrungen (type: experience).
    • Beispiel: "Ich bin frustriert." -> "Das erinnert mich an Projekt Y, da ging es uns ähnlich..."
  • Fakten ("Was ist?"): Der Bibliothekar.
    • Liefert präzise Definitionen.

3.2 Befehls-Modus (Interview)

Ausgelöst durch Aussagen wie "Neues Projekt", "Ich will festhalten".

  • Was passiert: Mindnet sucht nicht, sondern öffnet den Draft-Editor.
  • Beispiel: "Neue Erfahrung: Streit am Recyclinghof." -> Das System erstellt sofort eine strukturierte Notiz mit den Feldern "Situation", "Reaktion" und "Learning".

4. Ergebnisse interpretieren (Explanation Layer)

Mindnet liefert eine Begründung ("Reasons"), warum es etwas gefunden hat. Öffne eine Quellen-Karte, um zu sehen:

  • "Hohe textuelle Übereinstimmung." (Semantik)
  • "Bevorzugt aufgrund des Typs 'decision'." (Wichtigkeit)
  • "Verweist auf 'Projekt X' via 'depends_on'." (Graph-Kontext)

5. Feedback & Lernen

Mindnet wird schlauer, wenn du es pflegst.

  • Globales Feedback (Sterne): Bewertet die generierte Antwort (Prompting, Tonfall).
  • Granulares Feedback (Smileys): Bewertet die einzelne Quelle.
    • 😞 (Sad): Irrelevant. (Senkt das Gewicht dieser Verbindung).
    • 😀 (Grin): Perfekter Treffer! (Stärkt diesen Typ/Kante).

6. Neues Wissen beisteuern (Authoring & Intelligence)

Mindnet lebt von deinem Input. Du hast drei Wege, Wissen einzugeben:

6.1 Weg A: Der Interview-Assistent (Auto-Drafting)

  1. Start: Schreibe im Chat: "Ich möchte ein neues Projekt 'Apollo' starten."
  2. Generierung: Mindnet erkennt INTERVIEW, wählt das Schema und erstellt einen Entwurf.
  3. Editor: Die UI zeigt den Entwurf (status: draft).
    • Healing UI: Falls das LLM Syntax-Fehler gemacht hat, hat der Editor sie bereits repariert.
  4. Speichern: Klicke auf "💾 Speichern".

6.2 Weg B: Der Intelligence-Workflow

Wenn du im manuellen Editor schreibst, unterstützt dich Mindnet aktiv bei der Vernetzung:

  1. Schreiben: Tippe deinen Text im Tab "✏️ Inhalt".
  2. Analysieren: Wechsle zum Tab "🧠 Intelligence" und klicke auf "🔍 Analyse starten". Das System scannt deinen Text (Vektor-Suche & Exact Match).
  3. Vorschläge nutzen:
    • Exakte Treffer: Das System erkennt Begriffe wie "KI-Gedächtnis" als Alias für "Mindnet".
    • Semantische Treffer: Das System findet inhaltlich verwandte Notizen.
    • Klick auf "➕ Einfügen": Fügt den Link (z.B. [[rel:related_to Mindnet]]) an der Cursor-Position ein.
  4. Speichern: Der Text wird sofort in den Vault geschrieben und indiziert.