Repository navigation
v2.0.0-beta.4
Pre-release
Pre-release
·
8 commits
to main
since this release
Neu
- Plan ohne Backup: In der Plan-Vorschau gibt es unter „Erweitert“ den Schalter „Ohne Backup ausführen“, mit Warnmeldung. Nicht möglich bei Plänen, die in die Recorder-Datenbank schreiben; der Prüfbericht vermerkt das Überspringen.
- Backups automatisch aufräumen: Auf der Seite „Housekeeper-Backups aufräumen“ gibt es einen Schalter (aus), der stündlich nach der dortigen Regel löscht. Geschützte Backups und solche, die die einzige Rückkehr nach einer Recorder-Änderung sind, bleiben.
- Verwendungen sehen: In „Entitäten ersetzen“ und „Gerät austauschen“ lässt sich die Zahl der Verwendungen aufklappen. Die Liste zeigt jede Stelle und ob sie ersetzt wird oder von Hand zu prüfen bleibt.
- Statistik übernehmen nur bei Zählern: Im Ersetzen-Assistenten übernimmt die neue Entität Verlauf und ID nur noch bei echten Zählern von selbst. Bei Messwerten werden standardmäßig nur die Verweise umgestellt. Die Vorschau spricht von „Statistik übernehmen“ statt „Zählerwechsel“.
- Helfer: Housekeeper erkennt Helfer (Template, Derivative, Min/Max …) besser.
- Die Aktionsseite einer Helfer-Entität nennt ihren Helfer. „Helfer löschen“ ist ein Plan mit Vorschau und Backup, gesperrt, solange etwas den Helfer sicher verwendet. Input-Helfer, Zähler und Timer sind davon ausgenommen.
- Ein gelöschter Helfer lässt sich mit „Rückgängig“ neu erstellen: Housekeeper legt vorher Optionen, Entitäts-IDs, Namen, Bereiche und Labels im Journal ab und führt den Einrichtungsdialog des Helfers damit aus. Klappt das nicht, bringt ihn das Backup zurück.
- „Helfer exportieren“ speichert einen Helfer (auf der Helfer-Seite) oder alle der Liste (Inventar, Typ „Helfer“) als Datei. „Importieren …“ erzeugt daraus einen Plan mit Vorschau; Rückgängig löscht den neuen Helfer wieder.
- Wird eine Entität deaktiviert oder entfernt, die ein Helfer liest, sagt der Plan, dass der Helfer seine Quelle verliert. Meldet die Entität eines Helfers „nicht verfügbar“, nennt die Diagnose die ausgefallenen Quellen.
- Der Ersetzen-Assistent stellt auch die Quellen von Helfer-Einträgen auf die neue Entität um, mit Undo. Templates in Helfern bleiben von Hand zu prüfen.
- Im Inventar zeigt der Typ „Helfer“ die Spalten „Bereich“ und „Labels“ und den Filter „Ohne Bereich“ / „Ohne Label“.
- Nennt ein Template-Helfer eine Entität eindeutig (
states('sensor.x'),is_state(…)) und gibt es sie nicht mehr, wird er als „Entität fehlt“ gemeldet.
- Qualitätsregeln für Helfer und Templates (aus, Hinweise):
- Templates: Helfer ohne Verwendung, Zahl ohne Schutz vor fehlenden Werten, Template-Entität aus der YAML ohne
unique_id. - Helfer: wird nur beschrieben, ohne Bereich, Zahlenbereich unstimmig, liest sich selbst, Auswahl mit unbekannter Option, Zähler-Helfer mit ungeeigneter Quelle, doppelt (gleiche Einstellungen), Gruppe mit nur einem oder fehlenden Mitgliedern.
- Templates: Helfer ohne Verwendung, Zahl ohne Schutz vor fehlenden Werten, Template-Entität aus der YAML ohne
- Geräte entfernen auf der Geräteseite: Ein von Hand deaktiviertes Gerät zählt als in Quarantäne (ab der letzten Änderung in Home Assistant) und erscheint unter „Quarantäne und Entfernen“. Unter „Weitere Aktionen“ bietet seine Seite „Gerät entfernen“ (fragt die Integration) oder, wenn sie das nicht kann, „Gerät lokal vergessen“, jeweils mit Vorschau und Backup.
- Deaktivieren und Ausblenden auf der Entitätsseite: Unter „Weitere Aktionen“ lässt sich jede Entität per Plan deaktivieren oder ausblenden, mit Vorschau und Undo. Wird sie noch sicher verwendet, bleibt das Deaktivieren gesperrt.
- Alte Entität deaktivieren oder löschen: Der Ersetzen-Assistent kann die alte Entität nach dem Umstellen deaktivieren (Quarantäne) oder löschen. Löschen geht nur, wenn ihre Integration sie nicht mehr liefert (sonst käme sie zurück) oder wenn sie einem Helfer gehört, dann wird der Helfer gelöscht. Mit Warnhinweis und Backup; Rückgängig stellt den Eintrag oder den Helfer wieder her, nicht den Verlauf. Optional wird der Verlauf mitgelöscht (nur per Backup umkehrbar); Plan und Endzustand nennen die alte Entität und was mit ihr geschieht.
- Ein Assistent zum Ersetzen: „Entitäten ersetzen“ ersetzt eine oder mehrere Entitäten. „Zähler wechseln“ und „Verweise ersetzen“ gehen darin auf, Reparieren hat drei Kacheln.
- Für eine Entität gibt es fünf Arten, nach der ID gruppiert: Verweise umstellen, Verweise und Statistik (neu), Nur Statistik, Statistik und ID, Nur ID.
- Was bei diesem Paar nicht möglich ist, ist gesperrt und sagt warum.
- Oberfläche: Kleine Verbesserungen.
- Die Regel und der Schalter „Automatisch aufräumen“ der Backup-Seite stehen in einem Rahmen.
- Altes und neues Gerät stehen nebeneinander, ebenso beim Ersetzen von Entitäten.
- Welche Helfer-Arten Housekeeper kennt, steht nur noch im Backend; ein Test meldet, wenn Home Assistant eine neue Helfer-Art bringt.
- Ein Stepper für alle Abläufe: Assistenten, Plan-Seite, „Beheben“ und die erste Aufräumrunde zeigen dieselbe waagerechte Leiste: Einrichten, Prüfen, Bestätigen, Ausführen, Ergebnis. Im Ersetzen-Assistenten mit mehreren Entitäten steht über den zwei Seiten von „Einrichten“ „Teil 1 von 2“ und „Teil 2 von 2“.
- Erledigte Schritte sind grün, der aktuelle blau, ein fehlgeschlagener rot. Die Plan-Seite zeigt unter der Leiste nur die Unterschritte der gewählten Stufe, mit Fortschritt beim Ausführen.
- Auf schmalen Bildschirmen steht nur der Name des aktuellen Schritts. „1 Eintrag“ steht jetzt im Singular.
- Ersetzen für eine Entität: Der Vorschlag für die neue Entität kommt jetzt wie bei mehreren Entitäten aus Geräteklasse, Einheit, Bereich, Name und ID-Endung, mit den Gründen. Unter den Feldern steht „Hier wird sie verwendet“ über die ganze Breite, mit jeder Stelle einzeln.
- Neben „Vorschau erstellen“ gibt es „Abbrechen“. Es leert den Assistenten und führt zur Auswahl der Aufgabe zurück; es wurde nichts angelegt.
- Backup-Karte bei der Bestätigung: Alles zum Backup eines Plans steht in einer Karte: was vorher passiert, wann das letzte Backup war und wo es liegt, und der Schalter „Ohne neues Backup ausführen“ (nicht mehr hinter „Erweitert“).
- Die Karte ist grün bei einem frischen Backup, gelb bei einem Backup, das älter als 3 Tage ist oder fehlt, und rot, wenn du ohne neues Backup ausführst. Dann steht dort, auf welchen Stand du zurückfielest.
- Die Zusammenfassungen der Pläne sind kürzer, der Satz zum Backup steht nur noch in der Karte. „Entitäts-Verweise ersetzen“ heißt jetzt „N Stellen werden umgestellt“.
Behoben
- Einstellungen und Ansichten: Eingegebene Schwellenwerte bleiben bis zum Speichern erhalten. Batterie- und Laufdaten werden nach einem neuen Scan neu geladen. Die Detailansicht bietet keinen Bereichswechsel an, den der Plan ablehnt.
- Typprüfung: Der MyPy-Check der CI läuft wieder durch.
English
New
- Helpers: Housekeeper knows helpers (template, derivative, min/max …) better.
- The actions page of a helper's entity names its helper. "Delete the helper" is a plan with a preview and a backup, blocked while something certainly uses the helper. Input helpers, counters and timers are left out.
- A deleted helper can be created again with "Undo": Housekeeper keeps options, entity IDs, names, areas and labels in the journal first and runs the helper's own setup dialog with them. If that fails, the backup brings it back.
- "Export the helper" saves one helper (on its page) or all in the list (inventory, type "Helpers") as a file. "Import …" turns it into a plan with a preview; Undo deletes the new helper again.
- When an entity a helper reads is disabled or removed, the plan says the helper loses its source. When a helper's entity reports unavailable, the diagnosis names the sources that are down.
- The replace assistant also switches the sources of helper entries to the new entity, with undo. Templates in helpers stay for a manual check.
- In the inventory the type "Helpers" shows the columns "Area" and "Labels" and the filter "No area" / "No label".
- When a template helper names an entity clearly (
states('sensor.x'),is_state(…)) and it no longer exists, the helper is reported as "entity missing".
- Quality rules for helpers and templates (off, hints):
- Templates: helper without use, number without protection against missing values, YAML template entity without
unique_id. - Helpers: only written, without area, inconsistent number range, reads itself, select with an unknown option, meter helper with an unsuitable source, twice (same settings), group with a single or missing members.
- Templates: helper without use, number without protection against missing values, YAML template entity without
- Remove devices on the device page: A device disabled by hand counts as quarantined (from its last change in Home Assistant) and appears under "Quarantine and removal". Under "More actions" its page offers "Remove device" (asks the integration) or, when that cannot, "Forget device locally", each with a preview and a backup.
- Disable, hide and remove on the entity page: Under "More actions" any entity can be disabled or hidden by a plan, with preview and undo.
- Disable or delete the old entity: The replace assistant can disable the old entity after switching over (quarantine) or delete it. Deleting only works if its integration no longer provides it (it would come back otherwise) or if it belongs to a helper, then the helper is deleted. With a warning and a backup; undo restores the entry or the helper, not the history. Optionally the history is deleted too (reversible only from the backup); the plan and its end state name the old entity and what happens to it.
- Plan without a backup: The plan preview has a switch "Run without a backup" under "Advanced", with a warning. Not possible for plans that write into the recorder database; the audit report notes that the backup was skipped.
- Tidy backups automatically: The "Tidy up Housekeeper backups" page has a switch (off) that deletes every hour by the rule there. Protected backups and those that are the only way back after a recorder change stay.
- See the uses: In "Replace entities" and "Exchange a device" the count of uses unfolds into a list of every place and whether it is replaced or left for a manual check.
- Statistics takeover only for meters: In the replace assistant the new entity takes over history and ID by default only for real meters. For measurements only the references are switched. The preview says "statistics takeover" instead of "meter change".
- One assistant to replace: "Replace entities" replaces one or several entities. "Replace a meter" and "Replace references" are part of it, and Repair has three tiles.
- For one entity there are five kinds, grouped by the ID: Switch references, References and statistics (new), Statistics only, Statistics and ID, ID only.
- What is not possible for this pair is blocked and says why.
- Interface: Small improvements.
- The rule and the "Tidy up automatically" switch of the backup page share one frame.
- Old and new device sit side by side, and so do the entities when replacing.
- The helper types Housekeeper knows are kept in the backend only; a test reports when Home Assistant adds a new helper type.
- One stepper for every flow: Assistants, the plan page, "Fix" and the first cleanup round show the same horizontal bar: Set up, Review, Confirm, Run, Result. In the replace assistant for several entities the two pages of "Set up" are marked "Part 1 of 2" and "Part 2 of 2".
- Done stages are green, the current one blue, a failed one red. The plan page shows only the sub-steps of the chosen stage under the bar, with progress while it runs.
- On narrow screens only the current step keeps its name. "1 entry" is now singular.
- Replace for one entity: The proposal for the new entity now comes, as for several entities, from device class, unit, area, name and ID ending, with the reasons. "Where it is used" sits under the fields over the full width, with every place named.
- "Cancel" sits next to "Create preview". It empties the assistant and returns to the choice of a task; nothing was created.
- Backup card on the confirmation: Everything about the backup of a plan sits in one card: what happens first, when the last backup was and where it is, and the switch "Run without a new backup" (no longer behind "Advanced").
- The card is green for a fresh backup, yellow for one older than 3 days or none, and red when you run without a new backup. It then says which state you would be back at.
- The plan summaries are shorter, the sentence about the backup is only in the card. "Replace entity references" now reads "N places are switched".
Fixed
- Settings and views: Typed thresholds stay until they are saved. Battery and run data are loaded again after a new scan. The detail view no longer offers an area change that the plan rejects.
- Type check: The MyPy check of the CI passes again.