Files
sillyhome-next/docs/V1_1_0_OPERATING_GUIDE.md
Otto 0101596e93
Some checks failed
quality / test (3.11) (push) Has been cancelled
quality / test (3.13) (push) Has been cancelled
Add safety dashboard and decision transparency
2026-06-17 18:26:49 +02:00

2.1 KiB

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:

.venv/bin/pytest -q
.venv/bin/ruff check .
.venv/bin/mypy app backend tests
git diff --check
node --check /tmp/sillyhome-dashboard.js