2025.12：为假期按下触发器 🎄#

Home Assistant 2025.12 发布！🎄

随着年末临近、假期将至，我们用这次发布为 2025 年收尾，而它的主题就是：给你更多掌控力，再加上一点点魔法。✨

本月，我们正式推出 Home Assistant Labs，这是一个全新的空间，让你可以在功能正式普及前就先行体验。那有什么比用 Winter mode 作为开场更合适呢？❄️ 启用它后，你就能看到雪花飘过你的仪表盘。它完全不是刚需，却让人非常开心，而且这正是我们最爱打造的那类功能。❄️

但这还只是开始。过去几个版本里，我们一直在努力让自动化更直观，而这次发布终于带来了特定用途的触发器和条件。你不再需要从数字状态的角度去思考，而是可以直接表达成“当一盏灯打开时”或“如果温控正在制热”。自动化的构建方式终于更贴近人的思维方式了，本来就该如此。🧠

哦，如果你也想升级自己的 Zigbee 或 Thread 网络，别忘了看看我们上个月发布的 Home Assistant Connect ZBT-2。它快了四倍，还拥有一套漂亮的新天线设计，甚至会让你想把它摆在桌面上展示。📡

Home Assistant 团队全体成员想对你说：

感谢你陪我们走过如此精彩的 2025 年！ ❤️

节日快乐，也祝你享受这次发布！

../Frenck

Jingle Labs 作者：Frenck 与 Darren

穿梭代码之间，
全新 Labs 登场，
雪花缓缓飘落，
看仪表盘发亮！
触发器终于清晰，
条件也刚刚好，
把智能家居自动化，
每晚都真叫妙！

副歌
Jingle Labs, Jingle Labs，
新功能正赶来！
每天运行 Home Assistant，
真的乐开怀！

Jingle Labs, Jingle Labs，
Winter mode 登场！
一个念头灯就亮，
节日气氛满屋扬！

功率图已上线，
水表也加入，
每位用户都可以，
设置自己的仪表盘视图！

Xbox 收到关爱，
Shelly 晋升白金，
今年贡献者火力全开，
请接受最后一鞠躬！

副歌
Jingle Labs, Jingle Labs，
触发器大获全胜！
温控、灯光、风扇齐上阵，
让自动化转个不停！

Jingle Labs, Jingle Labs，
真的非常感谢大家！
祝你节日快乐， 现在快去自动化点什么吧！

• Home Assistant Labs 实验室 🧪
• 特定用途触发器与条件
• 更多仪表盘改进！
  • 设置系统级默认仪表盘
  • 重新排序区域与楼层
  • 实验性仪表盘毕业了
  • Home 仪表盘改进
  • 仪表盘编辑器中的撤销与重做
• 能源仪表盘中的电力与水
  • 实时功率监测
  • 下游水表
  • 新的能源布局
• 集成
  • 新集成
  • 现有集成的重要改进
  • 集成质量等级成果
  • 现已可通过 UI 设置
• 告别以下集成
• 其他值得注意的变化
• 深入了解你的 AI 对话
• 将实体添加到 Android 小组件和收藏夹
• 补丁版本
  • 2025.12.1 - 12 月 5 日
  • 2025.12.2 - 12 月 8 日
  • 2025.12.3 - 12 月 12 日
  • 2025.12.4 - 12 月 19 日
  • 2025.12.5 - 12 月 29 日
• 需要帮助？加入社区
• 不向后兼容的变更
• 所有变更

特别感谢所有让这次发布成为现实的贡献者！也要特别感谢帮助撰写本次发布说明的 @TimoPtr、@laupalombi、@jlpouffier 和 @MindFreeze。另外， @edenhaus 、@tr4nt0r、@jpbede、@RaHehl、@bieniu、@arturpragacz 和 @piitaya 也为润色内容投入了很多精力。正因为有他们，这份发布说明才如此出色。❤️

#Home Assistant Labs 🧪

当我们为 Home Assistant 开发新功能时，常常会遇到一个微妙的问题：某项功能也许已经完整实现并通过测试，但我们还不完全确定它是否已经适合所有人。也许我们想先收集真实世界中的反馈，或者想先看看社区会怎么使用它，再决定是否长期保留。

这正是 Home Assistant Labs 出场的原因！🧪

Labs 是 Home Assistant 中一个全新的区域，让你可以抢先看到我们正在开发的功能。它们并不是未完成的实验，也不是不稳定的测试版功能。这些功能已经可以正常使用，并且经过测试，但它们仍可能根据反馈而发生变化，甚至被移除。我们始终坚持开放开发，也希望让更多人能选择和我们一起进入“实验室”。你的参与和反馈，会直接帮助这些功能为整个社区变得更好。

