105 lines
5.2 KiB
Markdown
105 lines
5.2 KiB
Markdown
# Mindnet v2.4 – Overview & Einstieg
|
||
**Datei:** `docs/mindnet_overview_v2.6.md`
|
||
**Stand:** 2025-12-12
|
||
**Status:** **FINAL** (Inkl. Smart Edges, Traffic Control & Healing UI)
|
||
**Version:** 2.6.0
|
||
|
||
---
|
||
|
||
## 1. Einführung: Was ist Mindnet?
|
||
|
||
**Mindnet** ist ein persönliches, lokales KI-Gedächtnis. Es ist der Versuch, einen **Digitalen Zwilling** deines Wissens und deiner Persönlichkeit zu erschaffen.
|
||
|
||
Anders als herkömmliche Notiz-Apps (wie Obsidian oder Evernote), die Texte nur passiv speichern, ist Mindnet ein **aktives System**:
|
||
* Es **versteht** Zusammenhänge über einen Wissensgraphen.
|
||
* Es **begründet** Antworten ("Warum ist das so?").
|
||
* Es **unterstützt** beim Schreiben: Es schlägt automatisch Verbindungen zu bestehendem Wissen vor ("Active Intelligence").
|
||
* Es **antwortet** situativ angepasst: Mal als Strategieberater, mal als empathischer Spiegel, und neu: **als Interviewer, der hilft, Wissen zu erfassen.**
|
||
|
||
### Die Vision
|
||
> „Ein System, das nicht nur speichert, was ich weiß, sondern auch wie ich denke, fühle und arbeite.“
|
||
|
||
---
|
||
|
||
## 2. Die drei Ebenen des Systems
|
||
|
||
Mindnet arbeitet auf drei Schichten, die aufeinander aufbauen:
|
||
|
||
### Ebene 1: Content (Das Gedächtnis)
|
||
* **Quelle:** Dein lokaler Obsidian-Vault (Markdown).
|
||
* **Funktion:** Speicherung von Fakten, Projekten und Logs.
|
||
* **Technik:** Async Import-Pipeline, Smart Chunking (LLM-gestützte Kantenzuweisung), Vektor-Datenbank (Qdrant).
|
||
* **Status:** 🟢 Live (WP01–WP03, WP11, WP15).
|
||
|
||
### Ebene 2: Semantik (Das Verstehen)
|
||
* **Funktion:** Verknüpfung von isolierten Notizen zu einem Netzwerk.
|
||
* **Logik:** "Projekt A *hängt ab von* Entscheidung B".
|
||
* **Technik:** Hybrider Retriever (Graph + Nomic Embeddings), Explanation Engine.
|
||
* **Status:** 🟢 Live (WP04, WP11, WP15).
|
||
|
||
### Ebene 3: Identität & Interaktion (Die Persönlichkeit)
|
||
* **Funktion:** Interaktion, Bewertung und Co-Creation.
|
||
* **Logik:**
|
||
* "Ich empfehle Lösung X, weil sie unserem Wert 'Datensparsamkeit' entspricht."
|
||
* "Ich sehe, du willst ein Projekt starten. Lass uns die Eckdaten erfassen."
|
||
* **Technik:**
|
||
* **Hybrid Router v5:** Erkennt Absichten (Frage vs. Befehl) und unterscheidet Objekte (`types.yaml`) von Handlungen (`decision_engine.yaml`).
|
||
* **Traffic Control:** Priorisiert Chat-Anfragen ("Realtime") vor Hintergrund-Jobs ("Background").
|
||
* **One-Shot Extraction:** Generiert Entwürfe für neue Notizen.
|
||
* **Active Intelligence:** Schlägt Links während des Schreibens vor.
|
||
* **Status:** 🟢 Live (WP05–WP07, WP10, WP15).
|
||
|
||
---
|
||
|
||
## 3. End-to-End Architektur
|
||
|
||
Der Datenfluss in Mindnet ist zyklisch ("Data Flywheel"):
|
||
|
||
1. **Input:** Du schreibst Notizen in Obsidian **ODER** lässt sie von Mindnet im Chat entwerfen.
|
||
2. **Intelligence (Live):** Während du schreibst, analysiert Mindnet den Text und schlägt Verknüpfungen vor (Sliding Window Analyse).
|
||
3. **Ingest:** Ein asynchrones Python-Skript importiert und zerlegt die Daten.
|
||
* **Neu (Smart Edges):** Ein LLM analysiert jeden Textabschnitt und entscheidet, welche Kanten relevant sind.
|
||
4. **Intent Recognition:** Der Router analysiert deine Eingabe: Ist es eine Frage (RAG) oder ein Befehl (Interview)?
|
||
5. **Retrieval / Action:**
|
||
* Bei Fragen: Das System sucht Inhalte passend zum Intent.
|
||
* Bei Interviews: Das System wählt das passende Schema (z.B. Projekt-Vorlage).
|
||
6. **Generation:** Ein lokales LLM (Ollama) formuliert die Antwort oder den Markdown-Draft.
|
||
7. **Feedback:** Du bewertest die Antwort. Das System lernt (langfristig) daraus.
|
||
|
||
**Tech-Stack:**
|
||
* **Backend:** Python 3.10+, FastAPI (Async).
|
||
* **Datenbank:** Qdrant (Vektor & Graph, 768 Dim).
|
||
* **KI:** Ollama (Phi-3 Mini für Chat, Nomic für Embeddings) – 100% lokal.
|
||
* **Traffic Control:** Semaphore-Logik zur Lastverteilung zwischen Chat und Import.
|
||
* **Frontend:** Streamlit Web-UI (v2.5) mit Healing Parser.
|
||
|
||
---
|
||
|
||
## 4. Dokumentations-Wegweiser
|
||
|
||
Wo findest du was?
|
||
|
||
| Wenn du... | ...lies dieses Dokument |
|
||
| :--- | :--- |
|
||
| **...wissen willst, wie man Notizen schreibt.** | `mindnet_knowledge_design_manual_v2.6.md` |
|
||
| **...das System installieren oder betreiben musst.** | `mindnet_admin_guide_v2.6.md` |
|
||
| **...am Python-Code entwickeln willst.** | `mindnet_developer_guide_v2.6.md` |
|
||
| **...die Pipeline (Import -> RAG) verstehen willst.** | `mindnet_pipeline_playbook_v2.6.md` |
|
||
| **...die genaue JSON-Struktur oder APIs suchst.** | `mindnet_technical_architecture_v2.6.md` |
|
||
| **...verstehen willst, was fachlich passiert.** | `mindnet_functional_architecture_v2.6.md` |
|
||
| **...den aktuellen Projektstatus suchst.** | `mindnet_appendices_v2.6.md` |
|
||
|
||
---
|
||
|
||
## 5. Rollen im System
|
||
|
||
* **Mindmaster (User/Owner):** Du. Du erstellst Inhalte, stellst Fragen und gibst Feedback. Du definierst die Werte (`type: value`).
|
||
* **Mindnet (Der Agent):** Der digitale Zwilling. Er agiert als pragmatischer, transparenter Assistent und Analyst.
|
||
* **Administrator:** Verantwortlich für Docker-Container, Backups und LLM-Ressourcen.
|
||
|
||
---
|
||
|
||
## 6. Aktueller Fokus
|
||
|
||
Wir haben die **Smart Edge Allocation (WP15)** und die **System-Stabilisierung (Traffic Control)** erfolgreich abgeschlossen.
|
||
Das System kann nun aktiv helfen, Wissen zu strukturieren, ohne dabei unter Last zusammenzubrechen. Der Fokus verschiebt sich nun in Richtung **Conversational Memory (WP17)** und **MCP Integration (WP13)**. |