title: "2025.5:两百万用户,更进一步" description: '<lite-youtube videoid="kfu3Fm0wDw" videotitle="家庭助理2025.5发布派对"</lite-youtube。 本页属于 Home Assistant 中文博客与更新记录,适合了解版本演进、功能变更与社区动态。' 庆祝 200 万用户达成里程碑!本次发布带来更多生活质量改进, 包括按位置设置备份保留策略、Z-Wave 长距离支持、改进的实体选择体验、 Home Assistant Cloud 的大量新语音,以及可将 YAML 直接粘贴到自动化中。
2025.5:两百万用户,更进一步
家庭助理2025.5! 🎉 五月发布时间到了,我们有很多话要谈!但之前 我们确实如此,我想快速谈谈上个月发生的事情 你可能错过了... 我们最近举办了 Open Home 现状活动——直播节目。 我们讨论了 开放之家基金会 的现状、未来愿景,以及包括 Home Assistant 在内的各个项目。 在这次活动中,我们不仅公布了来年的路线图,同时也庆祝了一项巨大的里程碑: 全球 Home Assistant 的活跃安装量达到 2,000,000 次!🎉 在这篇总结性博客文章中了解有关 Open Home 现状的更多信息 拥有 200 万户家庭的社区,当然值得庆祝!我们会在 Home Assistant 社区日 亲自相聚庆祝,活动时间是 2025 年 5 月 24 日;目前正在组织 50 多场遍布世界各地的聚会! 想了解更多、参加聚会,甚至赞助一场活动吗?请查看《2025 年 Home Assistant 社区日》博客文章。 好了,回到五月发布,我真的很喜欢这次更新!它塞满了各种生活质量改进,我相信你也会喜欢。 🥰
我们继续打磨备份系统,这次带来了不少增强功能,其中最显著的是:你现在可以为每个备份位置单独设置保留策略!与此同时,Nabu Casa 还带来了大量新的文本转语音语音变体 🗣️,并且包含在你的 Home Assistant Cloud 订阅中,让你的播报内容可以听起来悲伤、快乐,或者更有个性。
但……还不止这些!Z-Wave 现已支持长距离通信 📶;你现在可以把 YAML 自动化片段直接复制粘贴到自动化 UI 中;还有一个用于查看 Home Assistant 正在发现什么设备的新工具;以及我个人最喜欢的一项改进——在界面任意位置选择实体时,体验更好了。🤩 享受发布! ../Frenck
- 备份系统的另一次迭代
- 为 Home Assistant Cloud 用户提供大量新的文本转语音语音变体
- 挑选实体
- Z-Wave 远程支持和改进的智能启动
- 集成
- 其他值得注意的变化
- 仪表盘上的徽章现在可以包裹或滚动
- 改进了在自动化中使用模板时的 UI 体验 & 脚本
- 将自动化和脚本 YAML 直接粘贴到 UI 中
- 发现家庭助理正在发现什么
- 补丁版本
- 需要帮助吗?加入社区!
- 向后不兼容的更改
- 所有更改
备份系统的另一次迭代
在我们的一月发布中, 我们对备份系统进行了第一次检修。在二月发布中, 我们根据您的反馈进行了迭代。在本次发布中,我们致力于更多 是时候进一步迭代和改进备份了。 让我们深入了解吧!
按位置设置备份保留策略
此版本添加了一项备受期待的功能:设置备份保留的能力
每个地点的政策。如果您有多个备份,这尤其有用
在 Home Assistant 中配置的位置。
您的备份位置之一的存储空间可能比 另一个,或者您希望在一个位置保留比另一个位置更多的备份。 例如,也许你的 Google Drive 只想保留最近 3 个备份,而本地 NAS 服务器则想保留 25 个备份。
升级 Home Assistant 操作系统前先备份
更新 Home Assistant 操作系统就像按下一个按钮一样简单。虽然升级流程本身已经带有失败时的回退机制,但在开始升级前,最好仍然在多个位置保留一份最近的备份。
为了帮助你做到这一点,Home Assistant 操作系统的更新对话框现在加入了一个新选项,可在开始升级前先创建备份。选择该选项后,会按照自动备份的设置创建一份备份;如果你尚未配置自动备份,则只会备份设置、历史记录和附加组件。随后,它会在升级开始前上传到所有已启用的备份位置。

这样,您可以确保之前已备份过系统 升级,即使出现超出安全保障范围的问题 操作系统升级。
设置升级时的默认备份偏好
上述升级前备份的选项很棒,但是关于
在混合升级之前切换以创建备份。你们中有些人喜欢总是
升级前备份,而其他人则依赖计划备份而不是
每当升级零件时都希望被备份过程所困扰
的家庭助理。
为了让这两个组都满意,我们在备份设置页面添加了一个新设置
设置升级切换之前备份的默认行为。

当您将选项设置为“升级前备份”时,将启用切换 默认情况下,否则将默认为禁用。还有一个额外的 选项也可以为附加组件设置此行为,因此您可以根据自己的需要调整它 喜欢。
在重启时等待备份完成
另一个虽小但重要的改进是:如果你在备份进行过程中重启 Home Assistant,系统会等待备份完成后再执行重启。
这可以避免备份进行中出现意外,也能防止你因为重启 Home Assistant 而中止备份过程。
为 Home Assistant Cloud 用户提供大量新的文本转语音语音变体
如果你订阅了Home Assistant Cloud,你
不仅获得包括备份存储,
但您还可以获得最快速、超准确的文本转语音
可用。如果您还没有尝试过,现在是注册 30 天试用版的最佳时机!
此发布扩展了已经数量惊人的文本到语音的声音,
而且现在还包括语音变体和风格。这意味着您可以
现在选择不同的语音风格和语气,例如“友好”,
“生气”、“悲伤”、“窃窃私语”等,让您可以自定义您的公告
适合情境的情绪和背景。

