> 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.14.0 - 2026年9月18日
本次发布扩展了 **Matter Bridge 功能和设备支持**，并改进了 eWeLink 关联设备同步、场景、CAST、Node-RED 以及整体稳定性。更新到此版本前，请花点时间阅读说明。
### 有什么新内容？
1. **新设备支持**
* 新增对 SONOFF S61SZBTPB Zigbee 智能插座的支持。
2. **增强的 eWeLink 关联设备同步支持**
* eWeLink Smart Home Add-on 和内置的“添加 eWeLink 关联设备”功能现在支持同步：
* SONOFF Hydro ONE 智能水阀（SWV-ZFE / SWV-ZFU）
* SONOFF Hydro ONE Lite 智能水阀（SWV-ZNE / SWV-ZNU）
* SONOFF Hydro DUO 双通道智能水阀（SWV-ZF2E / SWV-ZF2U）
* SONOFF MINI Extreme Zigbee 调光开关（MINI-ZBDIM）
3. **Matter Bridge 增强**
* 新增支持通过 Matter Bridge 将以下 Matter/Zigbee 设备类型同步到支持 Matter 的平台：
* 压力传感器
* 警号
* 扩展了空气质量传感器支持，新增以下测量能力：
* 甲醛浓度
* 二氧化氮浓度
* 臭氧浓度
* PM1 浓度
* PM10 浓度
* 氡浓度
* 扩展了以下对象的布尔状态配置簇支持：
* 现在支持调节人体存在传感器的灵敏度。
* 现在支持为漏水检测器启用或禁用防拆警报。
* 优化了色光映射，确保桥接到三星 SmartThings 后色彩调节可正常工作。
* 更改了 Matter Bridge 中多功能设备的映射方式，改用多个端点而不是 compose，从而提升设备兼容性。
4. **设备和自动化增强**
* SONOFF BASIC-ZB1GSP 现在支持双向电量监测，用户最多可查看 12 个月的电量历史。
* 基于功耗的场景触发器现在支持数值范围。
* CAST 现在支持兼容灯具的白光和彩光控制。
* 扩展了 Node-RED 的以下控制能力 **control-device** 节点：
* 功率百分比
* 阀门位置
* 灌溉/工作模式
* 新增对防拆警报事件日志的查看支持。
### 错误修复
1. 修复了当通过 **eWeLink Smart Home Add-on** 同步的设备的能耗被用作触发器时的场景执行问题。
2. 修复了当上报的电池电量为 0% 时，电池状态显示错误的问题。
3. 修复了 CAST 中恒温器控制页面可能显示为空白的问题。
4. 修复了 CUBE 上无法查看 Yoosee 摄像头 RTSP 流的问题。
5. 修复了在移除通过其他 Matter Bridge 添加的设备时，Matter Hub 可能反复重启的问题。
6. 修复了对 2.12.0 或更高版本创建的备份进行 Docker 数据恢复失败的问题。
7. 修复了影响 10 多种第三方 Zigbee 窗帘电机型号的反向控制问题，以及部分设备的校准问题。
8. 修复了 SONOFF SNZB-06P24 人体存在传感器过于频繁上报照度值的问题。
***
## v2.13.1 - 2026年8月13日
本次发布扩展了 Zigbee 和 Matter Bridge 的兼容性，增加了 Dongle-PP10 支持和 Mac 版 CUBE 镜像的 OTA 更新，并改进了 eWeLink 关联设备同步、备份、场景和设备稳定性。更新到此版本前，请花点时间阅读说明。
### 有什么新内容？
1\. **新设备支持**
* 新增对 SONOFF MINI-ZB1GS 单通道 Zigbee 智能开关的支持。
* 新增对 SONOFF SNZB-09P Zigbee 室内警号的支持。
* 新增对 SONOFF TRV-ZBT Zigbee/蓝牙双模恒温散热器阀的支持。
2\. **扩展的 Zigbee 设备支持**
* 新增对以下 Zigbee 设备类型的支持：
* 水阀
* 流量传感器
* 雨水传感器
* 土壤传感器
* 空气净化器
3\. **Matter Bridge 增强**
* 新增支持通过 Matter Bridge 将以下 Zigbee 设备类型同步到支持 Matter 的平台：
* 流量传感器
* 雨水传感器
* 土壤传感器
* 空气净化器
* 现在支持将已连接 Zigbee 设备的电量计量数据同步到支持 Matter 的平台，包括总导出电量和总消耗电量。
4\. **增强的 eWeLink 关联设备同步支持**
* **SONOFF WS01TPE-E** 支持能耗监测的 Matter-over-Wi-Fi 智能墙壁插座，现在可通过 eWeLink Smart Home Add-on 或内置的“添加 eWeLink 关联设备”功能同步到 eWeLink CUBE。
5\. **Zigbee Dongle 增强**
* 新增对 Dongle-PP10 的自动检测和固件刷写支持，包括兼容三种 Zigbee 固件波特率。
* 新增将 Dongle-PP10 作为 Zigbee 路由器的支持，包括在设备列表和 Zigbee 网络拓扑中的移除与正确识别。
6\. **系统和功能改进**
* 新增对 Mac 镜像的 OTA 升级支持，可在保留设备绑定和场景数据的情况下升级，无需重新下载或重新配置。
* 智能水阀新增英制加仑作为容量单位选项。
* 下载的备份文件现在使用与系统备份列表中显示相同的文件名。
* 优化了 SONOFF THR316D 温湿度监测开关的场景配置，即使开关处于“关闭”状态，也可以将温度设置为场景触发器。
### 错误修复
1. 修复了自动备份的两个问题：编辑后的计划时间显示不正确，以及可能创建多个自动备份任务。
2. 修复了在为 SONOFF SAWF-08P 输入温度阈值后确认按钮仍处于不可用状态的问题。
3. 修复了重启 CUBE 后，可能在支持 Matter 的平台上创建重复的 IKEA DIRIGERA 设备并使其无响应的问题。
4. 修复了 SONOFF SNZB-02WD 的温度数据在设备通过“**添加 eWeLink 关联设备**".
5. 修复了 SONOFF THR316D 通过“**添加 eWeLink 关联设备**”无法在同一场景中既作为触发器又作为动作使用的问题。
6. 修复了在 Apple Home 中 SONOFF TRV 的房间分配、配件名称、场景和自动化可能在 CUBE 重启后丢失的问题。
7. 修复了在 Docker 环境中运行 CUBE 时无法创建备份的问题。
8. 修复了在 Raspberry Pi 5 上的 Docker 中运行 CUBE 时摄像头流中断的问题。
9. 修复了某些传感器设备的测量值或状态显示为“未知”或“--”的问题。
***
## v2.12.0 - 2026年7月7日
本次发布扩展了 CUBE OS 中的设备兼容性，并进一步改善了 SONOFF TRVZB 体验。更新到此版本前，请花点时间阅读说明。
### 有什么新内容？
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 时，CUBE 无法正确检测或配置 SONOFF Zigbee Dongle 的问题。
***
## v2.10.3 - 2026年5月27日
本次发布引入内置的 eWeLink Smart Home，便于更轻松地同步设备、一键在 Mac 上安装， 并新增支持在 Docker 环境中运行 CUBE OS，以提供更灵活的部署选项。更新到此版本前，请花点时间阅读说明。
### 有什么新内容？
1. **用于更轻松同步设备的内置 eWeLink Smart Home**
* 现在 CUBE 中提供了一种更简单的同步 eWeLink 关联设备的方法。使用您的 eWeLink 帐户从 **主页 > 添加设备** 直接在 CUBE 中同步和管理符合条件的设备，而无需安装 eWeLink Smart Home Add-on。\
*注意：现有的 add-on 设备将继续独立运行。*
2. **Docker 部署支持**
* CUBE OS 现在可以在 Docker 环境中运行，为用户提供更灵活的部署选项。\
对于基于 Docker 的部署，以下系统级功能不可用：
* Docker（Add-ons）
* Pilot Features > 蓝牙扬声器
* 设置 > 网关信息 > 版本更新
* 设置 > 重启与关机
* 要更新基于 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 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. 修复了 **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 新增了两种临时模式：
* Boost 模式：在短时间内快速加热房间。
* 温度覆盖模式：临时维持设定温度。
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 问题：
* 修复了 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 和 Add-ons
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 的网页控制台和 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 Bridges 不会在设备控制页面显示子设备。而且，在设置页面中对于连接到 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.