2026.3：一键清扫到底

    Home Assistant 2026.3 来了！🎉

    经历了上个月那次“超大杯”发布后，这次节奏会轻松一些。我们稍微收一收重磅头条，把精力集中在同样重要的事情上：把社区贡献者带来的精彩改动认真评审、打磨并合并。💚

    而社区这次也完全没有让人失望！本次发布包含大量新集成、许多对现有集成的重要改进、海量错误修复，以及一份很棒的集成质量等级升级清单。📈

    像这样的一次发布，最能体现开源社区的力量。每一份贡献都很重要，而这个月更是如此。感谢大家！🙏

    我个人这个月最喜欢的改动？就是自动化编辑器里的这个变化： 出错后继续 终于 在 UI 中落地了。其实这个功能我很多年前就写好了，但当时只能通过 YAML 使用。现在它终于进入可视化编辑器（让每个人都能方便使用），真的太棒了。这种小改动，日常用起来却有巨大差异。🤩

    对了，差点忘了：你看过我们的 全新周边商店了吗？ Open Home Foundation 商店 已经上线！说实话，质量 真的 很好。连帽衫舒服到离谱，我最近几乎天天都在穿。快去看看！🏃

    另外也别忘了记下日期：Open Home 2026 状态大会 将于 4 月 8 日在荷兰乌得勒支举行！欢迎你来到现场，一起庆祝我们共同构建的一切、展望未来，并亲自参与塑造 Open Home 的下一步。门票数量有限， 赶紧抢票！🎟️

    祝你享受本次发布！

    ../Frenck

    衷心感谢所有让本次发布成为可能的贡献者！特别感谢 @TimoPtr、@arturpragacz 和 @MindFreeze 参与撰写本次发布说明，也感谢 @CoMPaTech、@balloob、@OnFreund 和 @silamon 对内容进行打磨。正因如此，这份发布说明才如此完善。❤️

    让吸尘器清扫指定区域

    你有扫地机器人吗？现在你可以精确指定它该清扫哪些区域！本次发布引入了 clean area 动作，让你可以直接在 Home Assistant 中按需让吸尘器清扫一个或多个指定区域。本次发布中，该功能已支持 Matter、Ecovacs 和 Roborock。

    最棒的是，这个动作使用的是你现有的 Home Assistant 区域，而不是厂商特有、难以理解的标识符。你只需要把吸尘器识别到的分区映射到 Home Assistant 里已经设置好的区域，就完成了。

    入门

    当你的吸尘器支持区域清扫时，你可以在吸尘器实体设置中完成映射。打开吸尘器实体，选择 设置图标，然后找到 Map 吸尘器 segments to areas 部分。在这里，你可以把吸尘器识别到的分区对应到 Home Assistant 区域。

    Screenshot of the 吸尘器 area mapping dialog, allowing you to map 吸尘器 segments to Home Assistant areas.

    如果吸尘器内部的分区布局发生变化（例如你在厂商 App 里重新分区，或吸尘器重新识别了环境），Home Assistant 会自动发现。系统会通过修复问题提醒你分区已变更，方便你更新映射，确保两边始终同步。

    为语音控制铺路

    由于映射直接使用 Home Assistant 原生区域，这项功能也为未来的语音助手支持打下了基础。你可以想象一下，只要说一句“清扫厨房”，吸尘器就会自动前往对应区域。这个功能现在还没上线，但基础已经准备好了。

    Energy 仪表盘改进

    本次发布为 Energy 仪表盘带来了一批实用改进。

    Now 视图新增了徽章，可一眼查看实时功耗、燃气流量和用水流量。与此同时，用水在 Now 视图中也拥有了自己的桑基图，像现有电力桑基图一样，直观展示家中各处的用水分布。

    Screenshot of the new badges in the Energy 仪表盘.

    为了减少歧义，Energy 仪表盘的第二个标签页已从 Energy 更名为 Electricity，因为这个仪表盘不仅包含电力，也覆盖燃气和用水。在配置层面，能源设置页面现在拆分为 Electricity、Gas 和 Water 三个标签页，更方便你查找和管理各类能源来源。

    Screenshot of the new tabs in the Energy 仪表盘 设置 page.

    最后，能源柱状图提示信息现在会显示星期几，帮助你更快识别用能规律。

    感谢 @MindFreeze、@NoRi2909 和 @gpoitch！🎉

    自动化编辑器中的“出错后继续”

    自动化编辑器现在为动作提供了 Continue on error 选项，并可直接在可视化编辑器中使用。此前这一设置只能通过 YAML 配置。

    你可以在任意动作的三点菜单 中找到这个选项。启用后，动作行上会出现可视化标记，让你快速识别哪些动作在出错时仍会继续执行。

    Screenshot of the 自动化 editor showing the Continue on 错误 option.

    这对于“某一个动作失败不应阻止其余动作”的自动化场景尤其有用。例如多个通知动作中有一个失败，其余通知仍会正常发送。

    感谢 @wendevlin！🎉

    Android 手机上的唤醒词检测（实验性）

    你的手机现在就是一颗语音卫星！Home Assistant Android Companion App 现已支持设备端唤醒词检测，让你在任何位置都能唤起 Assist；即使手机处于锁屏状态也可以。

    这项功能灵感来自 @brownard 在 Ava 中的出色工作。

    该功能使用 microWakeWord，也就是驱动 Home Assistant Voice Preview Edition 的同款轻量级唤醒词引擎。所有处理都在你的设备本地完成，不会把音频上传到云端，也不需要服务器端处理。你的声音数据始终留在手机上。

    你可以在三个唤醒词之间选择：

    • Okay Nabu
    • Hey Jarvis
    • Hey Mycroft

    要启用唤醒词检测，请打开 Android 设备上的 设置 > Companion App > Assist for Android，并开启 Enable wake word detection 开关。启用后，只需说出你选择的唤醒词，Assist 流水线就会启动并等待你的指令。

    你可以观看下方视频，了解 Android 设备上的唤醒词检测实际效果。

    它已经能与家中的语音设备协同工作；如果附近有其他语音卫星，只有响应最快的那个会接管。本规则同样适用于多台 Android 设备。

    电池消耗

    由于唤醒词检测需要持续占用麦克风与 CPU，这项功能确实会对电池续航产生明显影响。为了更好地管理耗电，你可以使用自动化，根据场景启动或停止唤醒词检测，例如只在连接到家庭 Wi-Fi 或位于指定区域时启用。这样既能在关键时刻实现免手动语音控制，也能避免全天持续耗电。

    Note

    如果 Google 开放硬件热词检测 API，电池消耗本可以大幅降低。遗憾的是，这项能力目前被封装在仅手机厂商可访问的系统 API 背后。希望未来有一天它会向开发者开放，从而改善整体体验。

    感谢 @TimoPtr！🎉

    集成

    感谢我们的社区持续带来新集成，并不断改进现有集成！你们都太棒了 🥰

    新集成

    我们欢迎以下新集成加入本次发布：

    • Ghost，由 @JohnONolan 添加
      直接在 Home Assistant 仪表盘中监测你的 Ghost 发布指标，包括会员数量、收入、文章统计和电子邮件简报表现。

    • Hegel Amplifier，由 @boazca 添加 - 以 🥈 白银质量等级发布
      通过本地网络控制你的 Hegel Music Systems 功放。支持管理电源、音量、输入源选择和静音，并通过实时推送更新即时反馈状态。

    • Homevolt，由 @Danielhiversen 添加 - 以 🥈 白银质量等级发布
      通过本地网络读取你的 Homevolt 电池数据，无需云端。可监测功率、能量、电压、温度和电池状态。

    • Hypontech Cloud，由 @jcisio 添加
      通过 Hypontech Cloud 平台监测你的 Hypontech 太阳能逆变器系统。可追踪发电功率、发电量和系统状态。

    • IDrive e2，由 @patrickvorgers 添加
      将 Home Assistant 备份到 IDrive e2 存储桶。IDrive e2 提供价格亲民、兼容 S3 的云存储，并带有灵活访问控制，用于安全保存备份。

    • Indevolt，由 @Xirt 添加
      通过本地网络直接与你的 Indevolt 储能设备通信。可监测发电、耗电和电池状态。

    • IntelliClima，由 @dvdinth 添加
      集成你的 Fantini Cosmi Ecocomfort 2.0 通风设备。可控制带热回收的机械通风系统的风扇模式和风速。

    • Liebherr，由 @mettolen 添加 - 以 🥈 白银质量等级发布
      通过云端控制并监测你的 Liebherr SmartDevice 冰箱和冷柜。可监测温度、调整制冷设置，并自动化食品安全提醒。

    • MTA New York City Transit，由 @OnFreund 添加 - 以 🥈 白银质量等级发布
      使用 Metropolitan Transportation Authority (MTA) 的数据，获取纽约市所有地铁和公交线路的实时到站预测。

    • MyNeomitis，由 @l-pr 添加
      将你的 Axenco MyNeomitis 供暖与能源管理设备接入 Home Assistant，例如电暖器、毛巾架和地暖系统。

    • OneDrive for Business，由 @zweckj 添加 - 以 🏆 白金质量等级发布
      使用 OneDrive for Business 作为 Home Assistant 备份存储位置。非常适合拥有 Microsoft 365 商业订阅的用户。

    • Powerfox Local，由 @klaasnicolaas 添加 - 以 🏆 白金质量等级发布
      通过本地网络直接采集你的 Powerfox Poweropti 设备数据，更新更快且不依赖云端。

    • Redgtech，由 @Jonhsady 添加
      将你的 Redgtech 智能开关接入 Home Assistant。可控制并监测这一巴西智能家居品牌的云连接开关和继电器。

    • System Nexa 2，由 @konsulten 添加 - 以 🥈 白银质量等级发布
      在本地集成你的 System Nexa 2 智能家居设备。支持控制灯光、开关和智能插座，并支持调光器和户外插座。

    • Teltonika，由 @karlbeecken 添加 - 以 🥈 白银质量等级发布
      监测运行 RutOS 的 Teltonika Networks 路由器。可追踪蜂窝信号质量、调制解调器温度和网络连通性。

    • Trane Local，由 @bdraco 添加
      通过直接 mTLS 连接，在本地网络中控制 Trane 和 American Standard 温控器。无需云端。

    • Zinvolt，由 @joostlek 添加
      在 Home Assistant 中监测你的 Zinvolt 电池，包括荷电状态和其他电池指标。

    本次发布还加入了新的虚拟集成。虚拟集成是由其他现有集成接管的占位集成，用于提升可发现性。本次新增如下：

    现有集成的重要改进

    本次不只是加入了新集成；现有集成也在持续不断改进。以下是一些值得关注的重要变化：

    • Matter 现在支持一氧化碳报警状态和 TVOC 空气质量等级传感器。如果你有获得 Matter 认证的一氧化碳传感器或空气质量设备，它们现在都会显示在 Home Assistant 中。感谢 @Leo2442926161 和 @lboue！
    • HomeKit Controller 现在会暴露水位传感器，因此像 Smartmi Rainforest 加湿器这样的设备也会在 Home Assistant 中显示当前水位。感谢 @romanlytvyn！
    • Reolink 摄像头新增了 5 个对角与连续旋转的 PTZ 按钮，PTZ 巡航开关现在也能正确报告实时状态。感谢 @starkillerOG！
    • SmartThings 现在支持双腔体 Samsung 烤箱，为每个腔体提供单独实体。同时还新增了 Samsung 洗碗机洗涤选项的开关和 select 控件，例如 sanitize、heated dry 和 speed booster。感谢 @mik-laj 和 @edu-tsen！
    • Roborock 现在已完整支持 Zeo 洗烘一体机，包括程序选择、温度控制、烘干模式以及洗涤剂状态传感器。感谢 @yangqian！
    • OpenAI Conversation 现已支持 gpt-image-1.5 图像生成模型用于 AI Tasks，提供更便宜且更快的图像生成。感谢 @Shulyaka！
    • UniFi Protect 摄像头现已支持 PTZ，新增 ptz_goto_preset 动作用于触发预设位，并新增 PTZ 巡航 select 实体，可实时更新状态。感谢 @RaHehl！
    • SwitchBot 现已支持以编程方式为 Keypad Vision 设备添加密码。同时还新增了窗帘设备的慢速模式设置，可降低噪音，并提升厚重窗帘场景下的可靠性。感谢 @zerzhang 和 @ljmerza！
    • Alexa 设备 现已支持 Amazon Air Quality Monitor 设备，新增空气质量指数、VOC 指数、湿度、温度和颗粒物传感器。感谢 @jamesonuk！
    • VeSync 加湿器现已新增一个开关，用于启用或禁用加湿垫自动烘干模式。感谢 @cdnninja！
    • SwitchBot Cloud 现已支持 SwitchBot AI Art Frame，包含电池电量、上一张/下一张图片按钮，以及用于显示当前图片的 image 实体。感谢 @XiaoLing-git！
    • KNX 现已支持直接在 UI 中配置 number 实体并发送当前时间。此外，expose 还新增了定时发送选项，可周期性地将实体状态重新发送到总线。感谢 @farmio！
    • MELCloud 的风冷水机设备现已新增 RSSI 信号强度、冷凝温度、风扇频率和预估产能等传感器。感谢 @ffourcot！
    • Nanoleaf 已将底层库替换为 aionanoleaf2，修复了导致较新款 Nanoleaf Essentials 设备无法连接的授权错误。感谢 @loebi-ch！
    • Uptime Kuma 监控项现已新增 1 天、30 天、365 天维度的在线率与平均响应时间传感器。感谢 @tr4nt0r！
    • Radarr 新增两个动作：radarr.get_movies 和 radarr.get_queue，可返回你媒体库中的电影详情以及当前下载队列信息。感谢 @Liquidmasl！
    • Renault 车辆现已新增按钮，可远程鸣笛或闪灯。感谢 @sebastiaanspeck！
    • Proxmox VE 新增了传感器平台，提供节点、虚拟机和容器的 CPU 使用率、内存使用率、磁盘使用率与状态传感器。感谢 @erwindouna！
    • Mealie 现已新增 get_shopping_list_items 动作，可返回结构化购物清单数据，适用于需要比 to-do 实体更详细信息的自动化。感谢 @andrew-codechimp！
    • Ambient Weather Station 现已为 AQIN 室内空气质量监测器提供传感器，包括 PM2.5、PM10、CO2、温度、湿度和 AQI 测量值。感谢 @n-6！
    • WeatherFlow Tempest 气象站现已将电池电量显示为百分比，以与其他集成保持一致。感谢 @pkolbus！
    • SleepIQ 现已为每位睡眠者新增 5 个睡眠健康传感器：睡眠评分、睡眠时长、平均心率、平均呼吸频率和心率变异性。感谢 @rhcp011235！
    • Anthropic 现已支持 Claude Opus 4.6 模型并提供自适应思考强度等级，同时新增原生结构化输出，以在 4.5 及更新模型上实现更准确的工具调用。感谢 @Shulyaka！
    • Tessie 获得多项增强：车辆新增剩余能量传感器、电池健康诊断，能源站点新增离网与电网状态传感器，并完整支持用于 Home Assistant Energy 仪表盘的能耗历史。感谢 @jrhillery 和 @Bre77！
    • Portainer 现已支持 Docker stack 的监测与控制，包含状态传感器、容器数量以及启动/停止开关。同时新增 prune_images 动作用于清理未使用的 Docker 镜像。感谢 @erwindouna！
    • Nintendo Parental Controls 现已新增就寝结束时间实体，与现有就寝开始时间互补，形成完整的就寝时间表。感谢 @pantherale0！
    • LG Soundbar 现已支持媒体播放/暂停控制，可显示曲目标题、艺术家和专辑封面，并报告播放/暂停状态。感谢 @alexmerkel！
    • Velux 现已支持连接到 KLF 200 网关的开/关开关。感谢 @wollew！
    • Switcher 现已支持 Switcher 加热器设备的监测与控制。感谢 @YogevBokobza！
    • Cambridge Audio 设备现已为兼容型号新增房间校正开关。感谢 @noahhusby！
    • Vera 计量开关现已新增功率和能耗传感器，为你的 Vera 设备带来能耗监测能力。感谢 @jronnols！
    • Control4 温控器现已支持风扇模式控制，包含 Auto、Circulate 和 On 模式。感谢 @davidrecordon！
    • BSB-Lan 现已在温控实体上显示当前 HVAC 动作（heating、cooling、idle），并新增了一个按钮用于同步供暖系统时钟。感谢 @liudger！
    • JVC Projector 新增了大量传感器与控制项：信号源、色深、HDR 状态、图像模式、安装模式、灯光功率，以及 E-Shift 与低延迟模式开关。感谢 @SteveEasley！
    • NRGkick 电动车充电器现已新增开关，可直接在 Home Assistant 中启用或暂停车辆充电。感谢 @andijakl！
    • Green Planet Energy 现已新增当天最高与最低电价时间戳传感器，帮助你更好安排用能时机。感谢 @petschni！
    • Compit 大幅扩展，新增热水器、number 与二元传感器平台，可用于控制热水、调整温度设置，并监测其 HVAC 产品线中的设备状态。感谢 @Przemko92！
    • Saunum 现已新增 start_session 动作，可通过一次调用设置时长、目标温度和风扇时长来启动桑拿会话。感谢 @mettolen！
    • Watts Vision + 现已支持在既有温控支持基础上控制智能开关。感谢 @theobld-ww！
    • Sunricher DALI 现已支持追踪通过 Sunricher 网关连接的 DALI 灯光设备能耗。感谢 @niracler！

    集成质量等级里程碑

    Home Assistant 中有一件让我们无比自豪的事情，那就是集成质量等级。这套等级体系帮助我们和贡献者确保集成具有高质量、可维护性，并能提供尽可能好的用户体验。

    在本次发布中，我们要庆祝多个集成提升了自己的质量等级：

    这对这些集成及其维护者来说都是一项重大成就。要达到这些质量等级，需要投入大量努力与坚持，因为这通常意味着广泛测试、完善文档、处理错误，甚至经常要重写集成的部分内容。

    向所有参与其中的贡献者致以诚挚感谢！👏

    现已可通过 UI 设置

    虽然大多数集成都已经可以直接通过 Home Assistant 用户界面进行设置，但仍有一些过去只能使用 YAML 配置。我们正在持续把更多集成迁移到 UI 中，让每个人都更容易设置和使用它们。

    以下集成现在已可通过 Home Assistant UI 进行设置：

    其他值得关注的变化

    本次发布还有许多其他改进；以下是其中一些值得注意的变化：

    • Matter、Z-Wave、Zigbee 和蓝牙的设置页面已重新组织，以提升清晰度与可发现性。感谢 @matthiasdebaat！
    • 你现在可以让 Assist 从 to-do 列表中移除项目！新的 remove item intent 与现有的 complete item intent 互补，让语音管理清单更轻松。感谢 @mistic100！
    • 统计图卡片编辑器现在提供“Year”可选周期，可直接在 UI 中查看年度趋势。感谢 @karwosts！
    • 安全仪表盘现在也会显示窗户类型的遮盖（自动窗），因此它们会与其他门窗传感器一起显示。感谢 @jhenkens！
    • sections 视图现已支持 footer 卡片，可在视口底部提供一个粘性卡片，类似现有的视图页眉。感谢 @MindFreeze！

    运行于 Python 3.14 🚀

    本次发布运行于 Python 3.14！如果你在想这意味着什么：Python 是 Home Assistant 所使用的编程语言。

    那么，这为什么和你有关？Python 3.14 为 Home Assistant 的基础运行环境带来了性能提升。新版本包含更快的解释器、更短的启动时间以及更好的内存使用表现，这些都会让 Home Assistant 使用起来更加流畅。🚀

    别担心！对于所有官方支持的安装方式，我们都会自动为你处理升级到 Python 3.14 的过程。像平常一样升级 Home Assistant 就可以了！😎

    补丁版本

    我们也会在 3 月为 Home Assistant 2026.3 发布补丁版本。 这些补丁版本只包含错误修复。我们的目标是每周发布一次补丁版本，时间预计在周五。

    2026.3.1 - 3 月 6 日

    需要帮助？加入社区

    Home Assistant 拥有一个非常棒的用户社区，大家都很乐意互相帮助。所以，快来加入我们吧！

    我们非常活跃的 Discord 聊天服务器 是一个很好的去处，也别忘了加入我们的精彩 论坛。

    发现 bug 或遇到问题？请在我们的 issue tracker 中反馈，以便我们修复！你也可以查看我们的 帮助页面，了解还有哪些地方可以寻求帮助。

    如果你更喜欢电子邮件，也可以订阅 Open Home Foundation 新闻通讯，把最新功能动态、社区新闻，以及支持 Open Home 的其他项目资讯直接发送到你的收件箱。

    不向后兼容的变更

    我们始终尽力避免对现有功能做出可能意外影响你 Home Assistant 安装的改动，但有时这确实无法避免。

    我们始终会把这些变化记录清楚，尽可能让过渡更顺利。本次发布包含以下不向后兼容的变更：

    BSB-Lan 热水器的 operation mode 状态值 on 已更改为 performance。如果你在自动化或脚本中使用了这个状态值，则需要更新为新的状态值。

    (@liudger - #160256) (BSB-Lan 文档)

    Home Assistant 容器镜像现在改用 zstd 而不是 gzip 进行压缩。Docker 23.0.0 及以上，以及 containerd 1.5.0 及以上都支持这一变化，因此只要你的环境满足这些最低版本要求，通常不会受到影响。如果你的环境仍在使用更旧版本的 Docker 或 containerd，请在更新前确认容器运行时支持 zstd。

    (@duhow - #160665)

    向 lifx.effect_pulse 动作传入 color_temp 参数（单位为 mired）现已不再被允许。请改用 color_temp_kelvin 参数。

    (@Djelibeybi - #161848) (LIFX 文档)

    使用 color_temp（单位为 mired）来设置灯光色温现已不再受支持。请改用 color_temp_kelvin。

    另外，灯光实体的 color_temp、kelvin、min_mireds 和 max_mireds 状态属性也已移除。请改用 color_temp_kelvin、min_color_temp_kelvin 和 max_color_temp_kelvin。

    (@emontnemery - #161777) (灯光 文档)

    在启动期间，当报警面板仍在上报全部状态时，二元传感器和开关现在的初始状态会是 unknown。此前默认状态为 off，但那其实并不准确，因为面板尚未发送任何数据。

    你受此影响的概率较低，因为大多数状态都会在 Home Assistant 完成设置前被上报；不过在较大的安装环境或较慢的连接中，仍有可能发生。

    (@Tommatheussen - #158533) (Satel Integra 文档)

    Snapcast 分组对应的 media player 实体已被移除。此外，Snapcast 专用的分组动作也已移除。如果你在自动化或脚本中使用了这些实体或动作，则需要更新它们。

    (@luar123 - #160945) (Snapcast 文档)

    引擎开关的 ignition 和 autostart 状态属性已被移除，取而代之的是两个新的二元传感器。如果你的自动化或脚本引用了这些属性，请更新为改用新的二元传感器实体。

    (@epenet - #163289) (StarLine 文档)

    Tado 集成中的移动设备追踪已被移除。移动设备及其关联的设备追踪器实体都将不再可用。这个变化解决了重新认证问题，并减少了 Tado API 上不必要的负载。

    (@erwindouna - #160881) (Tado 文档)

    template 风扇的行为已经发生变化：

    • 如果 state 模板遇到语法错误，template 风扇的状态现在会变为 unavailable。过去，模板错误会让风扇状态显示为 off。
    • 如果 percentage 模板遇到语法错误，那么 percentage 属性现在会是 None；过去则会显示为 0。
    • template 风扇现在也可以拥有 unknown 状态。如果 state 模板返回 None，实体将显示为 unknown，而不再是 off。

    (@Petro31 - #162328) (Template 文档)

    Z-Wave 风扇上报的百分比风速已被修正，以与其他集成保持一致。因此，数值可能会有轻微变化。例如，之前显示为 67% 的值现在可能会显示为 66%。如果你的自动化依赖精确百分比值来触发，可能需要相应调整。

    (@arturpragacz - #163093) (Z-Wave 文档)

    如果你是自定义集成开发者，并希望了解与你的集成相关的变更和新功能，请务必关注我们的开发者博客。以下是本次发布中最值得注意的开发者向变化：

    所有变更

    当然，本次发布的内容远不止这些。你可以在这里查看完整的变更列表：Home Assistant Core 2026.3 完整更新日志.