2026.1：有仪表盘的地方，才是家 🥂#

新年快乐！🥂

希望你度过了一个美好的假期，和所爱之人共享时光。我们用一次相对轻量的发布开启 2026，因为贡献者和维护者们也在享受应得的休息。不过别担心，这次发布依然有很多值得期待的内容！

Home Assistant 2026.1 为移动端带来了焕新的 Home 仪表盘体验，摘要卡片无需额外点按即可直接呈现。我们还让你比以往更容易进入连接设备所用的协议页面，比如 Zigbee、Z-Wave、Thread 等。

对于自动化爱好者来说，我们也在继续推进更“人性化”的触发器。这项功能可通过 Home Assistant Labs 启用，让你能用更容易理解的描述来创建自动化，而不是依赖技术性的状态变化，比如“按下按钮时”或“有人到家时”。

在集成方面，我们迎来了 8 个新成员，包括用 Fressnapf 追踪宠物、用 eGauge 监控能耗，以及通过 Watts Vision + 控制智能供暖。与此同时，社区贡献者们也为现有集成带来了大量改进。

祝你在 2026 年幸福安康！祝你享受本次发布！

../Frenck

• Home 仪表盘改进
  • 更精简的移动端导航
  • 新的设备页面
• 面向用途的触发器与条件进展
• 更轻松地访问协议仪表盘
• 集成
  • 新集成
  • 现有集成的重要改进
  • 集成质量等级里程碑
  • 现已可通过 UI 设置
• 其他值得关注的变化
  • Energy 仪表盘日期选择器
  • ESPHome 动作响应
• 补丁版本
  • 2026.1.1 - 1 月 12 日
  • 2026.1.2 - 1 月 16 日
  • 2026.1.3 - 1 月 23 日
• 需要帮助？加入社区
• 不向后兼容的变更
• 所有变更

衷心感谢所有让本次发布成为可能的贡献者！也特别感谢 @bramkragten、@piitaya 和 @abmantis 参与撰写本次发布说明。❤️

#Home 仪表盘改进

Home 仪表盘 仍在持续进化！在上一次发布中，我们引入了全新的侧边栏布局、天气磁贴和能耗分布摘要。这次发布则进一步带来了更精简的移动端体验和更好的设备管理。

#更精简的移动端导航

在移动设备上，Home 仪表盘现在会将摘要卡片（如灯光、温控、安全、媒体播放器、天气和能耗）直接显示在页面顶部，后面依次是你的收藏和区域。这取代了原先基于标签页的导航方式，让你无需额外点按就能立即访问最重要的内容。

桌面端体验保持不变，摘要内容仍显示在侧边栏的 为你推荐 分区下。

#新的设备页面

有没有想过，把设备从区域中移除之后，它们去了哪里？现在 Home 仪表盘中新增了一个 设备 页面，会显示所有当前未分配到具体区域的设备。这样你就能轻松找到并控制这些“孤立”设备，而不用再到设置里翻找。

新的“设备”页面会显示所有未分配到任何区域的设备。

#面向用途的触发器与条件进展

在上一次发布中，我们引入了面向用途的触发器与条件。现在你在创建自动化时，不必再从技术性的状态变化出发思考，而是可以直接选择像“当灯光开启时”或“当温控正在制热时”这样的自然描述。

这项功能仍在 Home Assistant Labs 中持续打磨，但本次发布新增了_大量_触发器类型，让这种新方式变得更实用。以下是本次发布新增触发器的概览：

• 按钮 触发器会在按钮实体被按下时触发。
• 温控 触发器现在覆盖了常见场景。你可以基于 HVAC 模式变化、目标温度变化，或目标温度跨越阈值来触发。还支持当前温度、当前湿度，甚至目标湿度变化的触发条件。
• 设备追踪器 触发器可基于设备进出家来自动化，支持“第一个设备到家”“最后一个设备离家”或“任意变化”等场景。别担心，面向人物的触发器也快来了，只是设备追踪器版本更早可用。
• 加湿器 触发器会在加湿器开关、开始加湿或开始除湿时触发。你也可以基于湿度变化或湿度跨阈值来触发。
• 灯光 触发器可基于亮度变化，或亮度跨越指定阈值来触发自动化。
• 门锁 触发器现在可在门锁上锁、解锁、打开或卡住时触发。
• 场景 触发器会在场景被激活时触发。
• 警笛 触发器会在警笛开启或关闭时触发。
• 更新 触发器会在有可用更新时触发。

