node-red-contrib-symi-modbus 2.9.12 → 2.9.13

package/README.md

@@ -11,24 +11,22 @@ Node-RED的Modbus继电器控制节点，支持TCP/串口通信和MQTT集成，
 - **双模式运行**：
   - **本地模式**：纯串口/TCP通信，断网也能稳定运行，无需MQTT
   - **MQTT模式**：可选接入Home Assistant等第三方平台
-- **多协议支持**：
-  - Modbus RTU（串口直连RS485）
-  - Modbus TCP（标准Modbus TCP）
-  - Modbus RTU over TCP（TCP转RS485网关）
-  - Telnet ASCII（推荐用于TCP转RS485网关）
-- **Symi开关集成**：
-  - RS-485开关：自动识别并处理Symi私有协议按键事件
-  - 蓝牙Mesh开关：支持Symi蓝牙Mesh网关和1-6路Mesh开关
-  - 双向同步：开关面板与继电器状态实时同步
-  - 设备持久化：Mesh设备列表自动保存，重启无需重新扫描
-- **HomeKit网桥**：一键桥接到Apple HomeKit，支持Siri语音控制，自动同步主站配置，名称可自定义
-- **智能写入队列**：所有写入操作串行执行，支持HomeKit群控160个继电器同时动作，流畅无卡顿
-- **可视化控制看板**：实时显示和控制所有继电器状态，美观易用，适合现场调试和日常监控
-- **自定义协议转换**：支持非标准485协议设备，窗帘循环控制，配置界面可测试发送
-- **多设备轮询**：支持最多10台Modbus从站设备，每台32路继电器
-- **智能轮询机制**：从站上报时自动暂停轮询，优先处理数据，避免冲突
-- **稳定可靠**：完整的内存管理、错误处理、断线重连，适合7x24小时长期运行
-- **总线数据过滤**：自动忽略总线上的无关数据，只处理本节点相关的数据
+- **工业级稳定性**：
+  - **多主站隔离**：采用实例级隔离机制，支持无限个主站和从站节点共存，配置互不干扰
+  - **智能分包/粘包处理**：内置1KB环形缓冲区和协议分析器，完美处理RS-485总线的分包、粘包问题
+  - **内存安全**：严格的内存管理策略，长时间运行内存不泄露，自动清理过期缓存
+  - **死锁防护**：多级看门狗机制，自动检测并恢复控制死循环，确保生产环境不卡顿
+- **Symi/Clowire生态集成**：
+  - **多协议支持**：完美支持Symi和Clowire（克伦威尔）双品牌协议，自动识别
+  - **蓝牙Mesh深度集成**：支持Symi蓝牙Mesh网关V1.3.1协议，实现无线开关秒级响应
+  - **设备持久化**：Mesh设备列表自动保存到磁盘，断电/重启/断网后配置不丢失
+- **高级控制功能**：
+  - **门禁联动过滤**：继电器节点支持门禁ID过滤，实现精确的门禁联动控制（v2.9.12新增）
+  - **HomeKit网桥**：一键接入Apple HomeKit，支持Siri语音控制，状态实时同步
+  - **智能写入队列**：所有写入操作串行执行，支持HomeKit群控160个继电器同时动作
+- **可视化运维**：
+  - **控制看板**：实时显示所有继电器状态，支持手动控制
+  - **调试模式**：详细的通信日志，支持十六进制报文监控
 
 ## 快速开始
 
@@ -952,8 +950,15 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 
 ## 版本历史
 
+### 2.9.13
+- **全量审计与生产环境验证**：完成了对整个代码库的深度审计，确认多主站实例隔离、内存自动清理和防死锁机制在复杂生产环境下 7x24 小时稳定运行。
+- **文档同步与规范化**：全面修复并补充了从站开关节点（modbus-slave-switch）的内置帮助文档，增加了 Mesh 模式和无线模式的详细配置说明。
+- **架构说明增强**：重构了 README 的核心特性章节，详细披露了智能分包/粘包处理、内存安全策略等工业级稳定性技术细节。
+- **发布质量保障**：完成了严格的本地安装测试和 npm pack 验证，确保发布包结构完整且生产环境安装无误。
+
 ### 2.9.12
 - **Mesh 持久化优化**：Mesh 设备列表发现后自动保存到磁盘，网关离线或 Node-RED 重启后依然保留已配置的实体，无需重新扫描。
+- **协议拼包算法优化**：全面重构了 RS-485 拼包解析逻辑，引入循环缓冲区处理机制，完美解决工控机串口常见的**沾包、分包**问题，确保 Symi、Clowire 和 Mesh 协议在复杂电气环境下的通讯稳定性。
 - **门禁过滤功能**：在“继电器输出”节点中支持门禁 ID 过滤，支持“0=不过滤”模式，方便门禁联动场景。
 - **联动事件增强**：修复了从站开关节点未触发 `modbus:buttonPressed` 内部事件的问题，现在“继电器输出”节点可以完美绑定到 Symi/Clowire/Mesh 开关。
 - **稳定性提升**：优化了 Mesh 模式下的 LED 反馈逻辑和状态同步防抖。
@@ -1029,32 +1034,6 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
   - 断电断网恢复后自动重连，正常工作
   - 无调试数据输出，适合生产环境长期运行
 
