버그 및 기능 보고
Dreame Vacuum Card는 dreame_vacuum Home Assistant 통합의 일부로 작동하며 별도의 저장소를 유지하지 않습니다. 모든 버그 보고, 기능 요청 및 논의는 메인 통합 저장소로 이동합니다.
이슈 제목
이슈 제목은 Dreame Vacuum Card와의 관련성을 명확히 나타내야 하며, 예를 들어 [Card] Map is not loading와 같이 작성해야 합니다. 이는 카드별 문제를 일반 통합 문제와 구분합니다.
업데이트 확인
HACS를 확인하면 이슈를 열기 전에 dreame_vacuum 통합의 최신 버전이 실행되고 있는지 확인할 수 있습니다. 보고된 버그나 요청된 기능은 이미 최근 릴리스에 존재할 수 있습니다.
GitHub에서 이슈 열기
기능 요청
새로운 기능 아이디어 및 개선 사항은 언제나 환영입니다.
아이디어에 대한 명확한 설명, 그 유용성에 대한 이유, 그리고 예상되는 기능을 제공해야 합니다. 모형, 스케치 또는 Dreame 공식 앱과 같은 다른 앱의 예시는 시각적 또는 동작 변경 요청을 쉽게 합니다.
버그 보고
예상치 못한 동작이 발생했을 때 명확하고 자세한 정보를 제공하면 문제 해결 과정을 가속화할 수 있습니다.
시각적 증거
대시보드에서 문제를 보여주는 전체 스크린샷 또는 화면 녹화가 이 시각적 UI 구성 요소에 필요합니다.
Home Assistant 로그 가져오기
UI 글리치, 버튼 작동 불가, 로딩 실패를 해결하려면 백그라운드에서 발생하는 프론트엔드 오류를 검토해야 합니다. Home Assistant는 브라우저 및 프론트엔드 오류를 자동으로 캡처하고 로깅합니다. 이러한 로그는 Home Assistant 시스템에서 직접 가져옵니다.
Home Assistant에서 프론트엔드 로그 캡처:
- 문제를 먼저 재현하는 것, 예를 들어 깨진 버튼을 클릭하거나 카드가 로드되지 않는 경우 페이지를 새로 고침하는 것은 로그를 확인하기 바로 전에 오류가 캡처되도록 보장합니다.
- 설정으로 이동한 다음 Home Assistant 사이드바에서 시스템과 로그를 차례대로 선택합니다.
- 페이지 하단의 전체 로그 다운로드 버튼을 클릭하면
homeassistant.log파일이 로컬에 저장됩니다. - 전체 로그 보기 옵션이나 오른쪽 상단의 오버플로 메뉴(세 개 점)를 사용하면 브라우저에서 원시 로그를 직접 표시할 수 있습니다.
- 다운로드한 로그 파일을 필터링하거나 관련 오류 메시지를 복사하면 GitHub 이슈에 첨부할 준비가 됩니다.
민감한 데이터 보호
전체 homeassistant.log 파일에는 비밀번호, 토큰 또는 다른 통합에서 가져온 개인 식별자와 같은 민감한 정보가 포함되어 있습니다. frontend 또는 dreame_vacuum와 관련된 부분만 추출하고 공유하면 이 데이터를 보호할 수 있습니다. 전체 로그 파일은 내용을 검토하지 않고 공개적으로 업로드해서는 절대 안 됩니다.