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

package/README.md

@@ -704,6 +704,36 @@ 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)
+
+**新增功能**：
+- **KNX 场景联动支持**：新增“场景”设备类型，支持 Mesh 开关按键与 KNX 场景的双向联动。
+    - **双向同步**：
+        - KNX 触发场景 -> 自动控制 Mesh 开关 (ON/OFF)
+        - Mesh 按键操作 -> 自动触发 KNX 场景 (发送场景号)
+    - **防死循环**：针对场景触发的单向特性，特别优化了防环路机制，确保 Mesh 状态变化后不会再次触发场景发送。
+    - **配置方式**：在 KNX 桥接节点中添加 KNX 实体时选择“场景”类型，需要配置以下三个参数：
+        1. **KNX组地址**：场景控制的组地址（如 1/1/1）。
+        2. **场景号(1-64)**：KNX 标准场景编号（对应 DPT 17.001 0-63 值）。
+         3. **绑定Mesh开关状态**：**必填项**。设置当触发该 KNX 场景时，关联的 Mesh 开关应变为“开”还是“关”。
+            - **为什么必须指定状态？** 场景通常是确定的状态（如“离家”=全关），而不是翻转（Toggle）。如果使用翻转，当灯已经是关闭状态时，再次触发“离家”会导致灯打开，这违背了场景的初衷。
+            - **逻辑说明**：
+                - **KNX -> Mesh**：收到 KNX 场景号 -> Mesh 开关执行指定状态（如设为 0，则执行关）。
+                - **Mesh -> KNX**：Mesh 开关变为指定状态（如变为关） -> 发送 KNX 场景号。
+- **日志优化**：
+    - **错误限流**：当 Mesh 网关离线时，KNX 同步节点会自动抑制重复的连接错误日志（1分钟内只显示一次），避免日志刷屏。
+    - **网络噪音过滤**：TCP 客户端自动过滤常见的网络连接错误（如 EHOSTUNREACH），减少生产环境的日志干扰。
+
 ### v1.8.9 (2026-01-14)
 
 **KNX 协议回显消除算法升级**：

package/lib/tcp-client.js

@@ -110,7 +110,8 @@ class TCPClient extends EventEmitter {
                 }
                 // 只在首次连接或重要错误时记录，避免大量重复日志
                 // ECONNRESET通常是网络波动，不记录错误
-                else if (!this.connected && error.code !== 'ECONNREFUSED' && error.code !== 'ECONNRESET') {
+                // EHOSTUNREACH/ETIMEDOUT 也是常见网络错误，不记录
+                else if (!this.connected && !['ECONNREFUSED', 'ECONNRESET', 'EHOSTUNREACH', 'ETIMEDOUT'].includes(error.code)) {
                     this.logger.log('TCP client error: ' + error.message);
                 }
 

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

@@ -26,7 +26,7 @@
             }
 
             let mappings = [], devices = [], knxEntities = [];
-            const typeLabels = {switch:'开关',light_mono:'单调',light_cct:'双调',light_rgb:'RGB',light_rgbcw:'RGBCW',cover:'窗帘',climate:'空调',fresh_air:'新风',floor_heating:'地暖'};
+            const typeLabels = {switch:'开关',light_mono:'单调',light_cct:'双调',light_rgb:'RGB',light_rgbcw:'RGBCW',cover:'窗帘',climate:'空调',fresh_air:'新风',floor_heating:'地暖',scene:'场景'};
 
             try { mappings = JSON.parse(node.mappings || '[]'); } catch(e) { mappings = []; }
             try { knxEntities = JSON.parse(node.knxEntities || '[]'); } catch(e) { knxEntities = []; }
@@ -64,7 +64,10 @@
 # 新风 (开关, 风速)
 全屋新风	fresh_air	4/1/1	4/2/1
 # 地暖 (开关, 温度, 当前温度)
-客厅地暖	floor_heating	5/1/1	5/2/1	5/3/1`;
+客厅地暖	floor_heating	5/1/1	5/2/1	5/3/1
+# 场景 (地址, 编号, 动作1开0关)
+回家模式	scene	0/0/1	1	1
+离家模式	scene	0/0/1	2	0`;
                 const blob = new Blob([tpl], {type:'text/plain;charset=utf-8'});
                 const a = document.createElement('a'); a.href = URL.createObjectURL(blob);
                 a.download = 'knx-template.txt'; a.click();
