Raportowanie błędów i funkcji

Dreame Vacuum Card działa w ramach integracji dreame_vacuum Home Assistant i nie posiada osobnego repozytorium. Wszystkie raporty błędów, prośby o funkcje i dyskusje trafiają do głównego repozytorium integracji.

Tytuły zgłoszeń

Tytuły zgłoszeń muszą wyraźnie wskazywać związek z Dreame Vacuum Card, na przykład [Card] Map is not loading. Pozwala to odróżnić problemy dotyczące karty od ogólnych problemów z integracją.

Sprawdź aktualizacje

Sprawdzenie HACS zapewnia, że przed otwarciem zgłoszenia działa absolutnie najnowsza wersja integracji dreame_vacuum. Zgłoszony błąd lub żądana funkcja mogą już istnieć w najnowszym wydaniu.

Otwórz zgłoszenie na GitHub

Prośba o funkcję

Nowe pomysły na funkcje i usprawnienia są zawsze mile widziane.

Wymagany jest jasny opis pomysłu, wyjaśnienie, dlaczego jest użyteczny, oraz przewidywanej funkcjonalności. Makiety, szkice lub przykłady z innych aplikacji, takich jak oficjalna aplikacja Dreame, ułatwiają zgłaszanie zmian wizualnych lub zachowań.

Zgłaszanie Błędu

Podanie jasnych i szczegółowych informacji w przypadku wystąpienia nieoczekiwanego zachowania przyspiesza proces rozwiązywania problemu.

Dowód Wizualny

Wymagany jest pełny zrzut ekranu lub nagranie ekranu pokazujące problem na pulpicie nawigacyjnym dla tego wizualnego komponentu UI.

Pobieranie logów Home Assistant

Rozwiązywanie problemów z awariami interfejsu, niedziałającymi przyciskami lub błędami ładowania wymaga sprawdzenia błędów frontendowych występujących w tle. Home Assistant automatycznie rejestruje błędy przeglądarki i frontendowe natywnie. Logi te są pobierane bezpośrednio z systemu Home Assistant.

Rejestrowanie logów frontendowych z Home Assistant:

1. Najpierw odtworzenie problemu, na przykład kliknięcie zepsutego przycisku lub odświeżenie strony, jeśli karta nie ładuje się, zapewnia przechwycenie błędu tuż przed sprawdzeniem logów.
2. Przejście do Ustawienia, następnie System i potem Logi w pasku bocznym Home Assistant.
3. Kliknięcie przycisku Pobierz pełny log na dole strony zapisuje plik homeassistant.log lokalnie.
4. Użycie opcji Pokaż pełne logi lub menu rozwijanego (trzy kropki) w prawym górnym rogu wyświetla surowe logi bezpośrednio w przeglądarce.
5. Filtrowanie pobranego pliku logów lub kopiowanie odpowiednich komunikatów o błędach przygotowuje je do załączenia do zgłoszenia na GitHub.

Chroń dane poufne

Cały plik homeassistant.log zawiera wrażliwe informacje, takie jak hasła, tokeny lub osobiste identyfikatory z innych integracji. Wyodrębnienie i udostępnienie jedynie części związanych z frontend lub dreame_vacuum chroni te dane. Cały plik dziennika nie powinien nigdy być publikowany publicznie bez wcześniejszego sprawdzenia jego zawartości.