Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

更新日志

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. 修复了一个问题：使用“添加 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 的使用体验。更新到此版本前，请花一点时间阅读说明。

有哪些新功能？

  1. 新设备支持

  • 新增支持带电量监测的 SONOFF MINI-ZB1GP / MINI-ZB1GSP 单路 Zigbee 智能开关。

  1. 扩展的 Matter Hub 设备支持

  • Matter Hub 现在支持以下 Matter 设备类型：

    • 温度传感器

    • 接触传感器

    • 占用传感器

    • 光照传感器

    • 空气质量传感器

    • 烟雾及一氧化碳报警器

    • 通用开关

    • 可调光插入式单元

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

  • 通过 SONOFF NSPanel Pro 86-Relay 和 Bridge-M 连接的符合条件的 Zigbee 子设备，现在可通过 eWeLink Smart Home Add-on 或内置的“添加 eWeLink 关联设备”功能同步到 eWeLink CUBE。

  1. 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 智能插座。

  1. Matter Bridge 摄像头支持

  • 现在可通过 Matter Bridge 将符合条件的摄像头同步到新增的 Matter 平台，并支持视频和音频流。

  1. 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 账户从 首页 > 添加设备 即可直接在 CUBE 中同步并管理符合条件的设备，无需安装 eWeLink Smart Home Add-on。 注意：现有的 Add-on 设备将继续独立运行。

  1. Docker 部署支持

  • CUBE OS 现在可以在 Docker 环境中运行，为用户提供更灵活的部署选项。 对于基于 Docker 的部署，以下系统级功能不可用：

    • Docker（Add-ons）

    • 试点功能 > 蓝牙音箱

    • 设置 > 网关信息 > 版本更新

    • 设置 > 重启与关机

  • 要更新基于 Docker 的部署，请拉取最新的 Docker 镜像。

  1. 扩展的一键安装支持

  • 新增支持在 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 小时内上报

    • 超过上报间隔的设备将在再次触发前显示为离线。

  1. 扩展的部署支持

  • 新增支持在 Windows 上一键安装 CUBE。

  1. Matter Bridge 增强

  • 将 CUBE Matter Bridge SDK 升级到 v1.5.0。

  • 优化了通过 Matter Bridge 将设备同步到 SmartThings 和 Alexa 时的默认设备命名。

  1. SONOFF TRVZB 增强

  • 为 SONOFF TRVZB 新增自适应模式，可在 eWeLink App 中配置，以帮助保持更稳定的室温。

  1. 新设备支持

  • 新增支持 SONOFF Hydro ONE Zigbee 智能水阀（SWV-ZFU / SWV-ZFE）和 SONOFF Hydro ONE Lite Zigbee 智能水阀（SWV-ZNU / SWV-ZNE）。

  • 新增支持 SONOFF MINI-ZBD 智能干接点模块。

  1. Zigbee 设备兼容性改进

  • 优化了第三方 Zigbee 设备的上电行为配置。

  1. 关机功能

  • 在 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 门窗传感器。

  1. 传感器准确性与校准增强

  • 新增选项，可调整以下设备的温湿度偏移： SONOFF SNZB-02P 以提高读数准确性。

  1. SONOFF TRVZB 增强

  • 现在可直接在 CUBE CAST

  • 中启用或禁用增强模式和温度临时覆盖模式。 现在可将 SONOFF SNZB-02LD 作为外部传感器使用，以获得更准确的室温和湿度测量。

  1. Zigbee 可靠性改进

  • 优化了 Zigbee 离线检测逻辑，以更快识别设备断开并提升整体控制可靠性。（注意：由于上报间隔限制，旧版 SNZB-01 / SNZB-02 / SNZB-03 / SNZB-04 传感器不包含在此优化中）

  1. 设备控制与校准增强

  • 新增选项，可为以下设备配置额外行程时间： SONOFF MINI-ZBRBS 以确保在手动校准期间百叶窗能够完全打开和关闭。

  • 新增对以下设备的步进控制支持： SONOFF MINI-ZB2GS，允许外部开关按压在预设继电器状态之间循环，以实现更灵活的多状态控制场景。

  • 新增手动校准选项至 SONOFF MINI-ZBDIM 调光校准。

错误修复

  1. 修复了 Frient IOMZB-110 模块输入能力在 eWeLink CUBE 中缺失的 bug。

  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 现已从 Beta 版过渡到正式发布版本。从此版本开始， CUBE OS 版本号将保持与 iHost 发布版本一致 ，以便实现一致的更新和功能改进。

