更新记录

1.0.5（2026-10-13） 下载此版本

v1.0.5

发布日期：2026-09-29

更新内容

  • 完善 RF 学习桥与 RF_SLOT_SWITCH 虚拟开关全链路，服务端 0.2.99。
  • 接入 ESP01S_UART_RELAY（市面串口继电器 1/2/4 路），服务端 0.2.93。
  • 品牌绿 Loading 替代系统灰菊花；教程反馈区文案统一为「反馈」。
  • 统一多通道/引脚角色卡片顶栏布局（名称独占行 + 标签行），倒计时间距与开关控件样式微调；服务端 0.2.91。
  • 联动/DIOL/开关控件美化，chip-ref 进接线弹窗；云端 Tab 默认关；WB3S MQTT；服务端 0.2.90。
  • 接入 ESP32-C3-Zero RF Bridge（APP/SERVER/固件/文档），服务端 0.2.89。
  • rename static chip folder DX-Z30 to ZX-D30 to match type_code.
  • 接入 ESP32-C3-Zero 万能 IO，扩展芯片引脚参考图与 chip-ref 规范，服务端 0.2.86。
  • 接入 Waveshare ESP32-C6-Zero 万能 IO / BLE 代理网关
  • DIOL 局域网：Popover 菜单/定时控件、固件 0.3.15 与服务端注册广播修复（0.2.74）。
  • 未配置友好引导、定时筛选与文档 Markdown 渲染
  • 将 APP 目录重命名为 NodeLioAPP，并同步规则/文档路径（v0.2.69）。

对接提醒

  • 本模板仅为 App 前端，请从官方下载并运行 NodeLio Server 后再在「应用配置」填写 API / WebSocket。
  • 官方清单：https://z-y.site/works/nodelio-update.json ；产品页：https://z-y.site/works/nodelio.html
  • 导入模板后请重新获取 DCloud appid（包内已清空）。

v1.0.3（首发）

服务端从官方下载并对接 API

本模板仅为 App 前端，设备控制依赖自建 NodeLio Server（提供 HTTP API + WebSocket/MQTT 相关能力）。请勿把 App 单独当成完整云平台。

1. 官方下载服务端

  • 产品说明与下载入口：https://z-y.site/works/nodelio.html
  • 固件与环境清单页：https://z-y.site/iot-ota.html
  • 服务端二进制（版本以清单为准）：
    • Windows amd64：https://cdn-file.z-y.site/works/iot-env/nodelio-server-windows-amd64-<版本>.exe
    • Linux amd64 / arm64：同目录 nodelio-server-linux-*
  • 建议同时下载官方 MQTT 可执行文件（同页 / 清单中 mqttServers），家庭自建常与 Server 同机运行。
  • 版本清单 JSON：https://z-y.site/works/nodelio-update.json（含 serverBuilds、firmwares 等）

2. App 对接 API

  1. 按部署文档启动 NodeLio Server（记下本机或局域网 HTTP 地址，默认端口常见为 8899）
  2. 打开 App → 应用配置
  3. 填写服务器地址（apiBaseUrl，一般形如 http://<主机>:8899/api）与 WebSocket 地址（按服务端说明填写）
  4. 保存后完成 Owner 绑定 / 设备配网注册；设备出现在首页即可云控

3. 说明

  • 官方站 z-y.site 是文档与账户站，不是把 API 基址填成 z-y.site；API 必须指向你下载并运行的 NodeLio Server。
  • 源码自建亦可；二进制下载适合快速对接本模板。

本版本其它

  • uni-app x 客户端首发至插件市场
  • 支持多品类设备控件、计划/情景/联动、局域网双路直控、BLE 网关代理等（需对应固件）

平台兼容性

uni-app x(5.0)

Chrome Safari Android iOS 鸿蒙 微信小程序
√ √ - - - -

NodeLio 易物连 App（uni-app x）使用说明

插件 ID：devsl-nodelioapp
版本：1.0.5
类型：uni-app 前端项目模板（uni-app x / Vue3 / uvue）

1. 简介

