node-red-contrib-symi-modbus 2.9.1 → 2.9.3

package/README.md

@@ -888,39 +888,29 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 
 ## 版本信息
 
-**当前版本**: v2.9.1 (2025-12-13)
-
-**v2.9.1 更新内容**：
-- **重要修复**：RS-485开关指示灯同步问题
-  - 修复TCP粘包导致的协议帧解析失败问题
-  - 新增`parseAllFrames`函数，正确处理多个帧粘在一起的情况
-  - 根据协议的`dataLen`字段精确提取帧边界，确保每个帧都被正确解析
-- **重要修复**：Modbus控制看板部署失效问题
-  - 修复主站更新后重新部署导致看板无法正确显示的问题
-  - 部署时自动清空并重新初始化状态缓存
-  - 新增`refresh` API，点击刷新按钮从主站获取真实继电器状态
-- **优化**：控制看板刷新功能
-  - 刷新按钮现在会主动从主站获取最新的继电器状态
-  - 确保显示的状态与实际继电器状态同步
-- **优化**：指示灯反馈队列间隔调整为50ms
-  - TCP/串口写入间隔从40ms调整为50ms
-  - 触发源面板优先处理，确保按键响应流畅
-  - 按线圈顺序陆续反馈所有有动作的继电器指示灯
-
-**v2.9.0 更新内容**：
-- **重要修复**：一个按键现在可以控制多个不同从站的继电器
-  - 修复了全局防抖机制导致的问题：之前一个开关配置控制多个从站时，只有第一个从站会执行
-  - 现在支持：一个物理按键同时控制从站0A和0B的同一线圈，两个都会正确执行
-- 优化防抖key设计，包含目标从站地址，确保不同目标互不影响
-- RS-485开关、Mesh开关、Mesh场景模式均已修复
-
-**v2.8.9 更新内容**：
-- 新增Mesh开关无线模式支持，适用于场景触发按键
-- 修复Mesh开关群控LED反馈问题，确保状态完全同步
-- 优化LED反馈防抖机制（100ms），智能合并多次状态变化
-- 群控多个继电器时，Mesh开关只发送一次LED反馈，包含所有按钮的最新状态
-- 修复串口永久连接机制，彻底解决部署时串口锁定问题
-- RS-485开关功能完全不受影响，保持稳定运行
+**当前版本**: v2.9.3 (2025-12-15)
+
+**v2.9.3 更新内容**：
+- **重要修复**：场景按钮LED反馈不同步问题
+  - 修复场景按钮帧使用特殊通道（如0x0F）导致LED反馈失效的问题
+  - 场景模式保持使用配置计算的按键通道，不被帧中的特殊标识覆盖
+  - 解决"部署后场景按钮可以同步一次，点击其他开关后不再同步"的问题
+- **优化**：场景按钮匹配逻辑
+  - 增加场景模式帧的特殊匹配：通道0x0F或isSceneMode标识
+  - 同一面板的场景按钮现在能正确识别和处理
+
+**v2.9.2 更新内容**：
+- **稳定性增强**：全局防抖缓存定期清理机制
+  - 每10分钟自动清理超过1分钟未使用的防抖记录
+  - 防止长期运行时内存缓慢增长
+- **稳定性增强**：Mesh无线模式按键注册清理
+  - 节点关闭时正确清理meshWirelessButtons全局Map
+  - 避免重新部署时残留无效注册信息
+- **代码审查**：全面检查所有节点代码
+  - 确认所有定时器在节点关闭时正确清理
+  - 确认所有事件监听器正确注销
+  - 确认所有连接资源正确释放
+  - 支持断电断网后自动恢复运行
 
 **核心特性**：
 - 支持Modbus RTU/TCP协议，兼容标准Modbus设备和TCP转RS485网关

package/nodes/modbus-slave-switch.js

