Lars/mindnet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 21 Wiki Activity
V2.3.1-WP06
mindnet/docs/user_guide.md
Lars 902f26ee95 WP06 Dokumentation
2025-12-09 17:11:03 +01:00

5.2 KiB
Raw Permalink Blame History

Mindnet v2.2 – User Guide

Datei: docs/mindnet_user_guide_v2.2.md Stand: 2025-12-09 Status: FINAL (Inkl. RAG & Multi-Personality Chat) 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)

Seit Version 2.3.1 passt Mindnet 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. 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.

2.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'."

2.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.
  • Beispiel-Dialog:
    • Du: "Ich bin total überfordert, nichts funktioniert."
    • Mindnet: "Das Gefühl kenne ich. Erinnere dich an die Situation im Projekt X ('Der Durchbruch nach der Krise'). Damals hat uns das Mantra 'Einfach weitermachen, der Nebel lichtet sich' geholfen."

2.3 Modus: Coding ("Der Techniker")

  • Auslöser: "Code", "Python", "Funktion", "Syntax".
  • Was passiert: Mindnet antwortet kurz, prägnant und liefert Code-Blöcke. Smalltalk wird reduziert.

2.4 Modus: Fakten (Standard)

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

3. Ergebnisse interpretieren (Explanation Layer)

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

3.1 Die Gründe ("Reasons")

Das System sagt dir in natürlicher Sprache, warum ein Treffer relevant ist:

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

3.2 Der Score Breakdown

Wenn du es genau wissen willst, schau auf die Aufschlüsselung:

Score = (Text) + (Typ-Bonus) + (Vernetzungs-Bonus)

4. 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.

4.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]]

4.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

5. Feedback & Lernen

Mindnet wird schlauer, wenn du es pflegst.

5.1 Feedback geben (Data Flywheel)

Das System zeichnet auf, welche Ergebnisse es liefert. Du kannst Treffer bewerten (geplant für WP-10 UI). In Zukunft analysiert das System diese Daten, um seine Gewichte selbstständig anzupassen (Self-Tuning).

5.2 Ergebnis fehlt? Troubleshooting

Wenn Mindnet etwas nicht findet:

  1. Existiert die Notiz im Vault? (Dateiname korrekt?)
  2. Typ korrekt? (Eine Erfahrung als concept getaggt wird im Empathie-Modus vielleicht übersehen).
  3. Keywords? (Wenn du "grau" sagst, aber in der Notiz nur "schlecht" steht, füge das Wort "grau" zur Notiz hinzu).