2025.3.4
首页 ▸ Integrations ▸

更新

一个更新 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 是一个表示设备或服务是否有可用更新的实体。这可以是任何更新，包括设备（如灯泡或路由器）的固件更新，或插件或容器等软件更新。

Note

构建模块集成

这个 更新 是一个构建模块集成，无法直接添加到你的 Home Assistant 中，但可以被其他集成使用和提供。

构建模块集成不同于典型的与设备或服务连接的集成。相反，其他将设备或服务集成到 Home Assistant 中的集成使用这个 更新 构建模块来提供实体、服务和其他你可以在自动化或仪表板中使用的功能。

如果你的某个集成具有这个构建模块，这个页面记录了 更新 构建模块所提供的功能。

要查看提供更新实体的 integrations集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 列表，请在集成页面上选择 “更新” 类别。

更新实体的状态

更新 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 的状态反映了是否有可用的更新。当状态为 On 时，表示有更新可用；当一切都是最新时，状态为 Off。

此外，实体可以具有以下状态：

  • 不可用：实体当前不可用。
  • 未知：状态尚未知道。

以下状态属性被公开，以提供关于更新状态的更多信息：

  • title：可用软件或固件的标题/名称。由于设备名称或实体名称可以在 Home Assistant 中更改，此标题将提供软件或固件的实际名称。
  • installed_version：当前安装和使用的版本。
  • latest_version：可供安装的最新版本。
  • skipped_version：如果跳过了版本更新，则此属性将被设置，并包含被跳过的实际版本。
  • release_summary：可用更新的发行说明摘要。
  • release_url：可用更新的完整发行公告链接。

设备类别

设备类别是 Home Assistant 中的一种测量分类。它影响实体在 仪表板 中的表示方式。这可以在 自定义部分 中进行修改。例如，不同的状态可能会用不同的图标、颜色或文本来表示。

以下设备类别支持更新实体：

  • None：通用软件更新。这是默认值，不需要设置。
  • firmware：此更新 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 提供固件。

动作

更新 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 提供两个可以用来安装或跳过提供的软件更新的动作。

动作 update.install

update.install 动作可用于安装提供的设备或服务的更新。

仅当某个 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 提供此功能时，更新 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 才可用此动作。此外，如果 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许，此动作还可以安装特定版本，甚至可以在安装更新之前进行备份。

动作数据属性

entity_id (必填)

指向更新的 entity_id 的字符串或字符串列表。要针对所有更新，将 entity_id 设置为 all。

version

要安装的特定更新版本，如果未提供，将安装最新可用更新。此属性的可用性取决于 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more]。

backup

如果设置为 true，在安装更新之前将进行备份。此属性的可用性取决于 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more]。

示例动作：

action: update.install
target:
  entity_id:
    - update.my_light_bulb

动作 update.skip

update.skip 动作可用于跳过提供的设备或服务的更新。

在跳过提供的更新后，entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 将返回到 off 状态，这意味着没有可用的更新。

action: update.skip
target:
  entity_id:
    - update.my_light_bulb

即使跳过了更新并显示为 off（表示没有更新），如果还有更新版本可用，对实体调用 update.install 动作仍然会安装最新版本。

动作 update.clear_skipped

update.clear_skipped 动作可用于删除之前跳过的设备或服务提供的更新的跳过版本标记。

在跳过提供的更新后，entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 将返回到 off 状态，但在新版本再次可用之前不会返回。

使用 update.clear_skipped 动作，可以移除跳过版本标记，因此实体将返回到 on 状态，并且更新通知将恢复。

action: update.clear_skipped
target:
  entity_id:
    - update.my_light_bulb

这对于，例如，在每周自动化中，取消跳过所有您之前标记为跳过的更新；以提醒您进行更新。

示例：发送更新可用通知

使用更新实体的一个常见用例是通知您是否有更新可供安装。使用更新实体，这样做相当简单。

这是一个 YAML 示例，用于在灯泡的更新可用时发送通知的自动化。

automation:
  - alias: "当更新可用时发送通知"
    triggers:
      - trigger: state
        entity_id: update.my_light_bulb
        to: "on"
    actions:
      - alias: "向我的手机发送更新通知"
        action: notify.iphone
        data:
          title: "新更新可用"
          message: "my_light_bulb 有可用的新更新！"

相关主题