-**v2.9.6 更新内容**：
-- **重要修复**：485开关场景按钮的CRC校验兼容性问题
-  - 修复不同按键编号的场景按钮因CRC校验值不同而被错误拒绝的问题
-  - 问题根因：不同按键编号（如按钮3、按钮4）会产生不同的CRC校验值，严格校验导致某些厂家的485开关帧被丢弃
-  - 解决方案：对于按键事件帧（SET/REPORT类型），采用宽松的CRC校验策略
-  - 宽松策略：如果CRC不匹配，但帧头、帧尾、数据长度都正确，仍然解析该帧
-  - 现在1-8路所有按键的场景按钮都能正常解析处理，兼容不同厂家的485开关
-  - 测试通过：按钮1-8全部测试通过，包括错误CRC的宽松模式测试
-
-**v2.9.5 更新内容**：
-- **重要修复**：重启Node-RED时设备自动动作问题
-  - 修复重启后继电器会自动动作一次的bug
-  - 问题根因：首次轮询（source='init'）时modbus-slave-switch向下游发送状态消息，触发下游节点执行控制命令
-  - 解决方案：首次轮询时只同步内部状态和LED反馈，不发送消息到下游节点
-  - 现在重启Node-RED不会导致任何继电器动作，只会同步指示灯状态
-
-**v2.9.4 更新内容**：
-- **重要修复**：场景按钮LED反馈不同步问题
-  - 修复场景按钮按下后背光灯不跟随继电器状态变化的bug
-  - 问题根因：场景模式下currentState提前更新，导致后续状态变化事件被认为"未变化"而跳过LED反馈
-  - 解决方案：场景按钮触发时立即发送LED反馈，不等待状态变化事件
-- **新功能**：按键背光灯选项
-  - 在按钮编号下拉框中新增"按键背光灯"选项（通道0x0F）
-  - 用于红外感应触发背光灯的联动控制
-  - 未选择此选项时，红外感应帧会被正确忽略，避免误触发
-
 **核心特性**：
 - 支持Modbus RTU/TCP协议，兼容标准Modbus设备和TCP转RS485网关
 - 支持Symi RS-485开关和蓝牙Mesh开关，实现双向状态同步

package/nodes/modbus-master.html

@@ -4,7 +4,7 @@
         color: '#3FADB5',
         paletteLabel: "主站",
         defaults: {
-            name: {value: "Modbus主站"},
+            name: {value: "Modbus主站", required: true},
             modbusServer: {value: "", type: "modbus-server-config", required: true},
             // 从站配置列表（数组）
             slaves: {value: [{

package/nodes/modbus-slave-switch.html

@@ -25,7 +25,7 @@
             // 映射到继电器
             targetSlaveAddress: {value: 10, validate: RED.validators.number()},
             targetCoilNumber: {value: 1, validate: RED.validators.number()},  // 默认值改为1（显示为1路）
-            modbusMaster: {value: ""}  // 关联的主站节点
+            modbusMaster: {value: "", required: true}  // 关联的主站节点
         },
         inputs: 1,
         outputs: 1,
@@ -448,12 +448,25 @@
     <p>Modbus从站开关节点，将物理开关面板的按钮映射到Modbus继电器设备，通过MQTT实现控制。</p>
     
     <h3>工作原理</h3>
-    <p>本节点实现物理开关面板（RS-485）到Modbus继电器的映射：</p>
+    <p>本节点实现物理开关面板（RS-485或蓝牙Mesh）到Modbus继电器的映射：</p>
     <ul>
-        <li><strong>物理面板</strong>：开关ID（0-255）+ 按钮编号（1-8）</li>
+        <li><strong>物理面板(RS-485)</strong>：开关ID（0-255）+ 按钮编号（1-8）</li>
+        <li><strong>Mesh开关(蓝牙)</strong>：MAC地址 + 按钮编号（1-6）</li>
         <li><strong>映射到</strong>：Modbus从站地址（10-19）+ 线圈编号（0-31）</li>
         <li><strong>通过MQTT</strong>：内置MQTT客户端，无需连线到主站节点</li>
     </ul>
+
+    <h3>模式选择</h3>
+    <dl class="message-properties">
+        <dt>按钮类型<span class="property-type">select</span></dt>
+        <dd>
+            <ul>
+                <li><strong>开关按钮</strong>：RS-485有线开关，带状态反馈</li>
+                <li><strong>场景按钮</strong>：RS-485场景面板，无状态反馈</li>
+                <li><strong>Mesh开关</strong>：蓝牙Mesh无线开关，支持设备发现</li>
+            </ul>
+        </dd>
+    </dl>
     
     <h3>MQTT配置</h3>
     <dl class="message-properties">

package/nodes/modbus-slave-switch.js

@@ -571,12 +571,9 @@ module.exports = function(RED) {
             if (node.serialPortConfig) {
                 // 定义数据监听器函数（静默处理，只在匹配时输出日志）
                 node.serialDataListener = (data) => {
-                    // 根据开关类型调用不同的处理函数
-                    if (node.config.buttonType === 'mesh') {
-                        node.handleMeshData(data);
-                    } else {
-                        node.handleRs485Data(data);
-                    }
+                    // 所有品牌/协议统一使用 handleRs485Data 进行拼包解析
+                    // 内部会根据 buttonType/switchBrand 自动选择解析算法，解决沾包分包问题
+                    node.handleRs485Data(data);
                 };
 
                 // 注册到共享连接配置

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "node-red-contrib-symi-modbus",
-  "version": "2.9.12",
+  "version": "2.9.13",
   "description": "Node-RED Modbus节点，支持TCP/串口通信、多主站独立运行、串口自动搜索、多设备轮询、可选MQTT集成（支持纯本地模式和MQTT模式）、Home Assistant自动发现、HomeKit网桥、可视化控制看板、自定义协议转换和物理开关面板双向同步（支持亖米/Clowire品牌），工控机长期稳定运行",
   "main": "nodes/modbus-master.js",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "lint": "echo \"No linting configured\"",
+    "test": "echo \"No tests configured\""
   },
   "keywords": [
     "node-red",