node-red-contrib-wznhjc-multi-ui

采集器客户端协议库（NetDAU485）+ Node-RED 节点：wznhjc-multi-edge-parse、wznhjc-multi-collector、Operator UI。
面向 Node-RED 4.0+ 新设备，支持边缘测点解析、TCP 握手、archives_ack 全量建档、仅有效读数 report、自动重连。

自原 node-red-contrib-wznhjc-collector 项目 fork 的独立 npm 包，包名与版本线独立维护。

环境要求

| 项 | 版本 | |----|------| | Node.js | >= 18（Node-RED 4.x 最低要求；推荐 20 LTS） | | Node-RED | >= 4.0（现场目标 4.0.2） |

在 Node-RED 里安装（推荐）

1. 菜单 设置 → 节点管理（Manage palette）→ 安装
2. 搜索并安装：node-red-contrib-wznhjc-multi-ui
3. 重启或部署后，在 palette 分类 wznhjc-multi 下可见节点；Operator 页 /wznhjc/operator

首次安装也可在 ~/.node-red 执行：

npm install node-red-contrib-wznhjc-multi-ui

环境：Node.js >= 18，Node-RED >= 4.0（含 4.0.2）。

详细说明见 docs/NODE-RED.md。
发布维护见 docs/PUBLISH.md（npm + flows.nodered.org 步骤）。

作为 npm 库使用

const {
  validateCollectorOptions,
  parseEdgeGetNodesPayload,
  buildElectricMetersFromEdgeParsed,
  connectCollectorUntilOnline,
  startCollectorAutoReconnect,
} = require('node-red-contrib-wznhjc-multi-ui');

推荐流程

[edge get nodes] → [multi edge-parse] → [multi collector]

• 建档：multi edge-parse 配置的全部 NodeID（无读数也建档）
• 上报：仅有有效数值的测点

开发 / 本地测试

npm install
npm test
npm run run:collector:local    # 改 scripts/run-collector-local.js 里的 LOCAL_CONFIG
npm run simulate:edge
npm run pack:install           # 模拟 tgz 安装到 examples/test-collector-consumer

连接必填参数

| 参数 | 说明 | |------|------| | host | 采集器地址 | | port | 端口 | | buildName | 建筑名称 | | buildNo | 建筑编号 / building_id | | gatewayId | 网关号 |

可选：sn、mac、ip；edgeGetNodesParsed / edgeNodeIds 用于档案与 report。

常用默认值

| 项 | 默认 | |----|------| | 握手步进 | 2000 ms（业务需要，每条服务端帧同步等待） | | 握手超时 | 120 s | | notify 心跳 | 30 s | | 首次 report | online 后 5 s | | 周期 report | 5 min | | 自动重连 | 3 min | | 协议日志保留 | 10 天 |

包内容

发布包含：src/、NetDAU_CLIENT/（含内置 collectorRuntimeConfig）、libs/log.js、nodes/。
不依赖 npm config 包；协议调试开启时写入 ~/.node-red/logs/collector-protocol.yyyy-MM-dd.log。