Lars/mindnet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 21 Wiki Activity
302e2a3d24
mindnet/docs/user_guide.md
Lars faaa3ef55f dokumentation WP15
2025-12-12 22:54:59 +01:00

7.8 KiB
Raw Blame History

Mindnet v2.4 – User Guide

Datei: docs/mindnet_user_guide_v2.6.md Stand: 2025-12-12 Status: FINAL (Inkl. Smart Edges, Hybrid Router v5 & Healing UI) 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".
  • Neu in v2.6 (Smart Edges): Mindnet zeigt dir präzise Verknüpfungen an, die für den spezifischen Textabschnitt relevant sind, statt pauschal alle Links der Notiz anzuzeigen.

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 v5, der intelligent zwischen Frage und Befehl unterscheidet.

3.1 Frage-Modus (Wissen abrufen)

Sobald du ein Fragezeichen ? benutzt oder Wörter wie "Wer", "Wie", "Was", "Soll ich" verwendest, sucht Mindnet nach Antworten (RAG).

  • Entscheidung ("Soll ich?"): Mindnet lädt deine Werte (type: value) und Ziele (type: goal) in den Kontext und prüft die Fakten dagegen.
    • Beispiel: "Soll ich Tool X nutzen?" -> "Nein, Tool X speichert Daten in den USA. Das verstößt gegen dein Prinzip 'Privacy First' und dein Ziel 'Digitale Autarkie'."
  • Empathie ("Ich fühle..."): Mindnet lädt deine Erfahrungen (type: experience) und Glaubenssätze (type: belief). Es antwortet verständnisvoll und zitiert deine eigenen Lektionen.
    • Beispiel: "Ich bin frustriert." -> "Das erinnert mich an Projekt Y, da ging es uns ähnlich..."

3.2 Befehls-Modus (Wissen erfassen / Interview)

Wenn du keine Frage stellst, sondern eine Absicht äußerst, wechselt Mindnet in den Interview-Modus.

  • Auslöser: "Neues Projekt", "Notiz erstellen", "Ich will etwas festhalten", "Neue Entscheidung dokumentieren".
  • Was passiert: Mindnet sucht nicht im Archiv, sondern öffnet den Draft-Editor.
  • Beispiel: "Neue Erfahrung: Streit am Recyclinghof." -> Das System erstellt sofort eine strukturierte Notiz mit den Feldern "Situation", "Reaktion" und "Learning".

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).
    • Healing UI (v2.5): Falls das LLM Syntax-Fehler gemacht hat (z.B. fehlendes ---), hat der Editor das bereits automatisch repariert.
    • 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: Klicke auf "💾 Speichern". Die Notiz landet sofort im Vault und im Index.

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.