Labs 中提供的第一个预览功能，就是 Winter mode ❄️。它灵感来自 Reddit 上一篇社区帖子，原作者是 u/Possible-Week-5815。启用后，你会看到 Home Assistant 界面在飘雪中变成冬日仙境。这是一个非常有趣的方式，让你提前进入节日氛围！

启用预览功能时，你还可以先创建一个备份，以防万一。如果你后来改变主意了？只要把它关掉就行，不需要重启！

预览功能默认都是关闭的，启用它们不会影响你现有的设置。它完全是可选的，所以如果你更愿意坚持已经经过大量验证的稳定体验，那当然也完全没问题。但如果你对未来的新功能感到好奇，并想提前探索接下来会发生什么，那么 Labs 就是你该去的地方。

那么，我们放进 Labs 里的第一个预览功能到底是什么？嗯，这可是个大家伙……

#Purpose-specific 触发器 and 条件

差不多两年前，我们发布了全新的自动化编辑器，把各种动作都“拆开摊平”，让它们更容易理解。你不再只看到一个晦涩的 “Call service” 动作，而是能看到像 “Light: Turn on” 或 “Media Player: Set Volume” 这样清晰直接的选项。

从那时起，我们就一直在想：能不能也对触发器和条件做同样的事？我们是否可以不再依赖那些偏技术化、基于状态的选项，而是提供一些更直观、更符合直觉的表达？比如“当一盏灯打开时”或者“如果一盏灯已打开”。

这个想法推动了一项历时两年的计划，而今天，它终于变成现实了。

在这个过程中，我们还发现了一件很有意思的事：很多人在构建自动化时，其实采用的是“目标优先”的思路。你会先想清楚 要自动化什么（某台设备、某个实体，或某个区域），然后才去考虑 怎样自动化它（执行哪个动作、使用哪个触发器）。这次发布正是顺着这种思维方式，带来了一套全新的自动化构建方式。

特定用途的触发器和条件现在会由 Light、Climate、Fan 等域直接提供，从而覆盖最常见的自动化使用场景。

这些新的触发器和条件完整支持目标选择。这意味着你现在可以在客厅中 任意一盏 灯打开时触发自动化，而无需逐个列出它们，也不用提前创建分组。以区域为目标会让事情变得更简单：它始终与你家的组织方式保持一致，而且在你添加或移除设备时，也不需要手动更新任何内容。

标签同样也受支持！现在你可以检查自己那些圣诞灯里是否有任何一盏还亮着。这个时间点简直再合适不过了！🎄

我们还引入了一种新的方式来选择触发器、条件和动作，以更好匹配“目标优先”的思路。你可以先按楼层浏览家，再进入区域、设备，并清楚看到每个目标有哪些可用选项。这让构建自动化的过程直观了许多。

这项功能仍在持续打磨中，因此我们把它作为 Labs 中的预览功能开放出来。前往 Settings > System > Labs 启用它，并和我们一起塑造自动化构建的未来吧！

#更多仪表盘改进！

这次发布中，我们有很多仪表盘方面的改进想与你分享！从更好的默认仪表盘管理，到更完善的 Home 仪表盘，我们一直在努力让你的 Home Assistant 体验变得更好。

#设置系统级默认仪表盘

选择默认仪表盘现在已经变成一个系统级设置，并会立即对你 Home Assistant 安装中的所有用户生效。你选择的仪表盘会出现在侧边栏顶部，取代当前默认项。

不过别担心，个人偏好依然很重要！我们在你的 User profile 中新增了一项设置，你可以覆盖系统默认值，并选择自己偏好的仪表盘。

如果你过去曾把手机设为一个仪表盘、墙上的平板设为另一个，那么它们现在都会回到默认仪表盘。如果你希望墙上平板使用与其他设备不同的仪表盘，我们建议为它单独创建一个用户资料，这样你就可以随意定制。

#重新排序区域与楼层

在使用内置仪表盘体验（如 Home、Lights、Security 等）时，一个主要痛点就是区域始终按字母顺序排列，而楼层则始终按层级数字排序。在真实家庭中，这种顺序常常毫无意义——比如客用卫生间不该排在客厅前面，而阁楼通常也不会比主楼层更重要。

现在，你可以前往 Settings > Areas, labels & zones，并使用新的 Reorder floors and areas 菜单，通过拖放手动调整任意区域或楼层的顺序。你的更改会立即应用到所有显示区域和楼层的内置仪表盘中。

#实验性仪表盘毕业了

随着 Labs 的推出，我们把创建仪表盘列表中的“实验性”标记移除了。Home 仪表盘现在已经会出现在仪表盘列表中（但默认仍不会显示），而 Areas 仪表盘已经演进成 Home，因此我们暂时将它移除。如果你当前正在使用 Areas 仪表盘，它仍然会继续工作；只是你不能再新建一个了。

