HitonabiandClaude Opus 5.5
cf01a5bb85
Die Schublade „Dienste und Protokolle" war eine schlichte Liste (Punkt, Name, „läuft", zwei Knöpfe). Jetzt eine Seite im Bereich KI-Box, gebaut wie die Geräte-Tabelle im Homelab-Cockpit: je Dienst Zustand in Worten (läuft, schläft, gestoppt, gescheitert, antwortet nicht), CPU, Speicher, „Läuft seit" und Neustarts; Probleme oben. „Protokoll" klappt unter der Zeile auf (das Neueste unten im Blick), Neu starten / Starten / Wecken fragen vorher nach. Entscheidungen: - Seite statt Schublade: die Tabelle braucht die Breite, und der Eintrag steht jetzt wie die anderen Seiten in der Seitenleiste. Schublade samt onDienste-Weg entfernt. - Speicher = MemoryCurrent als Zahl mit Einheit; der Balken zeigt den echten Anteil am Arbeitsspeicher der Box, keine erfundenen Prozente. Bei der Engine zählt der Grafikspeicher (GTT) mit — dort liegen die Modelle, und systemd rechnet ihn keinem Dienst zu (25.09.: 4,3 GB laut systemd, 27,6 GB Modelle). - CPU = Anteil an allen Kernen aus CPUUsageNSec zwischen zwei Abfragen (die Seite fragt alle 10 s). Fehlt eine brauchbare Probe, misst die Box einmal 0,5 s nach. Ruhiges Blau ohne Warnfarben: ein Dienst hat keine Grenze, was zählt, zeigt der Zustand. - Neustarts = NRestarts (automatische Neustarts nach Absturz), am Handy nur, wenn es welche gab; mehr als 0 rückt den Dienst nach oben. - Backend: Liste und Kennzahlen in services/dienste.py (ein systemctl show je Bereich, auf Windows harmlos leer), Router dünn. Die Felder der MCP-Werkzeuge bleiben; waechter.dienst_zustand war nur für die alte Liste da und ist weg. - Tabelle ab xl, Knöpfe ab 1400 px nebeneinander, darunter Karten mit zwei bzw. vier Spalten; bis 320 px keine waagrechte Scrollleiste. Tests: backend/tests/test_dienste.py (echte systemctl-show-Ausgabe der Box), frontend lib/dienste.test.ts und views/Dienste.test.tsx. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Doku — Index, Lesereihenfolge, Pflegeregeln
Stand 24.09.2026. Das Projekt heißt „Homelab Orchestrator"; der Bereich für die KI-Box heißt „Box-Wart", der für den Proxmox-PC „Homelab". Bei Widerspruch gilt: Code vor Doku, wissen/STACK.md vor anderen Dokumenten, aktuelle Doku vor dem Archiv.
Lesereihenfolge
Frischer Agent:
- ../AGENTS.md: verbindliche Bau-Regeln.
- wissen/ARBEITSWEISE.md: wer der User ist, die Regeln, was wohin gehört.
- wissen/STACK.md: Maschinen, Dienste, Modelle, Automatik.
- ARCHITEKTUR.md: wie die Teile zusammenhängen.
- wissen/VERDIKTE.md: was entschieden ist.
- wissen/FALLEN.md: vor jeder Änderung an der Box.
- wissen/OFFENE-FAEDEN.md: was als Nächstes ansteht.
Betrieb und Störungen: BETRIEB.md, dann je nach Thema UPDATES.md, RADAR.md, WIEDERAUFBAU.md und ../deploy/jobs/README.md.
User: BEDIENUNG.md.
Die Dateien
| Datei | Für | Inhalt |
|---|---|---|
| BEDIENUNG.md | User | Oberfläche, Telegram-Nachrichten, was tun, wenn etwas hakt |
| ARCHITEKTUR.md | Agenten, Technik | Prozesse, Rollen und Partner-Instanz, Modell-Rollen, wer was schreibt, Meldeweg, Schnittstellen |
| BETRIEB.md | Agenten, Technik | Handgriffe, Meldungen, Wächter-Regeln, Deploy und Prüftor, Sicherung, Notfall |
| UPDATES.md | Agenten, Technik | Sonntags-Kette, Prüfungen, Festhalten und Freigeben, Handbetrieb |
| RADAR.md | Agenten, Technik | Modell-Radar, Prüfstand, Stack-Radar |
| WIEDERAUFBAU.md | Technik | die KI-Box von null; Anhang A: llama-swap-Unit |
| wissen/STACK.md | Agenten | Stand-Wahrheit: Maschinen, Dienste, Modelle, Automatik |
| wissen/VERDIKTE.md | Agenten | Entscheidungen mit Datum und Grund; Abschnitt „Überholt" |
| wissen/FALLEN.md | Agenten | Fallen mit Datum und Symptom |
| wissen/ARBEITSWEISE.md | Agenten | User-Profil, Regeln, Flächen |
| wissen/OFFENE-FAEDEN.md | alle | Fahrplan und die eine Liste offener Punkte |
| ../deploy/jobs/README.md | Agenten, Technik | Hermes-Jobs und Timer, Daily News |
Archiv
archiv/ hält historische Dokumente mit Datumspräfix. Sie werden nicht mehr gepflegt; Aussagen und Links darin
können veraltet sein.
| Datei | Inhalt |
|---|---|
2026-06-30-optimierungsplan.md |
Audit und Plan zu Rollen, Warm-Set und Durchsatz (Juni) |
2026-06-30-zeroclaw-poc-auftrag.md, …-ergebnis.md |
ZeroClaw-Test; Beleg für „Hermes bleibt" |
2026-06-30-lucy-tts-plan.md |
Stimmen-Strategie für Lucy (Juni) |
2026-07-02-autonomie-plan.md |
„Die Box wartet sich selbst", Etappen E1–E6 |
2026-07-02-komplett-review.md |
Review von MC2 und Lucy |
2026-07-06-antigravity-review-prompt.md |
Review-Auftrag für Gemini |
2026-07-10-gemini-briefing.md |
Notfall-Briefing für Gemini |
2026-07-10-zielbild-abloesung.md |
Richtungs-Entscheid vom 10.07. |
2026-07-15-umbauplan-abloesung.md |
Abschluss-Review vom 15.07. mit Gateway- und Steward-Auszug |
2026-07-19-uebergabe-drei-welten.md |
Übergabe des Umbaus vom 19.07. |
2026-07-21-skill-gitea-workflow.md |
Beschreibung des früheren Skills gitea-workflow |
2026-08-07-hermes-setup.md |
Hermes-Runbook aus der Anfangszeit |
2026-08-20-savepoint.md |
Stand-Seite vom 20.08. |
2026-08-20-referenzaufgabe-gedaechtnis-ausbau.md, 2026-08-20-referenz-check.sh |
Messlatte des Referenzlaufs (Ausbau des alten Gedächtnis-Dienstes) |
2026-08-21-hermes-werkzeuge.md |
Werkzeugsätze nach Bedarf; Kern steht in wissen/FALLEN.md |
2026-08-21-umbau-openchamber.md |
Aufbau der Coding-Bahn mit OpenChamber, Gitea-SSH |
2026-09-04-raphael-lucy-innere-stimme.md |
Lucy als innere Stimme (Entscheid 04.09.) |
2026-09-04-offene-faeden-alt.md |
Liste offener Punkte bis 04.09., mit den Lucy-Fäden |
gitea-host/ |
Notizen zum Gitea-Host |
hermes-api_server-vision-patch-verwaist.diff |
verwaister Patch am Hermes-api_server (Bilder), nur zur Erinnerung |
Ganz gelöschte Dokumente (STATUS, CUTOVER, UPGRADE, AUDIT_KICKOFF, die Kopien unter docs/memory/ u. a.) stehen in
der Git-Historie.
Pflegeregeln
- Eine Wahrheit je Thema: Stand →
wissen/STACK.md; Entscheidungen →wissen/VERDIKTE.md; Fallen →wissen/FALLEN.md; offene Punkte →wissen/OFFENE-FAEDEN.md(die einzige Liste, keine zweite anlegen); Abläufe →ARCHITEKTUR.md,BETRIEB.md,UPDATES.md,RADAR.md. - Verifizieren vor Behaupten: Jede Aussage gegen Code oder Messung prüfen. Stand-Angaben tragen ein Datum, am besten mit Commit. Was nicht geprüft ist, heißt „offen" oder „nicht geprüft".
- Doku folgt dem Code im selben Branch: Wer Units, Skripte, Routen, Meldungstexte oder Abläufe ändert, zieht die betroffenen Dokumente mit.
- Verdikte ändern sich nur mit neuem, belegtem Anlass (Messung, Release, User-Entscheid); das alte wandert mit Datum nach „Überholt".
- Fallen mit Datum und Symptom eintragen; Erledigtes streichen.
- Historisches mit eigenem Wissen nach
archiv/(PräfixJJJJ-MM-TT-), sonst löschen; die Git-Historie behält alles. - Sprache: Deutsch, knapp, Fakten statt Adjektive.
BEDIENUNG.mdin Alltagssprache ohne Fachjargon. - Keine Geheimnisse (Tokens, Passwörter, Chat-IDs) in die Doku; Sicherheitshinweise in einem Satz.
- Weg der Änderung: Branch →
bash deploy/pruefen.sh→ Merge. Auf der Box kommt die Doku mit dem nächsten Deploy an.