From c6fb8210b3ea33a82f2b0d27ddc2897b4b0efdab Mon Sep 17 00:00:00 2001 From: Hitonabi Date: Tue, 23 Jun 2026 18:32:19 +0200 Subject: [PATCH] docs: README/CLAUDE/ROADMAP auf v8.1-v8.3 aktualisiert MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- CLAUDE.md | 11 ++++++++++- README.md | 9 ++++++--- ROADMAP.md | 46 +++++++++++++++++++++++++++++++++++++--------- 3 files changed, 53 insertions(+), 13 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 3341841..e327d3f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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). - **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`). +- **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 **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. -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. diff --git a/README.md b/README.md index fa79da9..03e5680 100644 --- a/README.md +++ b/README.md @@ -22,19 +22,22 @@ FastAPI-Backend + Svelte 5-Frontend. Kein Cloud-Zwang, keine Datenbank-Abhängig - Self-Update-Button (git pull → rsync → restart) **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** *(v7)* +**Gedächtnis** *(v7/v8.3)* - SQLite-Datenbank mit 5 Kategorien: `user` · `instruction` · `stable` · `versioned` · `ephemeral` - 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 **Hermes Agent** *(v8)* - 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 - 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 ## Voraussetzungen diff --git a/ROADMAP.md b/ROADMAP.md index 08c536d..0c7c83c 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -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**: `&` → `&` (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) **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. - **`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). -- **Setup-Wizard**: zeigt Schritt-für-Schritt Einrichtung für Piper + Windows OpenSSH. +- **HermesPanel.svelte**: Chat-UI mit Token-Streaming, Tool-Anzeige, Mikrofon-Button (MediaRecorder), TTS-Wiedergabe, Setup-Wizard. **Offene Schritte (nicht Code, sondern Einrichtung):** - [ ] 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) -### v8.1 — Hermes Windows-SSH (Phase C) +### v8.4 — Hermes Windows-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)` -- [ ] Hermes updated opencode.json / Zed-Settings automatisch wenn neue Modelle verfügbar -- [ ] Mission Control Setup-Wizard: SSH-Test-Button mit grünem Haken +- [ ] Hermes updated opencode.jsonc / Zed-Settings automatisch wenn neue Modelle verfügbar +- [ ] Setup-Wizard: SSH-Test-Button mit grünem Haken -### v8.2 — `.well-known/opencode` Remote Config -- [ ] `GET /.well-known/opencode` — vollständige, dynamisch generierte OpenCode-Config (provider + models + MCP) +### v8.5 — `.well-known/opencode` Remote Config +- [ ] `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 - [ ] 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 - [ ] 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) - [ ] Antigravity entfernen oder als "Cloud-first, lokal wackelig" 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 - [ ] Hermes-Persönlichkeit konfigurierbar (Name, Tonalität) über Gedächtnis `instruction`-Einträge