由于新的面向用途触发器与条件都支持定位到比单个实体更大的目标（例如区域、楼层，甚至标签），我们也重新设计了自动化流程中目标的展示方式。

这项改动的目标是让你一眼就能看懂自动化的意图。

前往 设置 > 系统 > Labs 启用面向用途的触发器与条件，立即体验！

#更轻松地访问协议仪表盘

作为一个热爱开放标准、追求设备无缝互联的组织，我们过去确实没有把这点讲清楚！很多人甚至不知道 Home Assistant 为 Zigbee、Z-Wave 等协议提供了专属仪表盘。

本次发布重组了 设置 页面，让这些开放协议拥有更醒目的位置。协议分区现在紧跟核心设置之后，更容易找到你连接设备的各种方式，也能更快进入非常实用的协议专属配置。

这些菜单项只会在你已配置对应集成时显示，因此你看到的内容始终与你的设置相关。

#集成

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

#新集成

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

• AirPatrol，由 @antondalgren 添加
  通过 AirPatrol Wi-Fi 设备，直接在 Home Assistant 中控制你的空调设备。
• eGauge，由 @neggert 添加
  集成 eGauge 能源监测设备，适用于住宅和商业场景，常见于太阳能安装环境。
• Fluss+，由 @Marcello17 添加
  将 Fluss+ Button 接入 Home Assistant，快速轻松地控制你的智能家居。
• Fish Audio，由 @noambav 添加
  使用 Fish Audio 的文本转语音服务，在 Home Assistant 中生成自然流畅的语音。
• Fressnapf Tracker，由 @eifinger 添加
  使用 Fressnapf GPS Tracker 追踪宠物位置并监测它们的活动情况。
• HomeLink，由 @ryanjones-gentex 添加
  接入你的 HomeLink 设备，让你在车内也能触发智能家居例程。
• Watts Vision +，由 @theobld-ww 添加
  控制 Watts Vision + 智能供暖系统，实现对家庭各供暖分区的远程控制。
• WebRTC，由 @balloob 添加
  一个内部集成，为 Home Assistant 中的摄像头串流提供 WebRTC 功能。

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

• Levoit，由 VeSync 提供，@timmo001 添加

#现有集成的重要改进

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

• @lboue 为 Matter 集成新增了 3 个用于温控远程感测状态的诊断二元传感器，帮助你更好地掌握温控系统状态。
• @joostlek 为 SmartThings 集成添加了大量新传感器，包括 PM1、PM2.5 和 PM10 空气质量传感器、油烟机滤网使用追踪、单门冰箱温度传感器，以及抽油烟机风扇速度控制。
• 感谢 @Lash-L 添加了基础只读支持，拥有 Q7 设备的 Roborock 用户现在也能接入这些设备，并获得电池、状态和清扫数据等传感器。
• @mib1185 改进了 FRITZ!SmartHome 集成，新增开关实体，让你可以直接在 Home Assistant 中启用或禁用 FRITZ! Smart Home 例程（触发器）。
• 得益于 @mib1185，Ping 集成现在可以追踪丢包率。新的传感器会以百分比显示丢包率，默认处于禁用状态。
• @Shulyaka 为 OpenAI 集成加入了对 GPT-5.2 和 GPT-5.2-pro 模型的支持，并新增了 xhigh 推理强度等级。
• @DCSBL 为 HomeWizard 集成新增了两种电池充电模式：仅零充电和仅零放电，让你对储能系统有更细粒度的控制。
• @Abestanis 扩展了 KNX 的 UI 配置，支持 time、date 和 datetime 实体；同时 @farmio 新增了传感器、场景、text 和风扇实体，让 KNX 安装配置比以往更轻松。
• 感谢 @wollew，Squeezebox 集成现在支持报警监控：你可以通过二元传感器查看报警是否即将触发、已激活或已贪睡，还能通过时间戳传感器查看下一次报警时间。
• @andrew-codechimp 为 Mealie 3.7 新增了对更多餐食计划类型的支持，包括甜点、饮品和零食，让你的餐食规划更加灵活。
• @ptarjan 为 Hikvision 集成加入了 NVR 支持，包括扩展事件检测和视频通道自动发现。
• @FredericMa 为 Risco 集成新增了 set_time 动作，让你可以同步本地报警面板时钟，解决烦人的时钟漂移问题。
• @heindrichpaul 对 Nederlandse Spoorwegen 集成进行了大幅重构，将原本单体式传感器拆分为 15 个以上独立传感器，每条线路一个，大大方便了特定行程追踪。
• @zweckj 为 La Marzocco 集成的主开关实体加入了一张精美的咖啡机实体图片。
• @kclif9 为 Actron Air 集成新增了开关平台，暴露了 Away Mode、Continuous 风扇、Quiet Mode 和 Turbo Mode 控制项。
• @Djelibeybi 大幅升级了 Pooldose 集成：你现在可以获得用于监测液位的水表传感器、用于配置投药目标的 number 实体，以及用于控制泳池运行模式的 select 实体。
• 得益于 @antondalgren 新增的传感器实体，AirPatrol 集成现在可以监测温度和湿度。
• @mettolen 为 Airobot 集成新增了传感器和 number 平台，让你可以监测空气质量数据，并控制迟滞带设置。