#Home 仪表盘改进

我们为 Home 仪表盘加入了一个新的侧边栏，用来汇总我们认为对你有帮助的快捷访问链接。同时，区域和楼层布局也变得更好看，并且能更高效地利用空间。从更技术层面来说，Home 仪表盘现在已经是一个真正的内置仪表盘，并会显示在仪表盘列表中。

:::important 在这次发布中，你当前的 favorites 有可能会暂时消失，并需要重新添加。这是因为这个仪表盘从 strategy 类型迁移成了内置仪表盘。 :::

#Undo and redo in the 仪表盘 editor

仪表盘编辑器现在也加入了我们在 2025.10 中带给自动化与脚本编辑器的撤销与重做功能。这让你在编辑仪表盘时可以更放心地尝试各种改动。你最多可以撤销 75 次更改，也可以一键重做回来，让仪表盘编辑更快、更轻松、也更没有压力。

感谢 @jpbede 实现了这个实用功能！

#能源仪表盘中的电力与水

多年来，Energy 仪表盘一直在帮助你追踪能源和燃气使用情况，而这次发布又带来了两个非常棒的新能力：实时功率监测 和 下游用水追踪。

#实时功率监测

直到现在，Energy 仪表盘一直关注的是“能量”——也就是一段时间内累计消耗或产生的 kWh。但有时候，你也会想知道 此时此刻 正在发生什么。某个设备现在到底在消耗多少功率？你的太阳能系统此刻正在发电吗？

在这次发布中，你现在可以和能量传感器一起配置 power 传感器。你可以追踪实时电网用电量、查看回馈到电网的功率，并实时观察这些瓦数如何流动。功率配置项现在会与每个来源或设备的能量设置一起显示，而新的功率图表则能让你看到一整天中的功率变化。

#下游水表

Energy 仪表盘已经支持追踪你的用水量一段时间了，但它一直缺少一个能力：查看这些水究竟 流向了哪里。就像你可以按单个设备追踪能耗一样，现在你也可以加入 下游水表，把用水情况拆分开来看。

你有智能灌溉控制器吗？带流量计的软水器？或者泳池专用的独立水表？现在你都可以追踪它们，并清楚看到你的用水量是如何分布到不同用途上的。

我们还加入了一张全新的 water sankey 卡片，用来可视化你的水流走向，就像你已经熟悉的能源 Sankey 图那样。它能让你一眼看出水到底用到了哪里。

新的 water sankey 卡片可以让你一眼看出家中的水都流向了哪里。

#新的能源布局

为了给这些新功能腾出空间，Energy 仪表盘也重新做了组织。别担心：如果你只配置了能源，那么看到的仍然会是熟悉的仪表盘。但如果你加入了水、燃气或功率项目，仪表盘就会拆分成多个标签页。

#集成

感谢社区持续推动新集成的加入以及现有集成的改进！你们真的太棒了 🥰

#新集成

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

• Airobot，由 @mettolen 添加
  通过本地 REST API 控制并监测你的 Airobot 智能温控器，实现智能地暖控制。
• Anglian Water，由 @pantherale0 添加
  接入你的 Anglian Water 智能水表，以追踪用水量和用水成本。
• Backblaze B2，由 @ElCruncharino 添加
  使用 Backblaze B2 云存储桶作为 Home Assistant 备份的存储位置。
• EnergyID，由 @Molier 添加
  将家中的各类数据直接同步到 EnergyID，用于高级分析、性能追踪与基准对比。
• Essent，由 @jaapp 添加
  为荷兰采用浮动电价合同的 Essent 用户监测动态电价和燃气价格。
• Google Air Quality，由 @Thomas55555 添加
  通过 Google Air Quality API 获取你所在位置的实时空气质量数据。
• Google Weather，由 @tronikos 添加
  使用 Google Weather 作为天气数据来源，提供当前状况、未来 24 小时逐小时预报，以及未来 10 天逐日预报。
• Hanna，由 @bestycame 添加
  从你的 Hanna Pool Controller 设备获取泳池水质数据，包括 pH、氯含量、ORP 数值和水温。
• Home Assistant Labs，由 @frenck 添加
  一个专门面板，让你在新功能成为 Home Assistant 标准功能前先行预览与测试。
• Philips Hue BLE，由 @flip-dots 添加
  无需 Hue Bridge，即可在 Home Assistant 中直接控制 Philips Hue 蓝牙灯光。
• Saunum，由 @mettolen 添加
  接入你的 Saunum Leil 桑拿控制单元，精确控制温度并监测桑拿运行状态。
• Victron BLE，由 @rajlaud 添加
  接入支持蓝牙低功耗协议的 Victron Energy 设备，实现实时监测。

