title: '2025.1:带着备份迈入 2025!' description: '<lite-youtube videoid="qCd7RHprmc0" videotitle="Home Assistant 2025.1 发布 Party"</lite-youtube。 本页属于 Home Assistant 中文博客与更新记录,适合了解版本演进、功能变更与社区动态。' 保留策略,以及由集成扩展备份位置的完整能力。还有大量 “What the Heck?!” 月改进、新集成等更多更新!
2025.1:带着备份迈入 2025!
Home Assistant 2025.1 来了!🥂
新年快乐!Home Assistant 全体项目成员祝你和家人 在 2025 年平安健康、万事顺遂!❤️ 让我们一起把今年变得比去年更精彩!
我们都非常兴奋地用一个重量级发布来开启新的一年!🎆
这次发布带来了 Home Assistant 备份系统的全面重构, 它已经筹备了好几个月!这可不只是界面改一改—— 而是从前到后彻底翻新!
自动备份、加密的 Home Assistant Cloud 备份存储、 保留策略、配置向导,甚至还支持由集成提供备份存储位置!🤯
但还不止这些!我们在 12 月还举办了 “What the Heck?!” 月, 社区在活动中提出了很多体验优化建议,而这次发布已经落地了其中相当一部分!
这次发布内容真的很多,话不多说,直接开看!
祝你用得开心!
../Frenck
- 备份系统全面重构
- "What the Heck?!" 月
- 集成
- 其他值得注意的变化
- 仪表盘 background 设置
- Tile 卡片的媒体播放器音量功能
- 补丁版本
- 需要帮助?加入社区吧!
- 向后不兼容的变更
- 所有变更
备份系统全面重构
我们来聊聊备份。说实话,备份是最重要却也最容易被忽视的事情之一。 但当灾难发生时,比如硬件故障,一份可靠备份就能救场。 谁不希望出问题后还能快速恢复运行呢?
虽然 Home Assistant 过去的备份系统多年下来一直稳定可靠, 但它并不太方便你落实最佳实践, 比如定期备份、加密和异地存储。 许多人不得不依赖自定义插件、自动化或蓝图来补足这些能力。
而这一切,从这次发布开始改变!🎉
我们彻底重做了 Home Assistant 的备份体验, 让你只需几次点击就能按最佳实践建立扎实的备份策略, 在备份这件事上真正安心。
不用担心,如果你已经在使用自定义备份方案,它们依然可继续使用。 即使引入了很多新能力,我们仍确保整体保持向后兼容。
那么,废话不多说,一起看看全新的备份系统!
自动备份 🤖
没看错——Home Assistant 现在支持自动备份了!
通过计划任务,备份会定期自动创建, 你完全不用手动操作。 这能确保你始终有一份近期可用的备份,不再为此操心。
当你在设置菜单中进入备份页面时, 会看到全新的概览页,清楚显示上次备份时间和下次计划时间。 安心感瞬间拉满!
自动备份会在凌晨 4:45 执行。 也就是说,当家里人都在睡觉时,Home Assistant 正在为你的数据保驾护航。 这个时间点也意味着内部数据库维护已经完成, 能让备份文件尽可能紧凑。
如果计划自动备份过程中出现问题, Home Assistant 会通过修复中心通知你, 确保你能及时知晓并采取处理动作。
触发计划外自动备份 👆
按计划自动备份很棒,但有时你会希望 立刻触发一次备份! 比如你准备做大改动,或者晚上要连着升级一堆东西。
没问题!现在你可以随时在备份页面触发一次计划外自动备份。 它会立即按与你计划自动备份相同的配置创建备份。
按需触发自动备份非常实用,一键就能覆盖你的全部备份设置。 当然,手动备份依然保留, 你仍可以创建内容精确可控的特定备份。
Home Assistant Cloud 备份 😎
你是 Home Assistant Cloud by Nabu Casa 的订阅用户吗? 那你有福了!现在你可以自动把最新、完整加密的备份 存到 Home Assistant Cloud 账户中。
该功能额外不收费就提供 5GB 存储, 为你的数据带来完整加密的异地保护!🎁
你可以在 Home Assistant 内下载备份, 也可以在 Nabu Casa 的 Home Assistant Cloud 账户页面 下载。 这样即使 Home Assistant 硬件完全故障, 你仍可随时拿到最新备份。
备份位置天生可扩展 🧩
所以,自动备份可以存本地磁盘,也可以存 Home Assistant Cloud。 但如果你还想存到其他地方呢?
选择权是 Home Assistant 的核心价值之一; 我们希望在避免厂商锁定的前提下,把系统做得尽可能灵活。 因此,备份系统从设计上就是可扩展的。
这意味着未来集成可以提供新的备份存储位置, 比如 NAS、Google Drive、Backblaze B2 或其他存储服务商。
目前这项能力还是全新功能 ✨, 所以暂时还没有集成提供额外位置。 不过我们预计在接下来几个版本里,会有更多集成加入备份位置支持。
这种可扩展性确保你能把备份存到想存的地方, 自由选择你更偏好、也更信任的存储方案。
默认加密备份 🔒
随着 Home Assistant Cloud 成为异地备份位置, 以及未来集成可能提供更多(异地)备份位置, 安全性变得前所未有地重要。 你的备份不仅包含智能家居设备的访问凭据, 还包含你家中的历史数据, 任何人都不应该接触到如此敏感的信息!绝不!
因此,所有备份现在默认使用 AES-128 加密。 为了把备份安全放在首位,我们将过去可选的密码机制, 替换为强制使用的加密密钥。
首次设置备份时,系统会为你生成加密密钥。 请务必把它保存在安全位置,因为恢复备份时必须用到。 为了方便保存,你可以在设置流程中把密钥下载为应急包的一部分, 也可以之后随时在备份设置页面下载。 请妥善保管!🔑
所有安装方式都支持恢复备份 🤗
还有一个好消息——现在所有安装方式都支持恢复备份了!🎉
此前只有 Home Assistant OS 安装支持恢复备份。 而从这个版本开始,所有安装方式都可使用该功能! 无论你如何运行 Home Assistant, 即使是在 Docker 环境下使用容器,也都可以恢复备份。
这也意味着你可以从本地存储、Home Assistant Cloud, 或未来通过集成新增的任何备份位置进行恢复。
事实上,今天发布的所有备份功能, 都不受安装方式限制。 我们希望每个人都能拥有可靠的备份策略。
备份保留策略 🗑
之前的备份系统虽然能生成可靠备份, 但如果你不手动清理,磁盘空间最终还是会被占满。😬
所以!现在我们加入了备份保留策略! 你可以配置要保留多少份备份,其余交给 Home Assistant 自动处理。
每次备份后都会自动执行清理。 如果你因为特殊需求手动创建了备份,它们不会被自动删除, 你可以对特殊场景保持完全控制。
首次设置备份 🚀
新备份系统上手快速又简单!
升级后首次打开备份设置时, 你会看到一个设置向导, 它会一步步引导你完成备份配置。
向导会帮助你设置加密密钥、配置备份频率, 并设定备份保留策略。 全部完成后,它会立即启动你的第一次备份!
全部搞定!又少了一件需要担心的事 🎉
3…2…1… 备份!🎊
我们对这套新备份系统超级兴奋! 新年伊始,也真心建议你认真对待备份这件事。 把它当成一个不错的新年目标,如何?😉
所以,先停下手头的事,马上把备份设置起来吧! 直接开始你的 3-2-1 备份策略。 如果你还不熟悉它:
你可以在我们的 3…2…1… 备份博客文章 中了解全部内容。
“What the Heck?!” 月
12 月的 “What the Heck?!” 月 真的是一场超精彩的活动!🎉
非常感谢每一位分享 “What the Heck?!” 时刻和 Home Assistant 改进想法的朋友。 你的反馈非常宝贵,也持续帮助我们规划未来路线图和优先级。
非常感谢每一位分享自己 “What the Heck?!” 时刻和 Home Assistant 改进想法的朋友。你的反馈极其宝贵,也在持续帮助我们塑造未来的路线图与优先事项。
这次发布中已经解决了相当多大家分享的 “What the Heck?!” 问题 🚀——而且我们还不会停下!接下来的版本里,你还会看到更多受到这些反馈启发而实现的改进。
创建自动化和脚本时设置类别与标签
第一个已经解决的 WTH 项目,要感谢 @jpbede!而且这也是票数较高的问题之一,确实很值得解决!Andrew Jackson 写道:
"WTH can you not add categories, labels etc when creating an 自动化"
是啊,这确实是个很好的 WTH!每次你创建新的自动化或脚本时,通常都希望当场把它整理好,而不是之后再回到设置里补做。已修复!🎉
现在,当你创建新的自动化或脚本,或者给它们重命名时,就可以立刻设置描述、类别、标签和区域!🏷️ 很棒!
快速跳转到设备
你可能已经知道,在 Home Assistant 的任意位置,都可以按键盘上的 c 键打开快速导航栏前往各种页面,或按 e 键搜索并跳转到任意实体。不过……
"WTH is there no quick bar for devices?"
这是 Andreas Brett 提出的一个好问题!确实,之前设备没有这样的快捷入口。现在由 @jpbede 出手解决!你可以按下键盘上的 d 键,通过快速栏直接跳转到任意设备。
图表缩放与平移
KNXBroker 提出了下面这个 WTH 话题:
你说得对!Home Assistant 中的历史图表虽然基础但够用,但我们当然还能做得更好!🚀
那个 WTH 讨论里呼声很高的一项功能,就是图表的缩放与平移……感谢 @MindFreeze,现在你可以在 Home Assistant 的任意图表中进行缩放和平移了!📈
按住 ctrl(macOS 上为 command)并滚动鼠标滚轮,
即可在 Home Assistant 中缩放并拖拽任意图表!
按住 control 键(macOS 上为 command 键)并滚动鼠标滚轮,就可以缩放图表。你也可以点击并拖拽,平移已经放大的图表。
除了这个改动之外,@MindFreeze 还为历史图表加入了细小的微动画,让它们看起来更灵动、不再那么静态。
控制新实体默认是否暴露给 Assist
mathd 在 “What the Heck?!” 月的讨论中提出了这样一个问题:
"WTH Are all new 实体 exposed to Assist by default?"
我们听到了!感谢 @jpbede,你现在可以控制新实体默认是否暴露给 Assist 了。你可以在 Home Assistant 语音助手设置中开启或关闭这个选项。
更多 “What the Heck?!” 改进
本次发布中的很多小改进都来自 “What the Heck?!” 月活动。以下是其中另外一些值得注意的变化:
"WTH there is no hotkey for Assist"**
感谢 @jpbede,现在你可以在 Home Assistant 的任意位置按下键盘上的 a 键来唤出 Assist 了!🎙️ 很赞!
"WTH doesn't HA ask if I want to save automation?"
哇,这个问题也很好!感谢 @jpbede,现在如果自动化编辑器中有未保存的更改,离开前 Home Assistant 会询问你是否要保存。🤖
"WTH Is in Energy 仪表盘 the individual 设备 not able to reorder"
感谢你提出这个问题,yormedia!说实话,这个问题在之前几届 “What the Heck?!” 活动中也被提过很多次了。理由已经足够充分,于是 @karwosts 把它实现了!你现在可以在分类设置中重新排列它们的顺序。🔡
"WTH Can't I filter labels within a table filter?"
这是个好问题。如果你有很多标签,那么在筛选选项里滚动浏览完整标签列表会有点麻烦。感谢 @silamon,现在你可以直接在筛选选项中搜索并筛选标签了!🔎
WTH sentence 触发器 doesn't contain any context
这是个很棒的点子!感谢 @balloob,现在完整的对话输入内容已经可以供句子触发器使用了!🗣️ 这实际上也是本届活动中第一个被解决的 WTH 项目!😎
集成
感谢社区持续带来新的集成,并不断改进现有集成!你们都太棒了 🥰
新集成
欢迎以下新集成加入本次发布:
- Cookidoo,由 @miaucl 添加
与 [Cookidoo 官方 Thermomix 食谱平台]上的购物清单交互。 - EHEIM Digital,由 @autinerd 添加
使用 Home Assistant 控制你的 [EHEIM Digital 水族设备]。 - Ituran,由 @shmuelzon 添加
获取并使用你车辆中 Ituran 设备提供的信息。 - Ohme,由 @dan-r 添加
获取 Ohme 智能电动车充电器的传感器信息。 - Peblar,由 @frenck 添加
控制并监控你的 [Peblar 电动车充电器]的充电会话。 - Powerfox,由 @klaasnicolaas 添加
采集你的 Poweropti 设备所读取的电、水、燃气和热能数据。 - Slide Local,由 @dontinelli 添加
通过本地 API 将你的 Slide 窗帘设备直接接入 Home Assistant。 - Watergate,由 @adam-the-hero 添加
将 Watergate Sonic Local 集成进 Home Assistant。
现有集成的重要改进
不仅有新集成加入,现有集成也在持续改进。以下是一些值得关注的现有集成更新:
- TP-Link Smart Home 现在已经支持摄像头了!干得漂亮,@sdb9696!
- @RaHehl 为 UniFi Protect 集成 添加了 UniFi Protect AI Port 支持。太棒了!
- Music Assistant 集成 现在支持返回响应值的动作。感谢 @marcelveldt!
- Cambridge Audio 集成现在支持媒体浏览了!感谢 @noahhusby!
- @dotav 为 Palazzetti 颗粒炉增加了燃烧功率控制能力。很赞!
- SwitchBot 蓝牙 集成 现在支持 SwitchBot Water Leak Detector 和继电器开关。干得好,@luc-ass 和 @greyeee!
- @davidrapan 一直在改进 Starlink 集成,加入了上报功率、能耗和数据使用情况的传感器。不错!
现已可通过 UI 设置
虽然大多数集成都可以直接在 Home Assistant 用户界面中设置,但仍有一些过去只能通过 YAML 配置。我们持续将更多集成迁移到 UI 中,让每个人都更容易设置和使用。
以下集成现在已可通过 Home Assistant UI 设置:
告别以下集成
以下集成也已在本次发布中移除:
- DTE Energy Bridge 在弃用后已被移除,因为该集成已经无法正常工作。
- Simulated 此前已被弃用,现在正式移除。
- Stookalert 已被移除,因为其上游数据已不再更新。若你需要相同信息,Stookwijzer 集成是一个不错的替代方案。
其他值得注意的变化
本次发布还有许多其他改进;以下是其中一些值得关注的变化:
- 当你查看数据表并在浏览器中使用
ctrl+f搜索时,搜索输入框现在会自动获得焦点,因为浏览器原生搜索在数据表中无法正常工作。感谢 @jpbede! - @marcinbauer85 调整了“添加卡片”对话框,现在添加卡片时会自动聚焦到搜索框,这样你就能立刻开始输入搜索内容。很贴心!
- 通过 Home Assistant 上传的图片(例如背景图或用户头像)现在可以在媒体浏览器中浏览了。感谢 @karwosts!
- 在数字实体的 more-info 对话框中,数值滑块旁边现在会显示计量单位。感谢 @abmantis!
- Home Assistant 现在支持将
mWh作为能量传感器的单位,并支持将mW作为电功率传感器的单位。感谢 @agners! - @wendevlin 为自动化和脚本编辑器添加了设置和类别的溢出菜单动作(右上角三点菜单),让你可以更直接地从编辑器访问这些内容。不错!
- logbook 卡片 现在支持选择要显示事件的目标。你现在可以按实体、设备、区域、楼层和标签来筛选!感谢 @silamon!
仪表盘 background 设置
几次发布之前,我们让给仪表盘添加背景图片变得更容易了。而在本次发布中,@silamon 更进一步,加入了大量设置,让你可以自定义背景图片的显示方式。
这包括支持平铺背景、透明度、尺寸设置、对齐方式,以及让背景随页面滚动或固定不动。
太棒了!感谢 @silamon!
Tile 卡片的媒体播放器音量功能
这是来自 @simon-zumbrunnen 的一个超棒新增功能!Tile 卡片现在支持媒体播放器音量滑块特性。借助它,你可以直接在 Tile 卡片上控制媒体播放器音量。🔉 干得漂亮,Simon!
Patch releases
我们还将在 1 月为 Home Assistant 2025.1 发布补丁版本。这些补丁版本只包含 bug 修复。我们的目标是每周五发布一个补丁版本。
2025.1.1 - January 7
- Matter Battery replacement icon (@lboue - #134460)
- Small fix to allow playing of expandable favorites on Squeezebox (@peteS-UK - #134572)
- 升级 bleak-esphome to 2.0.0 (@bdraco - #134580)
- 升级 uiprotect to 版本 7.2.0 (@RaHehl - #134587)
- Mention case-sensitivity in tplink credentials prompt (@rytilahti - #134606)
- 修复 Flick Electric authentication (@ZephireNZ - #134611)
- 修复 hive color tunable 灯光 (@epenet - #134628)
- 设置 logging in manifest for Cookidoo (@miaucl - #134645)
- 移除 call to remove slide (@joostlek - #134647)
- 更新 twentemilieu to 2.2.1 (@frenck - #134651)
- 修复 Reolink playback of recodings (@starkillerOG - #134652)
- 更新 peblar to 0.3.3 (@frenck - #134658)
- 升级 cookidoo-api library to 0.11.1 of for Cookidoo (@miaucl - #134661)
- 更新 demetriek to 1.1.1 (@frenck - #134663)
- Cookidoo exotic domains (@miaucl - #134676)
- Iterate over a copy of the list of programs at Home Connect select 设置 entry (@Diegorro98 - #134684)
- 将 from host to ip in zeroconf discovery for slide_local (@dontinelli - #134709)
- 升级 ZHA to 0.0.45 (@TheJulianJES - #134726)
- 升级 openwebifpy to 4.3.1 (@autinerd - #134746)
- 修复 swapped letter order in "°F" and "°C" temperature units (@NoRi2909 - #134750)
- Bumb python-homewizard-energy to 7.0.1 (@DCSBL - #134753)
- Register base 设备 entry during coordinator 设置 in AVM Fritz!Tools 集成 (@mib1185 - #134764)
- 升级 pysuezV2 to 2.0.1 (@jb101010-2 - #134769)
- 修复 missing sentence-casing etc. in several strings (@NoRi2909 - #134775)
- Raise ImportError in python_script (@gjohansson-ST - #134792)
- Replace "id" with "ID" for consistency across HA (@NoRi2909 - #134798)
- 修复 a few typos or grammar 问题 in asus_wrt (@NoRi2909 - #134813)
- 升级 uiprotect to 版本 7.4.1 (@RaHehl - #134829)
- 升级 habluetooth to 3.7.0 (@bdraco - #134833)
- 修复 how function arguments are passed on 动作 at Home Connect (@Diegorro98 - #134845)
- 升级 aiolifx-themes to 更新 colors (@Djelibeybi - #134846)
- 更新 Roborock config flow message when an account is already configured (@allenporter - #134854)
- 日志 upload BackupAgentError (@ludeeus - #134865)
- 日志 cloud 备份 upload response status (@ludeeus - #134871)
- 升级 solax to 3.2.3 (@squishykid - #134876)
- 添加 extra failure exceptions during roborock 设置 (@Lash-L - #134889)
- Use uppercase for "ID" and sentence-case for "name" / "icon" (@NoRi2909 - #134890)
- 升级 python-kasa to 0.9.1 (@sdb9696 - #134893)
- 添加
bring_apito loggers in Bring 集成 (@tr4nt0r - #134897) - 修复 wrong power limit decimal place in IronOS (@tr4nt0r - #134902)
- 更新 前端 to 20250106.0 (@bramkragten - #134905)
- 升级 powerfox to v1.1.0 (@klaasnicolaas - #134730)
- 升级 powerfox to v1.2.0 (@klaasnicolaas - #134908)
- 升级 holidays to 0.64 (@gjohansson-ST - #134922)
- 回滚 "Remove deprecated supported features 警告 in LightEntity" (@arturpragacz - #134927)
- 回滚 "Remove deprecated supported features 警告 in ..." (multiple) (multiple) (@frenck - #134933)
2025.1.2 - January 9
- 修复 Météo-France 设置 in non French cities (because of failed next rain 传感器) (because of failed next rain 传感器) (@Quentame - #134782)
- 提高 cloud 备份 download 超时 (@ludeeus - #134961)
- 修复 ZHA "referencing a non existing
via_device" 警告 (@puddly - #135008) - Catch 错误 in 自动化 (instead of raise unexpected 错误) in Overkiz (@iMicknl - #135026)
- 修复 channel retrieval for Reolink DUO V1 connected to a NVR (@starkillerOG - #135035)
- 升级 aioautomower to 2025.1.0 (@Thomas55555 - #135039)
- 升级 cookidoo-api to 0.12.2 (@miaucl - #135045)
- Implement upload retry logic in CloudBackupAgent (@ludeeus - #135062)
- 添加 jitter to 备份 start time to avoid thundering herd (@emontnemery - #135065)
- 升级 pysuezV2 to 2.0.3 (@jb101010-2 - #135080)
- 修复 Flick Electric Pricing (@ZephireNZ - #135154)
- 更新 前端 to 20250109.0 (@bramkragten - #135235)
2025.1.3 - January 20
- 修复 DiscoveryFlowHandler when discovery_function returns bool (@kgraefe - #133563)
- Aprilaire - Fix 加湿器 showing when it is not available (@chamberlain2007 - #133984)
- Gracefully handle webhook unsubscription if 错误 occurs while contacting Withings (@dcmeglio - #134271)
- Image 实体 key 错误 when 摄像头 is ignored in EZVIZ (@RenierM26 - #134343)
- 升级 pyaussiebb to 0.1.5 (@Bre77 - #134943)
- 修复 Watergate Power supply mode description and MQTT/WiFi uptimes (@adam-the-hero - #135085)
- 修复 missing comma in ollama MODEL_NAMES (@epenet - #135262)
- 升级 Freebox to 1.2.2 (@Quentame - #135313)
- Actually use translated 实体 names in Lametric (@joostlek - #135381)
- 修复 descriptions of send_message 动作 of Bring! 集成 (@NoRi2909 - #135446)
- 升级 switchbot-api to 2.3.1 (@SeraphicRav - #135451)
- 修复 incorrect cast in HitachiAirToWaterHeatingZone in Overkiz (@iMicknl - #135468)
- Replace pyhiveapi with pyhive-集成 (@KJonline - #135482)
- 修复 referenced objects in 脚本 sequences (@arturpragacz - #135499)
- Use STT/TTS languages for LLM fallback (@synesthesiam - #135533)
- 升级 demetriek to 1.2.0 (@joostlek - #135580)
- Use 设备 supplied ranges in LaMetric (@joostlek - #135590)
- 升级 elkm1-lib to 2.2.11 (@gwww - #135616)
- 修复 MQTT number 状态 validation (@jbouwh - #135621)
- 添加 reauthentication to SmartThings (@joostlek - #135673)
- 处理 invalid HS color values in HomeKit Bridge (@bdraco - #135739)
- 更新 aioairzone to v0.9.9 (@Noltari - #135866)
- 移除 device_class from NFC and fingerprint event descriptions (@RaHehl - #135867)
- 防止 HomeKit from going 不可用 when min/max is reversed (@bdraco - #135892)
- 升级 onvif-zeep-async to 3.2.2 (@bdraco - #135898)
- Round brightness in Niko Home Control (@VandeurenGlenn - #135920)
- 更新 NHC lib to v0.3.4 (@VandeurenGlenn - #135923)
- 更新 knx-前端 to 2025.1.18.164225 (@farmio - #135941)
- 升级 aiooui to 0.1.8 (@bdraco - #135945)
- 升级 aiooui to 0.1.9 (@bdraco - #135956)
- 修复 switchbot cloud library logger (@joostlek - #135987)
- Correct type for off delay in rfxtrx (@elupus - #135994)
- 处理 invalid datetime in onvif (@bdraco - #136014)
- 升级 aioraven to 0.7.1 (@cottsay - #136017)
- 升级 onvif-zeep-async to 3.2.3 (@bdraco - #136022)
- 升级 yt-dlp to 2025.01.15 (@joostlek - #136072)
- 升级 deebot-client to 11.0.0 (@edenhaus - #136073)
- Always include SSL folder in backups (@emontnemery - #136080)
2025.1.4 - January 24
- 更新 Hydrawise maximum watering duration to meet the app limits (@mattdoran - #136050)
- 升级 holidays to 0.65 (@gjohansson-ST - #136122)
- 处理 width and height placeholders in the thumbnail URL (@Makrit - #136227)
- 修复 slave id equal to 0 (@crug80 - #136263)
- 处理 LinkPlay 设备 with no mac (@silamon - #136272)
- Fallback to None for literal "Blank" serial number for APCUPSD 集成 (@yuxincs - #136297)
- 更新 peblar to v0.4.0 (@frenck - #136329)
- Avoid keyerror on incomplete api data in myuplink (@astrandb - #136333)
- 更新 前端 to 20250109.1 (@piitaya - #136339)
- 更新 前端 to 20250109.2 (@piitaya - #136348)
- 升级 aiowithings to 3.1.5 (@joostlek - #136350)
- 升级 powerfox to v1.2.1 (@klaasnicolaas - #136366)
需要帮助?加入社区吧!
Home Assistant 拥有一个非常棒的用户社区,大家都非常愿意彼此帮助。所以,加入我们吧!
我们非常活跃的 Discord 聊天服务器 是一个绝佳去处,也别忘了加入我们精彩的 论坛。
发现了 bug 或问题?请到我们的 issue tracker 提交反馈,帮助我们修复!或者查看帮助页面,了解更多可寻求帮助的渠道。
如果你更喜欢电子邮件,订阅我们的 Building the Open Home Newsletter,即可直接在收件箱中接收最新功能消息、社区动态,以及关于打造 Open Home 的其他新闻。
向后不兼容的变更
我们始终尽力避免对现有功能做出可能意外影响 Home Assistant 安装的更改。但很遗憾,有时候这是不可避免的。
我们始终会记录这些更改,以尽可能让迁移过程变得更容易。本次发布包含以下向后不兼容变更:
1-Wire 计数器中的计量单位已被移除,
因为 count 并不是一个单位 😁
现在,如果 HEOS 媒体播放器分组中的某个成员不是有效的 HEOS 播放器, 系统会抛出异常。此前,未知或无效成员会被静默忽略。
(@andrewsayre - #132213) (文档)
devolo Home Control 集成已更新,移除了设置 mydevolo URL 的选项。 该选项此前仅用于开发目的,以对接 devolo Home Control Cloud。 该选项现已不可用。
FXCOM RFXtrx 计数器中的计量单位已被移除,
因为 count 并不是一个单位 😁
“Water usage” 传感器的计量单位已从 l/min 更新为 L/min。
这项调整统一了单位表示,以提升 Home Assistant 内的一致性。
任何依赖旧单位的自动化、脚本或模板都可能需要调整。 长期统计数据会保持不变,但系统会创建修复问题, 以确保数据按新单位完成更新。
color_temp 和 kelvin 选项已不再是 LIFX 动作的有效参数。请改用 color_temp_kelvin。
内置的 OAuth 应用凭据已被移除,因为 Tesla 已不再支持开源应用注册,并正转向按使用量付费的模式。
你可以在这篇博客文章中了解更多相关公告内容。
“设备状态” 传感器的状态值现已被标准化,以符合 Home Assistant 核心规则,并支持翻译。这会影响以下 UniFi 传感器状态:
Connected, which now becameconnectedPending, which now becamependingFirmware Mismatch, which now becamefirmware_mismatchUpgrading, which now becameupgradingProvisioning, which now becameprovisioningHeartbeat Missed, which now becameheartbeat_missedAdopting, which now becameadoptingDeleting, which now becamedeletingInform Error, which now becameinform_errorAdoption Failed, which now becameadoption_failedIsolated, which now becameisolatedUnknown, which now becameunknown
如果你在自动化、脚本或模板中直接使用了这些状态值,就需要相应调整,以匹配这些变化。
该集成现在使用官方的 Zabbix Python API。因此,当前支持的最低 Zabbix 版本变为 5.0。这意味着不再支持 Zabbix 4 及更早版本。
如果你是自定义集成开发者,并想了解适用于你集成的变化和新功能,请务必关注我们的开发者博客。以下是本次发布中最值得注意的几项:
- Changed name of WaterHeaterEntityDescription
- 温控 实体 now supports independent horizontal swing
- Moving to Pydantic v2
- New 吸尘器 状态 property
- Use Kelvin as the preferred color temperature unit
- New area 设备 class
全部变更
当然,本次发布还有更多内容。你可以在这里查看完整变更列表:Home Assistant 核心 2025.1 完整更新日志

