2025.11：选得更准，自动化更顺，还来一块派 🥧

    Home Assistant 2025.11 发布！🎉

    11 月来了，而我们这段时间一直在努力打磨你每天都会接触到的一些核心体验。我想，你一定会喜欢我们这次带来的内容。

    这次发布里我个人最喜欢的功能？全新的目标选择器。🎯

    这是一种表面看起来很简单，但实际上会彻底改变你构建自动化方式的改进。现在你终于可以清楚看到自己到底在操作什么目标：某个实体属于哪台设备、位于哪个区域，相关上下文一目了然。当天花板灯有三盏时，你再也不用猜自己控制的是不是正确那一盏了！

    但这还只是开始。我们继续推进自动化编辑器的改进，这次带来了一个彻底重做的对话框，用来添加触发器、条件和动作。它更整洁、更易读，也为未来几个版本中一些非常令人期待的新内容打下了基础。🤫

    说到让信息更清晰，你现在还可以精确控制实体名称在仪表盘卡片上的显示方式。想只显示实体名？设备名？区域名？还是把它们组合起来？都可以。即使你之后重命名，它们也会在仪表盘中保持同步，再也不需要手动更新了！

    哦对了，能源仪表盘爱好者应该也会喜欢新的设备能耗饼图视图，而且每张能源卡片的角落里还会显示总量。🥧

    祝你享受这次发布！

    ../Frenck

    PS：哦对了，嘘……别告诉别人 🤫，11 月 19 日可能会有个很重磅的发布。 先给这个已公布的 YouTube 直播点个小铃铛，免得错过。敬请期待！😀

    特别感谢所有让这次发布成为现实的贡献者！也要特别感谢帮助撰写本次发布说明的 @bramkragten、@JLo、@MindFreeze、@agners 和 @piitaya。另外， @silamon 与 @GemPolisher 也投入了很多精力来打磨内容。正因为有他们，这份发布说明才如此出色。❤️

    全新的目标选择器

    你是否也遇到过这种情况：在构建自动化时，看到三个都叫“天花板灯（Ceiling light）”的实体，然后心里想，“等等，这到底是哪一盏天花板灯？” 又或者，当你把目标设为整层楼或整个区域时，根本搞不清自己实际控制了多少盏灯？

    这种体验大家都懂。直到现在，目标选择器都无法告诉你完整情况。你看不到某个实体属于哪台设备，也不知道它被分配到了哪个区域。而当你把楼层或区域设为目标时，更是完全不知道究竟会影响多少实体。这种不确定性，让很多人宁愿一直使用单个实体作为目标，尽管更大的目标范围（比如区域和楼层）其实能让自动化变得更加灵活。

    新的目标选择器改变了这一切。现在，你可以看到每个目标背后的完整上下文，也能清楚知道某个动作究竟会影响多少实体。

    已选择目标的灯光动作配置界面截图。

    想看得更细？你可以展开任意楼层、区域或设备，精确查看其中包含了哪些实体，以及它们是从哪里来的。

    目标详情界面截图。

    这让构建能够随家庭规模一起扩展的自动化变得容易得多。当你以区域或楼层作为目标时，随着你添加或移除设备，自动化也会自动适配。再也不需要每次新增灯光或传感器时都去修改自动化了。自动化就该这样，直接工作。

    在自动化中添加触发器、条件和动作的全新方式

    我们正在努力让自动化更易于创建，这早已不是秘密。在两个版本前发布了自动化侧边栏之后，这次我们又带来了一个全新的对话框，用来添加触发器、条件和动作。

    这些变化目前还只是界面层面的：对话框变得更大了，因此每个区块的描述更容易阅读；同时，它还采用了双栏布局，让导航和区块选择都更加轻松。

    用于添加动作的新对话框截图。

    构建块（用于实现更复杂的条件或动作序列，比如重复动作或把流程分成多个分支）现在被移到了主对话框中的第二个标签页。如今，你只需要通过一个入口就能往自动化里添加内容，而不再是两个入口，这也显著减少了复杂自动化中的按钮数量。

    用于向动作添加构建块的新对话框截图。

    正如上面所说，这些变化目前还只是界面层面的！但这个新的对话框是后续演进的基础，我们已经迫不及待想在下一阶段成果落地时展示给你了。

    在仪表盘中命名实体

    几个版本前，我们通过加入更多上下文信息，大幅升级了实体选择器，让你能轻松看出每个实体属于哪里（见 2025 年 5 月版本）。这次发布中，我们把同样的灵活性带到了仪表盘里。

    你现在可以选择卡片上名称的显示方式：显示实体、设备、区域、楼层，甚至把它们组合起来。这让你能完全掌控仪表盘的显示风格。例如，在某个专门展示特定设备的区域里，你可能只想显示实体名称，以避免每张卡片都重复同一个设备名。

    当然，如果你想完全掌控显示文字，也仍然可以直接设置自定义名称。

    而最棒的部分是？如果你重命名了某个实体或设备，仪表盘会自动保持同步。再也不需要手动修改，一切都会自己更新。

    磁贴卡片配置对话框截图。

    能源饼图

    我们为设备能耗图新增了一种布局：“饼图” 🥧。你可以通过点击右上角图标，在普通柱状图与新的饼图之间切换。

    显示设备能耗图饼图布局的截图。

    在加入这个切换后，其他能源卡片右上角看起来有点空，所以我们把这块空间利用起来，显示所选时间段的总能耗。例如，如果日期选择器设为“今天”，那么当天的太阳能总发电量就会显示在太阳能发电图卡片的角落里。

    Home Assistant 与插件更新进度

    从这次发布开始，你可以追踪 Home Assistant 与插件（由 Supervisor 管理）的更新进度了！这个进度会覆盖下载与解压等阶段，因此所需时间会受到网络速度、CPU 性能以及系统负载影响。也正因如此，进度条不会呈现出完全线性的变化，但它依然可以很好地估算更新已经进行到了哪一步。

    展示插件更新进度报告的屏幕录制。

    集成

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

    新集成

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

    现有集成的重要改进

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

    • SwitchBot 集成现在支持车库门开门器了。感谢 @zerzhang！
    • @tr4nt0r 为 Habitica 集成加入了通知支持。干得漂亮！
    • VegeHub 集成现在支持通过开关来控制执行器。不错， @Thulrus ！
    • Portainer 集成新增了开关、按钮和传感器支持，因此你现在可以控制和监控所有容器了！做得好 @erwindouna！
    • Volvo 集成现在可以显示车辆位置，并提供控制按钮。感谢 @thomasddn！
    • ElevenLabs 现在可以用于语音转文字了。感谢 @ehendrix23！
    • 你现在可以控制受支持的 UniFi 网络设备上的 LED 了！感谢 @Sese-Schneider！
    • @barneyonline 为 Yardian 集成加入了二元传感器。不错！
    • 现在你可以通过 OctoPrint 集成设置 3D 打印机喷头和热床的温度。感谢 @AmadeusW！
    • Niko Home Control 集成现在也会把你的场景加入 Home Assistant！感谢 @VandeurenGlenn！
    • 你的 Control4 气候设备（例如温控器）现在已经受 Home Assistant 支持。感谢 @davidrecordon！
    • Growatt MIN/TLX 逆变器控制支持已加入，你现在也可以启用电网充电了！感谢 @johanzander！
    • @hanwg 为 Telegram Bot 集成加入了事件实体。这样一来，例如当你收到消息时，就能更容易地做自动化了！很赞！
    • Xbox 集成现在支持图像显示了！它会展示你当前正在玩的游戏图片、头像，以及你和好友的 Gamerpic。感谢 @tr4nt0r！
    • @AndyTempel 为 Victron Remote Monitoring 加入了太阳能发电预测支持，因此你现在可以在能源仪表盘中看到当天可能产生多少太阳能的预测！
    • Shelly 集成现在支持 climate 和 valve 实体。感谢 @thecode！
    • @starkillerOG 改进了 Reolink 集成；它现在可以报告自行车以及人物、车辆和动物的类型。所以你现在还能知道摄像头检测到的是男人还是女人。做得很棒！

    现已可通过 UI 设置

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

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

    集成质量等级成果

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

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

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

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

    告别以下集成

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

    • Vultr 已被移除。自其所使用的 API v1 在 2023 年 9 月下线后，该集成就已经无法工作。
    • IBM Watson IoT Platform 已被移除。IBM 于 2020 年 9 月 8 日宣布停止支持 IBM Watson IoT Platform，并在 2022 年 9 月 30 日前逐步停用了所有版本。
    • Plum Lightpad 已被移除。由于其服务器已经关闭，该集成不再可用。

    其他值得关注的变化

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

    • @thecode 为阀门加入了 group 支持，因此你现在可以把多个阀门分组成一个。
    • 数据表中的搜索功能有了大幅提升；你现在可以同时跨多列进行搜索。感谢 @wendevlin！
    • 能源图表现在会在右上角显示该时段的总量。这是 @MindFreeze 带来的优秀补充！
    • 感谢 @karwosts，现在你可以把任意提供图像的集成中的图片用作仪表盘背景。

    日志效率改进

    如果你使用的是 Home Assistant Operating System，我们有个好消息！我们把日志系统做得高效多了。🚀

    你可能没意识到，但你在 设置 > 系统 > 日志 中看到的那些 Home Assistant 日志，实际上一直都在磁盘上被存了两份。🙈

    Home Assistant OS 会以非常高效的方式保存包括 Home Assistant 自身在内的所有日志，甚至在重启后也依然保留！但除此之外，我们还把这些日志再次写入你 Home Assistant 配置文件夹中的日志文件里。

    这并不理想。它不仅占用了双倍磁盘空间，更重要的是，它会对存储介质造成不必要的磨损，从而让其更早损坏。如果你使用的是例如树莓派上的 SD 卡，这一点尤其值得担心。

    从这次发布开始，我们已经停止把日志写入配置文件夹。你依然可以像之前一样，在 Home Assistant 设置页面中查看和下载所有日志；只是现在该页面会直接从操作系统中读取日志。

    Tip

    如果你更喜欢命令行，也没问题，我们的 Home Assistant CLI 同样支持。运行 ha core logs --help 即可查看更多信息。

    新的 Home 仪表盘还在持续变聪明

    在最近几个版本引入的改进基础上，这次发布又让整体体验变得更加顺滑、更加直观。

    我们对整体结构做了简化和重新组织：

    • 推荐实体和收藏项现在被合并进了一个智能分区里，在同一个地方显示最相关的内容。
    • 区域现在会按楼层分组，这让浏览和快速理解你家的布局变得更容易。
    • 灯光、气候和安防视图现在已经迁移到各自独立的仪表盘中，因此你可以直接在 设置 > 仪表盘 下访问它们。这些仪表盘现在也会包含那些没有被分配到特定区域的设备，确保没有内容被遗漏。

    这些改进让一切组合得更加自然，也让你的 Home 仪表盘不再像一堆设置项，而更像是你家真实状态的映射。

    仪表盘配置面板中的新内置仪表盘。

    Patch releases

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

    2025.11.1 - 11 月 7 日

    2025.11.2 - 11 月 14 日

    2025.11.3 - 11 月 21 日

    需要帮助？加入社区

    Home Assistant 拥有一个非常棒的社区，大家都很乐意彼此帮助。欢迎你加入我们！

    我们的 Discord 聊天服务器 非常活跃，是获取帮助的好地方，也别忘了加入精彩的 论坛。

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

    如果你更偏好邮件方式，可以 订阅 Open Home Foundation 新闻邮件，第一时间接收新功能、社区动态，以及支持 Open Home 的其他项目资讯。

    不向后兼容的变更

    我们一直尽力避免对现有功能做出可能意外影响你 Home Assistant 安装的变更。但有些情况下，这类变更不可避免。

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

    此前，group 的 assumed 状态始终为 false，不受其子实体状态影响。

    现在这一点已经调整：

    如果至少一个子实体的 assumed 状态为 true，那么 group 的 assumed 状态也会变为 true。 这让 group 的 assumed 状态可以更准确地反映子实体的不确定性。 新增适用域：switch、fan、light 和 cover。

    (@piitaya - #154163) (group docs)

    asuswrt 设备追踪器已移除 last_time_reachable 属性。 请在自动化中改用 last_changed 属性。

    (@ollo69 - #154219) (asuswrt docs)

    对于不具备自动开机能力的 LG webOS TV 媒体播放器实体，其状态将从原来的 off 改为 unavailable。

    (@thecode - #155164) (webostv docs)

    mealie 集成现在要求 Mealie 版本为 2 或更高。

    Mealie 版本 1 不再受支持。版本 2 于 2024 年 10 月发布，距今已超过一年。由于 1 与 2 版本差异较大，我们已无法继续支持或测试与版本 1 的兼容性。

    (@andrew-codechimp - #153203) (mealie docs)

    motion_blinds 设备的倾斜位置定义已修正，以对齐 Home Assistant 标准。 新的倾斜位置含义为：0 = 关闭/遮挡窗户开口，100 = 打开/允许光线进入。 旧值可按以下方式换算为新值：

    • new = 100 - old
    • current_tilt_position = 100 -> 0
    • current_tilt_position = 75 -> 25
    • current_tilt_position = 50 -> 50
    • current_tilt_position = 25 -> 75
    • current_tilt_position = 0 -> 100
    • open_cover_tilt -> close_cover_tilt
    • close_cover_tilt -> open_cover_tilt

    所有涉及 Motion Blinds 且使用 current_tilt_position 属性或倾斜开关操作的自动化，都需要相应调整。

    (@starkillerOG - #149777) (motion_blinds docs)

    支持 iPhone 与 Android 伴侣应用的 mobile_app 集成，现在更好地处理了“仅区域”位置更新。当伴侣应用仅发送区域名称（而非精确坐标）时，设备追踪器会显示该区域的友好名称。

    对于自定义区域，person 实体现在显示区域的友好名称（而非 object ID）。这可能会影响基于人员状态触发的现有自动化。

    例如，你有一个名为 zone.kids_school 的区域，其友好名称为 School：

    • 变更前：当伴侣应用中 Location Sent 设为 Zone Name Only 时，对应 person 和 device_tracker 实体状态为 kids_school；设为 Exact 时状态为 School。
    • 变更后：无论 Location Sent 如何设置，对应 person 和 device_tracker 实体状态都将为 School。

    (@Ashus - #149453) (mobile_app docs)

    Nederlandse Spoorwegen 实体现在以时间戳实体显示，而不再是字符串。请相应调整你的自动化和脚本。

    (@joostlek - #154011) (nederlandse_spoorwegen docs)

    ONVIF GoToPreset 动作中的 Speed 参数现在变为可选。

    系统不再默认设置 0.5。如果你想恢复之前的行为，需要在动作中显式将 speed 设为 0.5。

    (@carlos-sarmiento - #149636) (onvif docs)

    OralB 集成中的状态和值属性已发生变化。

    在多个位置中，空格已改为下划线：

    • 牙刷状态：

      • flight menu → flight_menu
      • selection menu → selection_menu
      • final test → final_test
      • pcb test → pcb_test

    • 刷牙模式：

      • daily clean → daily_clean
      • gum care → gum_care
      • tongue cleaning → tongue_cleaning
      • super sensitive → super_sensitive
      • deep clean → deep_clean

    • 压力：

      • power button pressed → power_button_pressed
      • button pressed → button_pressed

    • 分区：

      • no sector → no_sector
      • sector 1 → sector_1
      • sector 2 → sector_2
      • sector 3 → sector_3
      • sector 4 → sector_4

    自动化需要更新为使用新的状态和值属性。

    (@tr4nt0r - #153605) (oralb docs)

    此前 Renault 功能的发现逻辑基于一些假设，可能会创建无效且不可用的实体。 现在将不再创建这些实体。

    (@epenet - #154137) (renault docs)

    Traccar 集成已更新为使用更安全的 API Token 进行认证。这是一项必需的一次性破坏性变更，用于遵循 Traccar 的安全建议，并确保集成持续可用。

    本次发布将集成从旧的用户名/密码方式迁移出去，以提升稳定性与安全性，同时也让基于 SSO 的部署能够正常使用该集成。

    升级 Home Assistant 后，现有 Traccar 集成需要重新认证：

    1. 在你的 Traccar 服务器上生成 API Token（可在 Traccar 服务器的用户设置中找到该选项）
    2. 前往 设置 > 设备与服务 > Traccar Server
    3. 选择“重新配置（Reconfigure）”，并在提示时输入新的 API Token

    完成后，你的 Traccar 设备和实体将和之前一样正常工作。

    (@pantherale0 - #155297) (traccar_server docs)

    由于 Xbox Live Gold 已迁移至 Xbox Game Pass，Account tier 和 Gold tenure 传感器已停止更新并被移除。此外，In party 与 In multiplayer 二元传感器也已移除，因为它们已经长期不可用。

    (@tr4nt0r - #154891) (xbox docs)

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

    全部变更

    当然，本次发布还有很多其他更新。你可以在这里查看完整变更列表：Home Assistant 核心 2025.11 完整更新日志