Home Assistant 中使用 isy994.rename_node 重命名 ISY/IoX 节点UI、YAML 与命名同步机制详解【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇指南围绕 Home Assistant 的isy994.rename_node动作展开讲解如何通过 UI 或 YAML 重命名 Universal Devices ISY/IoX 控制器ISY994、eisy、Polisy上的节点与场景group/scene并厘清它与 Home Assistant 实体命名的同步边界。读完本文你将掌握该动作的完整配置方式、Target 匹配规则以及它与isy994.send_node_command、isy994.send_program_command等动作的配合场景。动作概述这个动作做什么不做什么isy994.rename_node是 Home Assistant 为 ISY/IoX 集成 提供的动作action用于在 ISY 控制器内部重命名一个节点node或组/场景group/scene。ISY 是一类家庭自动化控制器能够控制连接在其受支持硬件上的 Insteon、X10、Z-Wave 以及 Zigbee/Matter 设备该集成同时支持传统的 ISY994 硬件家族与当前 ISY-on-AnythingIoX硬件如 eisy、Polisy。需要特别强调的是该动作的行为边界它只修改ISY 侧的节点名称它不会自动同步Home Assistant 中的实体名称或实体 IDentity ID实体名称与 ID 的更新只会在重新加载该集成或重启 Home Assistant 之后发生并且仅当你在 Home Assistant 中没有对该实体做过自定义命名customization时才会被新名称覆盖。也就是说如果你在 Home Assistant 中手动改过实体的显示名称重载集成后 ISY 的新名称不会覆盖你的自定义名称这是为了避免你的个性化配置被静默丢弃。前置条件确认 ISY 集成已配置完成在使用该动作之前请确认 ISY/IoX 集成已经通过配置流config flow接入。集成配置完成后Home Assistant 会自动导入控制器上可定位到的 binary sensor、cover、fan、light、lock、sensor 和 switch 等实体。每个设备以及 ISY 集线器本身还会带有一个 Query 按钮可用于主动查询设备状态。只有这些已导入的实体以及设备、区域、楼层、标签背后的实体才能作为isy994.rename_node的 Target 被选中。在 UI 中使用逐步操作如果你习惯可视化地构建自动化或脚本可以完全在界面中完成无需编写 YAML进入SettingsAutomations scenes自动化与场景。打开一个现有的自动化或脚本如果要新建选择Create automationCreate new automation。如果是新建自动化在When何时部分添加触发器脚本不需要触发器它们在被其他对象调用时运行。在Then do然后执行部分选择Add action添加动作。选择你要控制的对象在By target按目标详见下文Targets下选中要重命名的 ISY 实体。你同样可以选择一个设备、区域、楼层或标签作为目标。在针对该目标显示的动作列表中选择ISY: Rename node。在Name名称字段中输入新名称。选择Save保存。UI 中的选项UI 中仅有一个输入项字段说明Name要在 ISY 内部使用的新名称必填。在 YAML 中使用参数与完整示例在 YAML 中该动作以isy994.rename_node引用。以下是一个可以直接用于自动化或脚本的基本示例action: isy994.rename_node target: entity_id: light.front_porch data: name: Front porch light这段配置会把light.front_porch实体背后的 ISY 节点重命名为 Front porch light。注意动作作用于ISY 侧的节点因此命名风格会影响你在 ISY Admin Console 中看到的设备树名称。YAML 选项字段必填类型说明name是string要在 ISY 内部使用的新名称。Targets动作的目标匹配规则isy994.rename_node要求一个目标target。目标即动作的作用对象你可以将动作指向单个实体、一个设备、一个区域、一个楼层或一个标签Home Assistant 会对目标背后的每一个匹配 ISY 实体执行重命名Entity实体单个具体 ISY 实体例如light.front_porch。Device设备属于某台设备的全部 ISY 实体。Area区域某个房间/区域内的全部 ISY 实体。Floor楼层某个楼层上的全部 ISY 实体。Label标签共享某个标签的全部 ISY 实体。你可以在同一次动作中混合选择不同类型的目标例如把「一个具体实体」和「一个区域」同时作为目标动作会一次性作用于这两组对象。这在批量重命名、统一命名规范时非常有用。动手验证在 Actions 工具中直接尝试无需编写 YAML你就能在界面中验证该动作进入SettingsToolsActions动作工具搜索isy994.rename_node填入目标实体与新名称选择Perform action执行动作。这样可以直观看到真实实体上的效果便于在写入自动化前确认命名是否符合预期。与相关动作的配合使用原文档将该动作与以下两个动作列为相关动作它们构成了 ISY 节点管理的基本组合isy994.send_node_command动作文档向节点发送 Home Assistant 未直接暴露的命令例如beep蜂鸣、brighten调亮、dim调暗、fade_up/fade_down/fade_stop渐变控制、fast_on/fast_off快开/快关、query查询等。适合在重命名节点后立即验证设备行为。isy994.send_program_command动作文档控制 ISY 程序或文件夹例如run、run_then、run_else、stop、enable、disable等。它不支持 Target而是通过address或name定位程序并可指定多 ISY 环境下的目标控制器。该动作文档也反向把isy994.rename_node列为相关动作。此外如果你的设备需要发送更底层的 ISY REST 命令如DON、DOF可参考isy994.send_raw_node_command动作文档它支持command、value0–255、parameters查询字符串参数映射与unit_of_measurement0–120等字段适用于尚未被 Home Assistant 完整支持的 NodeServer 节点。命名同步机制的注意事项基于动作说明与集成文档的行为描述使用该动作时有几点需要留意重命名是单向的isy994.rename_node只改 ISY 侧名称Home Assistant 侧不会即时跟随。若希望实体显示名与 ISY 一致需要在重命名后重载集成或重启 Home Assistant。自定义名称优先若实体名称已在 Home Assistant 中被 customization 覆盖重载/重启后 ISY 的新名称不会覆盖该自定义名称。场景scene同样可重命名动作说明明确覆盖 node or group (scene)即 ISY 中的 Insteon 场景在 Home Assistant 中通常以switch形式呈现也在适用范围之内。实体 ID 不随重命名变化即使 ISY 侧名称改变Home Assistant 的实体 ID如light.front_porch也不会自动改变自动化中已有的target.entity_id引用不会因此失效这反而保证了现有自动化在重命名操作后的稳定性。结语isy994.rename_node是一个轻量但边界清晰的 ISY/IoX 管理动作它负责修正 ISY 控制器侧的命名配合 Target 机制可以批量处理实体、设备、区域、楼层或标签背后的节点与场景而与send_node_command、send_program_command等动作组合可以完整覆盖「重命名—验证行为—执行程序」的运维闭环。理解它与 Home Assistant 实体命名的同步机制是避免「重命名后实体名称没有变化」这类困惑的关键。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Home Assistant 中使用 isy994.rename_node 重命名 ISY/IoX 节点：UI、YAML 与命名同步机制详解
Home Assistant 中使用 isy994.rename_node 重命名 ISY/IoX 节点UI、YAML 与命名同步机制详解【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇指南围绕 Home Assistant 的isy994.rename_node动作展开讲解如何通过 UI 或 YAML 重命名 Universal Devices ISY/IoX 控制器ISY994、eisy、Polisy上的节点与场景group/scene并厘清它与 Home Assistant 实体命名的同步边界。读完本文你将掌握该动作的完整配置方式、Target 匹配规则以及它与isy994.send_node_command、isy994.send_program_command等动作的配合场景。动作概述这个动作做什么不做什么isy994.rename_node是 Home Assistant 为 ISY/IoX 集成 提供的动作action用于在 ISY 控制器内部重命名一个节点node或组/场景group/scene。ISY 是一类家庭自动化控制器能够控制连接在其受支持硬件上的 Insteon、X10、Z-Wave 以及 Zigbee/Matter 设备该集成同时支持传统的 ISY994 硬件家族与当前 ISY-on-AnythingIoX硬件如 eisy、Polisy。需要特别强调的是该动作的行为边界它只修改ISY 侧的节点名称它不会自动同步Home Assistant 中的实体名称或实体 IDentity ID实体名称与 ID 的更新只会在重新加载该集成或重启 Home Assistant 之后发生并且仅当你在 Home Assistant 中没有对该实体做过自定义命名customization时才会被新名称覆盖。也就是说如果你在 Home Assistant 中手动改过实体的显示名称重载集成后 ISY 的新名称不会覆盖你的自定义名称这是为了避免你的个性化配置被静默丢弃。前置条件确认 ISY 集成已配置完成在使用该动作之前请确认 ISY/IoX 集成已经通过配置流config flow接入。集成配置完成后Home Assistant 会自动导入控制器上可定位到的 binary sensor、cover、fan、light、lock、sensor 和 switch 等实体。每个设备以及 ISY 集线器本身还会带有一个 Query 按钮可用于主动查询设备状态。只有这些已导入的实体以及设备、区域、楼层、标签背后的实体才能作为isy994.rename_node的 Target 被选中。在 UI 中使用逐步操作如果你习惯可视化地构建自动化或脚本可以完全在界面中完成无需编写 YAML进入SettingsAutomations scenes自动化与场景。打开一个现有的自动化或脚本如果要新建选择Create automationCreate new automation。如果是新建自动化在When何时部分添加触发器脚本不需要触发器它们在被其他对象调用时运行。在Then do然后执行部分选择Add action添加动作。选择你要控制的对象在By target按目标详见下文Targets下选中要重命名的 ISY 实体。你同样可以选择一个设备、区域、楼层或标签作为目标。在针对该目标显示的动作列表中选择ISY: Rename node。在Name名称字段中输入新名称。选择Save保存。UI 中的选项UI 中仅有一个输入项字段说明Name要在 ISY 内部使用的新名称必填。在 YAML 中使用参数与完整示例在 YAML 中该动作以isy994.rename_node引用。以下是一个可以直接用于自动化或脚本的基本示例action: isy994.rename_node target: entity_id: light.front_porch data: name: Front porch light这段配置会把light.front_porch实体背后的 ISY 节点重命名为 Front porch light。注意动作作用于ISY 侧的节点因此命名风格会影响你在 ISY Admin Console 中看到的设备树名称。YAML 选项字段必填类型说明name是string要在 ISY 内部使用的新名称。Targets动作的目标匹配规则isy994.rename_node要求一个目标target。目标即动作的作用对象你可以将动作指向单个实体、一个设备、一个区域、一个楼层或一个标签Home Assistant 会对目标背后的每一个匹配 ISY 实体执行重命名Entity实体单个具体 ISY 实体例如light.front_porch。Device设备属于某台设备的全部 ISY 实体。Area区域某个房间/区域内的全部 ISY 实体。Floor楼层某个楼层上的全部 ISY 实体。Label标签共享某个标签的全部 ISY 实体。你可以在同一次动作中混合选择不同类型的目标例如把「一个具体实体」和「一个区域」同时作为目标动作会一次性作用于这两组对象。这在批量重命名、统一命名规范时非常有用。动手验证在 Actions 工具中直接尝试无需编写 YAML你就能在界面中验证该动作进入SettingsToolsActions动作工具搜索isy994.rename_node填入目标实体与新名称选择Perform action执行动作。这样可以直观看到真实实体上的效果便于在写入自动化前确认命名是否符合预期。与相关动作的配合使用原文档将该动作与以下两个动作列为相关动作它们构成了 ISY 节点管理的基本组合isy994.send_node_command动作文档向节点发送 Home Assistant 未直接暴露的命令例如beep蜂鸣、brighten调亮、dim调暗、fade_up/fade_down/fade_stop渐变控制、fast_on/fast_off快开/快关、query查询等。适合在重命名节点后立即验证设备行为。isy994.send_program_command动作文档控制 ISY 程序或文件夹例如run、run_then、run_else、stop、enable、disable等。它不支持 Target而是通过address或name定位程序并可指定多 ISY 环境下的目标控制器。该动作文档也反向把isy994.rename_node列为相关动作。此外如果你的设备需要发送更底层的 ISY REST 命令如DON、DOF可参考isy994.send_raw_node_command动作文档它支持command、value0–255、parameters查询字符串参数映射与unit_of_measurement0–120等字段适用于尚未被 Home Assistant 完整支持的 NodeServer 节点。命名同步机制的注意事项基于动作说明与集成文档的行为描述使用该动作时有几点需要留意重命名是单向的isy994.rename_node只改 ISY 侧名称Home Assistant 侧不会即时跟随。若希望实体显示名与 ISY 一致需要在重命名后重载集成或重启 Home Assistant。自定义名称优先若实体名称已在 Home Assistant 中被 customization 覆盖重载/重启后 ISY 的新名称不会覆盖该自定义名称。场景scene同样可重命名动作说明明确覆盖 node or group (scene)即 ISY 中的 Insteon 场景在 Home Assistant 中通常以switch形式呈现也在适用范围之内。实体 ID 不随重命名变化即使 ISY 侧名称改变Home Assistant 的实体 ID如light.front_porch也不会自动改变自动化中已有的target.entity_id引用不会因此失效这反而保证了现有自动化在重命名操作后的稳定性。结语isy994.rename_node是一个轻量但边界清晰的 ISY/IoX 管理动作它负责修正 ISY 控制器侧的命名配合 Target 机制可以批量处理实体、设备、区域、楼层或标签背后的节点与场景而与send_node_command、send_program_command等动作组合可以完整覆盖「重命名—验证行为—执行程序」的运维闭环。理解它与 Home Assistant 实体命名的同步机制是避免「重命名后实体名称没有变化」这类困惑的关键。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
