Báo cáo Lỗi và Tính năng

Tất cả các báo cáo lỗi, yêu cầu tính năng và thảo luận đều gửi đến kho lưu trữ GitHub của tích hợp.

Kiểm tra Cập nhật

Kiểm tra HACS đảm bảo phiên bản mới nhất của tích hợp đang chạy trước khi mở vấn đề. Một lỗi đã báo cáo hoặc tính năng yêu cầu có thể đã tồn tại trong bản phát hành gần đây.

Kiểm tra FAQ Trước

Các thiết bị không được hỗ trợ, lỗi đăng nhập/kết nối, và Home Assistant bị treo hoặc hết bộ nhớ đã được đề cập trên trang Câu hỏi Thường Gặp và không phải là lỗi.

Mở Vấn đề trên GitHub

Yêu cầu Tính năng

Ý tưởng và cải tiến tính năng mới luôn được hoan nghênh.

Cần có mô tả rõ ràng về ý tưởng, lý do nó hữu ích và chức năng dự kiến. Các bản phác thảo, mô hình minh họa hoặc ví dụ từ các ứng dụng khác, như ứng dụng Dreame chính thức, giúp thuận tiện cho yêu cầu thay đổi về hình ảnh hoặc hành vi.

Yêu cầu Hỗ trợ Mẫu Mới Tùy chọn

Quá trình thêm hỗ trợ cho các mẫu thiết bị mới là bán tự động và được bao gồm trong mỗi bản phát hành tích hợp mới. Mặc dù thường chỉ cần chờ các phiên bản sắp tới, một yêu cầu Hỗ trợ Mẫu Mới có thể được mở nếu cần.

Khi yêu cầu hỗ trợ cho một thiết bị mới, các thông tin sau là bắt buộc:

• Phiên bản Home Assistant
• Số model thiết bị
• Nhật ký Thiết bị Không được hỗ trợ (Điều này phải được trích xuất từ nhật ký Home Assistant và cung cấp trong vấn đề)

Trước khi mở yêu cầu, hãy đảm bảo rằng phiên bản mới nhất của tích hợp đã được cài đặt, Home Assistant đã được khởi động lại và danh sách thiết bị được hỗ trợ/không được hỗ trợ trong tài liệu đã được kiểm tra.

Đặt câu hỏi

Đối với các câu hỏi chung hoặc thảo luận không phải là lỗi hoặc yêu cầu tính năng, một vấn đề Câu hỏi có thể được mở để yêu cầu trợ giúp hoặc làm rõ về dự án.

Báo cáo lỗi

Cung cấp thông tin rõ ràng và chi tiết khi xảy ra hành vi bất ngờ sẽ giúp tăng tốc quá trình giải quyết. Khi mở báo cáo lỗi, các thông tin sau đây là bắt buộc:

• Tên Model (ví dụ, dreame.vacuum.p2028)
• Phiên bản Firmware (ví dụ, 1156)
• Phiên bản Home Assistant
• Loại cấu hình
• Lỗi hoặc cảnh báo từ nhật ký Home Assistant (nếu có)

Lấy Nhật ký Gỡ lỗi

Khắc phục sự cố kết nối, thực thể bị thiếu hoặc trạng thái bất thường yêu cầu xem xét những gì mà tích hợp thực sự đã ghi lại. Bật ghi nhật ký gỡ lỗi sẽ ghi lại chi tiết hơn nhiều so với mức ghi nhật ký mặc định.

Ghi nhật ký gỡ lỗi hiện có thể được bật dễ dàng trực tiếp từ giao diện người dùng của Home Assistant mà không cần chỉnh sửa tệp cấu hình. Để biết hướng dẫn chi tiết về cách bật và tải xuống nhật ký, vui lòng tham khảo chính thức Tài liệu Khắc phục sự cố Home Assistant.

Bảo vệ Dữ liệu Nhạy cảm

Toàn bộ tệp homeassistant.log chứa thông tin nhạy cảm, chẳng hạn như mật khẩu, mã thông báo hoặc các định danh cá nhân từ các tích hợp khác. Việc trích xuất và chỉ chia sẻ các phần liên quan đến dreame_vacuum sẽ bảo vệ dữ liệu này. Toàn bộ tệp nhật ký không nên bao giờ được tải lên công khai mà không xem xét nội dung của nó.