> 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.15.0 - 2026年10月29日

此版本扩展了对 Zigbee 设备的支持、eWeLink 关联设备同步以及 Matter Bridge 兼容性，同时改进了传感器功能、场景自动化和设备可靠性。更新到此版本前，请花一点时间阅读说明。

### 有什么新内容？ <a href="#id-4f7756fa" id="id-4f7756fa"></a>

1. **新设备支持**

* 新增对以下设备的支持：
  * SONOFF TP-WGZBA Zigbee/蓝牙双模温控面板。
  * SONOFF SNZB-02UL 2.9 英寸电子墨水温湿度传感器
  * SONOFF ZBM5-1C-86/120 Zigbee 智能墙壁开关。
  * SONOFF ZBM5-2C-86/120 Zigbee 智能墙壁开关。
  * SONOFF ZBM5-3C-86/120 Zigbee 智能墙壁开关。

2. **增强的 eWeLink 关联设备同步支持**

* eWeLink Smart Home 插件和内置的“添加 eWeLink 关联设备”功能现已支持同步：
  * CoolKit CK-BL602-SWP1-02 带电量监测的 Wi-Fi 智能插座
  * SONOFF MINI-1GSP Matter over WiFi 智能电量计开关
  * SONOFF SNZB-09P Zigbee 室内警报器

3. **设备与自动化增强**

* SONOFF SNZB-02DR2 现在可使用两个外部传感器，两个传感器的温湿度读数会同时显示在其屏幕和 eWeLink App 中。
* SONOFF ZBMINIR2 的外接开关事件现在可用作场景触发器。
* 为 SONOFF SNZB-09P 室内警报器新增了五种可选警报音。
* 更新了 SONOFF SNZB-02WD 和 SNZB-02LD 的默认温湿度上报阈值。
* 改进了 SONOFF SNZB-02B 进入配对模式和执行恢复出厂设置的流程。
* 统一了 SONOFF Zigbee 设备的固件版本格式。
* 新增对 Tuya T2-Z62 智能风扇开关的支持，支持的控制将通过 Matter Bridge 暴露给支持 Matter 的平台。

### Bug 修复 <a href="#hkqvl" id="hkqvl"></a>

1. 修复了 SONOFF TRVZB 的温度回差设置中缺少 -0.2°C 选项的问题。
2. 修复了桥接设备在断电后恢复时，SONOFF SNZB-09P 的警报状态可能无法同步，导致 eWeLink App 中的警报控制无响应的问题。

***

## v2.14.1 - 2026年9月29日

我们已发布 v2.14.1 补丁，以解决 V2.14.0 中的若干问题。

### Bug 修复 <a href="#aoxer" id="aoxer"></a>

1. 修复了将 SONOFF AirGuard TH (SNZB-02DR2) 的固件更新到 1.0.5 版本后，无法显示在 CUBE 中配置的外部传感器温度读数的问题。
2. 修复了在 CUBE（v2.14.0）上同步摄像头后 Matter Bridge 可能不可用的问题。

***

## v2.14.0 - 2026年9月18日

此版本扩展了 **Matter Bridge 功能和设备支持**，并改进了 eWeLink 关联设备同步、场景、CAST、Node-RED 以及整体稳定性。更新到此版本前，请花一点时间阅读说明。

### 有什么新内容？ <a href="#od9j2" id="od9j2"></a>

1. **新设备支持**

* 新增对 SONOFF S61SZBTPB Zigbee 智能插座的支持。

2. **增强的 eWeLink 关联设备同步支持**

* eWeLink Smart Home 插件和内置的“添加 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 浓度
  * 氡浓度
* 扩展了布尔状态配置簇支持：
  * 占用传感器现在支持灵敏度调节。
  * 水浸探测器现在支持启用或禁用防拆警报。
* 优化了颜色灯映射，以确保桥接到 Samsung SmartThings 后颜色调节可正常工作。
* 将多功能设备的 Matter Bridge 映射改为使用多个端点而非 compose，从而提升设备兼容性。

4. **设备与自动化增强**

* SONOFF BASIC-ZB1GSP 现在支持双向电量监测，用户最多可查看 12 个月的用电历史。
* 基于功耗的场景触发器现在支持数值范围。
* CAST 现已支持兼容灯具的白光和彩光控制。
* 为 Node-RED 的 **control-device** 节点扩展了以下控制能力：
  * 功率百分比
  * 阀门位置
  * 灌溉/工作模式
