Home Assistant ecobee.set_fan_min_on_time在 UI 与 YAML 中设置每小时风扇最低运行时间【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文围绕 Home Assistant 文档中的ecobee.set_fan_min_on_time动作展开完整覆盖该动作的功能定位、UI 配置步骤、YAML 调用方式与全部参数约束060 分钟、entity_id可省略等并结合 ecobee 集成文档与同域其他动作页面讲清它与 climate 实体fan_min_on_time属性、通风机最小运行时间等概念的关联。读完后可直接在自动化或脚本中使用该动作让 ecobee 恒温器每小时保持风扇至少运行指定分钟数实现室温均衡、空气循环等场景。动作功能与适用场景ecobee.set_fan_min_on_timeUI 中显示为ecobee: Set fan minimum on time的作用是设置风扇每小时最少运行多少分钟。官方文档source/_actions/ecobee.set_fan_min_on_time.markdown给出的典型场景是希望风扇每小时按固定分钟数持续循环吹风例如让各个房间的温度趋于均衡。这与单纯把风扇“打开/关闭”不同——后者由 climate 实体本身的fan属性反映当前状态on/off而本动作控制的是“每小时最低运行时长”这一设备级设置。ecobee 集成页面source/_integrations/ecobee.markdown的 climate 实体属性表中对同一参数有如下描述属性说明fan风扇当前是开还是关on/off。fan_min_on_time风扇每小时最少运行的分钟数。该值由“minimum fan runtime”设置决定可在 ecobee App 或恒温器本机上修改。从这段描述可以确认ecobee.set_fan_min_on_time动作写入的正是 ecobee 设备的 minimum fan runtime 设置。也就是说你在 Home Assistant 里通过该动作修改后与在 ecobee App 或恒温器面板上手动修改是同一个设置项读取侧则体现在 climate 实体的fan_min_on_time属性上。使用前提已按 ecobee 集成文档 完成集成配置需要 ecobee.com 账户与设备已关联该集成为 Cloud Polling、支持配置流。文档同时注明自 2026.3 起不再需要开发者 API key可改用用户名/密码登录既有 API key 继续有效。在 UI 中配置该动作文档给出的完整 UI 操作路径如下入口为Settings Automations scenes进入Settings Automations scenes。打开一个现有自动化或脚本或选择Create automationCreate new automation。如果是新建自动化先在When部分添加触发条件脚本不需要触发条件它由其他东西调用时执行。在Then do部分选择Add action。在搜索框中搜索并选择ecobee: Set fan minimum on time。设置Fan minimum on time每小时风扇最少运行分钟数可选地选择Entity指定应用到哪台恒温器。选择Save保存。UI 选项选项说明必填Entity要应用该设置的 ecobee 恒温器单台或多台。省略时应用到所有 ecobee 恒温器。否Fan minimum on time风扇每小时最少运行的分钟数取值 060。是在 YAML 中调用该动作在 YAML 中该动作的引用名为ecobee.set_fan_min_on_time。文档给出的基础示例action: | action: ecobee.set_fan_min_on_time data: entity_id: climate.living_room fan_min_on_time: 15效果在climate.living_room这台 ecobee 恒温器上使风扇每小时至少运行 15 分钟。YAML 选项参数类型必填说明entity_idstring否要应用的 ecobee 恒温器也接受恒温器列表省略时应用到所有 ecobee 恒温器。fan_min_on_timeinteger是风扇每小时最少运行的分钟数取值 060。两个使用要点值得注意省略entity_id的影响范围是全局的——它会把该设置应用到 Home Assistant 中的所有 ecobee 恒温器。在多设备家庭网络中若只想改一台设备务必显式写出entity_id。fan_min_on_time为 0 即取消最低运行时长要求风扇只在设备自身逻辑如加热/制冷时才运行60 则意味着风扇每小时实际处于常开状态。一个典型的完整自动化示例将动作嵌入自动化后可实现“夜间自动开启循环风、早晨恢复默认”之类的策略例如alias: 夜间风扇循环 trigger: - platform: time at: 22:00:00 action: - action: ecobee.set_fan_min_on_time target: entity_id: climate.living_room data: fan_min_on_time: 30 mode: single上面target与data分离的写法与其他 ecobee 动作页面如 ecobee.set_dst_mode 中action/target/data三段式示例保持同一风格是自动化编辑器生成的标准结构文档示例中把entity_id直接写在data下的写法同样有效。与其他 ecobee 动作及实体的关系相关动作本动作的文档头部将 Set daylight savings time modeecobee.set_dst_mode与 Set occupancy modesecobee.set_occupancy_modes列为相关动作。目前 ecobee 域在 动作目录 下共有以下已文档化的动作可与本动作组合出更完整的恒温器策略动作说明ecobee.create_vacation在恒温器上创建假期模式ecobee.delete_vacation删除假期模式ecobee.resume_program恢复程序运行ecobee.set_dst_mode启用/禁用夏令时自动切换ecobee.set_fan_min_on_time设置风扇每小时最低运行时间ecobee.set_mic_mode设置麦克风模式ecobee.set_occupancy_modes启用/禁用 Smart Home/Away 与 Follow Meecobee.set_sensors_used_in_climate设置参与 climate 计算的传感器其中与风扇最直接相关的是ecobee.create_vacation它同样带有可选参数fan_min_on_timeinteger060默认 0用于设定假期期间风扇每小时的最低运行分钟数还可配合fan_modeauto/on。从参数命名与取值范围的一致性看假期内的风扇设置与全局的set_fan_min_on_time属于同一维度的控制只是作用域限定在假期时段内。不要混淆的三个“风扇/最小运行时间”概念概念位置含义fan属性climate 实体风扇当前开/关状态on/offfan_min_on_time属性 ecobee.set_fan_min_on_time动作climate 实体 / 动作风扇每小时最少运行分钟数060即本文章主题ventilator_min_on_time_home/ventilator_min_on_time_awayNumber 实体通风机HRV/ERV 配件在家/离家时每小时的最低运行分钟数与风扇设置互不干涉另有ventilator 20 min开关用于一次性定时 20 分钟排风文档演进与参考fan_min_on_time参数说明在 Home Assistant 核心 2025.4 版本的更新日志中曾有专门改进“Improve descriptions offan_min_on_timeinecobeeactions”见 source/changelogs/core-2025.4.markdown。若在其他版本的文档中阅读过该动作的旧描述参数语义060 分钟、entity_id可选且省略即全局生效保持一致。综上ecobee.set_fan_min_on_time是 ecobee 域中专门用于管理“风扇每小时最低运行时长”的写操作UI 与 YAML 两种配置方式参数语义一致省略实体即作用于全部恒温器配合 climate 实体的fan_min_on_time属性可以完成“下发设置 — 回读状态”的闭环。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考