NodeLio 易物连是配套自建 NodeLio Server 的物联网设备控制客户端。

导入本模板后，在应用内配置你自己的节点 API / WebSocket，即可管理常见固件设备，例如：

  • 继电器 / 双路 IO / 多通道控制器
  • 电脑电源点动开关
  • 运动感知、光强等传感类设备
  • ASR 离线语音
  • BLE 桥接网关与蓝牙 IO 外设（经网关代理）
  • 433 射频学习桥
  • 局域网双路直控（可不依赖云 MQTT）

本插件包只包含前端 App 工程，不包含服务端可执行文件与设备固件二进制。

2. 运行环境

  • HBuilderX：需支持 uni-app x（建议使用官方最新正式版）
  • 后端：自建 NodeLio Server（HTTP API + 配套 MQTT，按部署文档启动）
  • 网络：手机 / 模拟器需能访问你填写的服务器地址（家庭自建一般为同一局域网）

3. 导入工程

  1. 从插件市场下载本项目模板并解压（或导入 zip）。
  2. 用 HBuilderX 打开工程根目录。
  3. 模板内 manifest.json 不含 DCloud appid。请在 HBuilderX 中重新获取 / 填写你自己的 appid。
  4. 按需运行到 H5、App 等目标平台。

4. 服务端：从官方下载并对接 API（必做）

设备列表、控制、计划任务、情景、联动等接口均由 NodeLio Server 提供。请先下载并启动服务端，再配置 App。

4.1 官方下载入口

  • 产品页：https://z-y.site/works/nodelio.html
  • 固件与环境说明：https://z-y.site/iot-ota.html
  • 版本清单（含 serverBuilds、firmwares、mqttServers）：https://z-y.site/works/nodelio-update.json

服务端二进制示例（版本号以清单为准）：

  • Windows amd64：https://cdn-file.z-y.site/works/iot-env/nodelio-server-windows-amd64-<版本>.exe
  • Linux amd64 / arm64：同目录下的 nodelio-server-linux-*

建议同时下载官方 MQTT 服务（清单中 mqttServers），家庭自建时常与 Server 同机运行。

也可源码自建 Server；二进制适合快速对接本模板。

4.2 重要说明

  • 官网 z-y.site 是文档 / 账户 / 下载站，不是 IoT API 节点地址。
  • App「应用配置」里的服务器地址，必须指向你本机或内网已启动的 NodeLio Server，不要填成 z-y.site。

4.3 App 对接步骤

  1. 按官方部署说明启动 NodeLio Server（及 MQTT）。记下 HTTP 访问地址。默认 HTTP 端口常见为 8899。
  2. 打开 App → 应用配置。
  3. 填写：
    • API 基址 apiBaseUrl：一般形如 http://<主机>:8899/api
    • WebSocket 地址：按服务端说明填写（与节点配套）
  4. 保存配置。
  5. 完成 Owner 绑定（按页面提示登录 / 绑定账号）。
  6. 设备固件配网并注册到该节点后，首页即可看到设备并云控。

更细的家庭自建与连接说明，见产品文档站相关手册（产品页入口）。

5. 固件

各设备类型固件请从官方固件页 / 清单下载并烧录：

  • https://z-y.site/iot-ota.html
  • https://z-y.site/works/nodelio-update.json（firmwares 字段）

请按硬件类型选择对应固件，例如 GPIO 直驱继电器与「串口 MCU 继电器底板」不是同一固件，错烧会导致无法控制。

6. 主要功能一览

模块 说明
设备列表 / 详情 按 type_code 加载对应控件
计划任务 定时执行开关等动作
情景模式 设备情景与激活
事件联动 条件触发其它设备动作
应用配置 服务器、账号、版本检测等
教程与反馈 可选对接平台文档 / 反馈能力
局域网双路直控 standalone 固件场景，可不走云 MQTT

7. 目录与依赖说明

  • 业务页面：pages/
  • 设备控件：components/device-controls/
  • 第三方模块：uni_modules/（见下表），请遵守各模块自身许可
  • 样式源文件以 .scss 为主；发布包已去掉工程根目录等处的 SCSS 编译产物 .css / .map，保留 uni_modules 内插件所需样式

