錯誤與功能回報
Dreame 吸塵器卡片 作為 dreame_vacuumHome Assistant 整合的一部分運作，並不維護獨立的庫。所有的錯誤回報、功能請求和討論都應提交至主要整合庫。
問題標題
問題標題必須清楚表明與 Dreame 吸塵器卡片 的關聯，例如 [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 保護這些資料。整個日誌檔案應該 從不 在未審查其內容之前不得公開上傳。