* 新增查看防拆警报事件日志的支持。

### Bug 修复 <a href="#rcx1g" id="rcx1g"></a>

1. 解决了在使用通过 **eWeLink Smart Home 插件** 同步的设备功耗作为触发条件时，场景执行出现的问题。
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 兼容性，为 Mac 版 CUBE 镜像新增了 Dongle-PP10 支持和 OTA 更新，并改进了 eWeLink 关联设备同步、备份、场景以及设备稳定性。更新到此版本前，请花一点时间阅读说明。

### 有什么新内容？ <a href="#qzrtp" id="qzrtp"></a>

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 插件或内置的“添加 eWeLink 关联设备”功能同步到 eWeLink CUBE。

5\. **Zigbee Dongle 增强**

* 新增对 Dongle-PP10 的自动检测和固件刷写支持，并兼容三种 Zigbee 固件波特率。
* 新增将 Dongle-PP10 作为 Zigbee 路由器的支持，包括在设备列表和 Zigbee 网络拓扑中的移除与正确识别。

6\. **系统与功能改进**

* 新增 Mac 镜像的 OTA 升级支持，升级时无需重新下载或重新配置，同时保留设备绑定和场景数据。
* 为智能水阀新增英制加仑作为容量单位选项。
* 下载的备份文件现在使用与系统备份列表中显示相同的文件名。
* 优化了 SONOFF THR316D 温湿度监测开关的场景配置，即使开关处于“关闭”状态，也可将温度设为场景触发条件。

### Bug 修复 <a href="#gypuu" id="gypuu"></a>

1. 修复了两个自动备份问题：编辑后的计划时间显示不正确，以及可能创建多个自动备份任务。
2. 修复了为 SONOFF SAWF-08P 输入温度阈值后，确认按钮仍保持不可用的问题。
3. 修复了重启 CUBE 可能会在支持 Matter 的平台上创建重复的 IKEA DIRIGERA 设备并导致其无响应的问题。
4. 修复了 SONOFF SNZB-02WD 的温度数据在设备通过“**添加 eWeLink 关联设备**".
5. 修复了通过“**添加 eWeLink 关联设备**”后无法在同一场景中同时用作触发器和动作的问题。
6. 修复了 Apple Home 中 SONOFF TRV 在重启 CUBE 后，房间分配、配件名称、场景和自动化可能丢失的问题。
7. 修复了在 Docker 环境中运行 CUBE 时无法创建备份的问题。
8. 修复了在 Raspberry Pi 5 上通过 Docker 运行 CUBE 时摄像头流中断的问题。
9. 修复了某些传感器设备的测量值或状态显示为“unknown”或“--”的问题。

***

## v2.12.0 - 2026年7月7日

此版本扩展了 CUBE OS 的设备兼容性，并进一步改进了 SONOFF TRVZB 的使用体验。更新到此版本前，请花一点时间阅读说明。

### 有什么新内容？ <a href="#d9hzl" id="d9hzl"></a>

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 插件或内置的“添加 eWeLink 关联设备”功能同步到 eWeLink CUBE。

4. **SONOFF TRVZB 增强**

* 在 CUBE CAST 中优化了温度图表，坐标轴可根据温度数据动态调整。

### Bug 修复 <a href="#i1pmv" id="i1pmv"></a>

1. 修复了为 IKEA 空气质量传感器配置温湿度上报时显示空白弹窗的问题。
2. 修复了在未配置气压舒适范围时，SONOFF SNZB-02M 可能错误显示气压舒适度超出范围的问题。
3. 修复了 Node-RED 插件在某些设备上可能无法安装或更新的问题。

***

## v2.11.0 - 2026年6月16日

此版本扩展了多款 SONOFF 设备的兼容性和对 Matter Bridge 摄像头功能的支持，同时改进了 SONOFF TRVZB 的室温感知能力。更新到此版本前，请花一点时间阅读说明。

### 有什么新内容？ <a href="#u95d3" id="u95d3"></a>

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 的外部传感器使用，提供更准确的室温读数。

### Bug 修复 <a href="#mcfpk" id="mcfpk"></a>

1. 修复了通过 eWeLink Smart Home 插件同步到 CUBE 的 Zigbee 插座能耗图表无法加载的问题。
2. 修复了 SONOFF Zigbee Dongle 连接到 Raspberry Pi 4 时，CUBE 无法正确检测或配置的问题。

