Home Assistant 中 ecobee 恒温器夏令时模式设置的完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io摘要导读ecobee.set_dst_mode是 Home Assistant 中用于启用或禁用 ecobee 恒温器**自动夏令时Daylight Saving TimeDST**功能的动作action。本文基于 ecobee.set_dst_mode.markdown 文档完整讲解该动作的 UI 配置步骤、YAML 写法、全部参数细节并结合 ecobee 集成ecobee.markdown的云端轮询架构与相关动作ecobee.set_mic_mode、ecobee.set_occupancy_modes展开纵深解析。读完本文你将能够独立在自动化、脚本中调用该动作理解其底层数据交互与适用边界。动作概览什么是ecobee.set_dst_modeSet daylight savings time mode设置夏令时模式动作用于在 ecobee 恒温器上启用或禁用自动夏令时功能。当该功能启用时恒温器会根据所在时区的夏令时规则自动切换系统时间关闭后时间将固定为当前设置的时区标准时间不再随夏令时自动调整。该动作由ecobee域domain提供属于 Home Assistant 官方 ecobee 集成的一部分文档中将其归类为ha_domain: ecobee并且与以下两个动作互相列为 related actions相关动作ecobee.set_mic_mode启用或禁用 ecobee 4 恒温器上的 Alexa 麦克风ecobee.set_occupancy_modes启用或禁用 Smart Home/Away 与 Follow Me 占用感应模式。适用前提在调用本动作之前需要确保 ecobee 集成已经完成配置。根据 ecobee 集成文档 的说明需要 ecobee.com 账户的用户名与密码自 Home Assistant 2026.3 起不再强制要求开发者 API key已有 key 仍可继续使用需要将恒温器设备提前绑定到 ecobee.com 账户确保能被集成正确发现该集成的物联网类别为Cloud Polling云端轮询意味着动作调用最终会通过 ecobee 云 API 下发到设备。从界面UI使用该动作如果你更倾向于可视化地构建自动化和脚本Home Assistant 会一步步引导你完成该动作的设置无需编写 YAML对应 ui_header.md 的说明。操作步骤前往设置Settings 自动化与场景Automations scenes打开现有的自动化或脚本或者选择创建自动化Create automation 创建新自动化Create new automation如果是在创建新的自动化在当When部分添加一个触发器脚本script不需要触发器它们由其他自动化或流程调用时运行在然后执行Then do部分选择添加动作Add action选择你想要控制的设备。在目标By target下目标选择详见下文动作的目标小节选择要修改的 ecobee 恒温器在针对该目标显示的动作列表中选择ecobee: Set daylight savings time modeecobee设置夏令时模式打开或关闭Daylight savings time enabled启用夏令时开关点击保存Save。UI 中的选项选项说明是否必填Daylight savings time enabled打开以启用自动夏令时功能是界面选项Options in the UI由文档中的{% options_ui %}块定义界面上的开关与 YAML 中的dst_enabled字段一一对应。使用 YAML 调用该动作如果你直接编写 YAML或希望确切了解 Home Assistant 在底层做了什么可以参考本节的完整技术参考对应 yaml_header.md。在 YAML 中该动作以ecobee.set_dst_mode名称引用。一个基础示例如下action: ecobee.set_dst_mode target: entity_id: climate.living_room data: dst_enabled: true这个示例会为climate.living_room对应的 ecobee 恒温器启用自动夏令时功能。YAML 参数详解参数名说明是否必填类型默认值dst_enabled设为true启用自动夏令时设为false禁用是布尔值booleantrue参数补充说明dst_enabled为布尔类型因此合法的取值只有true和false不接受字符串形式的true该参数在文档的{% options_yaml %}块中标记为必填调用时不可省略默认值为true即 Home Assistant 的默认行为倾向是保持自动夏令时开启如果你希望恒温器不再自动跳转时间需要显式传入false。动作的目标Targets该动作需要一个目标target。目标是动作的作用对象你可以将动作指向单个实体entity、设备device、区域area、楼层floor或标签labelHome Assistant 会对该目标背后每一个匹配的climate实体执行动作对应 targets.md 的说明实体Entity某个具体的climate实体例如climate.living_room设备Device属于某台设备的全部climate实体区域Area某个房间或区域内的全部climate实体楼层Floor某个楼层上的全部climate实体标签Label共享某个标签的全部climate实体。你也可以在同一动作中混用不同类型的多个目标。例如在同一动作里同时指定一个具体实体和一个区域该动作会同时作用于两者。注意由于动作文档使用{% include actions/targets.md domainclimate %}引入目标实体的域domain被限定为climate。ecobee 恒温器在 Home Assistant 中正是以climate实体呈现因此示例中使用了climate.living_room这类实体 ID。底层原理动作如何到达恒温器云端轮询架构根据 ecobee 集成文档 的元数据该集成的ha_iot_class为Cloud Polling云端轮询。这意味着Home Assistant 与 ecobee 之间通过 ecobee 云 API 通信状态数据由 Home Assistant 定期从云端拉取而非设备主动推送当你调用ecobee.set_dst_mode时动作参数如dst_enabled会先被转换为 ecobee 云 API 的指令再通过云端下发到恒温器因此调用后设备端的生效可能存在一定的网络延迟这是云端轮询类集成的固有特征。与恒温器设置项的对应关系从功能层面看dst_enabled对应的正是 ecobee 恒温器本地设置中的Automatic Daylight Savings Time选项——这一设置同样可以在 ecobee 官方 App 或恒温器机身界面中修改。Home Assistant 的动作只是把这个配置项的修改能力开放到了自动化与脚本层使你可以在季节转换时自动确认夏令时开关状态在自动化中与其他 ecobee 动作联动例如切换到 Away 预设时同步检查时间设置将恒温器的时间行为统一纳入家庭自动化策略管理。集成配置前提回顾调用该动作的前提是 ecobee 集成已成功配置。根据 ecobee 集成文档配置时支持填入 API key或者直接使用用户名 密码登录2026.3 起不再强制要求开发者 API key若账户启用了基于 TOTP 的多因素认证MFA首次登录时 Home Assistant 会要求输入 6 位动态验证码之后通过 refresh token 自动续期如果 refresh token 失效例如在 ecobee.com 修改了密码Home Assistant 会触发重新认证流程。进阶用法组合与实战示例场景一在脚本中封装关闭自动夏令时alias: Disable DST on all thermostats sequence: - action: ecobee.set_dst_mode target: entity_id: climate.living_room data: dst_enabled: false脚本不需要触发器它会在这条脚本被其他自动化调用时执行。场景二与其他 ecobee 动作联动ecobee.set_dst_mode在文档中被标记为与以下动作相关联它们共同构成了 ecobee 恒温器配置管理的动作族相关动作作用ecobee.set_mic_mode启用或禁用 ecobee 4 上的 Alexa 麦克风参数mic_enabledecobee.set_occupancy_modes启用或禁用 Smart Home/Away参数auto_away与 Follow Me参数follow_me例如可以在离家自动化中同时禁用 Follow Me、启用 Away 占用模式并确认夏令时开关状态从而集中管理恒温器的行为策略。场景三通过试一试功能快速验证如果你不想写任何 YAML可以前往设置Settings 工具Tools 动作Actions搜索ecobee.set_dst_mode填写字段后点击执行动作Perform action即可在真实实体上立即观察效果对应 try_it.md 的说明。常见问题排查动作执行后设备端没有变化由于集成采用云端轮询请稍等片刻并刷新恒温器界面确认同时确认dst_enabled传入了合法的布尔值提示目标无效确认目标entity_id对应的确实是一个由 ecobee 集成创建的climate实体而非其他厂商的恒温器实体调用动作时集成报错检查 ecobee 集成的认证状态若 refresh token 失效需要在 Home Assistant 中完成重新认证仍然无法解决可以在 community forum 的指引。总结ecobee.set_dst_mode是一个参数极简、但应用场景明确的恒温器管理动作界面配置设置 自动化与场景 添加动作 选择目标 切换Daylight savings time enabledYAML 调用action: ecobee.set_dst_modedata.dst_enabled: true/false布尔值必填默认true目标类型实体、设备、区域、楼层、标签均可最终作用于匹配的climate实体底层机制经由 ecobee 云端 API 下发属于 Cloud Polling 架构配置前提是 ecobee 集成已成功登录并发现设备。将夏令时开关纳入自动化是完善恒温器时间行为管理的实用一步尤其适合在跨季节自动化策略中统一维护设备的系统设置。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考