@@ -76,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>';
                 });
@@ -108,7 +111,8 @@
                 'cover': ['上下地址*','位置地址','停止地址'],
                 'climate': ['开关地址*','温度地址','模式地址','风速地址','当前温度'],
                 'fresh_air': ['开关地址*','风速地址'],
-                'floor_heating': ['开关地址*','温度地址','当前温度']
+                'floor_heating': ['开关地址*','温度地址','当前温度'],
+                'scene': ['KNX组地址*', '场景号(1-64)*', '绑定Mesh开关状态(1=开/0=关)*']
             };
             
             // 统一的添加/编辑KNX实体面板
@@ -291,7 +295,7 @@
         .tbl th { background:#f0f0f0; }
         .tbl select { width:100%; font-size:11px; padding:2px; }
         .tbl input[type="checkbox"] { margin:0; }
-        #knx-list, #map-list { max-height:180px; overflow-y:auto; border:1px solid #ccc; margin:5px 0; padding:3px; }
+        #knx-list, #map-list { max-height:450px; overflow-y:auto; border:1px solid #ccc; margin:5px 0; padding:3px; }
         .tips { color:#666; padding:8px; text-align:center; font-size:12px; }
         .sec { display:flex; justify-content:space-between; align-items:center; margin:10px 0 4px; padding-bottom:4px; border-bottom:1px solid #ddd; }
         .sec b { font-size:12px; }

package/nodes/symi-knx-bridge.js

@@ -23,7 +23,8 @@ module.exports = function(RED) {
         'cover': { dpt: '1.008', name: '窗帘', hasChannel: false },
         'climate': { dpt: '9.001', name: '空调', hasChannel: false },
         'fresh_air': { dpt: '1.001', name: '新风', hasChannel: false },
-        'floor_heating': { dpt: '9.001', name: '地暖', hasChannel: false }
+        'floor_heating': { dpt: '9.001', name: '地暖', hasChannel: false },
+        'scene': { dpt: '17.001', name: '场景', hasChannel: false }
     };
 
     function SymiKNXBridgeNode(config) {
@@ -155,6 +156,10 @@ module.exports = function(RED) {
         node.lastKnxAddrSent = {};      // 记录发送到KNX地址的时间
         node.lastKnxValueSent = {};     // 记录发送到KNX地址的值
         
+        // 错误日志限流
+        node.lastErrorTime = 0;
+        node.ERROR_THROTTLE_MS = 60000; // 1分钟
+        
         // 初始化通用同步工具类
         node.syncUtils = new SyncUtils({
             defaultTimeout: DEFAULT_TIMEOUT,
@@ -173,6 +178,7 @@ module.exports = function(RED) {
         
         // 初始化标记
         node.initializing = true;
+        node.isClosed = false; // 防止僵尸节点执行逻辑
         node.initTimer = setTimeout(() => {
             node.initializing = false;
             node.log('[KNX Bridge] 初始化完成，开始同步');
@@ -256,6 +262,9 @@ module.exports = function(RED) {
 
         // ========== Mesh设备状态变化处理 ==========
         const handleMeshStateChange = (eventData) => {
+            // 防止僵尸节点执行
+            if (node.isClosed) return;
+
             // 只检查initializing，不检查syncLock
             // syncLock会导致队列处理期间丢失事件，改用per-device时间戳防回环
             if (node.initializing) return;
@@ -339,6 +348,63 @@ module.exports = function(RED) {
                         });
                     }
                 }
+                // 场景设备
+                else if (mapping.deviceType === 'scene') {
+                    const switchKey = `switch_${mapping.meshChannel}`;
+                    if (changed[switchKey] !== undefined) {
+                        const val = changed[switchKey];
+                        const switchValue = (val === 1 || val === true || val === 'on' || val === 'ON');
+                        
+                        // 检查是否匹配配置的触发动作
+                        if (switchValue === mapping.sceneAction) {
+                            // 构造防死循环key
+                            // 注意：这里使用的是 knx-to-mesh 方向的记录来防止 mesh-to-knx 的发送
+                            // 即：如果最近收到了 KNX 场景命令导致 Mesh 变化，这里应该拦截
+                            const sceneLoopKey = `${loopKey}_scene_${mapping.sceneNumber}`;
+                            
+                            if (node.shouldPreventSync('mesh-to-knx', sceneLoopKey)) {
+                                node.log(`[Mesh->KNX] 跳过场景触发(防死循环): ${sceneLoopKey}`);
+                                continue;
+                            }
+                            
+                            // 场景命令 DPT 17.001 (1字节无符号整数)
+                            // payload = 场景号 - 1 (KNX wire format: 0-63)
+                            const scenePayload = mapping.sceneNumber - 1;
+                            
+                            const knxMsg = {
+                                topic: mapping.knxAddrCmd,
+                                payload: scenePayload,
+                                dpt: '17.001',
+                                knx: { 
+                                    destination: mapping.knxAddrCmd, 
+                                    dpt: '17.001', 
+                                    action: 'write' 
+                                }
+                            };
+                            
+                            node.log(`[Mesh->KNX] 场景触发: Mesh开关=${switchValue?'ON':'OFF'} -> 发送场景 ${mapping.sceneNumber} 到 ${mapping.knxAddrCmd}`);
+                            
+                            // 直接发送，不经过通用队列（因为是单向触发）
+                            node.send([knxMsg, {
+                                topic: 'mesh-to-knx',
+                                payload: {
+                                    direction: 'Mesh→KNX',
+                                    type: 'scene',
+                                    scene: mapping.sceneNumber,
+                                    trigger: switchValue ? 'ON' : 'OFF'
+                                },
+                                timestamp: new Date().toISOString()
+                            }]);
+                            
+                            // 记录发送时间
+                            node.lastKnxAddrSent[mapping.knxAddrCmd] = Date.now();
+                            node.lastKnxValueSent[mapping.knxAddrCmd] = scenePayload;
+                            
+                            // 记录同步时间，防止反向循环
+                            node.recordSyncTime('mesh-to-knx', sceneLoopKey);
+                        }
+                    }
+                }
                 // 调光灯设备（单色、双色、RGB、RGBCW）- 简化逻辑：谁动谁跟，忽略过程反馈
                 else if (mapping.deviceType.startsWith('light_')) {
                     if (!eventData.isUserControl) continue;
@@ -566,7 +632,17 @@ module.exports = function(RED) {
                         }
                         await node.sleep(50);  // 命令间隔50ms
                     } catch (err) {
-                        node.log(`同步失败: ${err.message}`);
+                        const now = Date.now();
+                        // 如果是连接相关错误，进行限流
+                        if (err.message && (err.message.includes('Not connected') || err.message.includes('Connection'))) {
+                            if (now - node.lastErrorTime > node.ERROR_THROTTLE_MS) {
+                                node.lastErrorTime = now;
+                                node.error(`同步失败(网关离线): ${err.message} (后续类似错误将被抑制1分钟)`);
+                            }
+                        } else {
+                            // 其他错误正常记录
+                            node.error(`同步失败: ${err.message}`);
+                        }
                     }
                 }
             } finally {
@@ -1126,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);
@@ -1140,6 +1220,9 @@ module.exports = function(RED) {
         // ========== 场景执行事件处理 ==========
         // 当收到场景执行通知时，查询所有已映射设备的状态
         const handleSceneExecuted = (eventData) => {
+            // 防止僵尸节点执行
+            if (node.isClosed) return;
+
             if (node.initializing) return;
             
             node.log(`[场景执行] 检测到场景${eventData.sceneId}执行，延迟查询设备状态`);
@@ -1181,6 +1264,9 @@ module.exports = function(RED) {
         
         // ========== 清理 ==========
         node.on('close', function(done) {
+            // 标记为已关闭，阻止任何后续事件处理
+            node.isClosed = true;
+
             // 清除初始化定时器
             if (node.initTimer) {
                 clearTimeout(node.initTimer);
@@ -1190,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.9",
+  "version": "1.8.11",
   "description": "Node-RED节点集合，用于通过TCP/串口连接Symi蓝牙Mesh网关，支持Home Assistant MQTT Discovery自动发现和云端数据同步",
   "main": "nodes/symi-gateway.js",
   "scripts": {