title: '2025.3:快来看看这些页眉!' description: '<lite-youtube videoid="TrNpNsZyGFw" videotitle="Home Assistant 2025.3 发布 Party"</lite-youtube。 本页属于 Home Assistant 中文博客与更新记录,适合了解版本演进、功能变更与社区动态。' Assist 聊天现已支持流式回复,而且 SmartThings 集成体验也比以往更强!

2025.3:快来看看这些页眉!

Home Assistant 2025.3 来了!🎉

不过!在我开始讲这次发布前,先快速带你回顾几件你可能错过的事。 最近真的有很多超棒的进展!

我们做了一场关于 Assist 的直播:语音 chapter 9! 我们在直播中发布了 Speech-to-Phrase, 这是一项语音识别技术,速度极快、准确率极高, 甚至在树莓派上也表现出色!🚀

我也非常兴奋地看到这条公告Apollo automation 已正式加入 Works with Home Assistant 计划 🥰

我们的朋友 Music Assistant发布了下一次重磅更新! 带来了 Spotify Connect、Assist 优化、均衡器, 以及播客和有声书支持等超赞新功能。🎶

很棒对吧?而今天这次发布同样也装满了惊喜!

在连续几次聚焦备份的发布之后, 我们这次带着一个塞满新功能和改进的版本回来了, 而且重点主要放在仪表盘!🤩

这些新能力、磁贴卡片的精细打磨,以及仪表盘视图的新页眉, 真的都非常酷;我已经等不及想看到你们使用这些新功能后的仪表盘截图了!📸

祝你用得开心!

../Frenck

仪表盘视图页眉

这次发布带来了全新的视觉体验:你现在可以为仪表盘添加页眉。 你可以使用 Markdown,甚至模板,为仪表盘添加标题和欢迎语。 此外,页眉旁边还预留了充足空间用于放置徽章。

和以往一样,我们也提供了大量可自定义项,你可以用多种方式设置页眉对齐。 默认采用响应式布局,但你也可以将其固定为始终左对齐或居中对齐。

Screenshot showing the new header feature in the 仪表盘 view.

徽章也可以放在文字下方(默认)或上方。 直观的可视化菜单让你可以轻松决定页眉的组织方式。

磁贴卡片

这次发布对磁贴卡片做了很多改进与细节打磨。 它本来就是 Home Assistant 里最全能的卡片之一, 而现在我们又把它做得更好了!

让磁贴卡片交互更清晰

毫无疑问,磁贴卡片能做的事很多,但从它诞生起就有一个你可能也遇到过的小问题……

当你点磁贴卡片图标时,怎样知道它会直接触发动作,还是只会打开更多信息? 在这次发布里,我们用一些细腻的视觉语言解决了这个问题!

Screenshot showing tile 卡片 with and without direct 动作 on their icons. The ones that do have a direct 动作 have a circular background, others don't.

当点击图标会直接执行动作(例如打开灯)时, 图标周围会显示一个圆形背景。 在其他情况下,这个小圆圈则不会出现。

现在你一眼就能分辨了!👍

调整磁贴卡片功能位置

自从我们支持卡片尺寸调整后, 磁贴卡片可以做得很宽。这类卡片周围往往会出现不少空白, 有时确实有用。

但如果这块空间也能拿来干点实事呢?现在可以了! 磁贴卡片的功能现在可以以内联方式放进卡片里!

