> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/english-zh/zi-yuan/geng-xin-ri-zhi.md).
# 更新日志
## v2.12.0 - 2026年7月7日
### 有什么新内容？
1. **新增设备支持**
* 新增支持带电量监测的 SONOFF MINI-ZB1GP / MINI-ZB1GSP 单通道 Zigbee 智能开关。
2. **扩展的 Matter Hub 设备支持**
* Matter Hub 现已支持以下 Matter 设备类型：
* 温度传感器
* 接触传感器
* 占用传感器
* 光照传感器
* 空气质量传感器
* 烟雾/一氧化碳警报器
* 通用开关
* 可调光插入式设备
3. **增强的 eWeLink 关联设备同步支持**
* 现在可通过 SONOFF NSPanel Pro 86-Relay 和 Bridge-M 连接的符合条件的 Zigbee 子设备，借助 eWeLink Smart Home Add-on 或内置的“添加 eWeLink 关联设备”功能同步到 eWeLink CUBE。
4. **SONOFF TRVZB 增强功能**
* 在 CUBE CAST 中，基于温度数据动态调整坐标轴，优化了温度图表。
### 错误修复
1. 修复了在配置 IKEA 空气质量传感器的温湿度上报时显示空白弹窗的问题。
2. 修复了在未配置气压舒适范围时，SONOFF SNZB-02M 可能错误显示气压舒适度超出范围的问题。
3. 修复了 Node-RED Add-on 在某些设备上可能无法安装或更新的问题。
***
## v2.11.0 - 2026年6月16日
此版本扩展了对多款 SONOFF 设备的兼容性，并支持 Matter Bridge 摄像头能力，同时进一步提升了 SONOFF TRVZB 的室温感知能力。更新到此版本前，请先阅读说明。
### 有什么新内容？
1. **新增设备支持**
* 新增对以下 SONOFF 设备的支持：
* SONOFF SNZB-06P24 24GHz 存在传感器。
* 带照度上报的 SONOFF SNZB-03PR2 运动传感器。
* SONOFF SWV-ZF2U / SWV-ZF2E 双通道智能水阀。
* 带能耗监测的 SONOFF BASIC-ZB1GSP 智能插座。
2. **Matter Bridge 摄像头支持**
* 现在可通过 Matter Bridge 将符合条件的摄像头同步到已添加的 Matter 平台，并支持视频和音频流。
3. **SONOFF TRVZB 增强功能**
* SONOFF SNZB-02B 现在可作为 SONOFF TRVZB 的外部传感器使用，从而提供更准确的室温读数。
### 错误修复
1. 修复了通过 eWeLink Smart Home Add-on 同步到 CUBE 的 Zigbee 插座能耗图表无法加载的问题。
2. 修复了连接到 Raspberry Pi 4 时，SONOFF Zigbee Dongle 可能无法被 CUBE 检测或正确配置的问题。
***
## v2.10.3 - 2026年5月27日
此版本引入了内置 eWeLink Smart Home 以便更轻松地同步设备、Mac 一键安装， 并增加了在 Docker 环境中运行 CUBE OS 的支持，以提供更灵活的部署选项。更新到此版本前，请先阅读说明。
### 有什么新内容？
1. **内置 eWeLink Smart Home，设备同步更轻松**
* 现在可在 CUBE 中使用更简单的方式同步 eWeLink 关联设备。使用你的 eWeLink 账号登录 **主页 > 添加设备** 即可在无需安装 eWeLink Smart Home Add-on 的情况下，直接在 CUBE 中同步和管理符合条件的设备。\
\&#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 的 Dongle，若固件版本早于 v7.4.5，将升级到 v8.0.2。
* 基于 ZStack 的 Dongle，若固件版本早于 v20250321，将升级到 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 Smart Home Add-on 的兼容性和设备支持，并显著提升了 Zigbee 可靠性、自动化稳定性和设备控制灵活性。更新到此版本前，请先阅读说明。
### **有什么新内容？**
1. **扩展的 eWeLink Smart Home Add-on 设备支持**
* 新增支持通过 eWeLink Smart Home Add-on 将符合条件的空气质量监测器同步到 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. 修复了以下设备输入能力缺失的 bug： **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 Smart Home Add-on 的支持，引入了 SONOFF TRVZB 的新功能，增强了场景组织，并提升了整体可用性。更新到此版本前，请先阅读说明。
### 有什么新内容？
1. **扩展的 Matter Bridge 设备支持**
* 新增支持通过 Matter Bridge 同步更多 Matter 定义的设备类型，包括：
* 光照传感器
* 烟雾与一氧化碳警报器（包括烟雾和一氧化碳传感器）
* 空气质量传感器
* 房间空调
* 风扇
2. **SONOFF TRVZB 新功能**
* 为 SONOFF TRVZB 新增两个临时模式：
* 增压模式：短时间内快速加热房间。
* 温度覆盖模式：临时保持设定温度。
3. **场景增强**
* 轻松创建自定义标签，并将场景分配到现有标签。
4. **ONVIF 兼容摄像头的新功能**
* ONVIF 兼容摄像头现在支持将“检测到运动”和“检测到占用”用作场景触发条件。
5. **扩展的 eWeLink Smart Home Add-on**
* 新增支持通过 eWeLink Smart Home Add-on 将符合条件的设备同步到 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 问题：
* 修复了增压模式和温度覆盖模式无法正确执行的问题。
* 修复了场景动作错误地允许选择温度覆盖模式的问题。
* 修复了在增压模式下调整增压时间会导致计时不一致或不正确的问题。
* 修复了温湿度图表的分钟级数据无法正确显示的 bug。
* 修复了 CAST 中显示的目标温度超出允许范围的问题。
* 修复了 TRV 在增压/温度覆盖模式下的目标温度无法正确同步或显示的问题。
***
## 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：FW ≥ 1.0.6
* SONOFF CAM-B1P：FW ≥ 1.0.2
3. **CAST 增强**
* 扩展了 CAST 面板布局，带来更灵活的仪表盘体验。
### 错误修复
1. 修复了 CUBE OS 在 Raspberry Pi 5 上无法启动且无法执行 OTA 更新的问题。
2. 修正了恒温散热器阀趋势图中数据显示不准确的问题。
3. 修复了由功率阈值触发的场景无法正常执行的 bug。
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 可作为带远程链接的网页应用安装。该应用支持场景执行、Smart Security 事件、开关和插座切换以及传感器触发的通知，包括：
* 运动检测
* 存在检测
* 开窗检测
* 燃气检测
* 漏水检测
* 烟雾检测
* 按压动作
* 用户现在可以更改 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 设备恢复出厂设置。请使用其他 Matter 平台并将其共享给 CubeOS。
* Matter Hub 有时会崩溃并持续重启。
* 远程通知不稳定；用户可能无法收到系统推送，这可能与网络环境、浏览器问题或后端进程关闭有关。
* 通过远程链接，Raspberry Pi 安装的摄像头流可能会失败。
* Matter Bridge 不会在设备控制页面显示子设备。而对于设置页面中连接到 Matter Bridge 的子设备，缺少 Connected Bridge 信息。
* Vendor ID 为“1286”的 Matter Fabric 无法在 CubeOS 上移除。如果系统提示某设备的 Fabric 已满，请从其连接的其他 Matter 平台中移除一个。
* Raspberry Pi 5 安装不支持 OTA。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://cube.ewelink.cc/english-zh/zi-yuan/geng-xin-ri-zhi.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.