Lars/mindnet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 21 Wiki Activity
c741cc7d1b
mindnet/docs/user_guide.md
Lars 5bf91d51da Dokumentation WP11
2025-12-11 16:58:23 +01:00

7.5 KiB
Raw Blame History

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.