Lars/mindnet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 21 Wiki Activity
ba57e8b43f
mindnet/docs/user_guide.md
Lars be406d230f Dokumentation WP10
2025-12-10 10:26:44 +01:00

5.6 KiB
Raw Blame History

Mindnet v2.2 – User Guide

Datei: docs/mindnet_user_guide_v2.2.md Stand: 2025-12-10 Status: FINAL (Inkl. RAG & Web-Interface) Quellen: knowledge_design.md, wp04_retriever_scoring.md, Programmplan_V2.2.md, Handbuch.md.

Willkommen bei Mindnet. Dies ist dein persönliches Wissensnetzwerk und dein Digitaler Zwilling. Es hilft dir beim Erinnern, beim Entscheiden und beim Reflektieren.

1. Was Mindnet für dich tut

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

1.1 Das Gedächtnis (Der Graph)

Wenn du nach "Projekt Alpha" suchst, findet Mindnet nicht nur das Dokument. Es findet auch:

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

1.2 Der Zwilling (Die Personas)

Mindnet passt seinen Charakter dynamisch an deine Frage an:

  1. Der Bibliothekar (FACT): Liefert präzise Fakten und Definitionen.
  2. Der Berater (DECISION): Hilft dir beim Abwägen, basierend auf deinen Werten und Zielen.
  3. Der Spiegel (EMPATHY): Hört zu und antwortet basierend auf deinen Erfahrungen ("Ich"-Perspektive).
  4. Der Coder (CODING): Liefert technische Schnipsel ohne Smalltalk.

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

  • Eingabe: Unten findest du das Textfeld.
  • Intent-Badge: Über jeder Antwort zeigt ein kleines Label (z.B. ⚖️ Intent: DECISION), in welchem Modus das System arbeitet und ob dies durch ein Schlüsselwort oder die KI erkannt wurde.
  • Quellen-Karten: Unter der Antwort findest du ausklappbare Karten ("Expanders").
    • Grüner Punkt: Hohe Relevanz (Score > 0.8).
    • Gelber Punkt: Mittlere Relevanz.
    • Klick darauf: Zeigt den Textauszug und die Begründung ("Warum wurde das gefunden?").

2.2 Die Sidebar (Einstellungen & Verlauf)

  • Modus-Wahl: Umschalten zwischen "💬 Chat" und "📝 Neuer Eintrag" (Vorbereitung für WP07).
  • Verlauf: Die letzten Suchanfragen sind hier gelistet. Ein Klick führt die Suche erneut aus.
  • Settings:
    • Top-K: Wie viele Quellen sollen gelesen werden? (Standard: 5).
    • Explanation Layer: Schaltet die "Warum"-Erklärungen an/aus.

3. Den Chat steuern (Intents)

Du steuerst die Persönlichkeit von Mindnet durch deine Wortwahl. Das System nutzt einen Hybrid Router, der sowohl auf Schlüsselwörter als auch auf die Bedeutung achtet.

3.1 Modus: Entscheidung ("Der Berater")

Wenn du vor einer Wahl stehst, hilft Mindnet dir, konform zu deinen Prinzipien zu bleiben.

  • Auslöser (Keywords): "Soll ich...", "Was ist deine Meinung?", "Strategie für...", "Vor- und Nachteile".
  • Was passiert: Mindnet lädt deine Werte (type: value) und Ziele (type: goal) in den Kontext und prüft die Fakten dagegen.
  • Beispiel-Dialog:
    • Du: "Soll ich Tool X nutzen?"
    • Mindnet: "Nein. Tool X speichert Daten in den USA. Das verstößt gegen dein Prinzip 'Privacy First' und dein Ziel 'Digitale Autarkie'."

3.2 Modus: Empathie ("Der Spiegel")

Wenn du frustriert bist oder reflektieren willst, wechselt Mindnet in den "Ich"-Modus.

  • Auslöser (Keywords & Semantik): "Ich fühle mich...", "Traurig", "Gestresst", "Alles ist sinnlos", "Ich bin überfordert".
  • Was passiert: Mindnet lädt deine Erfahrungen (type: experience) und Glaubenssätze (type: belief). Es antwortet verständnisvoll und zitiert deine eigenen Lektionen.

3.3 Modus: Fakten (Standard)

  • Auslöser: Alles andere. "Was ist Qdrant?", "Zusammenfassung von X".
  • Was passiert: Standard-Suche nach Wissen ohne spezielle Filter.

4. Ergebnisse interpretieren (Explanation Layer)

Mindnet liefert nicht einfach nur Treffer. Es liefert eine Begründung (Explanation), warum es etwas gefunden hat.

4.1 Die Gründe ("Reasons")

Ö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. Nutze die Feedback-Funktionen im Chat:

5.1 Globales Feedback (Antwort-Qualität)

  • Wie: Klicke auf die Sterne (1-5) unter der Antwort.
  • Bedeutung: Bewertet, wie gut die generierte Antwort war (Prompting, Tonfall).

5.2 Granulares Feedback (Quellen-Relevanz)

  • Wie: Klicke innerhalb einer Quellen-Karte auf die Smileys (Faces).
  • Bedeutung:
    • 😞 (Sad): Diese Quelle ist irrelevant/falsch. (Senkt zukünftig das Gewicht).
    • 😐 (Neutral): Okay, aber nicht entscheidend.
    • 😀 (Grin): Das ist der perfekte Treffer! (Stärkt diesen Typ/Kante).

6. Neues Wissen beisteuern (Authoring)

Mindnet lebt von deinem Input. Du musst kein Techniker sein, um gutes Wissen zu designen. Siehe dazu das Knowledge Design Manual für Details.

6.1 Die Goldene Regel: "Verlinke semantisch"

Statt einfach nur [[Link]] zu schreiben, versuche zu sagen, wie es zusammenhängt.

  • Hängt es davon ab? -> [[rel:depends_on Ziel]]
  • Ist es ähnlich? -> [[rel:similar_to Ziel]]

6.2 Typen nutzen (Wichtig!)

Setze im Frontmatter deiner Notizen den richtigen Typ. Das ist der wichtigste Hebel für den Chat:

  • Willst du, dass Mindnet etwas als Regel nutzt? -> type: principle
  • Willst du, dass Mindnet dich an eine Lektion erinnert? -> type: experience