Докладване на бъгове и функции

Dreame Vacuum Card функционира като част от dreame_vacuum интеграцията на Home Assistant и не поддържа отделно хранилище. Всички доклади за бъгове, заявки за функции и дискусии се публикуват в основното хранилище на интеграцията.

Заглавия на проблеми

Заглавията на проблемите трябва ясно да указват връзката с Dreame Vacuum Card, като например [Card] Map is not loading. Това различава проблемите, специфични за картата, от общите проблеми на интеграцията.

Проверка за актуализации

Проверяването на HACS гарантира, че се изпълнява най-новата версия на dreame_vacuum интеграцията, преди да се отвори проблем. Докладването на бъг или заявката за функция може вече да съществува в последно издание.

Отваряне на проблем в GitHub

Заявка за функция

Нови идеи за функции и подобрения винаги са добре дошли.

Необходимо е ясно описание на идеята, логиката зад нейната полезност и предвижданата функционалност. Макети, скици или примери от други приложения, като официалното приложение Dreame, улесняват заявките за визуални или поведенчески промени.

Докладване на бъг

Предоставянето на ясна и детайлна информация при възникване на неочаквано поведение ускорява процеса на решаване.

Визуални доказателства

Пълна екранна снимка или запис на екрана, показващи проблема на таблото, е необходим за този визуален UI компонент.

Вземане на Home Assistant логове

Отстраняването на проблеми с интерфейса, счупени бутони или неуспехи при зареждане изисква преглед на грешките във фронтенда, които се случват зад кулисите. Home Assistant автоматично улавя и записва грешки на браузъра и фронтенда нативно. Тези логове се извличат директно от системата на Home Assistant.

Улавяне на фронтенд логове от Home Assistant:

1. Първо възпроизвеждане на проблема, като например кликване върху счупения бутон или презареждане на страницата, ако картата не се зареди, гарантира, че грешката е засечена точно преди проверка на логовете.
2. Навигиране до Настройки, след това Система и после Логове в страничната лента на Home Assistant.
3. Кликване върху бутона Изтегляне на цял лог в долната част на страницата запазва локално файла homeassistant.log.
4. Използването на опцията Покажи пълните логове или менюто за преливане (три точки) в горния десен ъгъл показва суровите логове директно в браузъра.
5. Филтрирането на изтегления лог файл или копирането на съответните съобщения за грешки ги подготвя за прикачване към проблема в GitHub.

Защити чувствителните данни

Целият файл homeassistant.log съдържа чувствителна информация, като пароли, токени или лични идентификатори от други интеграции. Извличането и споделянето само на частите, свързани с frontend или dreame_vacuum, защитава тези данни. Целият лог файл трябва никога да не бъде качван публично без преглед на съдържанието му.