我们大幅扩展了语音选择,某些语言的可用选项增长非常明显:
挑选实体
我们正在努力改善用户界面中显示的内容的上下文。这是为了
确保您始终知道您正在查看哪个设备或实体,无论怎样
您在 Home Assistant 界面中的位置。在上一篇文章中,我们已经对此进行了一个值得注意的小更改。
我们在实体信息对话框中添加了设备和区域,因此您始终
确切地知道您正在查看哪个实体。
在本次发布中,我们改进了 UI 实体选择器中提供的上下文。这是当您在其中选择实体时看到的下拉菜单,例如,动作、自动化、
或脚本。该选择器现在还将显示设备和区域名称!

此增强功能逐渐消除了您手动重命名的需要
实体或设备包含位置信息——为您提供更好的体验
只需更少的工作即可获得开箱即用的体验。
不仅改进了选择器的视觉外观,而且改进了搜索
功能也已彻底修改! 🔎 寻找确切的实体
由于更智能的搜索,您正在寻找的内容现在变得更加容易
算法并在匹配中添加更多上下文信息
过程。
:::tip
你可能会注意到实体ID不再显示在选择器中!
我们认为我们正处于一个你可以完全依赖 UI 和
不再需要实体ID了。但是,如果您确实希望看到
实体 ID 在此下拉列表中,您可以在您的个人资料设置中启用它。

