开发与运维阅读指南

倍肯智控（YunStack-IoT）由一个总仓库和独立组件仓库组成。平台管理设备身份、权限、状态和配置，设备负责执行动作、采集数据和本地定时。本文档以2026-10-28所核对源码为基线；当前发布版本为v0.7.1，修复权限、配置同步和设备执行问题，并包含本手册重整；历史v0.7.0及更早发布记录保持原样。

当前能做什么

能力	实现与验证范围	边界
设备接入	两款ESP32产品BLE配网、DHCP、MQTT TLS认证与账号认领	手机需具备BLE权限；仅WiFi SSID和密码，不提供静态IP
查看与控制	Web、小程序、板上按键状态同步，设备影子与离线检测	控制以设备回复/实际状态为准，网页发送成功不等于执行成功
配置与本地定时	通用配置/服务链路，继电器定时与延时，传感器采集/上报周期	分享者不能修改持久配置或创建倒计时；传感器不提供继电器式定时
单设备分享	一次性邀请、接受、取消、退出	家庭/房间的历史表存在，但不作为当前设备授权来源
OTA与工厂烧录	私有OSS、校验、双分区更新与失败回滚；Web串口烧录工具	二进制版本独立于平台版本，普通OTA、应用烧录、工厂镜像影响不同
历史数据	传感器只读数值曲线、分档聚合	不为继电器开关、SSID和版本号显示历史曲线

v0.8 BLE网关与子设备设计已选ESP32-S3＋CH582实验板，尚未实现；v0.9组合加固、v1.0发布是规划。家庭与房间放在v1.0后评估；HA桥接暂缓，其他Broker兼容验证排在HA之后。进度以滴答清单为准，本网站不维护第二套执行看板。

按任务阅读

读者要完成的工作	阅读顺序	完成标准
新开发者启动系统	环境搭建 → 数据库初始化 → 架构	健康接口正常；登录、数据库连接与前端请求目标可核对
嵌入式开发者接入设备	设备接入 → 配网认领 → MQTT → 配置定时	设备认证、归属ACTIVE、能力与状态回报均匹配
运维升级服务	部署维护 → EMQX → 故障排查	current/PM2/健康接口一致；数据库升级与应用发布分别验证
维护者定位配网或定时问题	排障索引 → 对应协议 → 验证范围	能区分WiFi、MQTT、归属、配置接受、执行结果

如何使用这些文档

现行协议集中在架构与协议章节；操作流程集中在开发指南；产品板级差异在硬件章节。章节概览只作入口，不重复复制契约。历史阶段说明见归档，它们解释设计演变，不作为可直接执行的配置。

本次未连接线上系统。在线地址、部署和烧录事实使用既有发布记录、已保存回执及人工确认；服务器当前监听、证书剩余有效期、Cloudflare控制台分支与微信体验版状态未重新查询，见核验范围。