报告问题

如果您遇到安装、设置或配置问题，请使用我们的 论坛 来寻求帮助。我们有一个庞大的社区会在力所能及的情况下帮助您。

如果您发现了bug，请在我们的 跟踪器 中报告它。为了帮助您和我们的开发者快速识别问题，请填写提供的模板。您会看到的“奇怪”内容是为了在提交后将您的条目呈现为良好的格式。它只是 markdown。

要查看版本信息，请参考 设置 > 关于 页面。

问题描述

提供您的问题摘要，并告诉我们哪里出错。告诉我们您尝试做什么，以及发生了什么。

有些集成需要额外的步骤（安装第三方工具、编译器等）才能使您的设置正常工作。如果需要，请描述您采取的步骤以及重现问题的步骤。

首个出现问题的 Home Assistant 版本

请提供包含问题的版本。您可以在 设置 > 系统 > 修复 > 右上角的三个点 > 系统信息 下找到版本信息。

最近正常工作的 Home Assistant 版本（如果已知）

如果可能，请提供您知道的该集成或平台正常工作的最新版本。 Home Assistant 的演进非常快速，问题可能已经得到解决，或者最近的更改可能引入了问题。您可以在 设置 > 系统 > 修复 > 右上角的三个点 > 系统信息 下找到有关您系统的详细信息。

操作环境

运行 Home Assistant 有许多不同方式。在本节中，请提及您正在使用的方式：Home Assistant 操作系统、Home Assistant 监督版、在 Docker 中运行的 Home Assistant Core，或手动安装的 Home Assistant Core。说明您使用的操作系统将很有帮助，因为并非所有操作系统都在同一级别上受到支持。您可以在 设置 > 系统 > 修复 > 右上角的三个点 > 系统信息 下找到此信息。

集成

请添加相关集成文档的链接。例如：

• random 传感器的问题: /integrations/random#sensor。
• hue 集成的问题: /integrations/hue/。

诊断信息

考虑随您的问题报告上传 诊断文件，以便更快地进行分类和定位问题。 生成的诊断文件中的信息经过处理，以避免任何敏感信息，但仍能为开发者修复问题提供帮助。

与问题相关的 configuration.yaml 条目

为排除配置问题并允许开发人员快速测试，可能重现您的问题，请添加您 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件的相关部分。此文件位于您的 配置文件夹 中。

sensor:
  - platform: random

确保不要发布您的用户名、密码、API 密钥、访问令牌或其他 机密信息。

回溯和日志信息（如果适用）

如果出现问题，您的日志下会有所谓的回溯或错误信息，位于 设置 > 系统 > 日志 下。请包括此内容。它以 Traceback 开头，可能包含有关代码中错误触发位置的信息。

Traceback (most recent call last):
...

在某些情况下，启用调试日志以获取详细日志也是必要的，以便对问题进行分类。 启用此选项将指示 Home Assistant 记录大量详细的信息。 这对于调试和修复问题非常有帮助。 与诊断信息不同，调试日志不会自动处理。确保仅包括您认为与问题相关的部分。

查看 配置文件夹 中的 home-assistant.log 文件，看看是否与您的集成相关的任何错误。

其他信息

本节可以包含其他细节或其他观察。通常，小细节也能提供帮助。