这次发布还包含新的虚拟集成。虚拟集成本质上是由其他现有集成负责处理的占位项，用来提升可发现性。新增的有：

• Cosori，由 VeSync 提供，@joostlek 添加
• VÁGNER POOL，由 SEKO PoolDose 提供，@lmaertin 添加

#现有集成的重要改进

新增的不只是新集成；现有集成也在持续不断改进。以下是一些值得关注的变化：

• @piitaya 更新了 ESPHome 集成，让 Home Assistant 可按标准规则生成实体 ID，与其他集成保持一致。
• 感谢 @bdraco，你现在可以在 Home Assistant 中通过蓝牙直接为 Shelly 第二代及以上设备配置 Wi-Fi。
• Shelly 现已支持即将发布的 Shelly Cury 设备控制模式。干得漂亮，@bieniu！
• 感谢 @gjohansson-ST，System Monitor 现在可为你的系统提供风扇传感器和电池传感器。
• Tuya 集成迎来大量更新！猫砂盆设备现在可暴露开关、按钮、灯光和传感器，用于控制宠物自动猫砂盆；另外也新增了门铃事件支持。感谢 @heindrichpaul！
• @starkillerOG 扩展了 Reolink 集成，为受支持摄像头加入曝光模式选择实体和音频降噪控制。
• OpenAI Conversation 集成现已支持 GPT-5.1 模型。感谢 @Shulyaka 的出色工作！
• Home Connect 集成新增了空调和微波炉支持，进一步扩展了受支持的 BSH 家电范围。感谢 @Diegorro98！
• @zerzhang 为 SwitchBot 集成加入了 SwitchBot 智能暖气片温控器支持。很赞！
• @tr4nt0r 为 Xbox 集成带来多项增强！你现在可以关联多个 Xbox 账号，统计你和好友的好友数量，查看是否正在组队，并控制更多远程功能。媒体浏览器还新增了官方游戏美术图与截图分类。
• 你有 Ecovacs 机器人吗？Ecovacs 集成现在新增了边缘旋转开关（拖地时可照顾边角区域）以及自动集尘选择实体。感谢 @aronnebrivio！
• VeSync 集成新增了儿童锁开关，让你可以控制设备这项安全功能。感谢 @cdnninja！
• @XiaoLing-git 为 SwitchBot Cloud 集成加入了 SwitchBot 智能暖气片温控器支持。
• SQL 集成现在支持在查询中使用模板，让数据库查询更灵活。很棒的补充，感谢 @gjohansson-ST！
• @tomwilkie 扩展了 Prometheus 集成，支持导出 water_heater 域的指标。
• Anthropic 集成现在支持 AI 任务实体。感谢 @Shulyaka！
• Portainer 现在可以显示容器资源使用情况。干得漂亮，@erwindouna！
• @thomasddn 为 Volvo 集成加入了一个按钮，可为兼容车辆启用低防护模式。
• Plugwise 集成现已支持新的 Anna P1 设备，并为 Adam 设备新增了分区配置文件选择实体。感谢 @bouwew！
• Bang & Olufsen 用户现在可以在 Home Assistant 中使用 Beoremote One。遥控器按键会以事件实体形式暴露。太棒了，@mj23000！
• @VandeurenGlenn 为 Niko Home Control 增加了温控平台，让你可以控制 Niko 供暖分区。
• Saunum 集成现已支持风扇控制，让你可以控制桑拿通风系统。感谢 @mettolen！
• @nasWebio 为 NASweb 集成加入了报警控制面板支持，让你可以布防和撤防安防系统。
• Nederlandse Spoorwegen 集成完成了重构，以提升可靠性与可维护性。感谢 @heindrichpaul！

#集成质量等级成果

Home Assistant 中有一项让我们非常自豪的东西，就是[集成质量等级]。这个等级体系帮助我们和贡献者确保集成具备高质量、可维护性，并能提供尽可能出色的用户体验。

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

• 2 个集成达到白金级 🏆

  • Brother Printer，感谢 @bieniu
  • Shelly，感谢 @davidrapan

• 1 个集成达到金牌级 🥇

  • Google Assistant SDK，感谢 @tronikos

• 2 个集成达到银牌级 🥈

  • LCN，感谢 @alengwenus
  • Telegram bot，感谢 @hanwg

• 2 个集成达到铜牌级 🥉

  • Music Assistant，感谢 @OzGav
  • Transmission，感谢 @andrew-codechimp

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

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

#现已可通过 UI 设置

虽然大多数集成都已经可以直接通过 Home Assistant 用户界面完成设置，但有些过去仍然只能通过 YAML 配置。我们仍在持续把更多集成迁移到 UI 中，让更多人都能更轻松地完成设置和使用。

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