为此,请在左下角选择您的个人资料图片 Home Assistant UI,并在 用户设置 下启用在选取器中显示实体 ID 选项。 :::
Z-Wave 长距离支持和改进的 Smart Start
本次发布为 Z-Wave 集成和整体使用体验带来了不少增强功能。我们的商业合作伙伴 Nabu Casa 正在开发一个几乎不算秘密的 Z-Wave 天线项目,而我们希望 Home Assistant 也已准备就绪,能够提供尽可能好的用户体验。 本次发布,我们改进了设置新 Z-Wave 设备的整体体验,包括通过扫描设置新的 Z-Wave 设备的改进支持智能启动二维码。 Z-Wave 智能启动 QR 扫描现在可以在我们的 移动配套应用程序 中本地运行,消除浏览器限制。添加的设备立即可见 家庭助理,即使设备尚未开机。一旦通电或重新启动, 设备将自动添加到您的 Z-Wave 网络。本次发布最令人兴奋的部分是添加了 Z-Wave 远程支持。这是一项新的 Z-Wave 技术,允许设备进行通信比传统的Z-Wave设备传输距离更长。这尤其是如果您有需要放置在远处的特定设备,则很有用, 例如,门上的接触式传感器或车道上的邮箱。
您可以选择是否将拓扑 Z-Wave 设备添加到现有网络状网络或直接使用远程连接。
扫描具有远程功能的设备的二维码后,您将获得 可以选择将其添加到现有网状网络或直接连接 使用长距离。两者各有利弊,推荐使用网状网络 大多数设备,但如果您有一个设备需要放置在较远的地方, 远程可能是更好的选择。
集成
感谢社区持续带来新集成,以及对现有集成的不断改进!你们都很棒 🥰
新集成
我们欢迎以下新集成加入本次发布:
- [AWS S3],由 [@tomasbedrich] 添加:可将 [Amazon S3 storage] 存储桶用作 Home Assistant 备份位置。
- [Imeon Inverter],由 [@Imeon-Energy] 添加:集成你的 [Imeon] 逆变器,让你可以在[能源仪表盘]中监控家用电池和太阳能使用情况。
- [Miele],由 [@astrandb] 添加:监控并控制你的 [Miele home appliances],包括洗衣机、烘干机、洗碗机等。
- [ntfy],由 [@tr4nt0r] 添加:集成 [ntfy.sh],这是一个简单的基于 HTTP 的发布/订阅通知服务,可向你的手机或桌面设备发送通知。
- [Rehlko],由 [@PeteRager] 添加:监控支持 Rehlko(前身为 Kohler Energy Management)的 [Kohler generator] 状态。 [@astrandb]: https://github.com/astrandb [@Imeon-Energy]: https://github.com/Imeon-Energy [@PeteRager]: https://github.com/PeteRager [@tomasbedrich]: https://github.com/tomasbedrich [@tr4nt0r]: https://github.com/tr4nt0r [Amazon S3 storage]: https://aws.amazon.com/s3/ [AWS S3]: /integrations/aws_s3 [能源仪表盘]: /docs/energy/ [Imeon Inverter]: /integrations/imeon_inverter [Imeon]: https://imeon-energy.com/ [Kohler generator]: https://www.kohlerhomeenergy.rehlko.com/kohler-energy-management-app [Miele home appliances]: https://www.miele.com/ [Miele]: /integrations/miele [ntfy.sh]: https://ntfy.sh/ [ntfy]: /integrations/ntfy [Rehlko]: /integrations/rehlko
此版本还加入了一批新的虚拟集成。虚拟集成本身由其他现有集成处理,用来提升可发现性。新增项目如下:
- Balay,由 Home Connect 提供,由 @Diegorro98 添加
- Constructa,由 Home Connect 提供,由 @Diegorro98 添加
- Gaggenau,由 Home Connect 提供,由 @Diegorro98 添加
- Google Gemini,由 Google Generative AI 提供,由 @tronikos 添加
- Maytag,由 Whirlpool 提供,由 @abmantis 添加
- National Grid US,由 Opower 提供,由 @tronikos 添加
- Neff,由 Home Connect 提供,由 @Diegorro98 添加
- Pitsos,由 Home Connect 提供,由 @Diegorro98 添加
- Profilo,由 Home Connect 提供,由 @Diegorro98 添加
- Siemens,由 Home Connect 提供,由 @Diegorro98 添加
- Thermador,由 Home Connect 提供,由 @Diegorro98 添加
对现有集成的值得注意的改进
这次不仅有新集成加入,现有集成也在持续增强。以下是一些值得关注的改进:
- [OpenAI Conversation] 集成现在支持在
openai_conversion.generate_content动作 中处理 PDF,这意味着你现在可以让它帮你总结 PDF 报告。干得好,[@Shulyaka]! - [@allenporter] 添加了一个新的 LLM 工具,用于获取待办事项列表条目,让你可以通过语音或聊天助手与待办列表内容交互。很棒!
- [HomeKit Bridge] 集成现在支持空气净化器。谢谢 [@MaartenStaa]!
- [@frenck] 扩展了 [YouTube] 集成,让你可以监控自己的 YouTube 频道 📺。
- [HEOS] 集成从 [@andrewsayre] 那里获得了多项改进,包括将项目添加到播放队列以及删除排队项目的能力。
- 多亏了 [@Danielhiversen],[Mill] 集成现在加入了统计数据,可帮助你跟踪一段时间内的供暖能耗。
- [Xiaomi BLE] 集成现在支持人体成分秤 S400。谢谢 [@zry98]!
- [SwitchBot] 现在支持 [Roller Shade] 和 [HubMini Matter] 设备。干得好,[@zerzhang]!
- [@lezmaka] 改进了 [Synology DSM] 集成,现在支持外部 USB 驱动器监控。
- [La Marzocco] 新增了更多传感器和统计实体,可提供更好的咖啡机性能洞察。感谢 [@zweckj]! [@allenporter]: https://github.com/allenporter [@andrewsayre]: https://github.com/andrewsayre [@Danielhiversen]: https://github.com/Danielhiversen [@lezmaka]: https://github.com/lezmaka [@MaartenStaa]: https://github.com/MaartenStaa [@Shulyaka]: https://github.com/Shulyaka [@zerzhang]: https://github.com/zerzhang [@zry98]: https://github.com/zry98 [@zweckj]: https://github.com/zweckj [HEOS]: /integrations/heos [HomeKit Bridge]: /integrations/homekit [HubMini Matter]: https://www.开关-bot.com/products/switchbot-hub-mini-Matter-enabled [La Marzocco]: /integrations/lamarzocco [Mill]: /integrations/mill [OpenAI Conversation]: /integrations/openai_conversation [Roller Shade]: https://www.开关-bot.com/products/switchbot-roller-shade [SwitchBot]: /integrations/switchbot [Synology DSM]: /integrations/synology_dsm [Xiaomi BLE]: /integrations/xiaomi_ble [YouTube]: /integrations/youtube
集成质量规模成就
我们对 Home Assistant 深感自豪的一件事,就是[集成质量量表]。这一体系有助于我们和贡献者确保 集成是高质量的、可维护的,并提供最好的可能 用户体验。 在此发布中,我们庆祝了一些改进 他们的质量等级:
- 4 个集成达到白金级 🏆
- [Ohme],感谢 [@dan-r]
- [Vodafone Station],感谢 [@chemelli74]
- [ESPHome],感谢 [@bdraco]
- [Enphase Envoy],感谢 [@catsmanac]
- 2 个集成达到银牌级 🥈
- [IMGW-PIB],感谢 [@bieniu]
- [SMLIGHT],感谢 [@tl-sl]
- 2 个集成达到铜牌级 🥉
对于这些集成及其维护者来说,这是一项巨大的成就。 达到这些质量水平所需的努力和奉献精神是巨大的, 因为它涉及广泛的测试、文档、错误处理,并且经常 完整重写部分集成。 非常感谢所有参与的贡献者! 👏 [集成质量量表]: /docs/quality_scale/ @abmantis: https://github.com/abmantis [@bdraco]: https://github.com/bdraco [@bieniu]: https://github.com/bieniu [@catsmanac]: https://github.com/catsmanac [@chemelli74]: https://github.com/chemelli74 [@dan-r]: https://github.com/dan-r [@tl-sl]: https://github.com/tl-sl [Enphase Envoy]: /integrations/enphase_envoy [ESPHome]: /integrations/esphome [IMGW-PIB]: /integrations/imgw_pib [Ohme]: /integrations/ohme [SMLIGHT]: /integrations/smlight [UptimeRobot]: /integrations/uptimerobot [Vodafone Station]: /integrations/vodafone_station Whirlpool: /integrations/whirlpool
现在可以从 UI 进行设置
虽然大多数集成都已经可以直接在 Home Assistant 用户界面中设置,但仍有一些过去只能通过 YAML 配置。我们仍在持续把更多集成迁移到 UI 中,让每个人都更容易设置和使用。 现在可通过 Home Assistant UI 设置以下集成:
- STIEBEL ELTRON,由 @ThyMYthOS 完成
告别以下内容
以下集成也已在本次发布中停止提供:
- Oncue by Kohler 已被删除,因为 Kohler 的应用程序已被删除 已停产。
Other noteworthy changes
本次发布还有更多改进;这是其他一些 此发布的值得注意的更改:
- 你知道家庭助理实际上有各种键盘快捷键吗
东西?不?好吧...如果您有兴趣学习,升级后,请按
?用户界面中的任意位置可查看所有可用键盘快捷键的列表。 很好的补充[@jpbede]! -增加了对[事项]1.4热水器设备类型的支持。 谢谢,[@lboue]! - 在 Home Assistant 中设置新设备时,您现在可以直接命名 它在设置过程中。好的!谢谢,[@bramkragten]!
- 媒体播放器现在可以使用
media_player.search_media搜索动作 动作。谢谢,[@zweckj]! - [@piitaya] 添加了
device_name模板函数来获取设备的名称 在家庭助理中。凉爽的! - [@formatBCE] 增强了
floor_id和area_id模板方法 还可以查找楼层或区域别名。惊人的! - 我们现在支持基于发酵的[模板实体],用于开关和 灯光。了不起的工作[@Petro31]!
- 遮盖 [template 现代实体] 中还添加了对 YAML 语法的支持 作者:[@Petro31]。好的!
- [@frenck]增加了对检测Home Assistant容器安装的支持 类型不在主机网络模式下运行。这对于 家庭助理正常运行。如果检测到,则会引发修复问题 这个。
- iOS和用户界面中下拉项的长期存在问题 已修复!当您点击它时,它不再会选择错误的项目 当下拉菜单打开并显示键盘时。 [@bramkragten]: https://github.com/bramkragten [@formatBCE]: https://github.com/formatBCE [@frenck]: https://github.com/frenck [@lboue]: https://github.com/lboue [@Petro31]: https://github.com/Petro31 [@piitaya]: https://github.com/piitaya [@zweckj]: https://github.com/zweckj [Matter]: /integrations/Matter [template 实体]: /integrations/template/
仪表盘上的徽章现在可以环绕或滚动
仪表盘的一个很酷的小新功能发布了这篇文章,但我们没有
想要不被人注意地冲过去。标题中徽章的行为
仪表盘视图现在可以配置为换行或滚动。
换行是最初的行为,并且仍然是默认行为,但如果您有很多
徽章并且主要使用移动设备,滚动可能是更好的选择
为了你。