@@ -30,6 +30,27 @@ module.exports = function(RED) {
     let meshLedFeedbackQueueTimer = null;
     let meshLedFeedbackGlobalLock = 0;  // 全局锁定时间戳：在此时间之前，忽略所有Mesh面板的状态上报
     
+    // 全局防抖缓存定期清理（每10分钟清理超过1分钟未使用的条目，防止内存泄漏）
+    let globalDebounceCacheCleanupTimer = null;
+    function startGlobalDebounceCacheCleanup() {
+        if (globalDebounceCacheCleanupTimer) return;
+        globalDebounceCacheCleanupTimer = setInterval(() => {
+            const now = Date.now();
+            const expireThreshold = 60 * 1000;  // 1分钟未使用的条目将被清理
+            let cleanedCount = 0;
+            for (const [key, timestamp] of globalDebounceCache.entries()) {
+                if (now - timestamp > expireThreshold) {
+                    globalDebounceCache.delete(key);
+                    cleanedCount++;
+                }
+            }
+            if (cleanedCount > 0) {
+                RED.log.debug(`全局防抖缓存清理: 删除${cleanedCount}条过期记录，剩余${globalDebounceCache.size}条`);
+            }
+        }, 10 * 60 * 1000);  // 每10分钟执行一次
+    }
+    startGlobalDebounceCacheCleanup();
+    
     // 初始化Mesh设备持久化存储
     const meshPersistDir = path.join(RED.settings.userDir || os.homedir() + '/.node-red', 'mesh-devices-persist');
     let meshStorageInitialized = false;
@@ -774,16 +795,26 @@ module.exports = function(RED) {
                     // 检查是否是我们监听的开关面板和按钮
                     // switchId对应本地地址（物理面板地址）
                     // buttonNumber对应实际按键编号（1-8）
-                    if (buttonEvent.raw.localAddr === node.config.switchId && actualButtonNumber === node.config.buttonNumber) {
-                        // 保存原始的deviceAddr和channel，用于LED反馈
-                        const oldDeviceAddr = node.buttonDeviceAddr;
-                        const oldChannel = node.buttonChannel;
-                        node.buttonDeviceAddr = buttonEvent.deviceAddr;
-                        node.buttonChannel = buttonEvent.channel;
-
-                        // 输出调试日志，对比计算值和实际值
-                        if (oldDeviceAddr !== buttonEvent.deviceAddr || oldChannel !== buttonEvent.channel) {
-                            node.log(`按键事件更新LED反馈地址：计算值(设备${oldDeviceAddr} 通道${oldChannel}) → 实际值(设备${buttonEvent.deviceAddr} 通道${buttonEvent.channel})`);
+                    // 
+                    // 重要：场景按钮的帧通道可能是特殊标识（如0x0F），而不是实际按键通道
+                    // 因此需要额外判断：如果是场景模式且localAddr匹配，也应该处理
+                    const isSceneModeFrame = buttonEvent.isSceneMode || buttonEvent.channel === 0x0F;
+                    const isMatchedByButtonNumber = (buttonEvent.raw.localAddr === node.config.switchId && actualButtonNumber === node.config.buttonNumber);
+                    const isMatchedBySceneMode = (buttonEvent.raw.localAddr === node.config.switchId && node.config.buttonType === 'scene' && isSceneModeFrame);
+                    
+                    if (isMatchedByButtonNumber || isMatchedBySceneMode) {
+                        // 只有开关模式才更新deviceAddr和channel为实际值
+                        // 场景模式保持使用配置计算的值，因为场景帧的通道（如0x0F）是特殊标识，不是LED反馈通道
+                        if (!isSceneModeFrame && node.config.buttonType !== 'scene') {
+                            const oldDeviceAddr = node.buttonDeviceAddr;
+                            const oldChannel = node.buttonChannel;
+                            node.buttonDeviceAddr = buttonEvent.deviceAddr;
+                            node.buttonChannel = buttonEvent.channel;
+
+                            // 输出调试日志，对比计算值和实际值
+                            if (oldDeviceAddr !== buttonEvent.deviceAddr || oldChannel !== buttonEvent.channel) {
+                                node.log(`按键事件更新LED反馈地址：计算值(设备${oldDeviceAddr} 通道${oldChannel}) → 实际值(设备${buttonEvent.deviceAddr} 通道${buttonEvent.channel})`);
+                            }
                         }
 
                         // 判断按钮类型：优先使用协议解析结果，其次使用配置
@@ -1478,6 +1509,15 @@ module.exports = function(RED) {
                     clearTimeout(meshLedDebounceTimers.get(meshAddr).timer);
                     meshLedDebounceTimers.delete(meshAddr);
                 }
+                
+                // 清理meshWirelessButtons中当前节点的按键注册
+                if (node.config.meshWirelessMode === true && meshWirelessButtons.has(meshAddr)) {
+                    meshWirelessButtons.get(meshAddr).delete(node.config.meshButtonNumber);
+                    // 如果该设备没有其他无线按键了，删除整个条目
+                    if (meshWirelessButtons.get(meshAddr).size === 0) {
+                        meshWirelessButtons.delete(meshAddr);
+                    }
+                }
             }
 
             // 清理队列（释放内存）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-symi-modbus",
-  "version": "2.9.1",
+  "version": "2.9.3",
   "description": "Node-RED Modbus节点，支持TCP/串口通信、串口自动搜索、多设备轮询、可选MQTT集成（支持纯本地模式和MQTT模式）、Home Assistant自动发现、HomeKit网桥、可视化控制看板、自定义协议转换和物理开关面板双向同步，工控机长期稳定运行",
   "main": "nodes/modbus-master.js",
   "scripts": {