连接与本地控制
设备连接不仅是把 WiFi 密码写进去，也包括用户如何发现设备、确认状态，以及连接失败后如何继续操作。
配网之前
先确认设备与 App 的版本兼容，手机具备官方流程要求的网络与发现权限，路由器环境满足对应设备的要求。具体频段、配网方式与重置步骤请以当前设备文档为准。
为设备设置容易辨认的名称。多个设备部署在同一场景时，名称应能反映安装位置或用途，而不仅是默认编号。
区分连接状态
在产品需求中，至少应该区分以下几种状态，避免把不同问题都显示为“离线”：
- 设备尚未配置网络。
- 设备正在连接网络。
- 已连接网络，但 App 尚未建立控制连接。
- 设备可以控制，状态已同步。
- 连接中断，正在尝试恢复。
实际界面和协议字段以当前版本实现为准。这些状态用于帮助产品团队梳理交互，不构成协议规范。
理解本地优先
本地优先意味着把关键设备操作尽可能保留在用户所在的网络与设备端。它不等于设备完全没有网络要求，也不等于所有远程能力都能离线使用。
设计产品时，应分别确认本地控制、设备端调度、互联网访问和远程服务各自的边界。让用户知道哪些能力在断开外网后仍可继续使用。
验证异常恢复
用真实场景验证路由器重启、设备断电、手机切换网络和应用重新进入前台等情况。观察连接是否恢复、显示状态是否更新，以及是否需要用户重新操作。
在测试记录中同时保留 App 版本、固件版本、设备型号和网络环境，以便复现问题。
集成自己的产品
在品牌 App、现有业务平台或自研硬件中使用 Borneo-IoT 前，先确认目标版本支持的接口和授权条件。请从官方文档或工程咨询获取对应资料，不要依赖未公开的接口假设。