本次更新扩展了 Matter Bridge 和 eWeLink Smart Home Add-on 支持，为 SONOFF TRVZB 引入了新功能，增强了场景组织，并提升了整体易用性。更新到此版本前，请花一点时间阅读说明。

有哪些新功能？

  1. 扩展的 Matter Bridge 设备支持

  • 新增支持通过 Matter Bridge 同步更多由 Matter 定义的设备类型，包括：

    • 光照传感器

    • 烟雾及一氧化碳报警器（涵盖烟雾和一氧化碳传感器）

    • 空气质量传感器

    • 房间空调

    • 风扇

  1. SONOFF TRVZB 新功能

  • 为 SONOFF TRVZB 新增两个临时模式：

    • 增强模式：在短时间内快速加热房间。

    • 温度临时覆盖模式：临时保持设定温度。

  1. 场景增强

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

  1. ONVIF 兼容摄像头的新功能

  • ONVIF 兼容摄像头现在支持将“检测到移动”和“检测到占用”用作场景触发条件。

  1. 扩展的 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

  1. 设备列表增强

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

  1. 数据可视化增强

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

错误修复

  1. 修复了远程访问时场景通知未通过 CUBE CAST 接收的问题。

  2. 修复了与 Tuya TS0001 Fingerbot 的兼容性问题。

  3. 修复了 Matter Bridge 问题：

  • 修复了 Matter Bridge 反复离线的问题。

  • 修复了添加超过 10 个设备后，新添加的设备无法通过 Matter Bridge 同步的问题。

  • 修复了 Matter Fabric 显示为空的问题。

  • 修复了从 CUBE 删除设备时，无法正确从第三方 Matter 平台移除对应设备的问题。

  1. 修复了 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）

  1. ONVIF 摄像头支持

  • 新增对 ONVIF 兼容摄像头的自动发现。

  • 支持 PTZ（平移-倾斜-变焦）控制。

  • 已测试并验证兼容的设备（含所需固件版本）：

    • SONOFF CAM-PT2：固件 ≥ 1.0.6

    • SONOFF CAM-B1P：固件 ≥ 1.0.2

  1. 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 设备（兼容型号）

  1. 通过 USB Dongle 的 Zigbee 设备支持（例如 SONOFF ZBDongle-E）

  2. Matter Hub 和 Matter Bridge

  3. 通过 PWA 进行远程访问/推送通知

  4. 支持 Docker 和 Add-ons

  5. 场景、组、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 服务器 获取支持并分享反馈

v0.2 - 2024年12月31日

有哪些新内容？

  • 试点功能现已推出远程访问。启用后，可通过安全链接远程访问 CubeOS 的 Web 控制台和 CAST。

  • CAST 可以作为带有远程链接的网页应用安装。该应用可为场景执行、Smart Security 事件、开关和插座切换以及传感器触发提供通知，包括：

    • 运动检测

    • 存在检测

    • 开窗检测

    • 燃气检测

    • 漏水检测

    • 烟雾检测

    • 按压动作

  • 用户现在可以更改 Web 控制台的密码。

  • 现在提供新的 MQTT Broker 设置页面，支持添加账户和密码。它允许使用这些凭据连接到 broker，以订阅 MQTT 消息。

  • 摄像头现在支持同时查看多个流。

新平台：

  • Raspberry Pi 5（未验证）。

优化：

  • 通过使用内置 Mosquitto broker 优化了 Tasmota add-on，取消了额外安装 broker 的需要。

  • 改进了 Matter 设置代码的显示格式，以提高可读性。

错误修复：

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

已知问题：

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

  • 首次访问网页时，虚拟机和 Raspberry Pi 可能偶尔会显示断开连接提示。

  • Raspberry Pi 安装不支持添加全新或恢复出厂设置后的 Matter 设备。请使用其他 Matter 平台并将其共享给 CubeOS。

  • Matter Hub 有时会崩溃并持续重启。

  • 远程通知不稳定；用户可能无法收到系统推送，可能与网络环境、浏览器问题或后端进程关闭有关。

  • 通过远程链接在 Raspberry Pi 安装上进行摄像头流传输可能失败。

  • Matter Bridge 不会在设备控制页面显示子设备。而对于设置页面中连接到 Matter Bridge 的子设备，缺少 Connected Bridge 信息。

  • 在 CubeOS 中无法移除 Vendor ID 为“1286”的 Matter fabric。如果系统推广了一个已满的 fabric，请从其连接的其他 Matter 平台中移除一个。

  • Raspberry Pi 5 安装不支持 OTA。

上一页Zigbee
下一页开发者与 API 指南

最后更新于