7.1 本模板用到的 uni_modules

工程已随包提供，请勿删除；easycom 自动注册，一般无需在页面里再 import。

模块 组件 / 用途 本模板用法
uni-icons <uni-icons> 主图标库：列表、详情、教程、状态占位等绝大多数界面图标
uni-scss 全局 SCSS 变量 / 辅助类 uni-ui 配套样式变量（边距、圆角、色板等）
lime-popup <l-popup> 底部 / 居中弹层：设备配置、通道编辑、接线说明、授权、运营位等
lime-icon <l-icon> 少量页面图标（如底部 Tab、设置页部分入口）；依赖 iconify / 内置字体
lime-overlay <l-overlay> 遮罩层；由 lime-popup 内部使用
lime-transition <l-transition> / useTransition 弹层进出动画；由 popup / overlay 依赖
lime-shared JS/TS 工具集 lime 系列公共函数（vue 适配、单位、样式字符串等），业务页一般不直接引用
lime-style SCSS 主题 / 原子类 lime-icon 等样式依赖
lime-svg <l-svg>（本地 stub） 满足 lime-icon 对 SVG 分支的依赖；字体图标走 text，可替换为市场正式版

图标约定（业务代码）：

  • 优先 uni-icons（type 用插件已有图标名，如 eye、download、heart）
  • 需要 lime 图标集时再用 l-icon（name 须为模块已注册的名）

许可：uni-icons / uni-scss 属 DCloud uni-ui；lime-* 为插件市场第三方开源组件。

8. 常见问题

Q：导入后无法登录 / 无设备？
A：先确认 NodeLio Server 已启动，且 App 配置的 API 地址可从运行环境访问（模拟器注意 localhost 指向）。

Q：把服务器填成 z-y.site 行不行？
A：不行。那是文档站，不提供本模板所需的 NodeLio Go API。

Q：只要这个 App 包就能用吗？
A：不能。必须另外部署 Server（及通常需要的 MQTT），并烧录匹配固件。

Q：HBuilderX 报 uni-app x / uvue 相关错误？
A：请升级到支持 uni-app x 的 HBuilderX 版本。

隐私、权限声明

1. 本插件需要申请的系统权限列表：

按功能按需申请，无定位、通讯录、通话记录等无关权限。可能涉及：网络访问（连接自建 Server/平台/局域网设备）；本地存储（配置与登录态）；相机/相册（设备图标、头像、反馈配图；扫码导入配置）；麦克风（反馈区语音附件，若启用录音）；剪贴板（复制配置、固件地址、错误信息等）；拨打电话（仅当运营位配置了拨号动作且用户主动点击）。手机端不直接调用系统蓝牙扫描 API；BLE 外设通过已配网的 BLE 网关经 MQTT/云侧代理。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

本插件不内置第三方统计/归因 SDK。运行时数据仅发往用户自行填写的地址，主要包括：（1）自建 NodeLio Server（apiBaseUrl/WebSocket）：设备列表与控制、Owner 鉴权头、计划/情景/联动、配置与版本检测等业务 API；（2）可选平台站（默认示例 https://z-y.site，可改）：账号登录/资料/头像、教程、反馈/评论、许可相关接口，以及按日汇总的匿名化用量（如设备总数/在线数、账号数、安装标识）POST 至平台 daily-stats，用于产品运营统计；（3）局域网 DIOL 直控时访问用户输入的设备 IP。敏感令牌（如 owner_token、平台 auth_token）仅存本机本地存储，不写入本插件源码包。

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无穿山甲、优量汇、AdMob 等第三方广告 SDK，不展示程序化广告。应用内「官方通知/运营位」（首页与设置页轮播、弹窗）内容来自用户配置的 NodeLio 节点 bootstrap 或平台 nodelio-update.json 的 ads 字段，由部署方自行配置；可配置为空或关闭相关入口。运营位点击可能跳转应用内页面、外链、复制文本或拨号（makePhoneCall），不含强制弹窗广告收益分成。

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。