Home Assistant input_select.reload 动作完全指南热重载 YAML 下拉助手配置【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.ioinput_select.reload是 Home Assistant 中用于在不重启整个实例的前提下重新加载configuration.yaml中定义的下拉助手Input select / Dropdown helper的动作。本文以 官方动作文档 为主体结合 input_select 集成文档 与同类 reload 动作文档完整讲解其用途、UI 操作步骤、YAML 调用写法、权限限制及与其他相关动作的配合方式帮助你掌握改配置 → 热重载 → 立即生效的完整工作流。动作是什么为什么需要 reloadinput_select是 Home Assistant 中的一种辅助实体helper它让用户从一组预定义选项中保存一个值常见用途包括今天谁做饭、选择恒温器模式、切换房间场景等。它有两种创建方式通过 UI 在Settings Devices services Helpers中创建配置存储在.storage中通过 YAML 在configuration.yaml中声明例如 集成文档 中的写法。问题的关键在于UI 创建的助手与 YAML 声明的助手在修改生效机制上并不相同。对于 YAML 中定义的 input select直接编辑configuration.yaml后改动并不会自动生效需要重启 Home Assistant 才会被读取。而input_select.reload动作正是为此设计的——它可以在不重启的情况下仅针对 YAML 中定义的 input select 配置执行重新加载让修改立刻生效。input_select.reload是 Home Assistant 众多*.reload动作家族的一员。仓库中同类动作还包括automation.reload、script.reload、scene.reload、group.reload、input_boolean.reload、input_datetime.reload、input_number.reload、input_text.reload、input_button.reload、intent_script.reload、zone.reload、mqtt.reload等它们遵循同一套热重载 YAML 配置的设计模式。核心行为与限制根据 动作文档该动作有以下关键行为特征只作用于 YAML 定义的助手它重新加载的是你在 YAML 中配置的 input select helper。通过 UI 创建的助手不受影响也不会被这个动作卸载或重载。无需重启在修改configuration.yaml后执行此动作即可让改动生效这是它最大的价值所在。不支持目标targets该动作没有 target 机制。在 UI 中你不会被提示选择区域、设备、实体或标签因为它是对整个 input select 域domain的全局重载。仅限管理员只有具有管理员权限的用户才能执行此动作。普通用户调用时会因为没有权限而失败。无附加参数该动作在 UI 和 YAML 中都没有额外选项调用时不需要也不接受任何 data 参数。在 UI 中调用自动化与脚本如果你希望通过 UI 在自动化或脚本中使用该动作按照 动作文档 的步骤操作进入SettingsAutomations scenes自动化与场景。打开一个现有的自动化或脚本或者选择Create automationCreate new automation新建。如果新建的是自动化需要在When何时部分添加触发器脚本不需要触发器它们由其他调用方触发运行。在Then do然后执行部分选择Add action添加动作。在搜索框中搜索并选择Input select: Reload input selects重载下拉输入项。选择Save保存。需要注意由于该动作不支持 target你在 UI 中不会被要求选择区域、设备、实体或标签同时只有管理员账号才能运行它。作为辅助实体类动作input_select.reload在 UI 中的呈现方式与其他 input_select 动作如select_option、set_options、select_next等一致但它不需要任何额外选项因此 UI 表单中不会有参数输入区域。在 YAML 中调用自动化与脚本在 YAML 中该动作的调用名称为input_select.reload。动作文档 给出的基础示例为action: input_select.reload将其放入自动化或脚本的actions或旧版action列表中即可例如automation: - alias: Reload dropdown helpers after config change triggers: - trigger: homeassistant event: start actions: - action: input_select.reload执行后Home Assistant 会重新读取configuration.yaml中的input_select:段落应用其中的options、name、initial、icon等配置详见下文配置项说明。由于该动作没有 data 参数调用时不需要也不能指定target或data。YAML 配置项回顾reload 会重新读取什么为了更好地理解 reload 的效力范围这里回顾 集成文档 中定义的 YAML 配置项——这些正是 reload 动作重新加载的内容配置项必填类型说明默认值options是list可供选择的选项列表无必须提供name否string助手的友好名称无initial否mapHome Assistant 启动时的初始值options的第一个元素icon否icon前端显示在输入项前的图标无配置示例# Example configuration.yaml entry input_select: who_cooks: name: Who cooks today options: - Paulus - Anne Therese initial: Anne Therese icon: mdi:panda living_room_preset: options: - Visitors - Visitors with kids - Home Alone注意如果options中使用了 On、Yes、Y、Off、No、N 等 YAML 布尔值变体不区分大小写它们会被 YAML 解析为True/False除非用引号包裹。这是 集成文档 明确提示的易踩坑点修改配置时需特别留意。与状态恢复的关系修改配置后执行 reload 时如果新的配置中设置了有效的initial值集成会以该值作为起始状态否则它会恢复 Home Assistant 停止之前的状态参见 Restore state 一节。这意味着 reload 通常不会破坏当前选中的选项只要该选项在新配置的options中仍然存在。实战工作流修改 YAML 后热重载结合以上内容推荐的实际操作流程如下编辑configuration.yaml新增、删除或修改input_select:下的助手定义。保存文件。触发input_select.reload动作通过开发者工具、自动化或脚本让改动无需重启即生效。例如若你在 YAML 中给某个下拉助手新增了一个选项执行 reload 后该选项立即出现在实体状态中可以被自动化、脚本和仪表盘使用。与相关动作的搭配input_select.reload通常与同一域下的其他动作配合使用。它们在 动作目录 中均有对应文档input_select.select_option将某个 input select 的选项直接设置为指定值如option: Paulus。input_select.set_options整体替换一个或多个 input select 的选项列表新列表至少包含一个选项当前选中的值只有在新列表中仍存在时才会被保留。input_select.select_next /input_select.select_previous在选项列表中前进/后退默认在末尾循环回开头可用cycle: false关闭循环。例如一个常见组合是先用input_select.set_options动态调整选项列表再通过input_select.select_option选定具体值而当你希望把 YAML 里改好的配置重新读进来时就用input_select.reload。如果一次改了多处 YAML 配置也可以考虑 homeassistant.reload_all 动作它会对所有支持 reload 的域执行重载包括 input_select并额外重载核心配置、主题和自定义 Jinja 模板。重载前会先做基础配置检查检查失败则什么都不加载并抛出错误。不过它比单独使用input_select.reload影响面更大应按需选用。常见问题执行了 reload 但改动没生效检查是否真的把配置写在了input_select:段落中且 YAML 格式正确缩进、选项列表的连字符等。YAML 解析错误会导致重载失败。普通用户执行报权限错误该动作仅限管理员运行这是设计行为与文档中其他 reload 类动作如homeassistant.reload_all同样仅限管理员一致。UI 创建的助手为何 reload 后没变化因为该动作只针对 YAML 配置的助手UI 创建的助手存储在内部.storage中不属于 reload 的作用范围。下拉选项出现 True/False检查options中的值是否未加引号且形如 YAML 布尔值On/Yes/Off/No 等按 集成文档 的说明用引号包裹即可。总结input_select.reload是维护 YAML 驱动式下拉助手的核心工具它在不重启的前提下热重载 YAML 中的 input select 配置不支持 targets、无额外参数、仅限管理员使用。将其与input_select.select_option、input_select.set_options、input_select.select_next及homeassistant.reload_all等动作配合即可构建一套完整、高效的配置即代码式自动化体系。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
