108 lines
5.2 KiB
Markdown
108 lines
5.2 KiB
Markdown
# 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). |