***

## v2.10.3 - 2026年5月27日

此版本引入了内置 eWeLink Smart Home，以便更轻松地同步设备、Mac 一键安装， 并新增对在 Docker 环境中运行 CUBE OS 的支持，以提供更灵活的部署选项。更新到此版本前，请花一点时间阅读说明。

### 有什么新内容？ <a href="#x3hge" id="x3hge"></a>

1. **内置 eWeLink Smart Home，便于设备同步**

* CUBE 现已提供更简单的 eWeLink 关联设备同步方式。请使用您的 eWeLink 账户登录： **主页 > 添加设备** 即可直接在 CUBE 中同步并管理符合条件的设备，无需安装 eWeLink Smart Home 插件。\
  *注意：现有插件设备将继续独立运行。*

2. **Docker 部署支持**

* CUBE OS 现在可以在 Docker 环境中运行，为用户提供更灵活的部署选项。\
  对于基于 Docker 的部署，以下系统级功能不可用：
  * Docker（插件）
  * 试验功能 > 蓝牙扬声器
  * 设置 > 网关信息 > 版本更新
  * 设置 > 重启与关机
* 要更新基于 Docker 的部署，请拉取最新的 Docker 镜像。

3. **扩展的一键安装支持**

* 新增支持在 Mac 上一键安装 CUBE。

***

## v2.10.2 - 2026年5月18日

此版本引入了 SONOFF Dongle 固件管理、扩展的部署选项以及新的设备支持，同时进一步改进了 Matter Bridge 兼容性、Zigbee 设备行为和整体系统稳定性。更新到此版本前，请花一点时间阅读说明。

### **有什么新内容？** <a href="#ta75j" id="ta75j"></a>

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 设置页面新增关机选项。

### **Bug 修复** <a href="#ty9uy" id="ty9uy"></a>

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 插件的兼容性和设备支持，并显著提升了 Zigbee 可靠性、自动化稳定性和设备控制灵活性。更新到此版本前，请花一点时间阅读说明。

### **有什么新内容？** <a href="#id-91770f03" id="id-91770f03"></a>

1. **扩展的 eWeLink Smart Home 插件设备支持**

* 新增支持通过 eWeLink Smart Home 插件将符合条件的空气质量监测器同步到 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** 新增手动校准选项。

### **Bug 修复** <a href="#osbzz" id="osbzz"></a>

1. 修复了以下设备输入能力缺失的错误： **Frient IOMZB-110** 模块在 eWeLink CUBE 中缺失。
2. 解决了以下设备的控制问题： **Tuya/Moes AM43-0.45/40-ES-EZ** 窗帘电机。
3. 修复了以下问题： **Paulmann Gen2 RGB 遥控器** 无法用作场景触发器。
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 插件支持，为 SONOFF TRVZB 引入了新功能，增强了场景组织，并改进了整体易用性。更新到此版本前，请花一点时间阅读说明。

### 有什么新内容？ <a href="#ufpq2" id="ufpq2"></a>

1. **扩展的 Matter Bridge 设备支持**

* 新增支持通过 Matter Bridge 同步更多 Matter 定义的设备类型，包括：
  * 光照传感器
  * 烟雾与一氧化碳警报器（涵盖烟雾和一氧化碳传感器）
  * 空气质量传感器
  * 房间空调
  * 风扇

2. **SONOFF TRVZB 新功能**

* 为 SONOFF TRVZB 新增两种临时模式：
  * 增强模式：在短时间内快速加热房间。
  * 温度覆盖模式：临时维持设定温度。

3. **场景增强**

* 可轻松创建自定义标签，并将场景分配到现有标签。

4. **ONVIF 兼容摄像头的新功能**

* ONVIF 兼容摄像头现在支持将“检测到运动”和“检测到占用”用作场景触发器。

5. **扩展的 eWeLink Smart Home 插件**

* 新增支持通过 eWeLink Smart Home 插件将符合条件的设备同步到 CUBE，包括：
  * SONOFF Mini-RBS
  * 虚拟设备（涵盖开关和按钮）
  * ZBBridge-U 的子设备：SONOFF S60ZB、SNZB-02LD/SNZB-02WD、Mini-ZBRBS、SWV

6. **设备列表增强**

* 现在可将离线设备从主页设备列表中隐藏，以获得更整洁、更聚焦的视图。

