node-red-contrib-symi-mesh 1.8.10 → 1.8.11

package/README.md

@@ -704,6 +704,16 @@ node-red-contrib-symi-mesh/
 
 ## 更新日志
 
+### v1.8.11 (2026-01-16)
+
+**核心稳定性修复**：
+- **僵尸节点彻底清除**：修复了在删除或修改 KNX 场景映射并重新部署后，旧的配置逻辑仍在后台运行的问题。
+    - **原因分析**：旧节点实例销毁时，未能完全解绑网关事件监听器，导致“僵尸节点”继续响应事件。
+    - **解决方案**：引入 `node.isClosed` 标志位，强制拦截销毁后的所有逻辑执行；同时修复了网关连接状态监听器的内存泄漏问题。
+- **内存泄漏修复**：将所有匿名事件监听器改为具名函数，确保在节点关闭时能被正确移除，防止多次部署后的内存累积。
+- **空指针异常防护**：在 `symi-gateway` 中增加了多处连接状态检查，防止网关断开后后台任务访问已销毁的客户端对象，彻底消除 `Cannot read properties of null (reading 'sendFrame')` 报错刷屏。
+- **UI 显示优化**：修复了 KNX 开关类型在配置列表中错误显示“扩展”列数据的问题，现在开关类型的扩展列将正确显示为“-”。
+
 ### v1.8.10 (2026-01-16)
 
 **新增功能**：

package/nodes/symi-gateway.js

