错误和功能报告

Dreame 真空卡 作为 dreame_vacuum Home Assistant 集成的一部分运行，并不维护单独的仓库。所有错误报告、功能请求和讨论都应提交到主集成仓库。

问题标题

问题标题必须清楚地表明与 Dreame 真空卡 相关，例如 [Card] Map is not loading。这有助于区分卡片特定问题和一般集成问题。

检查更新

检查 HACS 可确保在提交问题之前运行的 dreame_vacuum 集成是最新版本。报告的错误或请求的功能很可能在最新发布中已经存在。

在 GitHub 上提交问题

请求新功能

新功能想法和改进始终欢迎。

需要对想法进行清晰的描述，包括其有用性的理由和设想的功能。通过原型图、草图，或其他应用程序（如官方 Dreame 应用）的示例，有助于视觉或行为的更改请求。

报告错误

当出现意外行为时，提供清晰且详细的信息可以加快问题解决过程。

视觉证据

对于此视觉 UI 组件，需要提供显示仪表板问题的完整截图或屏幕录制。

获取 Home Assistant 日志

排查 UI 问题、按钮故障或加载失败，需要查看后台发生的前端错误。Home Assistant 会原生自动捕获并记录浏览器及前端错误。这些日志直接从 Home Assistant 系统中获取。

从 Home Assistant 捕获前端日志：

1. 首先重现问题，例如点击损坏的按钮或在卡片加载失败时刷新页面，可以确保在检查日志之前捕获错误。
2. 在 Home Assistant 侧边栏中依次导航到 设置，然后是 系统，最后是 日志。
3. 点击页面底部的 下载完整日志 按钮，将 homeassistant.log 文件保存到本地。
4. 使用 显示完整日志 选项或右上角的溢出菜单（三个点）可以直接在浏览器中显示原始日志。
5. 过滤下载的日志文件或复制相关错误信息，为附加到 GitHub 问题做准备。

保护敏感数据

完整的 homeassistant.log 文件包含敏感信息，例如密码、令牌或来自其他集成的个人标识符。仅提取并分享与 frontend 或 dreame_vacuum 相关的部分可以保护这些数据。整个日志文件在未经审查其内容的情况下，绝不 应公开上传。