改进了在自动化和脚本中使用模板时的 UI 体验
如果您是高级用户,在自动化和脚本中使用模板,您
可能熟悉 UI 回退到使用 YAML 的事实任何包含模板的动作块。
[@karwosts] 来救援!他已经研究了一个解决方案来改善这一点
经验。
因此,对于整个块来说,现在只需要使用纯 YAML 即可回退到包含动作模板的字段的代码编辑器。这个
意味着 UI 的其余部分(对于所有其他动作字段)保持不变,并且您
仍然可以使用 UI 来编辑其余部分。
正如您在下面的屏幕截图中看到的,亮度是使用模板设置的,
这没问题,因为其余的动作仍然可以在 UI 中编辑。

这对于高级用户来说是一个很大的改进,因为它允许您使用 UI 对于大多数自动化或脚本,同时仍然能够使用模板 在需要的地方。它还使理解自动化或脚本变得更容易, 您可以在 UI 中看到模板的上下文。 那里有很大的进步[@karwosts]! 🙌 [@karwosts]: https://github.com/karwosts
将自动化和脚本 YAML 直接粘贴到 UI 中
你是否曾在我们的文档或
社区论坛,但它是在
YAML 格式?没问题!您现在可以将 YAML 直接粘贴到 UI 中。当您编辑自动化时,现在只需直接粘贴 YAML进入UI编辑器,它将转换为UI格式。这是无论
无论粘贴的示例是一个成熟的自动化还是只是一个单一的自动化,
条件,或动作。
生活质量的惊人改善,由 [@jpbede] 贡献!谢谢你! 🙌 [@jpbede]: https://github.com/jpbede
发现 Home Assistant 正在发现什么
Home Assistant 会持续扫描你的网络,以通过各种发现协议查找新设备和集成。这会极大提升你的
体验,因为它可以让您轻松地向您的家庭添加新设备
助理安装。
然而,有时,您可能想知道家庭助理正在看到什么
或者想知道为什么某个设备没有被发现。为了帮助解决这个问题
[@bdraco]添加了 DHCP、mDNS/ZeroConf 和 UPnP/SSDP 的浏览工具让您可以看到家庭助理所看到的内容。这是很有技术含量的,但是
这是查看网络中正在发生的情况的好方法。