衷心感谢所有改进这些集成的贡献者，也感谢所有未在这里列出的其他改进贡献。正是你们的工作，让 Home Assistant 对每个人都变得更好！❤️

#集成质量等级里程碑

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

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

• 2 个集成达到铂金等级 🏆

  • KNX，感谢 @farmio
  • UniFi Protect，感谢 @RaHehl

• 4 个集成达到白银等级 🥈

  • Autarco，感谢 @klaasnicolaas
  • SFR Box，感谢 @epenet
  • Squeezebox，感谢 @peteS-UK、@pssc 和 @rajlaud
  • Watergate，感谢 @adam-the-hero

• 2 个集成达到青铜等级 🥉

  • Growatt Server，感谢 @johanzander
  • TP-Link Omada，感谢 @MarkGodwin

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

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

#现已可通过 UI 设置

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

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

• Hikvision，由 @ptarjan 完成
• VIVOTEK，由 @HarlemSquirrel 完成

#其他值得关注的变化

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

• 如果你在监控家中的油箱或其他低流速设备，可能会喜欢 @StaleLoafOfBread 新增的体积流量单位 加仑/天（gallons per day）。这个单位尤其适合追踪取暖油或类似资源的每日消耗速率。
• 你有 Matter 音箱吗？@lboue 为 Matter 集成加入了音量控制支持，为使用 LevelControl 集群的 Matter 音箱提供音量滑块实体。
• statistics graph 卡片 现在也会在标题中显示通往历史面板的链接，就像原本的 history graph 卡片一样。选择该链接后，会直接打开已预选相同实体和时间范围的历史视图，感谢 @joepio。
• 当你在 picture elements 卡片中使用 状态 badge element 时，现在可以设置自定义 name 选项，从而让你的仪表盘设计更加灵活，感谢 @ildar170975。
• 在 2025.11 中，我们通过停用重复日志文件来提升日志效率。本次发布加入了一个新的配置选项，让你在需要时重新启用它。如果你在使用官方 Terminal & SSH add-on，请确保它已更新到 9.22.0 或更高版本，才能使用该选项。Advanced SSH & Web Terminal add-on 目前还未更新，但很快会跟上。
• 对于集成开发者，@bramkragten 新增了一个 choose 选择器，允许用户在 UI 中从不同输入类型之间进行选择。之后你会在需要灵活输入的多个位置看到它出现。

#Energy 仪表盘日期选择器

在上一次发布中，Energy 仪表盘迎来了一次大更新，加入了实时功率监控和下游用水追踪。不过，其中一些用户注意到，在不同时间区间之间切换时必须先滚回页面顶部，这让你在查看页面较下方的图表时更难比较数据。

本次发布修复了这个问题！日期选择器现在会固定在屏幕底部，因此你可以在日、周、月之间轻松切换，而不会失去当前正在查看图表的上下文。这也让它在移动设备上更容易使用。

#ESPHome 动作响应

ESPHome 2025.12 引入了一项强大的新特性：API 动作响应，让你的 ESPHome 设备与 Home Assistant 之间实现真正的双向通信。通过本次发布，Home Assistant 现在已经完全支持接收这些响应！

过去，当你对 ESPHome 设备调用动作时，通信是单向的：你可以发送命令，但设备无法返回结构化数据。现在，ESPHome 设备可以在响应动作时返回 JSON 数据，这带来了新的可能性，比如查询设备配置、按需读取传感器数值，或获取诊断信息。

这对那些“回答问题”而不是“执行任务”的动作尤其有用。比如，你可以创建一个动作，返回设备当前的 Wi-Fi 信号强度、固件版本，或任意自定义传感器读数，并将这些结构化数据直接用于自动化。

