# 更新日志
## V2.10.3 - 2026年5月27日
本版本引入了内置 eWeLink 智能家居，便于设备同步，Mac 上的一键安装， 并增加了在 Docker 环境中运行 CUBE OS 的支持，提供更灵活的部署选项。请在更新到此版本前花点时间阅读以下说明。
### 有什么新功能？
1. **内置 eWeLink 智能家居，便于设备同步**
* 现在在 CUBE 中可以更简单地同步与 eWeLink 关联的设备。使用您的 eWeLink 账号从 **首页 > 添加设备** 登录后，即可直接在 CUBE 中同步并管理符合条件的设备，无需安装 eWeLink 智能家居插件。\
\&#xNAN;*注意：现有的插件设备将继续独立运行。*
2. **Docker 部署支持**
* CUBE OS 现在可在 Docker 环境中运行，为用户提供更灵活的部署选项。\
对于基于 Docker 的部署，以下系统级功能不可用：
* Docker（插件）
* 试点功能 > 蓝牙音箱
* 设置 > 网关信息 > 版本更新
* 设置 > 重启与关机
* 如需更新基于 Docker 的部署，请拉取最新的 Docker 镜像。
3. **扩展的一键安装支持**
* 新增支持在 Mac 上一键安装 CUBE。
***
## V2.10.2 - 2026年5月18日
本版本引入了 SONOFF Dongle 固件管理、扩展的部署选项和新的设备支持，同时进一步提升了 Matter Bridge 兼容性、Zigbee 设备行为以及整体系统稳定性。请在更新到此版本前花点时间阅读以下说明。
### **有什么新功能？**
1. **SONOFF Dongle 固件管理**
* 新增对已连接 Zigbee Dongle 的自动检测。现在可一键将不受支持的 SONOFF Dongle 升级到推荐的稳定 Zigbee 固件版本：
* 基于 Ember、且固件版本早于 v7.4.5 的 Dongle 将升级到 v8.0.2。
* 基于 ZStack、且固件版本早于 v20250321 的 Dongle 将升级到 v20250321。
* 将 CUBE 升级到 v2.10.2 后，已连接的 SONOFF Dongle 将自动升级到推荐的稳定固件版本。非 SONOFF Dongle 必须使用其官方刷机工具升级，以确保正确连接和设备控制。
* 优化了 Zigbee 离线检测行为：
* 路由器设备在 1 分钟内上报
* 终端设备在 1 小时内上报
* 超过上报间隔的设备将显示为离线，直到再次触发。
2. **扩展的部署支持**
* 新增支持在 Windows 上一键安装 CUBE。
3. **Matter Bridge 增强**
* 将 CUBE Matter Bridge SDK 升级到 v1.5.0。
* 优化了通过 Matter Bridge 将设备同步到 SmartThings 和 Alexa 时的默认设备命名。
4. **SONOFF TRVZB 增强**
* 为 SONOFF TRVZB 新增自适应模式，可在 eWeLink App 中配置，以帮助保持更稳定的室温。
5. **新设备支持**
* 新增支持 SONOFF Hydro ONE Zigbee 智能水阀（SWV-ZFU / SWV-ZFE）和 SONOFF Hydro ONE Lite Zigbee 智能水阀（SWV-ZNU / SWV-ZNE）。
* 新增支持 SONOFF MINI-ZBD 智能干接点模块。
6. **Zigbee 设备兼容性改进**
* 优化了第三方 Zigbee 设备的上电行为配置。
7. **关机功能**
* 在 CUBE Web 设置页面中新增了关机选项。
### **错误修复**
1. 修复了 Raspberry Pi 5 Rev1.1 主板可能无法正常启动的问题。
2. 修复了设备通过 Matter Bridge 同步到 Alexa 时可能失败的问题。
3. 修复了添加 ONVIF / RTSP 摄像头时的超时问题。
4. 修复了 HOBEIAN ZG-102ZM 振动传感器状态无法更新的问题。
5. 修复了 Zigbee 插座的历史数据图表不显示的问题。
***
## V2.9.0 - 2026年2月13日
本版本扩展了 eWeLink 智能家居插件的兼容性和设备支持，并显著提升了 Zigbee 可靠性、自动化稳定性以及设备控制灵活性。请在更新到此版本前花点时间阅读以下说明。
### **有什么新功能？**
1. **扩展的 eWeLink 智能家居插件设备支持**
* 新增支持通过 eWeLink 智能家居插件将符合条件的空气质量监测器同步到 CUBE，包括：
* **SONOFF SAWF-07P**
* **SONOFF SAWF-08P**
* 新增支持 SONOFF SNZB-04PR2 门窗传感器。
2. **传感器精度与校准增强**
* 新增为 **SONOFF SNZB-02P** 调整温湿度偏移量的选项，以提高读数准确性。
3. **SONOFF TRVZB 增强**
* 现在可直接在 **CUBE CAST**
* **SONOFF SNZB-02LD** 中将其用作外部传感器，以获得更准确的室温和湿度测量。
4. **Zigbee 可靠性改进**
* 优化了 Zigbee 离线检测逻辑，以更快识别设备断开并提升整体控制可靠性。（注意：由于上报间隔限制，旧版 **SNZB-01 / SNZB-02 / SNZB-03 / SNZB-04** 传感器不包含在此优化中）
5. **设备控制与校准增强**
* 新增为 **SONOFF MINI-ZBRBS** 配置额外行程时间的选项，以确保在手动校准期间百叶窗完全打开和关闭。
* 新增对 **SONOFF MINI-ZB2GS**的步进控制支持，允许外部开关按压在预定义的继电器状态之间切换，以实现更灵活的多状态控制场景。
* 为 **SONOFF MINI-ZBDIM** 调光校准新增了手动校准选项。
### **错误修复**
1. 修复了 **Frient IOMZB-110** 模块的输入能力在 eWeLink CUBE 中缺失的问题。
2. 解决了 **Tuya/Moes AM43-0.45/40-ES-EZ** 窗帘电机的控制问题。
3. 修复了 **Paulmann Gen2 RGB Remote** 无法用作场景触发器的问题。
4. 更正了 **SONOFF R5 远程开关** 从备份恢复后未能按预期触发自动化的问题。
5. 修复了在 eWeLink CUBE 重启后场景需要重新启用才能再次运行的问题。
6. 修复了一个偶发问题，即 **Matter Bridge** 在第三方平台同步大量设备时可能无响应。
7. 优化了通过 **Matter Bridge**.
***
## V2.8.1 - 2025年11月27日
我们很高兴地宣布， **CUBE OS 现已从测试版过渡到正式发布版本**。从此版本开始， **CUBE OS 版本号将与 iHost 发布版本保持一致** ，以确保更新和功能改进保持一致。
本次更新扩展了 Matter Bridge 和 eWeLink 智能家居插件支持，为 SONOFF TRVZB 引入了新功能，增强了场景组织，并提升了整体易用性。请在更新到此版本前花点时间阅读以下说明。
### 有什么新功能？
1. **扩展的 Matter Bridge 设备支持**
* 新增支持通过 Matter Bridge 同步更多 Matter 定义的设备类型，包括：
* 光照传感器
* 烟雾与一氧化碳报警器（涵盖烟雾和一氧化碳传感器）
* 空气质量传感器
* 空调
* 风扇
2. **SONOFF TRVZB 新功能**
* 为 SONOFF TRVZB 新增了两种临时模式：
* Boost 模式：在短时间内快速加热房间。
* 温度覆盖模式：临时维持设定温度。
3. **场景增强**
* 可轻松创建自定义标签，并将场景分配到现有标签。
4. **ONVIF 兼容摄像头的新功能**
* 兼容 ONVIF 的摄像头现在支持将“检测到运动”和“检测到有人”用作场景触发器。
5. **扩展的 eWeLink 智能家居插件**
* 新增支持通过 eWeLink 智能家居插件将符合条件的设备同步到 CUBE，包括：
* SONOFF Mini-RBS
* 虚拟设备（涵盖开关和按钮）
* 来自 ZBBridge-U 的子设备：SONOFF S60ZB、SNZB-02LD/SNZB-02WD、Mini-ZBRBS、SWV
6. **设备列表增强**
* 现在可在主页设备列表中隐藏离线设备，以获得更简洁、更聚焦的视图。
7. **数据可视化增强**
* 温度和湿度图表现在支持分钟级数据，以获得更细致的洞察。
### 错误修复
1. 修复了远程访问期间场景通知未通过 CUBE CAST 接收的问题。
2. 修复了与 Tuya TS0001 Fingerbot 的兼容性问题。
3. 修复了 Matter Bridge 问题：
* 修复了 Matter Bridge 反复离线的问题。
* 修复了添加超过 10 个设备后，新添加设备无法通过 Matter Bridge 同步的问题。
* 修复了 Matter Fabric 显示为空的问题。
* 修复了从 CUBE 删除设备时，未能正确从第三方 Matter 平台移除对应设备的问题。
4. 修复了 SONOFF TRVZB 问题：
* 修复了 Boost 模式和温度覆盖模式无法正确执行的问题。
* 修复了场景动作错误地允许选择温度覆盖模式的问题。
* 修复了在 Boost 模式下调整 Boost 时间会导致时间不一致或不正确的问题。
* 修复了温度和湿度图表的分钟级数据无法正确显示的错误。
* 修复了 CAST 中显示的目标温度超出允许范围的问题。
* 修复了 TRV 在 Boost/温度覆盖模式下的目标温度无法正确同步或显示的问题。
***
## V0.5 - 2025年8月27日
本次更新带来了更广泛的 Zigbee Dongle 兼容性、ONVIF 摄像头增强，以及 CUBE CAST 的显著改进。请在更新到此版本前花点时间阅读以下说明。
### 有什么新功能？
1. **扩展的 Zigbee Dongle 兼容性**
* 新增支持 SONOFF ZBDongle-P 和 SMLIGHT SLZB-06 Zigbee 协调器。
* 目前已测试并验证兼容的 Dongle：
* SONOFF ZBDongle-E / P
* SMLIGHT SLZB-06 / 06M
* SkyConnect Zigbee（EZSP）
2. **ONVIF 摄像头支持**
* 新增对兼容 ONVIF 摄像头的自动发现。
* 支持 PTZ（云台变焦）控制。
* 已测试并验证兼容的设备（需指定固件版本）：
* SONOFF CAM-PT2：固件 ≥ 1.0.6
* SONOFF CAM-B1P：固件 ≥ 1.0.2
3. **CAST 增强**
* 扩展了 CAST 面板布局，带来更灵活的仪表盘体验。
### 错误修复
1. 修复了 CUBE OS 无法在 Raspberry Pi 5 上启动且无法执行 OTA 更新的问题。
2. 更正了恒温暖气阀趋势图中不准确的数据显示。
3. 修复了由功率阈值触发的场景无法正确执行的错误。
4. 修复了 CAST 上设备状态更新需要手动刷新浏览器的问题。
***
## V0.4 - 2025年6月19日
### 有什么新功能？
1. 支持以下环境的独立安装：
* Raspberry Pi 4B / 5
* -x86\_64 虚拟机（例如 VirtualBox、VMware）
* NAS 设备（兼容型号）
2. 通过 USB Dongle 支持 Zigbee 设备（例如 SONOFF ZBDongle-E）
3. Matter Hub 与 Matter Bridge
4. 通过 PWA 远程访问/推送通知
5. 支持 Docker 和插件
6. 场景、分组、OTA、CAST 仪表盘等\
更多详情：\
### 如何尝试
1. 下载适合您环境的镜像（Raspberry Pi / VM / NAS）\
`raspberrypi4_64_prod.img.xz` 适用于 Raspberry Pi\
`sdcard.vdi.xz/sdcard.vmdk.xz` 适用于虚拟机、NAS 设备
2. 按照以下指南刷机并安装：\
3. 加入我们的 [Discord 服务器](https://discord.gg/67Ybdn23rS) 获取支持并分享反馈
***
## V0.2 - 2024年12月31日
### 有什么新功能？
* 试点功能现已推出远程访问。启用后，可通过安全链接远程访问 CubeOS 的 Web 控制台和 CAST。
* CAST 可作为带远程链接的网页应用安装。该应用可为场景执行、智能安防事件、开关和插座切换以及传感器触发提供通知，包括：
* 运动检测
* 有人检测
* 门窗开启检测
* 燃气检测
* 漏水检测
* 烟雾检测
* 按压操作
* 用户现在可以更改 Web 控制台的密码。
* 新增 MQTT Broker 设置页面，支持添加账号和密码。可使用这些凭据连接到 Broker，以订阅 MQTT 消息。
* 摄像头现在支持同时查看多个流。
**新平台：**
* Raspberry Pi 5（未验证）。
**优化：**
* 通过使用内置 Mosquitto Broker 优化了 Tasmota 插件，取消了额外 Broker 安装的需要。
* 改进了 Matter 设置码的显示格式，以提高可读性。
**错误修复：**
* 解决了版本 0.1 无法通过 OTA 更新的问题。
**已知问题：**
版本 0.2 存在以下已知问题，并将在未来更新中修复：
* 首次访问 Web 时，虚拟机和 Raspberry Pi 可能偶尔会显示断开连接提示。
* Raspberry Pi 安装不支持添加新的未配置或恢复出厂设置的 Matter 设备。请使用其他 Matter 平台并将其共享给 CubeOS。
* Matter Hub 有时会崩溃并持续重启。
* 远程通知不稳定；用户可能无法收到系统推送，这可能与网络环境、浏览器问题或后端进程关闭有关。
* 通过远程链接在 Raspberry Pi 安装上进行摄像头流媒体播放可能失败。
* Matter Bridge 不会在设备控制页面显示子设备。并且在设置页面中，对于连接到 Matter Bridge 的子设备，缺少已连接桥接器的信息。
* Vendor ID 为“1286”的 Matter fabric 无法在 CubeOS 上移除。如果系统提示某个设备的 fabric 已满，请先从其连接的其他 Matter 平台中移除一个。
* Raspberry Pi 5 安装不支持 OTA。
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://cube.ewelink.cc/english-zh/zi-yuan/geng-xin-ri-zhi.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.