# Mindnet v2.4 – User Guide **Datei:** `docs/mindnet_user_guide_v2.4.md` **Stand:** 2025-12-11 **Status:** **FINAL** (Inkl. RAG, Web-Interface & Interview-Assistent & Intelligence) **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, beim Reflektieren und beim **Erstellen von Inhalten**. --- ## 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 Analyst (INTERVIEW):** Hilft dir, neue Notizen zu entwerfen und strukturiert zu erfassen. --- ## 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 "📝 Manueller Editor". * *Neu in v2.4:* Der manuelle Editor speichert deine Eingaben auch beim Wechseln der Tabs ("State Resurrection"). * **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: Interview ("Der Analyst") Wenn du Wissen festhalten willst, statt zu suchen. * **Auslöser:** "Neues Projekt", "Notiz erstellen", "Ich will etwas festhalten", "Neue Entscheidung dokumentieren". * **Was passiert:** Siehe Kapitel 6.3. --- ## 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` ### 6.3 Der Interview-Assistent (Drafting) Mindnet kann dir helfen, Markdown-Notizen zu schreiben. 1. **Start:** Schreibe im Chat: *"Ich möchte ein neues Projekt 'Apollo' starten, Ziel ist die Mondlandung."* 2. **Generierung:** Mindnet erkennt den Wunsch (`INTERVIEW`), analysiert den Satz und erstellt **sofort** einen Entwurf. 3. **Editor:** Die UI wechselt von der Chat-Blase zu einem **Draft-Editor**. * Du siehst das generierte Frontmatter (`type: project`, `status: draft`). * Du siehst den Body-Text mit Platzhaltern (`[TODO]`), wo Infos fehlten (z.B. Stakeholder). 4. **Finalisierung:** Ergänze die fehlenden Infos direkt im Editor und klicke auf **Download** oder **Kopieren**. 5. **Speichern:** Speichere die Datei in deinen Obsidian Vault. Beim nächsten Import ist sie im System. ### 6.4 Der Intelligence-Workflow (Neu in v2.4) Wenn du Texte 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" automatisch als Alias für "Mindnet (System)". * **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 oder am Ende ein. 4. **Speichern:** Klicke auf "💾 Speichern & Indizieren". Der Text wird sofort in den Vault geschrieben und in Qdrant indiziert.