7. **数据可视化增强**

* 温湿度图表现在支持按分钟级数据展示，以提供更详细的洞察。

### Bug 修复 <a href="#fbhve" id="fbhve"></a>

1. 修复了远程访问时无法通过 CUBE CAST 接收场景通知的问题。
2. 修复了与 Tuya TS0001 Fingerbot 的兼容性问题。
3. 修复了 Matter Bridge 问题：

* 修复了 Matter Bridge 反复离线的问题。
* 修复了添加超过 10 个设备后，新增设备无法通过 Matter Bridge 同步的问题。
* 修复了 Matter Fabric 显示为空的问题。
* 修复了从 CUBE 删除设备后，未能正确从第三方 Matter 平台移除对应设备的问题。

4. 修复了 SONOFF TRVZB 问题：

* 修复了增强模式和温度覆盖模式无法正确执行的问题。
* 修复了场景动作错误地允许选择温度覆盖模式的问题。
* 修复了在增强模式下调整增强时间会导致计时不一致或不正确的问题。
* 修复了温湿度图表的分钟级数据无法正常显示的错误。
* 修复了 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 面板布局，以提供更灵活的仪表板体验。

### Bug 修复

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 加密狗支持 Zigbee 设备（例如 SONOFF ZBDongle-E）
3. Matter Hub 和 Matter Bridge
4. 通过 PWA 进行远程访问/推送通知
5. 支持 Docker 和插件
6. 场景、群组、OTA、CAST 仪表板等\
   更多详情：\
   <https://forum.ewelink.cc/t/ewelink-cube-os-v0-4-beta-self-hosted-ewelink-server-public-testing-now-open/198406>

### 如何尝试

1. 下载适合您环境的镜像（Raspberry Pi / VM / NAS）\
   `raspberrypi4_64_prod.img.xz` 适用于 Raspberry Pi\
   `sdcard.vdi.xz/sdcard.vmdk.xz` 适用于虚拟机、NAS 设备
2. 请按照这些指南刷写并安装：\
   <https://github.com/eWeLinkCUBE/CUBE-OS/tree/master/Installation%20%26%20User%20Guide>
3. 加入我们的 [Discord 服务器](https://discord.gg/67Ybdn23rS) 以获取支持并分享反馈

***

## v0.2 - 2024年12月31日

### 有什么新内容？

* 远程访问功能已面向试点特性推出。启用后，可通过安全链接远程访问 CubeOS 的网页控制台和 CAST。
* CAST 可以作为带有远程链接的网页应用安装。该应用可为场景执行、智能安防事件、开关和插座切换以及传感器触发提供通知，包括：&#x20;
  * 运动检测
  * 在场检测
  * 开窗检测
  * 气体检测
  * 漏水检测
  * 烟雾检测
  * 按压动作
* 用户现在可以更改网页控制台的密码。
* 现在提供了一个新的 MQTT Broker 设置页面，支持添加账户和密码。它允许使用这些凭据连接到 Broker，以订阅 MQTT 消息。
* 摄像头现在支持同时查看多个视频流。

**新平台：**

* Raspberry Pi 5（未验证）。

**优化：**

* 通过使用内置的 Mosquitto Broker 优化了 Tasmota 插件，取消了额外安装 Broker 的需求。
* 改进了 Matter 设置代码的显示格式，以提高可读性。

**错误修复：**

* 已解决版本 0.1 无法通过 OTA 进行更新的问题。

**已知问题：**

版本 0.2 存在以下已知问题，并将在未来更新中修复：

* 首次访问网页时，虚拟机和 Raspberry Pi 可能偶尔会显示断开连接提示。
* Raspberry Pi 安装不支持添加全新或恢复出厂设置后的 Matter 设备。请使用其他 Matter 平台并将它们共享给 CubeOS。
* Matter Hub 有时会崩溃并持续重启。
* 远程通知不稳定；用户可能收不到系统推送，这可能与网络环境、浏览器问题或后端进程关闭有关。
* 通过远程链接时，Raspberry Pi 安装的摄像头流可能失败。
* Matter Bridge 不会在设备控制页面显示子设备。而且在设置页面中，连接到 Matter Bridge 的子设备缺少“已连接桥”的信息。
* 厂商 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cube.ewelink.cc/english-zh/zi-yuan/geng-xin-ri-zhi.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