• DuckDNS，由 @tr4nt0r 完成

#告别以下集成

以下集成已在本次发布中被移除：

• Dominos Pizza：Dominos Pizza 集成已被移除。该集成已经无法继续工作，其底层来源自 2019 年起就未再维护。
• Flick Electric：Flick Electric 集成已被移除。Flick Electric 的所有客户都已迁移到 Meridian Energy，而该集成所依赖的服务也已经失效。
• 以下集成也已被移除，因为它们与当前支持的安装方式不兼容：
  • 蓝牙 Tracker
  • CUPS
  • Decora
  • dlib Face Detect
  • dlib Face Identify
  • Eddystone Temperature
  • GStreamer
  • Keyboard
  • LIRC
  • Pandora
  • 树莓派 摄像头
  • SMS
  • Snips
  • TensorFlow

#其他值得注意的变化

这次发布中还有很多其他改进；以下是一些值得一提的变化：

• 全新的模板数学函数来了！@akx 加入了 clamp、wrap 和 remap，让你可以在模板中更灵活地处理数字。太棒了！
• activity 卡片 现在支持按状态筛选，更容易查看特定事件。干得漂亮， @karwosts ！
• @MindFreeze 为 tile 卡片中的 bar gauge feature 加入了 min 和 max 选项，让你可以更精细地控制量表范围。
• 现在你可以直接在 helpers 面板中删除 helpers，无需先打开它们。感谢 @frenck！
• blueprints 面板现在会显示每个 blueprint 被多少个自动化和脚本使用，更方便你进行追踪。很实用， @EarMaster ！
• @timmo001 加入了一个方便的小技巧：双击自动化编辑器侧边栏即可重置其宽度。
• Labels 现在也会显示在设备信息卡片上，让你更容易看出设备是如何组织的。再次感谢 @timmo001！

#深入了解你的 AI 对话

你是否在 Home Assistant 中试过 AI，然后好奇到底发送了哪些数据？

@balloob 升级了语音助手的调试界面，现在你可以直接查看告诉 AI 应该如何表现的 system prompt，以及它为了生成回答而调用的各种工具。

这让你更容易弄清楚，为什么 AI 会跳过某个实体，或者为什么它调用了某个特定工具。你可以在语音助手配置面板中找到这个调试界面。

#将实体添加到 Android 小组件和收藏项

如果你正在使用 Home Assistant Companion app for Android，那有个实用新功能在等着你！从 app 版本 2025.11 开始，你现在可以直接从实体的 more info 对话框中，把实体添加到小组件和 Android Auto 收藏项中。

只需轻点几下，你就可以：

• 添加 widgets，从主屏幕快速控制实体
• 将实体设为 Android Auto 收藏项，让它们在车里也能快速访问

再也不用层层深入 app 设置了！Add to 选项会直接出现在 more info 对话框中，并根据你正在查看的实体提供相应选项。例如，媒体播放器小组件就只会对媒体播放器实体显示。

这是把原生移动端能力直接整合进 Home Assistant 界面的第一步。未来几个版本里，我们还会继续扩展，加入创建快捷方式、tiles 和手表收藏项等支持。

感谢 @TimoPtr 带来的这个优秀改进！🙏

#Patch releases

我们也会在 12 月为 Home Assistant 2025.12 发布补丁版本。🎄 这些补丁版本只包含错误修复。我们的目标是每周发布一个补丁版本，发布时间尽量安排在周五。

#2025.12.1 - December 5

