docs: README/CLAUDE/ROADMAP auf v8.1-v8.3 aktualisiert

- ROADMAP: v8.1 (Bug-Fixes), v8.2 (UX), v8.3 (Memory Import) als done markiert;
  v8.1-Hermes-SSH -> v8.4, v8.2-opencode -> v8.5 umnummeriert
- CLAUDE.md: Projektstatus + 3 neue Gotchas (system_status-Keys,
  OpenCode .jsonc, ConnectPanel NPM-Proxy)
- README.md: Hermes + Gedächtnis-Features aktualisiert, Download-Links erwähnt

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Hitonabi
2026-06-23 18:32:19 +02:00
parent 6f4f25480a
commit c6fb8210b3
3 changed files with 53 additions and 13 deletions
+10 -1
View File
@@ -113,11 +113,20 @@ Oder über den Self-Update-Button in Mission Control (empfohlen).
- **Piper TTS**: Binary + Stimm-Modell müssen separat installiert werden (nicht via pip). - **Piper TTS**: Binary + Stimm-Modell müssen separat installiert werden (nicht via pip).
- **Whisper**: lädt beim ersten Aufruf ~1.4 GB Modell herunter (einmalig, dann gecacht). - **Whisper**: lädt beim ersten Aufruf ~1.4 GB Modell herunter (einmalig, dann gecacht).
- **Hermes SSH-Key**: muss auf dem Bosgame generiert werden (`~/.ssh/id_ed25519_hermes_agent`). - **Hermes SSH-Key**: muss auf dem Bosgame generiert werden (`~/.ssh/id_ed25519_hermes_agent`).
- **system_status-Keys**: `/api/system/status` liefert verschachtelt (`cpu.percent`, `ram.used` in Bytes) — nicht flach. `hermes_agent.py` muss entsprechend lesen.
- **OpenCode Config**: Datei heißt `opencode.jsonc` (nicht `.json`), Key ist `"providers"` (Plural).
- **ConnectPanel hinter NPM-Proxy**: `location.hostname` zeigt Proxy-Domain → LAN-IP Override im Verbinden-Tab setzen (localStorage).
## Projektstatus ## Projektstatus
**v7 (Memory Layer)**: SQLite-Gedächtnis mit 5 Kategorien + MCP-Server für alle Tools live. **v7 (Memory Layer)**: SQLite-Gedächtnis mit 5 Kategorien + MCP-Server für alle Tools live.
**v8 (Hermes Agent)**: Chat-Agent mit Voice (Whisper STT + Piper TTS), Tool Calling, WebSocket-Streaming live. **v8 (Hermes Agent)**: Chat-Agent mit Voice (Whisper STT + Piper TTS), Tool Calling, WebSocket-Streaming live.
Offene v8-Schritte: Piper-Binary installieren, Windows OpenSSH Server + SSH-Key einrichten. **v8.1 (Bug-Fix)**: system_status-Keys, Model-Routing, asyncio, sudo-PW für Engine-Update, Chat-History in sessionStorage.
**v8.2 (UX)**: Guide-Tabs + Begriffe oben, Mobile Bottom-Nav (≤520px), Download-Links, ConnectPanel-Fixes.
**v8.3 (Memory Import)**: Import aus Cloud-KIs (Claude/Gemini/ChatGPT) — zeilenweiser Batch-POST.
Offene v8-Einrichtungsschritte (kein Code, nur Setup):
- Piper Binary + Kerstin-Stimme installieren (Befehle im Hermes-Tab → ⚙ Setup)
- Windows OpenSSH Server aktivieren + SSH-Key einrichten
**Nordstern:** Den Bosgame nie wieder via SSH/Putty anfassen — 100 % Automatisierung / Klicki-Bunti. **Nordstern:** Den Bosgame nie wieder via SSH/Putty anfassen — 100 % Automatisierung / Klicki-Bunti.
+6 -3
View File
@@ -22,19 +22,22 @@ FastAPI-Backend + Svelte 5-Frontend. Kein Cloud-Zwang, keine Datenbank-Abhängig
- Self-Update-Button (git pull → rsync → restart) - Self-Update-Button (git pull → rsync → restart)
**Verbinden** **Verbinden**
- Copy-Paste-Configs für Cline, OpenCode, Zed, Continue, Jan AI, OpenWebUI - Copy-Paste-Configs für Cline, OpenCode, Zed, Continue, Jan AI, OpenWebUI — inkl. Download-Links
- LAN-IP Override für NPM-Proxy-Setups (localStorage)
- Gedächtnis-MCP: alle Tools teilen dasselbe persistente Gedächtnis - Gedächtnis-MCP: alle Tools teilen dasselbe persistente Gedächtnis
**Gedächtnis** *(v7)* **Gedächtnis** *(v7/v8.3)*
- SQLite-Datenbank mit 5 Kategorien: `user` · `instruction` · `stable` · `versioned` · `ephemeral` - SQLite-Datenbank mit 5 Kategorien: `user` · `instruction` · `stable` · `versioned` · `ephemeral`
- MCP-Server (`mcp_memory.py`): Cline, OpenCode, Claude Code teilen dasselbe Gedächtnis - MCP-Server (`mcp_memory.py`): Cline, OpenCode, Claude Code teilen dasselbe Gedächtnis
- Import aus Cloud-KIs (Claude/Gemini/ChatGPT): zeilenweise einfügen → Batch-POST
- Temporäre Einträge (ephemeral) nach 7 Tagen automatisch gelöscht - Temporäre Einträge (ephemeral) nach 7 Tagen automatisch gelöscht
**Hermes Agent** *(v8)* **Hermes Agent** *(v8)*
- Lokaler KI-Assistent direkt im Browser — Text und Sprache - Lokaler KI-Assistent direkt im Browser — Text und Sprache
- Whisper STT (lokal, ROCm-beschleunigt) + Piper TTS (weibliche Stimme Kerstin) - Whisper STT (lokal, CPU) + Piper TTS (weibliche Stimme Kerstin)
- Tool Calling: Dateien lesen, Befehle ausführen, System abfragen, Web suchen - Tool Calling: Dateien lesen, Befehle ausführen, System abfragen, Web suchen
- Gedächtnis-Integration: Hermes kennt dich und deinen Stack von Anfang an - Gedächtnis-Integration: Hermes kennt dich und deinen Stack von Anfang an
- Chat-History überlebt Browser-Reload · Stopp-Button · Verlauf löschen
- Setup-Wizard für Piper + Windows SSH-Zugriff - Setup-Wizard für Piper + Windows SSH-Zugriff
## Voraussetzungen ## Voraussetzungen
+37 -9
View File
@@ -5,14 +5,42 @@
--- ---
## v8.3 — Memory Import (✅ UMGESETZT & live, Stand 2026-06-23)
- **MemoryPanel**: Import-Button öffnet Formular — Text einfügen, jede Zeile wird ein eigener Eintrag (Batch-POST).
- Quelle wählbar: `claude` · `gemini` · `chatgpt` · `import` · `manual` — Kategorie frei wählbar.
---
## v8.2 — UX & Mobile (✅ UMGESETZT & live, Stand 2026-06-23)
- **GuidesPanel**: "Begriffe kurz erklärt" jetzt ganz oben; Tab-Navigation mit Active-Highlighting + Scroll-to-Group.
- **ConnectPanel**: Download-Links für Zed (`zed.dev`) und Cline (VS Code + JetBrains Marketplace) ergänzt; OpenCode `.jsonc`-Pfad und `"providers"`-Key korrigiert; LAN-IP Override für NPM-Proxy-Setups.
- **Mobile (≤520px)**: Sidebar → Bottom-Navigation; kompaktere Buttons/Padding; Touch-freundliche Mindesthöhen.
---
## v8.1 — Bug-Fix Release (✅ UMGESETZT & live, Stand 2026-06-23)
Alle kritischen Bugs aus dem ersten Bosgame-Praxistest behoben:
- **Hermes system_status**: Key-Mismatch behoben — zeigt jetzt echte CPU/RAM/GPU-Werte statt `?`
- **Model-Routing**: Keyword-Liste erweitert (recherchiere/suche/vergleiche/…); kein Downgrade wenn komplexes Modell bereits geladen
- **HermesPanel**: Chat-History überlebt Browser-Reload (sessionStorage); ⏹ Stopp-Button während Generierung; Verlauf-löschen
- **Engine-Update**: fragt jetzt nach sudo-Passwort (analog OS-Update)
- **asyncio**: `get_event_loop()``get_running_loop()` in Whisper + TTS
- **Guide-Titel**: `&amp;``&` (HTML-Entity in Textknoten war ein Bug)
- `import os` in `routers/maintenance.py` ergänzt (war NameError in `updates()`)
---
## v8 — Hermes Agent / Agentic OS Kern (✅ UMGESETZT & live, Stand 2026-06-23) ## v8 — Hermes Agent / Agentic OS Kern (✅ UMGESETZT & live, Stand 2026-06-23)
**Hermes**: dauerhafter lokaler KI-Assistent auf dem Bosgame. Text + Voice, Tool Calling, Gedächtnis. **Hermes**: dauerhafter lokaler KI-Assistent auf dem Bosgame. Text + Voice, Tool Calling, Gedächtnis.
- **`hermes_agent.py`**: ReAct-Agent mit Tool-Set (read_file, list_dir, run_command, system_status, memory r/w, web_search). Modell-Routing: scout für einfache Tasks, coder für komplexe. - **`hermes_agent.py`**: ReAct-Agent mit Tool-Set (read_file, list_dir, run_command, system_status, memory r/w, web_search). Modell-Routing: scout für einfache Tasks, coder für komplexe.
- **`routers/hermes.py`**: WS `/chat` (streaming), POST `/transcribe` (Whisper STT, CPU), POST `/tts` (Piper TTS, weibliche Stimme Kerstin), GET `/status`, GET `/pubkey`. - **`routers/hermes.py`**: WS `/chat` (streaming), POST `/transcribe` (Whisper STT, CPU), POST `/tts` (Piper TTS, weibliche Stimme Kerstin), GET `/status`, GET `/pubkey`.
- **HermesPanel.svelte**: Chat-UI mit Token-Streaming, Tool-Anzeige, Mikrofon-Button (MediaRecorder), TTS-Wiedergabe, Setup-Wizard (Windows SSH + Piper-Anleitung). - **HermesPanel.svelte**: Chat-UI mit Token-Streaming, Tool-Anzeige, Mikrofon-Button (MediaRecorder), TTS-Wiedergabe, Setup-Wizard.
- **Setup-Wizard**: zeigt Schritt-für-Schritt Einrichtung für Piper + Windows OpenSSH.
**Offene Schritte (nicht Code, sondern Einrichtung):** **Offene Schritte (nicht Code, sondern Einrichtung):**
- [ ] Piper Binary + Kerstin-Stimme auf dem Bosgame installieren (Befehle im Setup-Wizard) - [ ] Piper Binary + Kerstin-Stimme auf dem Bosgame installieren (Befehle im Setup-Wizard)
@@ -52,14 +80,14 @@ Details in Git-History.
## Nächste Features (Vorschläge) ## Nächste Features (Vorschläge)
### v8.1 — Hermes Windows-SSH (Phase C) ### v8.4 — Hermes Windows-SSH
- [ ] Hermes kann Dateien auf Windows-PC lesen/schreiben via paramiko SSH - [ ] Hermes kann Dateien auf Windows-PC lesen/schreiben via paramiko SSH
- [ ] Tool: `read_file_windows(path)`, `write_file_windows(path, content)`, `run_command_windows(cmd)` - [ ] Tool: `read_file_windows(path)`, `write_file_windows(path, content)`, `run_command_windows(cmd)`
- [ ] Hermes updated opencode.json / Zed-Settings automatisch wenn neue Modelle verfügbar - [ ] Hermes updated opencode.jsonc / Zed-Settings automatisch wenn neue Modelle verfügbar
- [ ] Mission Control Setup-Wizard: SSH-Test-Button mit grünem Haken - [ ] Setup-Wizard: SSH-Test-Button mit grünem Haken
### v8.2 — `.well-known/opencode` Remote Config ### v8.5 — `.well-known/opencode` Remote Config
- [ ] `GET /.well-known/opencode` — vollständige, dynamisch generierte OpenCode-Config (provider + models + MCP) - [ ] `GET /.well-known/opencode` — vollständige, dynamisch generierte OpenCode-Config (providers + models + MCP)
- [ ] OpenCode Desktop lädt beim Start automatisch alle Configs von Mission Control - [ ] OpenCode Desktop lädt beim Start automatisch alle Configs von Mission Control
- [ ] Einmalig: `OPENCODE_REMOTE_CONFIG=http://192.168.178.151:9000/.well-known/opencode` setzen - [ ] Einmalig: `OPENCODE_REMOTE_CONFIG=http://192.168.178.151:9000/.well-known/opencode` setzen
@@ -69,11 +97,11 @@ Details in Git-History.
- [ ] Push-Notifications: Hermes meldet sich wenn er fertig ist - [ ] Push-Notifications: Hermes meldet sich wenn er fertig ist
- [ ] Multi-Step-Workflows: "Recherchiere X, schreibe Zusammenfassung, speichere ins Gedächtnis" - [ ] Multi-Step-Workflows: "Recherchiere X, schreibe Zusammenfassung, speichere ins Gedächtnis"
### v9.1 — Guides & Connect aktualisieren ### v9.1 — Guides & Connect weiter verbessern
- [ ] Zed als primäre Editor-Empfehlung (Inline-Completion + Agent, lokal) - [ ] Zed als primäre Editor-Empfehlung (Inline-Completion + Agent, lokal)
- [ ] Antigravity entfernen oder als "Cloud-first, lokal wackelig" markieren - [ ] Antigravity entfernen oder als "Cloud-first, lokal wackelig" markieren
- [ ] Continue als "unsichere Zukunft (Cursor-Akquisition)" markieren - [ ] Continue als "unsichere Zukunft (Cursor-Akquisition)" markieren
- [ ] `.well-known/opencode`-Snippet in Connect-Tab ergänzen - [ ] `.well-known/opencode`-Snippet in Connect-Tab ergänzen (nach v8.5)
### Langfristig ### Langfristig
- [ ] Hermes-Persönlichkeit konfigurierbar (Name, Tonalität) über Gedächtnis `instruction`-Einträge - [ ] Hermes-Persönlichkeit konfigurierbar (Name, Tonalität) über Gedächtnis `instruction`-Einträge