2025.3.4
首页 ▸ 文档 ▸ Automation ▸

使用自动化蓝图

自动化蓝图是预制的automationsHome Assistant 中的自动化允许您自动响应在家中和周围发生的事情。 [Learn more]，您可以轻松将其添加到您的 Home Assistant 实例中。每个蓝图可以添加多次。

快速链接：

蓝图自动化

基于蓝图的自动化需要进行配置。配置的内容因蓝图而异。

  1. 要创建第一个基于蓝图的自动化，请转到 设置 > 自动化与场景 > 蓝图。
  2. 找到您想要使用的蓝图并选择 创建自动化。
    • 这将打开自动化编辑器，并选择该蓝图。
  3. 给它起个名字并配置蓝图。
  4. 在右下角选择蓝色的 保存自动化 按钮。

完成！如果您想重新访问配置值，请转到 设置 > 自动化与场景 > 蓝图。

导入蓝图

Home Assistant 可以从 Home Assistant 论坛、GitHub 和 GitHub gists 导入蓝图。

  1. 要导入蓝图，首先 找到您想要导入的蓝图。

    • 如果您只是想练习导入，可以使用此 URL：

      https://github.com/home-assistant/core/blob/dev/homeassistant/components/automation/blueprints/motion_light.yaml

  2. 转到 设置 > 自动化与场景 > 蓝图。

  3. 在右下角选择蓝色的 Import Blueprint 按钮。

    • 会弹出一个新的对话框，询问您输入 URL。

  4. 输入 URL 并选择 预览。

    • 这将加载蓝图并在导入对话框中显示预览。
    • 您可以更改名称并完成导入。

该蓝图现在可以用于创建自动化。

编辑导入的蓝图

您可以通过“控制”该蓝图来调整导入的蓝图。Home Assistant 将把蓝图自动化转换为常规自动化，使您可以进行任何调整，而不必完全重新发明轮子。

要编辑导入的蓝图，请按照以下步骤操作：

  1. 转到 设置 > 自动化与场景 > 蓝图。

  2. 从列表中选择蓝图。

  3. 选择 并选择 控制。

  4. 显示自动化的预览。

    • 信息：通过控制，蓝图被转换为自动化。您将无法将其转换回蓝图。
    • 要转换为自动化并进行控制，请选择 是。
    • 如果您改变主意并想保留蓝图，请选择 否。

    演示如何控制蓝图的屏幕录像

重新导入蓝图

社区创建的蓝图可能会经历多次修订。有时用户创建了蓝图，社区提供反馈，添加了新功能。

获取这些更改的最快方法是重新导入蓝图。这将覆盖您当前拥有的蓝图。

Caution

在您这样做之前：如果重新导入的蓝图不兼容，可能会破坏您的自动化。

  • 在这种情况下，您需要手动调整您的自动化。

重新导入蓝图

  1. 转到 设置 > 自动化与场景 > 蓝图。
  2. 在您希望重新导入的蓝图上，选择三点菜单，并选择 重新导入蓝图。

在 YAML 中更新导入的蓝图

社区创建的蓝图可能会经历多次修订。有时用户创建了蓝图，社区提供反馈，添加了新功能。

如果由于某种原因您不想 重新导入蓝图，您可以手动编辑其 YAMLYAML 是一种人类可读的数据序列化语言。它用于以结构化格式存储和传输数据。在 Home Assistant 中，YAML 用于配置，例如在 configuration.yaml 或 automations.yaml 文件中。 [Learn more] 内容以保持其最新：

  1. 导航到蓝图目录（blueprints/automation/）。 此目录的位置取决于安装方法。它与您查找 configuration.yaml 的方式类似。
  2. 接下来，您必须找到要更新的蓝图。蓝图的路径名称由以下内容组成：
    • 创建该蓝图的用户的用户名。名称取决于蓝图的来源：论坛或 GitHub。
    • YAMLYAML 是一种人类可读的数据序列化语言。它用于以结构化格式存储和传输数据。在 Home Assistant 中，YAML 用于配置，例如在 configuration.yaml 或 automations.yaml 文件中。 [Learn more] 文件的名称。对于论坛，它是 URL 中主题的标题，对于 GitHub，它是 YAML 文件的名称。
  3. 使用编辑器打开 YAML 文件并更新其内容。
  4. 重新加载自动化以使更改生效。

这些新更改也将出现在您现有的自动化中。

寻找新蓝图

Home Assistant Community 论坛为蓝图有一个特定的标签。此标签用于收集所有蓝图。

访问 Home Assistant 论坛

创建新蓝图

使用蓝图很简单，但是如果您可以创建我们社区确实需要的一个缺失的蓝图呢？

通过 阅读我们关于创建蓝图的教程 来了解更多关于蓝图的信息。

解决缺失自动化的问题

当您使用蓝图创建自动化时，如果它们未出现在 UI 中，请确保您从默认配置中重新添加 automation: !include automations.yaml 到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 中。