@@ -495,6 +495,10 @@ module.exports = function(RED) {
                 }
                 
                 for (const attr of queryAttrs) {
+                    if (!this.client) {
+                        this.error(`查询设备${device.name}失败: 网关未连接 (Client is null)`);
+                        break;
+                    }
                     const frame = this.protocolHandler.buildDeviceStatusQueryFrame(device.networkAddress, attr);
                     await this.client.sendFrame(frame, 2);
                     await this.sleep(150); // 增加延迟确保设备有时间响应
@@ -522,6 +526,7 @@ module.exports = function(RED) {
                             this.log(`[三合一检测] 查询 ${device.name} 完整状态...`);
                             const threeInOneAttrs = [0x02, 0x16, 0x1B, 0x1C, 0x1D, 0x6A, 0x6C];
                             for (const attr of threeInOneAttrs) {
+                                if (!this.client) break;
                                 const frame = this.protocolHandler.buildDeviceStatusQueryFrame(device.networkAddress, attr);
                                 await this.client.sendFrame(frame, 2);
                                 await this.sleep(150);
@@ -545,6 +550,7 @@ module.exports = function(RED) {
                         // 查询温控器状态
                         const tempCtrlAttrs = [0x02, 0x16, 0x1B, 0x1C, 0x1D];
                         for (const attr of tempCtrlAttrs) {
+                            if (!this.client) break;
                             const frame = this.protocolHandler.buildDeviceStatusQueryFrame(device.networkAddress, attr);
                             await this.client.sendFrame(frame, 2);
                             await this.sleep(150);
@@ -567,6 +573,10 @@ module.exports = function(RED) {
         this.log('启用设备状态上报功能...');
         for (const device of devices) {
             try {
+                if (!this.client) {
+                    this.error('网关连接断开，停止启用状态上报');
+                    break;
+                }
                 // 启用状态上报：msg_type=0x10, param=0x01
                 const frame = this.protocolHandler.buildDeviceControlFrame(device.networkAddress, 0x10, Buffer.from([0x01]));
                 await this.client.sendFrame(frame, 2);

package/nodes/symi-knx-bridge.html

@@ -79,7 +79,7 @@
                 if (!knxEntities.length) { c.html('<div class="tips">点击"导入"或"添加"管理KNX实体</div>'); return; }
                 let h = '<table class="tbl"><tr><th>名称</th><th>类型</th><th>命令</th><th>状态</th><th>扩展</th><th style="width:60px">操作</th></tr>';
                 knxEntities.forEach((e,i) => {
-                    const ext = [e.ext1,e.ext2,e.ext3].filter(x=>x).join(',');
+                    const ext = (e.type === 'switch') ? '-' : [e.ext1,e.ext2,e.ext3].filter(x=>x).join(',');
                     const inv = e.type==='cover' ? '<input type="checkbox" class="e-inv" title="位置反转"'+(e.invert?' checked':'')+'>' : '';
                     h += '<tr data-ei="'+i+'"><td>'+e.name+'</td><td>'+(typeLabels[e.type]||e.type)+inv+'</td><td>'+e.cmdAddr+'</td><td>'+(e.statusAddr||'-')+'</td><td>'+(ext||'-')+'</td><td><button class="red-ui-button red-ui-button-small e-edit" title="编辑"><i class="fa fa-pencil"></i></button> <button class="red-ui-button red-ui-button-small e-del" title="删除"><i class="fa fa-times"></i></button></td></tr>';
                 });

package/nodes/symi-knx-bridge.js

@@ -178,6 +178,7 @@ module.exports = function(RED) {
         
         // 初始化标记
         node.initializing = true;
+        node.isClosed = false; // 防止僵尸节点执行逻辑
         node.initTimer = setTimeout(() => {
             node.initializing = false;
             node.log('[KNX Bridge] 初始化完成，开始同步');
@@ -261,6 +262,9 @@ module.exports = function(RED) {
 
         // ========== Mesh设备状态变化处理 ==========
         const handleMeshStateChange = (eventData) => {
+            // 防止僵尸节点执行
+            if (node.isClosed) return;
+
             // 只检查initializing，不检查syncLock
             // syncLock会导致队列处理期间丢失事件，改用per-device时间戳防回环
             if (node.initializing) return;
@@ -1198,13 +1202,17 @@ module.exports = function(RED) {
         // ========== 事件监听 ==========
         
         // 监听网关连接状态
-        node.gateway.on('gateway-connected', () => {
+        const handleGatewayConnected = () => {
+            if (node.isClosed) return;
             node.status({ fill: 'green', shape: 'ring', text: `网关已连接 ${node.mappings.length}个映射` });
-        });
+        };
+        node.gateway.on('gateway-connected', handleGatewayConnected);
         
-        node.gateway.on('gateway-disconnected', () => {
+        const handleGatewayDisconnected = () => {
+            if (node.isClosed) return;
             node.status({ fill: 'red', shape: 'ring', text: '网关断开' });
-        });
+        };
+        node.gateway.on('gateway-disconnected', handleGatewayDisconnected);
         
         // 监听Mesh设备状态变化
         node.gateway.on('device-state-changed', handleMeshStateChange);
@@ -1212,6 +1220,9 @@ module.exports = function(RED) {
         // ========== 场景执行事件处理 ==========
         // 当收到场景执行通知时，查询所有已映射设备的状态
         const handleSceneExecuted = (eventData) => {
+            // 防止僵尸节点执行
+            if (node.isClosed) return;
+
             if (node.initializing) return;
             
             node.log(`[场景执行] 检测到场景${eventData.sceneId}执行，延迟查询设备状态`);
@@ -1253,6 +1264,9 @@ module.exports = function(RED) {
         
         // ========== 清理 ==========
         node.on('close', function(done) {
+            // 标记为已关闭，阻止任何后续事件处理
+            node.isClosed = true;
+
             // 清除初始化定时器
             if (node.initTimer) {
                 clearTimeout(node.initTimer);
@@ -1262,6 +1276,8 @@ module.exports = function(RED) {
             if (node.gateway) {
                 node.gateway.removeListener('device-state-changed', handleMeshStateChange);
                 node.gateway.removeListener('scene-executed', handleSceneExecuted);
+                node.gateway.removeListener('gateway-connected', handleGatewayConnected);
+                node.gateway.removeListener('gateway-disconnected', handleGatewayDisconnected);
             }
             
             // 销毁 SyncUtils 实例，清理资源

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-symi-mesh",
-  "version": "1.8.10",
+  "version": "1.8.11",
   "description": "Node-RED节点集合，用于通过TCP/串口连接Symi蓝牙Mesh网关，支持Home Assistant MQTT Discovery自动发现和云端数据同步",
   "main": "nodes/symi-gateway.js",
   "scripts": {