你可以在 设置 > 系统 > 网络 中找到这些新工具。 在该页面底部,你可以查看 Home Assistant 在你的网络中通过各种发现协议看到的内容。
Patch releases
我们在 5 月份发布了 Home Assistant 2025.5 的补丁版本。这些补丁版本仅包含错误修复。我们的目标是发布补丁 每周五发布。
2025.5.1 - 5 月 9 日
- 修复 Z-Wave 恢复 nvm 命令以等待驱动程序准备就绪 ([@MartinHjelmare] - [#144413])- 修复 homekit 空气净化器温度传感器以转换单元 ([@tamwahba] - [#144435])- 将 LAP-V102S-AUSR 添加到 VeSync ([@DukeChocula] - [#144437])- 将 pylamarzocco 升级到 2.0.1 ([@zweckj] - [#144454])- 修复Z-Wave累加值按钮实体类别([@MartinHjelmare] - [#144459])- 修复点导入错误([@fredrike] - [#144462])
- 忽略 Fronius Gen24 固件 1.35.4-1 SSL 验证问题 ([@farmio] - [#144463])- 不要加密或解密备份存档中的未知文件 ([@emontnemery] - [#144495])
- 将预测太阳能提高到 4.2.0 ([@bdraco] - [#144502])
- 修复了AVM Fritz!SmartHome集成启动时删除智能家居模板的问题([@mib1185] - [#144506])- 将 aiodns 提升至 3.4.0 ([@bdraco] - [#144511])- 修复·拉马尔佐科 的统计协调员订阅 ([@zweckj] - [#144541])- 前端更新至 20250509.0 ([@bramkragten] - [#144549])
- Reolink 清理设备 mac ([@starkillerOG] - [#144554])- 防止清理设备注册表中的连接 /identifiers 时出现错误 ([@starkillerOG] - [#144558]) [#144406]: https://github.com/home-assistant/核心/pull/144406 [#144413]: https://github.com/home-assistant/核心/pull/144413 [#144435]: https://github.com/home-assistant/核心/pull/144435 [#144437]: https://github.com/home-assistant/核心/pull/144437 [#144454]: https://github.com/home-assistant/核心/pull/144454 [#144459]: https://github.com/home-assistant/核心/pull/144459 [#144462]: https://github.com/home-assistant/核心/pull/144462 [#144463]: https://github.com/home-assistant/核心/pull/144463 [#144495]: https://github.com/home-assistant/核心/pull/144495 [#144502]: https://github.com/home-assistant/核心/pull/144502 [#144506]: https://github.com/home-assistant/核心/pull/144506 [#144511]: https://github.com/home-assistant/核心/pull/144511 [#144541]: https://github.com/home-assistant/核心/pull/144541 [#144549]: https://github.com/home-assistant/核心/pull/144549 [#144554]: https://github.com/home-assistant/核心/pull/144554 [#144558]: https://github.com/home-assistant/核心/pull/144558 [@DukeChocula]: https://github.com/DukeChocula [@MartinHjelmare]: https://github.com/MartinHjelmare [@bdraco]: https://github.com/bdraco [@bramkragten]: https://github.com/bramkragten [@emontnemery]: https://github.com/emontnemery [@farmio]: https://github.com/farmio [@fredrike]: https://github.com/fredrike [@frenck]: https://github.com/frenck [@mib1185]: https://github.com/mib1185 [@starkillerOG]: https://github.com/starkillerOG [@tamwahba]: https://github.com/tamwahba [@zweckj]: https://github.com/zweckj
2025.5.2 - 5 月 16 日
- 允许为SMLIGHT用户流保留dns主机名。 ([@tl-sl] - [#142514])- 从 open_ai_conversation 请求中删除了未使用的 file_id 参数([@cadavre] - [#143878])- 门铃事件在 homematicip_cloud 中仅触发一次([@hahn-th] - [#144357])- 不要缩放 Roborock 拖把路径 ([@Lash-L] - [#144421])- Reolink 修复了 NVR IPC 摄像头隐私模式的可用性 ([@starkillerOG] - [#144569])- 将 aiodiscover 升级到 2.7.0 ([@bdraco] - [#144571])- 将 reolink_aio 提升至 0.13.3 ([@starkillerOG] - [#144583])- 将 inkbird 协调器标记为不需要可连接 ([@bdraco] - [#144584])- 修复 enphase_envoy 诊断主端点名称 ([@catsmanac] - [#144634])- 将 pylamarzocco 升级到 2.0.2 ([@zweckj] - [#144635])- 将 pyenphase 提升至 1.26.1 ([@catsmanac] - [#144641])- 升级至 9.2.1 ([@allenporter] - [#144642])
- 将 python-linkplay 升级到 v0.2.5 ([@silamon] - [#144666])- 卸载时关闭 Octoprint aiohttp 会话 ([@RubenNL] - [#144670])- 将假期提高到 0.72 ([@gjohansson-ST] - [#144671])
- 修复 Comelit 的字符串拼写错误 ([@chemelli74] - [#144672])- 避免关闭 Comelit 的共享会话 ([@chemelli74] - [#144682])- 修复 Husqvarna Automower 中的错误状态 ([@Thomas55555] - [#144684])- 将 voluptious-openapi 升级到 0.1.0 ([@allenporter] - [#144703])- 升级至 9.2.2 ([@allenporter] - [#144713])
- 将 gcal-sync 升级到 7.0.1 ([@oyvindwe] - [#144718])- 将 aiocomelit 提升至 0.12.1 ([@chemelli74] - [#144720])- 修复 Netgear 对设备中丢失 MAC 的处理 ([@starkillerOG] - [#144722])- 修复 Z-Wave 未知控制器([@MartinHjelmare] - [#144738])- 通过占位符填写 Plaato URL ([@joostlek] - [#144754])- 清理错误组合的 Reolink 设备 ([@starkillerOG] - [#144771])- 如果未设置,请勿在 MQTT 设备子入口上显示空组件名称,而不是
None([@jbouwh] - [#144792])- 修复天蓝色存储中的阻塞调用([@zweckj] - [#144803]) - 修复控制器重置后 Z-Wave 的唯一 ID ([@MartinHjelmare] - [#144813])- 修复 azure_storage 配置流程中的阻塞调用 ([@zweckj] - [#144818])- 将 pylamarzocco 升级到 2.0.3 ([@zweckj] - [#144825])- 将 python-snoo 升级到 0.6.6 ([@Lash-L] - [#144849])- 升级至 9.2.4 ([@allenporter] - [#144852])
- 修复遥测中的墙壁连接器状态([@Bre77] - [#144855])
- 修复不支持 ONVIF 活跃时 Reolink 设置的问题 ([@starkillerOG] - [#144869])- 修复一些 Home Connect 翻译字符串 ([@rjblake] - [#144905])- 更新 Tibber lib 0.31.2 ([@Danielhiversen] - [#144908])- 更新工厂库 0.12.5 ([@Danielhiversen] - [#144911])
- 修复 Sensibo 未知的纯 AQI ([@gjohansson-ST] - [#144924])- 新设置忽略 Fronius Gen24 固件 1.35.4-1 SSL 验证问题 ([@farmio] - [#144940])- 修复家庭助理黄色配置条目数据([@emontnemery] - [#144948])
- 将 deebot-client 升级到 13.2.0 ([@edenhaus] - [#144957])- 修复进入设置后启用深度睡眠时 ESPHome 实体不可用的问题 ([@oddstr13] - [#144970])- 从 ZHA 事件
unique_id中取出_CLIENT后缀 ([@puddly] - [#145006])- 将 pySmartThings 升级到 3.2.2 ([@joostlek] - [#145033])- 将SmartThings即时设定点设置为未知(为是否1华氏度)([@joostlek] - [#145038])- 修复 Comelit 的温休闲控制状态 ([@chemelli74] - [#145059])- 映射正确的 SmartThings 自动模式 ([@joostlek] - [#145061])- 前端更新至 20250516.0 ([@bramkragten] - [#145062]) - 电梯新的 SmartThings 设备设置建议区域 ([@joostlek] - [#145063])- 修复 SmartThings AC 中的风扇 AC 模式 ([@joostlek] - [#145064])- 不要为 Smartthings 智能标签创造实体 ([@joostlek] - [#145066])- 修复 Ecovacs 割草机区域传感器 ([@edenhaus] - [#145071])[#142514]: https://github.com/home-assistant/核心/pull/142514 [#143878]: https://github.com/home-assistant/核心/pull/143878 [#144357]: https://github.com/home-assistant/核心/pull/144357 [#144406]: https://github.com/home-assistant/核心/pull/144406 [#144421]: https://github.com/home-assistant/核心/pull/144421 [#144564]: https://github.com/home-assistant/核心/pull/144564 [#144569]: https://github.com/home-assistant/核心/pull/144569 [#144571]: https://github.com/home-assistant/核心/pull/144571 [#144583]: https://github.com/home-assistant/核心/pull/144583 [#144584]: https://github.com/home-assistant/核心/pull/144584 [#144634]: https://github.com/home-assistant/核心/pull/144634 [#144635]: https://github.com/home-assistant/核心/pull/144635 [#144641]: https://github.com/home-assistant/核心/pull/144641 [#144642]: https://github.com/home-assistant/核心/pull/144642 [#144666]: https://github.com/home-assistant/核心/pull/144666 [#144670]: https://github.com/home-assistant/核心/pull/144670 [#144671]: https://github.com/home-assistant/核心/pull/144671 [#144672]: https://github.com/home-assistant/核心/pull/144672 [#144682]: https://github.com/home-assistant/核心/pull/144682 [#144684]: https://github.com/home-assistant/核心/pull/144684 [#144703]: https://github.com/home-assistant/核心/pull/144703 [#144713]: https://github.com/home-assistant/核心/pull/144713 [#144718]: https://github.com/home-assistant/核心/pull/144718 [#144720]: https://github.com/home-assistant/核心/pull/144720 [#144722]: https://github.com/home-assistant/核心/pull/144722 [#144738]: https://github.com/home-assistant/核心/pull/144738 [#144754]: https://github.com/home-assistant/核心/pull/144754 [#144771]: https://github.com/home-assistant/核心/pull/144771 [#144792]: https://github.com/home-assistant/核心/pull/144792 [#144803]: https://github.com/home-assistant/核心/pull/144803 [#144813]: https://github.com/home-assistant/核心/pull/144813 [#144818]: https://github.com/home-assistant/核心/pull/144818 [#144825]: https://github.com/home-assistant/核心/pull/144825 [#144849]: https://github.com/home-assistant/核心/pull/144849 [#144852]: https://github.com/home-assistant/核心/pull/144852 [#144855]: https://github.com/home-assistant/核心/pull/144855 [#144869]: https://github.com/home-assistant/核心/pull/144869 [#144905]: https://github.com/home-assistant/核心/pull/144905 [#144908]: https://github.com/home-assistant/核心/pull/144908 [#144911]: https://github.com/home-assistant/核心/pull/144911 [#144924]: https://github.com/home-assistant/核心/pull/144924 [#144940]: https://github.com/home-assistant/核心/pull/144940 [#144948]: https://github.com/home-assistant/核心/pull/144948 [#144957]: https://github.com/home-assistant/核心/pull/144957 [#144970]: https://github.com/home-assistant/核心/pull/144970 [#145006]: https://github.com/home-assistant/核心/pull/145006 [#145033]: https://github.com/home-assistant/核心/pull/145033 [#145038]: https://github.com/home-assistant/核心/pull/145038 [#145059]: https://github.com/home-assistant/核心/pull/145059 [#145061]: https://github.com/home-assistant/核心/pull/145061 [#145062]: https://github.com/home-assistant/核心/pull/145062 [#145063]: https://github.com/home-assistant/核心/pull/145063 [#145064]: https://github.com/home-assistant/核心/pull/145064 [#145066]: https://github.com/home-assistant/核心/pull/145066 [#145071]: https://github.com/home-assistant/核心/pull/145071 [@Bre77]: https://github.com/Bre77 [@Danielhiversen]: https://github.com/Danielhiversen [@Lash-L]: https://github.com/Lash-L [@MartinHjelmare]: https://github.com/MartinHjelmare [@RubenNL]: https://github.com/RubenNL [@Thomas55555]: https://github.com/Thomas55555 [@allenporter]: https://github.com/allenporter [@bdraco]: https://github.com/bdraco [@bramkragten]: https://github.com/bramkragten [@cadavre]: https://github.com/cadavre [@catsmanac]: https://github.com/catsmanac [@chemelli74]: https://github.com/chemelli74 [@edenhaus]: https://github.com/edenhaus [@emontnemery]: https://github.com/emontnemery [@farmio]: https://github.com/farmio [@frenck]: https://github.com/frenck [@gjohansson-ST]: https://github.com/gjohansson-ST [@hahn-th]: https://github.com/hahn-th [@jbouwh]: https://github.com/jbouwh [@joostlek]: https://github.com/joostlek [@oddstr13]: https://github.com/oddstr13 [@oyvindwe]: https://github.com/oyvindwe [@puddly]: https://github.com/puddly [@rjblake]: https://github.com/rjblake [@silamon]: https://github.com/silamon [@starkillerOG]: https://github.com/starkillerOG [@tl-sl]: https://github.com/tl-sl [@zweckj]: https://github.com/zweckj
2025.5.3 - 5 月 23 日
- Netatmo:不要按计划更新失败 ([@wuede] - [#142933])- 修复 QNAP 无法加载的问题 ([@disforw] - [#144675])- 允许以只读访问权限发送图像(矩阵通知)([@TheOneValen] - [#144819])
- 服务调用后延迟 WMSPro 中的更新 ([@mback2k] - [#144836])- 将 ESPHome 稳定 BLE 版本提升至 2025.5.0 ([@bdraco] - [#144857])- 修复专辑和艺术家为 Squeezebox 媒体播放器返回“None”而不是 None 的问题。 ([@peteS-UK] - [#144971])- 将 aiontfy 提升至 0.5.2 ([@tr4nt0r] - [#145044])- 修复了异常的Ecovacs割草机区域传感器 ([@edenhaus] - [#145078])- 将自动映射到 SmartThings 中恒温器的 heat_cool ([@joostlek] - [#145098])- 将缺失的设备条件翻译添加到门锁组件 ([@jpbede] - [#145104])
- 使用结束之前的滑动窗口修复history_stats ([@karwosts] - [#145117])- 将感应能量提升至 0.13.8 ([@kbickar] - [#145156])
- 改进Z-Wave配置流程测试([@MartinHjelmare] - [#144871])- 修复控制器迁移期间 Z-Wave 唯一 ID 更新 ([@MartinHjelmare] - [#145185])- 将 velbusaio 升级到 2025.5.0 ([@cereal2nd] - [#145198])- 将 aiocomelit 提升至 0.12.3 ([@chemelli74] - [#145209])- 修复 NVM 恢复后 Z-Wave 配置区域的唯一 ID ([@MartinHjelmare] - [#145221])- 将假期提高到 0.73 ([@gjohansson-ST] - [#145238])
- 将 pyaprilaire 提升至 0.9.0 ([@chamberlain2007] - [#145260])- 将云作为 after_dependency 添加到 onedrive ([@zweckj] - [#145301])- 处理azure_storage中的更多异常([@zweckj] - [#145320])- 修复了 Synology DSM 位置上显示备份的限制 ([@mib1185] - [#145342])- 为 Squeezebox 中的玩家创建初始协商员刷新([@peteS-UK] - [#145347])- 修正:将Ecovacs割草机总统计面积单位恢复为平方米([@Augar] - [#145380])- 将 pysqueezebox 升级到 v0.12.1 ([@rajlaud] - [#145384])- OTBR:删除过时的多协议文档的链接([@c0ffeeca7] - [#145394])- 将 pylamarzocco 升级到 2.0.4 ([@zweckj] - [#145402])- 将 py-synologydsm-api 升级至 2.7.2 ([@mib1185] - [#145403])- Lamarzocco 中的 GS3 MP 不支持标记反冲二元传感器 ([@zweckj] - [#145406])- 将 yt-dlp 提升至 2025.05.22 ([@joostlek] - [#145441])- Reolink 修复设备迁移 ([@starkillerOG] - [#145443])- 将 pysmartthings 升级到 3.2.3 ([@joostlek] - [#145444])- 将 opower 提升至 0.12.1 (@tronikos - [#145464])- 让 Gemma 模型在 Google AI 中工作 (@tronikos - [#145479])- 修复与 Google AI 中的 Google 搜索工具相关的字符串 (@tronikos - [#145480])- 将 pyfibaro 提升到 0.8.3 ([@rappenze] - [#145488])- 将 deebot-client 升级到 13.2.1 ([@edenhaus] - [#145492])[#142933]: https://github.com/home-assistant/核心/pull/142933 [#144406]: https://github.com/home-assistant/核心/pull/144406 [#144564]: https://github.com/home-assistant/核心/pull/144564 [#144675]: https://github.com/home-assistant/核心/pull/144675 [#144819]: https://github.com/home-assistant/核心/pull/144819 [#144836]: https://github.com/home-assistant/核心/pull/144836 [#144857]: https://github.com/home-assistant/核心/pull/144857 [#144871]: https://github.com/home-assistant/核心/pull/144871 [#144971]: https://github.com/home-assistant/核心/pull/144971 [#145044]: https://github.com/home-assistant/核心/pull/145044 [#145072]: https://github.com/home-assistant/核心/pull/145072 [#145078]: https://github.com/home-assistant/核心/pull/145078 [#145098]: https://github.com/home-assistant/核心/pull/145098 [#145104]: https://github.com/home-assistant/核心/pull/145104 [#145117]: https://github.com/home-assistant/核心/pull/145117 [#145156]: https://github.com/home-assistant/核心/pull/145156 [#145185]: https://github.com/home-assistant/核心/pull/145185 [#145198]: https://github.com/home-assistant/核心/pull/145198 [#145209]: https://github.com/home-assistant/核心/pull/145209 [#145221]: https://github.com/home-assistant/核心/pull/145221 [#145238]: https://github.com/home-assistant/核心/pull/145238 [#145260]: https://github.com/home-assistant/核心/pull/145260 [#145301]: https://github.com/home-assistant/核心/pull/145301 [#145320]: https://github.com/home-assistant/核心/pull/145320 [#145342]: https://github.com/home-assistant/核心/pull/145342 [#145347]: https://github.com/home-assistant/核心/pull/145347 [#145380]: https://github.com/home-assistant/核心/pull/145380 [#145384]: https://github.com/home-assistant/核心/pull/145384 [#145394]: https://github.com/home-assistant/核心/pull/145394 [#145402]: https://github.com/home-assistant/核心/pull/145402 [#145403]: https://github.com/home-assistant/核心/pull/145403 [#145406]: https://github.com/home-assistant/核心/pull/145406 [#145441]: https://github.com/home-assistant/核心/pull/145441 [#145443]: https://github.com/home-assistant/核心/pull/145443 [#145444]: https://github.com/home-assistant/核心/pull/145444 [#145464]: https://github.com/home-assistant/核心/pull/145464 [#145479]: https://github.com/home-assistant/核心/pull/145479 [#145480]: https://github.com/home-assistant/核心/pull/145480 [#145488]: https://github.com/home-assistant/核心/pull/145488 [#145492]: https://github.com/home-assistant/核心/pull/145492 [@Augar]: https://github.com/Augar [@MartinHjelmare]: https://github.com/MartinHjelmare [@TheOneValen]: https://github.com/TheOneValen [@bdraco]: https://github.com/bdraco [@c0ffeeca7]: https://github.com/c0ffeeca7 [@cereal2nd]: https://github.com/cereal2nd [@chamberlain2007]: https://github.com/chamberlain2007 [@chemelli74]: https://github.com/chemelli74 [@disforw]: https://github.com/disforw [@edenhaus]: https://github.com/edenhaus [@frenck]: https://github.com/frenck [@gjohansson-ST]: https://github.com/gjohansson-ST [@joostlek]: https://github.com/joostlek [@jpbede]: https://github.com/jpbede [@karwosts]: https://github.com/karwosts [@kbickar]: https://github.com/kbickar [@mback2k]: https://github.com/mback2k [@mib1185]: https://github.com/mib1185 [@peteS-UK]: https://github.com/peteS-UK [@rajlaud]: https://github.com/rajlaud [@rappenze]: https://github.com/rappenze [@starkillerOG]: https://github.com/starkillerOG [@tr4nt0r]: https://github.com/tr4nt0r @tronikos: https://github.com/tronikos [@wuede]: https://github.com/wuede [@zweckj]: https://github.com/zweckj
需要帮助吗?加入社区!
家庭助理拥有庞大的用户群体,他们都非常愿意互相帮助。那么,加入我们吧! 我们非常活跃的 Discord 聊天服务器 是一个绝佳的地方 ,并且不要忘记加入我们精彩的论坛。 发现错误或问题?请在我们的问题跟踪器 中报告该问题, 把它修好!或者,查看我们的帮助页面 以获取更多指导 你可以去的地方。 您更喜欢电子邮件吗? 订阅我们的“构建开放家庭通讯” 获取有关功能、社区中发生的事情的最新消息以及 有关建造开放之家的其他新闻;直接进入您的收件箱。
向后不兼容的更改
我们尽力避免对现有功能进行更改,这可能会导致 意外地影响您的家庭助理安装。不幸的是,有时,这是不可避免的。 我们始终确保记录这些更改,以使过渡变得简单 对你来说是可能的。此版本具有以下向后不兼容的更改: 在此发布中,我们对主题系统进行了基础更新, 包括向后不兼容的更改:
- 删除了聚合物组件:传统的基于聚合物的组件已被删除
完全移除。因此,所有相关的
paper-*CSS 变量也已已 已被删除。- 一些变量已迁移到新的主题令牌。
- 其他内容已过时并已被完全删除。
- 新的版式变量:我们引入了一组新的
排版CSS变量为更一致的内容奠定基础 和现代的用户界面。
- 这些是正在进行的重构的一部分,尚未在所有地方使用。 在未来的版本中将有更多的采用。 如果您正在维护自定义调整或主题,请更新 相应地遵循以下变量。
✅ 新代币
❌删除的令牌
🔄 迁移的代币
之前已弃用的 17TRACK 实体的状态属性已被删除。 如果您在自动化或脚本中依赖这些属性,您将需要 将它们更新为使用专用传感器。 ([@joostlek] - [#142622]) (文档) [@joostlek]: https://github.com/joostlek [#142622]: https://github.com/home-assistant/核心/pull/142622
AVM Fritz!Smarthome 有设备和单元的概念。一个设备可以有具有不同功能的多个单元。我们现在将设备的所有单元合并为 代表物理设备的一项。 由于这可能会删除现有设备并创建新设备,因此您应该检查您的 自动化和脚本以查看是否需要调整以适应新的设备注册表 条目。 ([@mib1185] - [#142845]) (文档) [@mib1185]: https://github.com/mib1185 [#142845]: https://github.com/home-assistant/核心/pull/142845
温控实体的所有额外状态属性都迁移到了它们的 自己的实体。这样这些属性就被弃用并将被删除 在家庭助理 2025.11 中。 如果您在自动化或脚本中依赖这些属性,您将需要 将它们更新为使用专用传感器。 ([@mib1185] - [#143394]) (文档) [@mib1185]: https://github.com/mib1185 [#143394]: https://github.com/home-assistant/核心/pull/143394
通用恒温器所针对的开关现在仅在以下情况下打开: 当前温度超出目标温度范围 (目标温度 +- 公差)。 以前,当温度等于极限时也会打开 的目标范围。 ([@esand] - [#138209]) (文档) [@esand]: https://github.com/esand [#138209]: https://github.com/home-assistant/核心/pull/138209
现在,在 Home Assistant 中配置的名称优先于以下内容HomeKit儿童配件:- 风扇预设(开关)
- 媒体播放器源(开关)
- 电源板(输入选择等)(插座)
- 开关(无状态可编程开关) 这修复了 HomeKit 中这些孩子名字缺失的问题配件。缺点是 Home Assistant 提供的名称必须在 Home Assistant 中进行更改(如果适用)。([@bdraco] - [#142531]) (文档) [@bdraco]: https://github.com/bdraco [#142531]: https://github.com/home-assistant/核心/pull/142531
Google 已放弃使用距离矩阵 API。新的路线 API 不提供状态属性 Destination addresses 和 Origin addresses
不再了。
免费请求数量减半,导致传感器现在刷新
每 10 分钟一次而不是每 5 分钟一次。
([@eifinger] - [#140691]) (文档)
[@eifinger]: https://github.com/eifinger
[#140691]: https://github.com/home-assistant/核心/pull/140691
La Marzocco 上个月发布了网关固件 v5,该固件已停止了支持本地通信。我们现在完全支持该固件;支持 旧固件已被删除。 以下实体和控件缺失,要么是因为它们不是 应用程序不再支持或尚未成为新库版本的一部分:
- 蒸汽和咖啡锅炉温度
- 射击计时器传感器
- 规模支持
- 蒸汽温度数
- 预冲泡和预输液编号 ([@zweckj] - [#142098]) (文档) [@zweckj]: https://github.com/zweckj [#142098]: https://github.com/home-assistant/核心/pull/142098
状态传感器已更改,从 UPS 显示屏提供状态。以前,多个状态会使用空格连接起来,这使得 它们更难阅读和处理。截至本发布,多种状态 而是使用逗号分隔。 ([@bonanitech] - [#141335]) (文档) [@bonanitech]: https://github.com/bonanitech [#141335]: https://github.com/home-assistant/核心/pull/141335
扫描间隔选项已从 NUT 中删除默认。扫描一次每 60 秒一次。如果需要,独立于集成且 常用方法 可用于设置自定义轮询间隔。 ([@tdfountain] - [#141845]) (文档) [@tdfountain]: https://github.com/tdfountain [#141845]: https://github.com/home-assistant/核心/pull/141845
如果你将能量返回电网,你将不得不重新配置你的能量
仪表盘。
为了改善能量仪表盘的体验,负能量
消费/cost值已被分成两个专用的
返回 /compensation 统计数据。
在下面添加 Opower {utility name} elec {account number} return
返回电网查看返回能量统计数据。轨道返回补偿
使用 Opower {utility name} elec {account number} compensation。
([@parkerbxyz] - [#135258]) (文档)
[@parkerbxyz]: https://github.com/parkerbxyz
[#135258]: https://github.com/home-assistant/核心/pull/135258
阿联酋,针对大西洋电熨烫设备,“自动”HVAC 模式Home Assistant 中的功能被映射到 Overkiz 中的“prog”模式。现在,Home Assistant 中的“自动”模式将直接对应于Overkiz中的“自动”模式,而“编程”模式可以使用默认设置进行选择。([@iMicknl] - [#143243]) (文档) [@iMicknl]: https://github.com/iMicknl [#143243]: https://github.com/home-assistant/核心/pull/143243
发现设备时不再创建持久通知。
基于持久通知的自动化
config_entry_discovery 应更新为在
事件config_entry_discovered。
([@emontnemery] - [#141546])
[@emontnemery]: https://github.com/emontnemery
[#141546]: https://github.com/home-assistant/核心/pull/141546
Total Connect 报警按钮之前已废弃的状态属性面板已被移除。 如果您在自动化或脚本中依赖这些属性,您将需要 将它们更新为使用专用传感器。 ([@joostlek] - [#142625]) (文档) [@joostlek]: https://github.com/joostlek [#142625]: https://github.com/home-assistant/核心/pull/142625
如果你是自定义集成开发者,并且想了解适用于你的集成的新功能和变更,请务必关注我们的[开发者博客][开发者博客]。本次发布中最值得注意的变化包括:
所有更改
当然,这篇文章还有很多内容。您可以找到以下列表 此处所做的所有更改:家庭助理核心 2025.5 的完整变更日志

