Home Assistant 2026.9 测试版：升级前先 grep 这几处旧字段

Home Assistant 保持月度节奏：测试版在每月最后一个周四，正式版在每月第一个周四。2026.9 正式版说明见 release-20269，RC 说明见 rc.home-assistant.io，项目主页 home-assistant.io。下面按改动面分组，重点标出升级后会静默失效的位置。

UI 与仪表盘

• 安全仪表盘 Security Dashboard：Active alerts 仅在有异常时出现，区分 Alert 严重告警与 Warning 普通警告（门窗未关、烟雾报警等），实体可自定义，无异常自动隐藏；另有 Favorites 收藏区，可置顶门锁、门窗、传感器。
• History & Activity 新增 Sources 侧边筛选面板，按楼层、区域、设备、实体、域、设备类型、集成过滤；大屏常驻、窄屏折叠，筛选条件自动记忆。History 仍需手动选实体才绘图，Activity 默认展示全部事件。
• Activity 活动日志点开单条事件可看到完整链路：触发源（人、状态变更、计划、集成、重启）→ 自动化/脚本 → 实体变更，链路可点击跳转，时间戳精确到毫秒。
• Matter 面板新增 Show map，展示 Thread/Wi-Fi 设备、边界路由器、电池终端，连线颜色区分传输方式、粗细代表信号强度。旧版 Matter Server 不支持会提示升级。
• Tile 卡片：灯可直接预览灯光特效，扫地机卡片可切风扇档位，支持湿度的 climate 实体可直接设目标湿度。
• 设置新增串口管理面板，统一列出正在使用、已插入未使用、预期缺失的串口，排查 USB-RS485、Zigbee 棒断线用得上。
• NAS 网络挂载显示占用进度条，85% 琥珀、95% 红色。
• 仪表盘编辑器新增 Background 标签页，背景不再写 YAML。
• 折线/柱状图表支持键盘导航与屏幕阅读器，能源仪表盘同样；时间线、桑基图暂不支持。

自动化与模板

• 太阳事件补全：新增 4 种条件、8 种触发器，覆盖 golden hour、blue hour、midnight sun、polar night，可限定早上/傍晚。
• 模板实体：报警面板、按钮、卷帘、风扇、灯、锁等支持自定义属性模板，attributes 支持模板语法；触发器型模板实体新增 conditions，条件不满足时阻止实体更新。
• 卷帘 cover 动作支持速度参数。
• 重启弹窗实时列出正在运行的自动化与脚本，重启前能看清会中断什么。
• 自动化 Trace 页面直接标出每一步操作的目标实体/设备/区域。

Modbus 连接共享

多个集成现在可以共用同一条 RS485/TCP Modbus 总线连接，不再抢占端口——不少光伏逆变器只允许很少的并发连接。底层换成新的 tmodbus 库。首批支持该机制的集成：Fronius、Sofar 阳光电源逆变器 Modbus、Flexit 通风设备。Fronius 走 Modbus TCP 能取到每串组件的 MPPT 电压电流功率，补上云 API 拿不到的数据；Sofar Inverter Modbus 本地接入并自动识别机型，支持光储一体机。

集成改进

Tuya 新增灯带 HCDD 设备类型；Shelly 摄像头完整支持（相机、移动侦测、隐私镜头开关），Wall Display XL 增加人体感应，修复温控继电器反向接线状态；Reolink 新增泛光灯定时、时间同步、防闪烁频率、防拆报警开关；Roborock V1 支持基站控制（洗拖布、烘干、集尘）；Midea 大量增强并新增子品牌虚拟集成；SwitchBot Cloud 支持户外灯带与 Curtain4；Imou 新增夜视模式、音量、门窗接触传感器；MQTT 新增独立仪表盘、订阅消息格式化与复制、快速跳转 Broker 设置；KNX 可在 UI 创建气象与选择实体，YAML 实体支持显式 unique_id。

向后不兼容变更

• Flexit Nordic(BACnet)：移除 switch._fireplace_mode，改为调用 climate.set_preset_mode，preset_mode: fireplace。
• KNX：实体首次上线不再主动向总线发送初始值，只响应读请求和后续状态变更，依赖上线即发报文的逻辑会异常。
• LLM 工具调用：工具名加了域前缀，如 homeassistant__GetLiveContext，自定义提示词里写死工具名的要同步改。
• Persistent Notification：通知更新触发事件带 update_type: updated，只监听 added 的自动化捕获不到修改。
• UniFi Protect：智能检测开关即使关闭录像依然可用、实体 ID 不变；但最低要求服务端 7.2.105，旧版本集成直接加载失败。
• Update 动作：安装更新、跳过更新、清除跳过更新需要管理员账号，非管理员触发的脚本会失败，改由自动化触发（自动化不受限制）。
• Vacuum：基础实体的 battery_level 属性移除。2026.8 开始迁移，2026.9 彻底删除，读电池必须改用独立 sensor.xxx_battery，未迁移的自定义集成不再输出电池数据。
• ZWave JS 锁管理（set_user/delete_user 等）同样要求管理员账号。

坑点与风险

扫地机旧自动化读 vacuum.battery_level 彻底失效，石头、追觅等机型升级后仪表盘无电池数值、条件判断不成立，统一换成 sensor.xxx_battery。UniFi Protect 服务端必须先到 7.2.105。KNX 不再发初始化报文，总线逻辑要复查。LLM 提示词里的旧工具名会报错。非管理员脚本触发更新会失败。VLC 本地集成已移除，只保留 VLC via Telnet，升级后旧集成会消失。Matter 拓扑图依赖新版 Matter-Server。

升级前建议在 /config 下扫一遍：

grep -rn "battery_level" /config    # vacuum 旧电池属性
grep -rn "GetLiveContext" /config   # LLM 旧工具名
grep -rn "fireplace_mode" /config   # Flexit 壁炉模式
grep -rn "update_type" /config      # 持久通知监听

Beta 不建议直接上生产环境，先备份。