如果想开始使用，请查看 ESPHome 关于动作响应的文档，其中包含配置示例。

#补丁版本

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

#2026.1.1 - 1 月 12 日

• 修复 Hikvision NVR 二元传感器未被检测到的问题 (@ptarjan - #160254)
• 将 eheimdigital 升级到 1.5.0 (@autinerd - #160312)
• 将 ZHA 升级到 0.0.84 (@TheJulianJES - #160440)
• 将 pyOverkiz 升级到 1.19.4 (@iMicknl - #160457)
• 修复 anthropic 工具结果中 time 对象的 JSON 序列化问题 (@dcermak - #160459)
• 为 Backblaze B2 上传增加 asyncio 级超时机制 (@ElCruncharino - #160468)
• 修复 RequirementsManager 中的依赖解析问题 (@epenet - #160485)
• 新增 Nettleie 优化选项 (@osohotwateriot - #160494)
• 将 python-otbr-api 升级到 2.7.1 (@emontnemery - #160496)
• 修复少数罕见 Velux 窗型的雨量传感器问题 (@wollew - #160504)
• 修复触发器选择器问题 (@bramkragten - #160519)
• 将 Intergas Incomfort-client 升级到 v0.6.11 (@jbouwh - #160520)
• 回滚“升级 voluptuous 和 voluptuous-openapi”改动 (@synesthesiam - #160530)
• 将 serialx 升级到 v0.6.2 (@puddly - #160545)
• 捕获 Teslemetry 中所有迁移失败情况 (@Bre77 - #160549)
• 修复 Tractive 在健康数据缺失或不完整时的 AttributeError (@bieniu - #160553)
• 将 pysilero-vad 升级到 3.1.0 (@synesthesiam - #160554)
• 修复老款 Fritzbox（不支持 Smart Home 触发器）的问题 (@mib1185 - #160555)
• 将 google-air-quality-api 升级到 2.1.2 (@Thomas55555 - #160561)
• 修复 Teslemetry 中的温控信号问题 (@Bre77 - #160571)
• 将 pysma 升级到 1.1.0 (@kellerza - #160583)
• 将 opower 升级到 0.16.1 (@tronikos - #160588)
• 修复 Tesla Fleet 的配置流程问题 (@Bre77 - #160591)
• 为 WLED 补充缺失的分段速度图标 (@Tommatheussen - #160597)
• 改进对 Tibber 限流的处理 (@Danielhiversen - #160599)
• 将部分 enphase_envoy 电池实体的设备类别改为 energy_storage (@catsmanac - #160603)
• 修复 Z-Wave 在空闲状态下创建通知二元传感器的问题 (@MartinHjelmare - #160604)
• 将 pynintendoparental 升级到 2.3.2 (@pantherale0 - #160626)
• 将前端升级到 20260107.1 (@bramkragten - #160644)
• 将 pyhik 升级到 0.4.0 (@ptarjan - #160654)
• 将 greeclimate 升级到 2.1.1 (@cmroche - #160683)
• 将 pysilero-vad 升级到 3.2.0 (@synesthesiam - #160691)
• 为修复数据缺失问题，将 bthome-ble 回滚至 3.16.0 (@Ernst79 - #160694)
• 修复 lamarzocco 中按重量萃取缺失键的问题 (@zweckj - #160722)
• 将 pytado 升级到 0.18.16 (@erwindouna - #160724)
• 将 python-homewizard-energy 升级到 10.0.1 (@DCSBL - #160736)
• 修复 fitbit 图标问题 (@joostlek - #160750)

#2026.1.2 - 1 月 16 日

• 修复 Airzone Q-Adapt select 实体问题 (@Noltari - #160695)
• 回滚到 microVAD (@synesthesiam - #160821)
• 将 opower 升级到 0.16.2 (@tronikos - #160822)
• fressnapf_tracker 的 sms_code 现在接受前导零 (@eifinger - #160834)
• 版本升级脚本新增对 packaging 版本 >= 26 的支持 (@edenhaus - #160858)
• 将 PyNaCl 升级到 1.6.2 (@cdce8p - #160909)
• 将 pyenphase 从 2.4.2 升级到 2.4.3 (@catsmanac - #160912)
• 将 Essent 更新间隔缩短为 1 小时 (@jaapp - #160959)
• 将 opower 升级到 0.16.3 (@tronikos - #160961)
• 将 PySrDaliGateway 从 0.18.0 升级到 0.19.3 (@niracler - #160972)
• 为 openai_conversation 增加描述信息 (@zweckj - #160979)
• 清理不必要的 Z-Wave“设备配置已更改”修复项 (@AlCalzone - #161000)
• 将 knx-前端升级到 2026.1.15.112308 (@farmio - #161004)
• 蓝图 WebSocket 命令现在要求管理员权限 (@edenhaus - #161008)
• 将 aiomealie 升级到 1.2.0 (@andrew-codechimp - #161058)
• 将前端升级到 20260107.2 (@bramkragten - #161061)
• 将 aioairzone 升级到 v1.0.5 (@Noltari - #160688)

#2026.1.3 - 1 月 23 日

• 将 uiprotect 升级到 8.1.1 (@RaHehl - #160816)
• 更新 London Air 的支持地区列表 (@allanlewis - #160884)
• 将 onedrive-personal-sdk 升级到 0.1.0 (@zweckj - #160976)
• 调整 Matter 设备电池电压传感器的显示精度 (@lboue - #161088)
• 修复 wiz 中色温属性问题 (@arturpragacz - #161125)
• 将 xiaomi-ble 升级到 1.4.3 (@terop - #161132)
• 将 opower 升级到 0.16.4 (@tronikos - #161153)
• 修复单个事件中多个智能对象类型的检测问题 (@RaHehl - #161189)
• 修复 moving 状态的图标问题 (@stickpin - #161194)
• 将 onedrive-personal-sdk 升级到 0.1.1 (@zweckj - #161337)
• 将 uiprotect 升级到 10.0.0 (@RaHehl - #161350)
• 将配置条目迁移为字符串唯一 ID (@edenhaus - #161370)
• 将 uiprotect 升级到 10.0.1 (@RaHehl - #161397)
• 将 Insteon 面板升级到 0.6.1 (@teharris1 - #161411)
• 将 music-assistant-client 升级到 1.3.3 (@arturpragacz - #161438)
• 回滚容器安装中 server_host 的弃用改动 (@emontnemery - #161443)
• 将 opower 升级到 0.16.5 (@tronikos - #161450)

#需要帮助？加入社区

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

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

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

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

#不向后兼容的变更

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

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

Coolmaster 集成提供的温控实体现在使用 medium 表示中档风扇模式；在此之前，该值为 med。如果你的自动化在设置或查询风扇速度时使用了 med，现在需要将其改为 medium。

(@tan-lawrence - #157253) (coolmaster docs)

Tailscale 集成中的“支持 Hairpinning”二元传感器已被移除。根据 Tailscale 官方 API 文档，这项信息已经不再被追踪，并且始终会返回 null。

(@CraigCallender - #156728) (tailscale docs)

选择（select）实体的状态值已从原本的混合大小写格式改为带有正确翻译的 snake_case 格式。这提升了一致性，也使本地化支持更加完善。

受影响的选择实体包括：提示音类型（chime type）、录制模式（recording mode）、红外模式（infrared mode）、状态灯模式（status light mode）、HDR 模式（HDR mode）、门铃文本（doorbell text）、LCD 消息（LCD message）等。

示例变化如下：

• 提示音类型（Chime type）：Mechanical → mechanical，Digital → digital
• 录制模式（Recording mode）：Always → always，Detections → detections，Never → never
• 红外模式（Infrared mode）：Auto → auto，On → on，AutoNoLEDsOn → auto_no_leds_on
• 状态灯模式（Status light mode）：On → on，Off → off，OnWhenDark → on_when_dark
• HDR 模式（HDR mode）：Auto → auto，On → on，Off → off

如果你的自动化、脚本或模板会检查或设置 UniFi Protect select 实体的状态，则需要更新它们，改用新的 snake_case 值。UI 仍会继续显示经过正确翻译、适合人类阅读的文本。

(@RaHehl - #159284) (unifiprotect docs)

Telegram bot 动作不再允许额外或未使用的参数。只有那些曾在 Telegram bot 动作中使用未定义参数的用户会受到影响。如果你属于这种情况，请从自动化和脚本中移除这些参数。支持的参数可在 Telegram bot 通知动作 文档中查看。

(@hanwg - #158886) (telegram_bot docs)

advancedSleep 风扇模式现已改为 advanced_sleep。如果你的自动化或脚本使用了这个风扇模式，请相应更新。

(@cdnninja - #158956) (vesync docs)

如果你是自定义集成开发者，并希望了解与你的集成相关的变更和新功能，请务必关注我们的开发者博客。

#所有变更

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