From df8d088face1ed2433e4e658019771da49b8e7a0 Mon Sep 17 00:00:00 2001 From: Hitonabi Date: Fri, 4 Sep 2026 16:06:32 +0200 Subject: [PATCH] =?UTF-8?q?doku(raphael):=20Ausroll-Weg=20korrigiert=20?= =?UTF-8?q?=E2=80=94=20Branch=20->=20Ampel=20->=20User-Merge=20->=20deploy?= =?UTF-8?q?.sh,=20nicht=20Auftragsbuch?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Der vorige Commit sprach von Karten annehmen. Befund: die Auftragsbuch-Logik liegt noch im Code und die Box listet Branches als Karten, ist aber seit 02.08. ungenutzt (Kanban-Tools seit 21.08. aus, v3-Umbau lief ueber Branch/Ampel/Merge/deploy.sh, PC-Executor-IP in der Box veraltet). RAPHAEL.md beschreibt jetzt den echten Weg mit Befehlen; OFFENE-FAEDEN traegt die Leiche als Entscheid-Punkt ein. Kein Code geaendert. Co-Authored-By: Claude Fable 5.1 --- docs/wissen/OFFENE-FAEDEN.md | 7 +++++- docs/wissen/RAPHAEL.md | 46 ++++++++++++++++++++++++------------ 2 files changed, 37 insertions(+), 16 deletions(-) diff --git a/docs/wissen/OFFENE-FAEDEN.md b/docs/wissen/OFFENE-FAEDEN.md index 0e58087..4f0bd09 100644 --- a/docs/wissen/OFFENE-FAEDEN.md +++ b/docs/wissen/OFFENE-FAEDEN.md @@ -62,13 +62,18 @@ keine zweite Liste anlegen. Verdikte werden NICHT als „offen" geführt → [VE ## Lucy -- **Raphael-Umbau (04.09.2026) — zwei Karten offen, Reihenfolge zählt:** erst MC2 +- **Raphael-Umbau (04.09.2026) — zwei Branches offen, Reihenfolge zählt (Branch → Ampel → + User-Merge → deploy.sh bzw. `npm run dist`, NICHT übers Auftragsbuch):** erst MC2 `wartung/lucy-stimme-proxy-raphael` (Proxy `/api/lucy/stimme/*`), dann Lucy `feature/raphael-innere-stimme` (HUD-Client, Stimme von der Box). Danach Hand-Schritte auf der Box: `pocket_server.py` nach `~/.lucy-stimme` syncen (OpenAI-Fassade), Hermes-TTS auf `openai` + `base_url http://127.0.0.1:8021/v1` (Telegram spricht dann mit Lucys Stimme), SOUL.md-Ton auf Raphael (nur mit User-Ja). Ohr-Test Box-Stimme vs. lokal mit `lucy_perf=1`. Alles in [RAPHAEL.md](RAPHAEL.md). +- **Auftragsbuch = Leiche im Code (Fund 04.09.2026):** Router/View/Annahme-Skripte liegen noch in + main, die Box listet Branches als Karten, aber letzte Annahme 02.08. (revertiert), Kanban-Tools + seit 21.08. aus, PC-Executor-IP in der Box veraltet (`.98` statt `.22`), STACK.md nennt den Weg + trotzdem „Standard". Entscheid nötig: ausbauen + STACK.md/GRENZEN.md auf den manuellen Weg. - **Nach dem Ohr-Test:** VERDIKTE.md-Einträge „Electron, nicht Tauri" (Begründung Overlay entfällt) und „STT läuft auf der BOX / Stimme lokal" ersetzen; Lucy-Repo-Altlasten (`mini-stimme/`, Kokoro-Notebooks, `Lucy-Startklar.bat` mit totem Pfad) mit User-Ja räumen. diff --git a/docs/wissen/RAPHAEL.md b/docs/wissen/RAPHAEL.md index 69c0fac..5e9d9ff 100644 --- a/docs/wissen/RAPHAEL.md +++ b/docs/wissen/RAPHAEL.md @@ -31,7 +31,7 @@ HUD, unterwegs über Telegram — und spricht überall mit **derselben Stimme**. ## Was gebaut wurde (04.09.2026) -**Lucy-Repo, Branch `feature/raphael-innere-stimme`** (→ Lucy-Karte im Auftragsbuch): +**Lucy-Repo, Branch `feature/raphael-innere-stimme`**: - Renderer auf HUD eingedampft: Kern (Zustand als Licht), gehörter Satz, Antwort als Text, Dock, drei Panels (Meldungen ◉, Zettelkasten ▤, Steuerung ⚙). Bundle 4,4 → 2,5 MB. - Raus: `Avatar3D`, `AuraGlow`, `ContextWindow` (zeigte auf das tote `/api/memory`), `companion/` @@ -45,32 +45,48 @@ HUD, unterwegs über Telegram — und spricht überall mit **derselben Stimme**. `GET /v1/models`; Formate wav/mp3/opus/ogg via ffmpeg) — für Hermes' `openai`-TTS-Provider. - System-Prompt der Desktop-Sitzung im Raphael-Ton (kurzer erster Satz, keine Tags, stumme Tools). -**MC2-Repo, Branch `wartung/lucy-stimme-proxy-raphael`** (→ MC2-Karte): +**MC2-Repo, Branch `wartung/lucy-stimme-proxy-raphael`**: - `config.LUCY_STIMME_URL` (Env `MC_LUCY_STIMME_URL`, Default `http://127.0.0.1:8021`). - `routers/voice.py`: `/api/lucy/stimme/health`, `/tts` (WAV), `/tts/stream` (PCM16-Stream, `X-Sample-Rate` durchgereicht, Upstream schließt bei Client-Abbruch). Kein Frontend-Build nötig. - Diese Doku + Zielbild-Ergänzung. -## Reihenfolge der Annahme (wichtig) +## Reihenfolge des Ausrollens (wichtig) -1. **MC2-Karte zuerst** annehmen (Proxy-Routen). Vorher liefert `/api/lucy/stimme/health` die - SPA-Index-Seite (200, HTML) — die Desktop-Lucy bleibt dann sichtbar in „Stimme wird verbunden …" - mit Hinweis auf den Lokal-Schalter. Nichts geht kaputt, nur stumm. -2. **Lucy-Karte** annehmen (dist-Build + Neustart am PC). Erster Test per Ohr: Latenz Box-Stimme - gegen den alten PC-Pfad (Steuerung → Stimme → „Lokal (PC)" zum Vergleich). Der 21.08.-Wert - „~5 s für 3,7 s Audio" auf der Box wurde ohne Worker/Streaming gemessen — **neu messen**, nicht - übernehmen (`lucy_perf=1`). -3. **Stimmserver auf der Box nachziehen** (nicht Teil des Annahme-Wegs, Hand-Schritt): +‼️ **Nicht über das Auftragsbuch.** Die Karten-Logik (`routers/auftragsbuch.py`, AuftragsbuchView, +`deploy/auftrag-annehmen.sh`, `deploy/lucy-annahme.sh`) liegt zwar noch im Code und die Box listet +Branches weiterhin als „Karten", aber sie ist seit August ungenutzt: letzte Annahme 02.08. (am +selben Tag revertiert), Hermes-Kanban-Tools seit 21.08. abgeschaltet, der v3-Umbau (28.08.) ging +über Branch → Ampel → Merge → `deploy.sh`, und die Box kennt den PC-Executor unter der alten IP +`192.168.178.98` (der PC hat heute `192.168.178.22`, `pc_executor_reachable: false`). Der echte +Weg ist der aus AGENTS.md/STACK.md „Manuell": + +1. **MC2 zuerst.** Ampel für `wartung/lucy-stimme-proxy-raphael` grün → User merged auf `main` + → `main` nach Gitea → auf der Box `bash ~/mission-control-v2/deploy/deploy.sh` (oder + `POST :9001/api/system/self-update`) → `curl -s localhost:9001/api/lucy/stimme/health` muss + `{"status":"ok",…}` liefern. Vorher liefert der Pfad die SPA-Index-Seite (200, HTML) — die + Desktop-Lucy bliebe sichtbar in „Stimme wird verbunden …" mit Hinweis auf den Lokal-Schalter. +2. **Lucy danach.** Ampel für `feature/raphael-innere-stimme` grün → User merged auf `main` → + am PC `cd lucy-desktop && npm ci && npm run dist`, dann `Lucy-Neustart.bat` + (`deploy/lucy-annahme.ps1` macht dasselbe mit Backup/Auto-Restore, von Hand startbar). + Erster Test per Ohr: Latenz Box-Stimme gegen den alten PC-Pfad (Steuerung → Stimme → + „Lokal (PC)"). Der 21.08.-Wert „~5 s für 3,7 s Audio" auf der Box wurde ohne Worker/Streaming + gemessen — **neu messen**, nicht übernehmen (`lucy_perf=1`). +3. **Stimmserver auf der Box nachziehen** (Hand-Schritt): ```bash cp ~/.lucy-stimme/pocket_server.py ~/.lucy-stimme/pocket_server.py.bak-$(date +%Y%m%d) - cp ~/lucy/lucy-tts/pocket_server.py ~/.lucy-stimme/pocket_server.py # Lucy-Checkout auf der Box + diff ~/.lucy-stimme/pocket_server.py ~/lucy/lucy-tts/pocket_server.py # Box-lokale Abweichungen? erst ins Repo! + cp ~/lucy/lucy-tts/pocket_server.py ~/.lucy-stimme/pocket_server.py # Lucy-Checkout auf der Box systemctl --user restart lucy-stimme && sleep 60 && curl -s localhost:8021/health curl -s -X POST localhost:8021/v1/audio/speech -H 'Content-Type: application/json' \ -d '{"input":"Bericht. Die Fassade antwortet.","response_format":"opus"}' -o /tmp/t.ogg && file /tmp/t.ogg ``` - ‼️ Vorher prüfen, ob `~/.lucy-stimme/pocket_server.py` lokale Abweichungen gegenüber dem Repo - trägt (`diff`). Die 21.08.-Notiz sagt „ganze Abstimmung mitgezogen" — wenn dort etwas - Box-spezifisch getunt wurde, gehört es zurück ins Repo, nicht überschrieben. + Die 21.08.-Notiz sagt „ganze Abstimmung mitgezogen" — wenn dort etwas Box-spezifisch getunt + wurde, gehört es zurück ins Repo, nicht überschrieben. + +**Aufräum-Kandidat (User-Entscheid):** Auftragsbuch-Router + View + Annahme-Skripte + PC-Executor- +Verweis ausbauen und STACK.md „Deploy & Pipeline" auf den manuellen Weg umschreiben — sonst +behauptet die Doku weiter einen Standard-Weg, den niemand mehr geht. ## Mobil: Telegram ist die Tür, die Stimme ist dieselbe