• 修复 Rituals Perfume Genie ([@quebulm] - #151537)
• 移动 telegram-bot URLs out of strings.json ([@maxmichels] - #155130)
• 修复 Starlink's ever updating uptime (@davidrapan - #155574)
• Display 错误 when forming new ZHA network fails ([@TheJulianJES] - #157863)
• 移动 teslemetry time-of-use URL out of strings.json (@jbouwh - #157874)
• Correctly pass MopParserConfig for Roborock (@Lash-L - #157891)
• 修复 VeSync 二元sensor discovery (@cdnninja - #157898)
• 升级 reolink_aio to 0.17.1 (@starkillerOG - #157929)
• 移动 out URL of Xiaomy_aquara from strings.json (@jbouwh - #157937)
• 设置 account number as required for Anglian Water config entry (@pantherale0 - #157939)
• 移动 translatable URL from rainmachine push_weather_data 动作 description (@jbouwh - #157941)
• Convert image URLs to secure URLs in Xbox 集成 (@tr4nt0r - #157945)
• 添加 pyanglianwater to Anglian Water loggers (@pantherale0 - #157947)
• 修复 template migration 错误 (@Petro31 - #157949)
• 移动 Yeelight URLs out of translatable strings for 动作 descriptions (@jbouwh - #157957)
• 移动 out zwave_js api docs url from strings.json (@jbouwh - #157959)
• 修复 unit parsing in Tuya 温控 实体 (@epenet - #157964)
• 更新 template deprecation to be more explicit (@Petro31 - #157965)
• 移动 pilight URL out of strings.json (@jbouwh - #157967)
• 移动 out example URL and IP of strings.json for reolink (@jbouwh - #157970)
• 添加 subscribe preview feature endpoint to labs (@piitaya - #157976)
• 升级 python-Roborock to 3.10.0 (@Lash-L - #157980)
• 升级 oralb-ble to 1.0.2 ([@abmantis] - #157992)
• 升级 evohome-async to 1.0.6 ([@zxdavb] - #158005)
• 修复 doorbird duplicate unique ID generation (@ptarjan - #158013)
• SharkIQ dep 升级 v1.5.0 ([@funkybunch] - #158015)
• 升级 python-roborock to 3.10.2 (@allenporter - #158020)
• 将 ZHA strings for incorrect adapter 状态 ([@TheJulianJES] - #158021)
• 改进 动作 descriptions for Telegram bot (@hanwg - #158022)
• 修复 missing template key in deprecation repair (@Petro31 - #158033)
• 防止 entsoe from loading (@joostlek - #158036)
• 不要 create restart button for sleeping gen2+ Shelly 设备 (@bieniu - #158047)
• Replace deprecated preview image model (@Shulyaka - #158048)
• 移动 lametric URLs out of strings.json (@jbouwh - #158051)
• 移动 example image path out of translatable strings (@jbouwh - #158053)
• 修复 inverted kelvin 问题 (@Petro31 - #158054)
• 升级 uiprotect to 7.33.2 (@RaHehl - #158057)
• 更新 前端 to 20251203.1 (@piitaya - #158069)

#2025.12.2 - December 8

• fix Lutron Caseta smart away subscription (@omrishiv - #158082)
• 修复 legacy template entity_id field in migration (@Petro31 - #158105)
• 回滚 "Remove Shelly redundant 设备 entry check for sleepy 设备" (@thecode - #158108)
• Ensure Roborock disconnects MQTT on unload/stop (@allenporter - #158144)
• 修复 secure URLs for promotional game media in Xbox 集成 (@tr4nt0r - #158162)
• 添加 program id codes for Miele WQ1000 (@astrandb - #158175)
• 升级 pymiele dependency to 0.6.1 (@astrandb - #158177)
• 升级 asusrouter to 1.21.1 (@Vaskivskyi - #158192)
• 升级 HueBLE to 2.1.0 (@flip-dots - #158197)
• 升级 python-roborock to 3.10.10 (@allenporter - #158212)
• Be more specific about winter mode in the description (@piitaya - #158230)
• 修复 description placeholders for system_bridge (@jbouwh - #158232)
• 升级 google air quality api to 2.0.0 (@Thomas55555 - #158234)
• 修复 zwave_js 服务 description placeholders (@epenet - #158236)
• 修复 yeelight 服务 description placeholders (@epenet - #158239)
• 修复 teslemetry 服务 description placeholders (@epenet - #158240)
• 修复 multiple top-level 支持 for template 集成 (@Petro31 - #158244)
• 升级 yt-dlp to 2025.12.08 (@andreimoraru - #158253)
• 更新 前端 to 20251203.2 (@piitaya - #158259)
• Skip check for onboarding done in Music Assistant 集成 (@marcelveldt - #158270)

#2025.12.3 - December 12

• 修复 Tuya BitmapTypeInformation parsing (@epenet - #158475)
• 移动 translatable URL out of strings.json for knx 集成 (@jbouwh - #155244)
• 改进 Tuya HVACMode handling (@epenet - #158042)
• 升级 pypck to 0.9.7 (@alengwenus - #158089)
• 升级 blinkpy to 0.25.1 (@KiraPC - #158135)
• 修复 webhook exception when empty json data is sent (@mikedast - #158254)
• 修复 roborock off peak electricity timer (@allenporter - #158292)
• Switchbot Cloud: Fixed 二元sensor didn't 更新 automatically (@XiaoLing-git - #158434)
• 添加 Tuya local_strategy to Tuya diagnostic (@epenet - #158450)
• 改进 Roborock exception logging behavior for Zeo/Dyad 设备 (@allenporter - #158465)
• 修复 Matter Door 门锁 Operating Mode select 实体 (@lboue - #158468)
• 升级 asusrouter to 1.21.3 (@Vaskivskyi - #158492)
• 升级 hanna-cloud to 版本 0.0.7 (@bestycame - #158536)
• 添加 measurement 状态 class to ohme 传感器 (@andrew-codechimp - #158541)
• 升级 python-roborock to 3.12.2 (@allenporter - #158572)
• Pin pycares to 4.11.0 (@bdraco - #158695)
• 添加 state_class to Growatt power and energy 传感器 (@johanzander - #158705)
• 更新 advanced_options display text for MQTT (@ndrwrbgs - #158728)
• 升级 google air quality api to 2.0.2 (@Thomas55555 - #158742)
• Migrate Blink component to use hardware_id instead of device_id (@cdutr - #158765)
• 升级 ical to 12.1.1 (@allenporter - #158770)
• 升级 pylamarzocco to 2.2.3 (@zweckj - #158104)
• 升级 pylamarzocco to 2.2.4 (@zweckj - #158774)
• 提高 Xbox 更新 interval to 15 seconds and refactor title data handling (@tr4nt0r - #158780)
• 升级 pySmartThings to 3.5.1 (@joostlek - #158795)
• 升级 aioasuswrt to 1.5.2 (@kennedyshead - #158727)

#2025.12.4 - December 19

• 防止 empty aliases in registries (@FI-153 - #156061)
• 不要 check Reolink 固件 at start (@starkillerOG - #158275)
• 更新 pynintendoparental to 2.0.0 (@pantherale0 - #158285)
• 启用 volvo engine status for all engine types (@thomasddn - #158437)
• 更新 pynintendoparental to 2.1.0 (@pantherale0 - #158487)
• 抑制 roborock failures under some unavailability threshold (@allenporter - #158673)
• 抑制 verbose UPnP subscription 错误 日志 (@ptarjan - #158677)
• 修复 Sonos speaker async_offline assertion failure (@ptarjan - #158764)
• 升级 pynintendoparental to 2.1.1 (@pantherale0 - #158779)
• 升级 aioasuswrt 1.5.3 (@kennedyshead - #158882)
• 回滚 adding entity_category to Plugwise thermostat schedule select (@bouwew - #158901)
• 升级 aiomealie to 1.1.1 and statically define mealplan entry types (@andrew-codechimp - #158907)
• 更新 systembridgeconnector to 5.2.4, fix media source (@timmo001 - #158917)
• 假定 遮盖 or valve is always "running" in google assistant when the 状态 is assumed or the position is reported to allow it to be be stopped (@jbouwh - #158919)
• 升级 ical to 12.1.2 (@allenporter - #158965)
• 更新 unnecessary 错误 logging of unknown and 不可用 source 状态 from mold indicator (@Petro31 - #158979)
• 添加 exception handling for rate limited or unauthorized MQTT requests (@allenporter - #158997)
• 升级 aioasuswrt to 1.5.4 (@upsuper - #159038)
• 升级 blinkpy to 0.25.2 (@fronzbot - #159049)
• 修复 slow event 状态 updates for remote calendar (@allenporter - #159058)
• 升级 aiodns to 3.6.1 (@mithomas - #159073)
• 升级 pysmlight to v0.2.13 (@tl-sl - #159075)
• 改进 icloud reauth flow (@PaulCavill - #159081)
• Sonos fix media player join to avoid race 条件 (@PeteRager - #159106)
• Sonos increase wait for groups 超时 (@PeteRager - #159108)
• 升级 pynintendoparental 2.1.3 (@pantherale0 - #159120)
• 升级 soco to 0.30.13 for Sonos (@PeteRager - #159123)
• 处理 missing Miele status codes gracefully (@astrandb - #159124)
• 升级 ekey-bionyxpy to 版本 1.0.1 (@richardpolzer - #159196)
• 修复 incorrect status updates for lcn (@alengwenus - #159251)
• 升级 python-roborock to 3.18.0 (@Lash-L - #159271)
• 升级 pypck to 0.9.8 (@alengwenus - #159277)
• 修复 AttributeError in Roborock Empty Mode 实体 (@allenporter - #159278)
• 添加 missing strings for Shelly voltmeter 传感器 (@chemelli74 - #159332)
• 不要 触发器 reauth for addon in Music Assistant (@arturpragacz - #159372)
• 对齐 format of voltmeter strings for Shelly (@chemelli74 - #159394)
• 升级 ZHA to 0.0.81 (@puddly - #159396)
• 升级 python-roborock to 3.19.0 (@allenporter - #159404)
• 移除 users refresh tokens when the user get's deactivated (@edenhaus - #159443)
• 更新 前端 to 20251203.3 (@bramkragten - #159451)

#2025.12.5 - December 29

• 禁用 quoted cookies for compatibility with older SolarLog 设备 (@dontinelli - #157839)
• 规范化 unique ID in WLED (@mik-laj - #157901)
• 将 Samsung TV WoL turn_on 日志 from 警告 to 调试 (@ptarjan - #158676)
• 修复 ZeroDivisionError for inverse unit conversions (@ReneNulschDE - #159161)
• 添加 openid scope and 更新 OAuth2 url:s in senz 集成 (@astrandb - #159265)
• 创建 问题 for Sonos when Sonos system does not have UPnP enabled (@PeteRager - #159330)
• 升级 insteon 面板 to 0.6.0 to fix dialog button 问题 (@teharris1 - #159449)
• 升级 yalexs-ble to 3.2.2 (@bdraco - #158124)
• 升级 yalexs-ble to 3.2.4 (@bdraco - #159476)
• 改进 date handling in UniFi Protect media source (@RaHehl - #159491)
• Redact additional unnecessary diagnostic fields (@allenporter - #159546)
• 升级 melissa to 3.0.3 (@kennedyshead - #159557)
• 升级 valbusaio to 2025.12.0 (@cereal2nd - #159578)
• 升级 uiprotect to 7.33.3 (@RaHehl - #159593)
• 修复 Ecoforest unknown 报警 翻译 key (@maylikenoother - #159594)
• 升级 axis to v66 fixing an 问题 with latest xmltodict (@Kane610 - #159604)
• 升级 python-roborock to 3.20.1 (@allenporter - #159621)
• 升级 python-roborock to 3.21.1 (@allenporter - #159660)
• 修复 Roborock repair 问题 behavior (@allenporter - #159718)
• 开始 reauth when roborock notices the MQTT session is unauthorized (@allenporter - #159719)
• 添加 state_class to Nuki battery 传感器 (@victor-gurbani - #159756)

#需要帮助？加入社区

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

我们非常活跃的 Discord 聊天服务器 是交流的绝佳去处，别忘了也来加入同样精彩的 论坛。

发现了 bug 或遇到问题？请在我们的 问题追踪器 中提交反馈，帮助我们尽快修复！你也可以查看帮助页面，了解更多可获取支持的渠道。

你更喜欢邮件方式？欢迎订阅 Open Home Foundation 新闻通讯，将最新功能消息、社区动态以及其他支持 Open Home 的项目进展直接送达你的收件箱。

#不向后兼容的变更

我们始终尽力避免对现有功能做出可能意外影响你 Home Assistant 安装的变更，但有些情况下这确实无法避免。

我们会确保完整记录这些变更，尽可能让迁移过程更平滑。本次发布包含以下不向后兼容的变更：

经过 6 个月的弃用期后，Home Assistant Core 与 Home Assistant Supervised 两种安装方式，以及所有 32 位系统架构（i386、armhf 和 armv7）的支持现已被完全移除。

这些安装方式和架构将不再接收任何更新（包括安全更新）。如果你目前仍在使用其中之一，请尽快迁移到受支持的安装方式和架构，以继续获得更新与支持。

关于这项变更的更多信息，请阅读博客文章：弃用 Core / Supervised 安装方式及 32 位系统。

Hive 已停止支持其安防产品。由于 Hive API 不再支持这些设备，我们也已从该集成中移除了报警控制面板。

(@KJonline - #156184) (hive docs)

issues() 模板方法过去会返回所有问题（包括已修复的问题）。从现在起，它只会返回仍处于活动状态的问题。

(@jbouwh - #156274)

现在，启用调试 UI 时必须设置 username 和 password。

(@edenhaus - #157008) (go2rtc docs)

UniFi Protect 集成中旧版的车牌事件传感器已被移除，因为它在 Protect 6 及更高版本中已无法工作。同时，UniFi Protect 集成也早已不再兼容 6 以下的 Protect 版本。

这个传感器已由新的 Vehicle Detection Event 实体替代，提供了更多功能，包括车牌识别、车型识别、颜色识别以及置信度评分。新的事件实体会延迟 3 秒触发，以确保缩略图与 LPR 数据质量达到最佳。

更多信息与自动化示例，请参阅 Vehicle Detection Event 文档。

(@RaHehl - #157196, #157203) (unifiprotect 文档)

• Xbox 媒体浏览器已完成全面重构，以支持多账号并带来一系列其他改进。作为这次更新的一部分，media source 标识符的格式也发生了变化。

• 上个版本引入的 following 与 followers 传感器，过去会把好友数量计入统计。由于近期 API 的变更，好友已不再计入。

(@tr4nt0r - #155925) (@tr4nt0r - #155536) (xbox docs)

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

• 为 MQTT 订阅添加状态回调
• Data Update Coordinator 现已支持 Retry-After
• 设备识别按钮现归类为诊断类型
• 改进离线场景下 oauth2 配置的错误处理
• 为服务动作翻译引入描述占位符
• 引入 Labs：在功能正式发布前先行预览
• worker 线程中的 Store 数据序列化改为可选开启
• 从 CalculatedState 中移除 capability_attributes 字段

#所有变更

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