Screenshot showcasing the new inline tile 卡片 features (versus the existing bottom feature

这带来了全新的观感和使用体验,我们相信你会喜欢! 在设置里,你可以添加比如亮度滑块这样的功能, 并将它放在下方(bottom)或图标右侧(inline)。

Note

只有第一个功能可以以内联方式显示;其余功能不会显示。

新的磁贴卡片功能

本次发布还带来了两个新的磁贴卡片功能, 可以添加到实体上,提供新的控制方式。感谢 @jpbede 的贡献!

开关 切换

第一个新增功能是一个让人惊讶“我们怎么现在才有”的功能: 开关切换!你现在可以直接在磁贴卡片上切换开关实体。

Screenshot showing the new tile 卡片 feature for 开关 实体.

Counter 动作

第二个新增功能是计数器操作。 你可以在磁贴卡片上添加按钮,直接对计数器实体执行增加、减少或重置。

Screenshot showing the new tile 卡片 feature for counter helper 实体.

细微交互改进

我们还对磁贴卡片做了更多微调来提升交互体验。 例如,当你悬停在磁贴卡片上时,会出现小动画,更直观地提示“这里可以交互”。 同样地,点击磁贴卡片时也会出现反馈动画,明确告诉你点击已被识别。

Screenrecording showing the new tiny micro interactions added to the tile 卡片 and a small demo of using keyboard navigation

另一个很棒的改进是:磁贴卡片现在也支持键盘交互! 你可以用 Tab 和 Shift + Tab 在页面中穿梭,尽情发挥“键盘侠”实力。

编辑器改进

我们不仅改进了磁贴卡片本身,也改进了它的编辑器。 现在它更清晰,也更易用。

新的控件能让你更直观地了解每个选项会对磁贴卡片产生什么效果。

Screenshot showing the brand new visual 卡片 editor that make it more visually clear what options do.

Assist 聊天现已支持流式回复

如果你把 ChatGPT 这类 LLM 接入 Assist 作为对话代理, 现在在文本聊天时,它会以流式方式实时返回回复!

在体验更大模型,或较慢硬件环境下,LLM 往往会显得有些迟缓。 它们通常要等整段回复生成完才一次性返回, 当回答较长时等待会很煎熬(比如让它讲个史诗童话,你会等一会儿)。

我们新增了 LLM 文本聊天流式输出支持, 你可以在回复生成过程中就开始阅读。 还有一个额外好处:命令执行也更快了, 它们会在到达时立即执行,不用等整条消息全部生成完。

关于 Assist 和新语音功能,其实还有很多内容可以讲; 如果你错过了,可以在这篇博客中查看完整介绍:

📰 Speech-to-Phrase brings voice home - 语音 chapter 9

集成

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

新集成

欢迎以下新集成加入本次发布:

本次发布还加入了新的虚拟集成。虚拟集成是由其他(现有)集成接管的占位集成, 用于提升可发现性。以下是本次新增内容:

现有集成的重要改进

不仅有新集成加入,现有集成也在持续改进。以下是一些值得关注的现有集成更新:

SmartThings

SmartThings 集成已经被完全重写了!🎉 去年 12 月,SmartThings 关闭了旧的身份验证方式,但得益于 SmartThings 团队的努力以及他们与我们的紧密合作,@joostlek 成功把这个集成带了回来——而且比以前更好了。

你不再需要设置路由、暴露端口,或创建带访问令牌的开发者账户——只要使用你的 Samsung 账户登录,就可以开始使用!

而且还有更多!现在推送更新已经可以在不把你的实例暴露到互联网的情况下工作,让整个体验更快、更顺畅,也更安全!🚀

也要特别感谢我们超棒的社区,大家在这次工作中发挥了关键作用!💙 当 @joostlek 分享了一份收集测试数据的指南后,社区成员纷纷响应,提交了大量宝贵的测试数据,帮助我们进一步打磨这个集成。这种协作真的带来了巨大不同!

Other noteworthy changes

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

  • 你有没有在升级 Home Assistant 后,不得不在浏览器里强制刷新页面才能恢复正常?现在这种情况已经大大减少了!感谢 @bramkragten
  • @balloob 做了一个小改动,却带来了很大的影响。现在当你为一个新设备设置新集成后,Home Assistant 会自动跳转到该设备页面。很棒!
  • 现在你可以为分区视图顶部增加额外的边距了。感谢 @piitaya
  • 添加 / 编辑区域对话框得到了改进,也更紧凑了,现在用起来舒服多了。感谢 @jpbede
  • 我们现在为风向传感器加入了新的设备类别!感谢 @edenhaus
  • @jschlyter 为传感器新增了 energy distance 设备类别,支持 kWh/100mikWh/100kmmi/kWh 这些单位,并支持它们之间的转换。太棒了!
  • 支持媒体浏览的媒体播放器实体现在新增了一个动作,可用于 [以带响应的动作方式浏览媒体]。感谢 @PeteRager
  • @rikroe 新增了一个动作,可以 [获取 schedule helper 的配置]。感谢!

持续改进图表图例

在上个版本中,我们通过替换 Home Assistant 中用于绘制图表的软件,对图表进行了一次相当大的调整。虽然底层实现发生了变化,但我们一开始的目标,是尽量让它在视觉和使用感受上仍然保持相似。

不过,我们收到了很多社区反馈,认为新图表上的图例显示效果还不够理想。我们的 UX 与前端团队一直在努力改进这一点,让新的图例更接近旧版体验。

A screen recording showing expanding and collapsing the legend

默认情况下,图例会显示在图表下方,并尽可能展示更多数据点。如果条目太多,则会通过小小的省略号按钮按需展开显示。

如果你在仪表盘上使用这些卡片,并希望始终显示完整图例,现在有一个新选项可以让图例一直保持完整可见。

你现在还可以通过双击图表来缩放。如果你想更精确地控制想查看的区间,可以按住 ctrl/cmd 键,然后在图表上选中想放大的范围。

地图中可追踪对象的分组 / 聚类

地图卡片非常适合可视化实体位置,但如果太多标记聚集在同一个地方,画面就会显得有些拥挤。

为了解决这个问题,我们引入了标记聚类功能,它会把相邻实体分组显示,让你更容易一眼看清。放大地图时,聚类中的标记会像蜘蛛网一样散开,显示各个实体的独立位置,并用连线指向它们原本聚集的地点。你也可以通过一个简单的开关暂时关闭聚类。

感谢 @jpbede@marcinbauer85 带来的这项超棒改进!

地图现在会把同一位置的项目优雅聚类,这段动画展示了展开聚类项目的效果。

Patch releases

我们还将在 3 月为 Home Assistant 2025.3 发布补丁版本。这些补丁版本只包含 bug 修复。我们的目标是每周五发布一个补丁版本。

2025.3.1 - March 7

2025.3.2 - March 11

2025.3.3 - March 14

2025.3.4 - March 21

需要帮助?加入社区吧!

Home Assistant 拥有一个非常棒的用户社区,大家都非常愿意彼此帮助。所以,加入我们吧!

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

发现了 bug 或问题?请到我们的 issue tracker 提交反馈,帮助我们修复!或者查看帮助页面,了解更多可寻求帮助的渠道。

如果你更喜欢电子邮件,订阅我们的 Building the Open Home Newsletter,即可直接在收件箱中接收最新功能消息、社区动态,以及关于打造 Open Home 的其他新闻。

向后不兼容的变更

我们始终尽力避免对现有功能做出可能意外影响 Home Assistant 安装的更改。但很遗憾,有时候这是不可避免的。

我们始终会记录这些更改,以尽可能让迁移过程变得更容易。本次发布包含以下向后不兼容变更:

脚本或自动化内层作用域中定义的 wait 变量,以及通过 response_variable 定义的变量,现在即使内层作用域中存在 variables 动作, 也会向外层作用域传播。

此外,通过 response_variable 定义的变量现在也会从 parallel 序列中向外传播。 依赖旧版(存在缺陷)行为的脚本和自动化可能需要进行调整。

(@arturpragacz - #138883)

主传感器上的所有状态属性已在 Home Assistant 2024.9 中被独立传感器取代。 这些已弃用属性现已被移除。

(@jrieger - #137600) (文档)

由于缺少 aiohomeconnect 的程序键枚举(文件), 一些程序、程序开关(正处于弃用阶段)以及程序选择实体可能不再被该集成暴露。 你可以从配置条目或设备中获取诊断信息, 并在 aiohomeconnect 仓库 提交 issue,或附上生成的诊断文件提交 PR, 以补充缺失的程序项。

(@Diegorro98 - #136116) (文档)


在 Home Connect 动作中使用 API 文档里不存在的程序键和选项键,将不再生效。如果你需要使用未记录在文档中的程序键或选项键,请到 MartinHjelmare/aiohomeconnect 提交 issue,或直接提交包含所需键值的 pull request。

(@Diegorro98 - #137027) (文档)


现在将不允许配置多个 Home Connect 配置条目。对于普通用户来说,家中的所有家电通常都连接到同一个 Home Connect 账户,因此没有理由拥有多个配置条目,因为所有设备都会通过同一个账户和同一个配置条目接入。

(@Diegorro98 - #137088) (文档)

MQTT JSON 灯光对旧版 color_mode 的支持已被移除。这项支持早在 HA 核心 2024.4 中就已弃用。

使用 YAML 设置的用户,系统已经通过修复流程提示他们在 configuration.yaml 中更新配置。对于通过 discovery 设置的 MQTT JSON 灯光,弃用问题则会通过日志中的警告提示。即使在 discovery 中继续使用已移除的参数,配置本身不会直接损坏,但仍然会记录一条警告。

(@jbouwh - #136996) (文档)

距离现在会测量到监控区域的边缘(会考虑半径),而不再像以前那样测量到区域中心。这会导致预期距离值略有不同,因此你可能需要相应调整现有自动化。

(@Spcemarine - #138819) (文档)

对于所有带开关的设备,能量和功率传感器已被移除。它们之前很少真正可用,因为这些设备通常并没有可供读取的能量或功率能力。如果你的设备确实具备这些能力,那它依然会正常工作。

(@joostlek - #138313) (文档)


有很多状态值已被重命名;这可能需要你更新自动化或其他相关配置。

  • 为 SmartThings 中的洗碗机作业状态传感器设置选项(#139349
  • 为 SmartThings 媒体输入源添加可翻译状态(#139353
  • 为 SmartThings 媒体播放添加可翻译状态(#139354
  • 为 SmartThings 烤箱模式添加可翻译状态(#139356
  • 为 SmartThings 烤箱作业状态添加可翻译状态(#139361
  • 为 SmartThings 机器人清洁器移动状态添加可翻译状态(#139363
  • 为 SmartThings 机器人清洁器涡轮模式添加可翻译状态(#139364
  • 为 SmartThings 洗衣机作业状态添加可翻译状态(#139368
  • 为 SmartThings 烘干机作业状态添加可翻译状态(#139370

扫描间隔选项已被移除,现在统一使用默认的 15 分钟。如有需要,你仍可通过一种与集成无关的通用方式来设置自定义轮询间隔。

(@mib1185 - #138490) (文档)

状态传感器的 high_charge_period 状态已被重命名为 high_tariff_period

(@Moustachauve - #139314) (文档)

如果你是自定义集成开发者,并想了解适用于你集成的变化和新功能,请务必关注我们的开发者博客。以下是本次发布中最值得注意的几项:

全部变更

当然,本次发布还有更多内容。你可以在这里查看完整变更列表:Home Assistant 核心 2025.3 完整更新日志