73 lines
2.1 KiB
Markdown
73 lines
2.1 KiB
Markdown
# SillyHome Next v1.1.0 Operating Guide
|
|
|
|
## Ziel
|
|
|
|
v1.1.0 macht das Dashboard zur Zentrale fuer Visualisierung, Einrichtung,
|
|
Sicherheit und manuelles Gegensteuern. Autonomes Schalten bleibt ein kurzer
|
|
lokaler Pfad: Vorhersage und Safety-Profil werden aus bereits vorhandenen Daten
|
|
bewertet, danach folgt direkt der Home-Assistant-Serviceaufruf.
|
|
|
|
## Sicherheitsmodell
|
|
|
|
Jeder Aktor hat ein Safety-Profil:
|
|
|
|
- `stage`: Beobachten, Vorschlagen, Shadow, Teilaktiv oder Aktiv.
|
|
- `manual_block`: harte manuelle Sperre.
|
|
- `min_confidence`: Mindest-Sicherheit fuer autonomes Schalten.
|
|
- `cooldown_seconds`: optionaler Aktor-Cooldown gegen schnelles Hin-und-her.
|
|
- Safety-Regeln: Freigabe, Confidence, Cooldown und manuelle Sperre.
|
|
|
|
Ein Aktor schaltet nur, wenn alle lokalen Safety-Regeln frei sind, der
|
|
Behavior-Modus aktiv ist, die Freigabe bereit ist, die Confidence passt, der
|
|
Zielzustand noch nicht erreicht ist und der Cooldown abgelaufen ist.
|
|
|
|
## Transparenz
|
|
|
|
Die Aktor-Detailansicht trennt:
|
|
|
|
- Wissen: belegte Fakten aus Historie, Zuordnung und Automationen.
|
|
- Annahmen: heuristische Schluesse wie Zeit-/Kontext-Aehnlichkeit.
|
|
- Unsicherheiten: geringe Datenmenge, unklare Quellen, Review-Bedarf oder
|
|
negatives Feedback.
|
|
- Beitragsfaktoren: Sensoren, Kontextsignale, aktive Gewichtung und Beitrag.
|
|
- Safety-Blocker: Gruende, warum nicht geschaltet wird.
|
|
|
|
## Job-Queue
|
|
|
|
Das Dashboard zeigt die letzten Jobs mit Status, Dauer, Fehler und
|
|
Zusammenfassung. Sichtbar sind:
|
|
|
|
- Discovery
|
|
- Reconciliation
|
|
- Training
|
|
- Evaluation
|
|
- Automation-Refresh
|
|
|
|
Die Queue ist persistent in `job_queue.json` und dient als Betriebsanzeige. Sie
|
|
blockiert nicht den Startpfad und nicht den Schaltpfad.
|
|
|
|
## Manuelles Gegensteuern
|
|
|
|
Im Dashboard koennen pro Aktor gesetzt werden:
|
|
|
|
- manuelle Sicherheitssperre
|
|
- Freigabestufe
|
|
- Mindest-Confidence
|
|
- optionaler Cooldown
|
|
- Sensor-Gewichtungen und Gruppen-Gewichtungen
|
|
- Kontextauswahl
|
|
- Feedback: Vorhersage korrekt/falsch
|
|
- HA-Automationen pausieren/fortsetzen
|
|
|
|
## Qualitaetspruefung
|
|
|
|
Vor Release:
|
|
|
|
```bash
|
|
.venv/bin/pytest -q
|
|
.venv/bin/ruff check .
|
|
.venv/bin/mypy app backend tests
|
|
git diff --check
|
|
node --check /tmp/sillyhome-dashboard.js
|
|
```
|