node-red-contrib-symi-modbus 2.8.2 → 2.8.3

package/README.md

@@ -884,9 +884,9 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 
 ## 版本信息
 
-**当前版本**: v2.8.2
+**当前版本**: v2.8.3
 
-### v2.8.2 (2025-11-11)
+### v2.8.3 (2025-11-11)
 
 **核心功能**：
 - **Mesh开关完整支持**：支持Symi蓝牙Mesh网关和1-6路Mesh开关，实现双向状态同步
@@ -897,6 +897,9 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
   - **彻底解决Mesh开关LED不跟随继电器状态同步的问题**
 
 **重要修复**：
+- **修复串口锁定问题**：优化监听器注销逻辑，添加2秒延迟关闭机制，避免Mesh设备发现等临时操作导致串口频繁开关
+  - 问题原因：Mesh设备发现API注销监听器时立即关闭串口，导致其他节点无法打开串口（Resource temporarily unavailable Cannot lock port）
+  - 解决方案：监听器注销后延迟2秒关闭连接，给其他节点注册监听器的机会，确保485串口和TCP网关都能正常工作
 - 修复Mesh LED反馈状态不同步问题：引入全局共享状态Map，所有按钮节点共享同一个状态数组
 - 修复Mesh控制帧格式错误：移除多余参数，修正长度字段，确保与Mesh网关协议一致
 - 修复部署后LED指示灯不同步问题：主站首次轮询时主动广播所有线圈状态
@@ -909,6 +912,7 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 - 全局队列优化：40ms间隔 + 智能优先队列，确保长期稳定流畅运行
 - 串行发送：所有LED反馈按优先级和加入顺序依次发送，间隔40ms（TCP和串口统一）
 - 去重机制：每个节点50ms内不重复发送相同状态，避免总线拥堵
+- 延迟关闭机制：连接在所有监听器注销后延迟2秒关闭，避免临时操作导致连接频繁开关
 
 **典型场景说明**：
 1. **场景1：单个继电器控制**

package/nodes/serial-port-config.js

@@ -44,6 +44,9 @@ module.exports = function(RED) {
         node.triggerSource = null;  // 当前触发场景的开关ID
         node.triggerSourceTime = 0;  // 触发时间戳
 
+        // 延迟关闭定时器（避免Mesh设备发现等临时操作导致串口频繁开关）
+        node.closeTimer = null;  // 延迟关闭定时器
+
         // 打开TCP连接
         node.openTcpConnection = function() {
             if (node.connection && !node.connection.destroyed) {
@@ -506,6 +509,12 @@ module.exports = function(RED) {
                 node.reconnectTimer = null;
             }
 
+            // 清除延迟关闭定时器
+            if (node.closeTimer) {
+                clearTimeout(node.closeTimer);
+                node.closeTimer = null;
+            }
+
             // 清空所有监听器
             node.dataListeners = [];
 

package/package.json

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

package/RELEASE_CHECKLIST.md

@@ -1,99 +0,0 @@
-# v2.8.2 发布前检查清单
-
-## 代码质量检查
-
-### 1. 资源管理 ✅
-- [x] 所有定时器在节点关闭时正确清理（clearTimeout/clearInterval）
-- [x] 所有事件监听器在节点关闭时正确移除（removeListener/removeAllListeners）
-- [x] 所有连接在节点关闭时正确关闭（TCP/串口/MQTT）
-- [x] 全局缓存合理管理，不会无限增长
-
-### 2. 内存泄漏防护 ✅
-- [x] modbus-slave-switch.js: 完整的close处理
-- [x] modbus-master.js: 完整的close处理
-- [x] serial-port-config.js: 完整的close处理
-- [x] 全局Map使用合理（globalDebounceCache, meshDeviceStates）
-
-### 3. 稳定性保障 ✅
-- [x] 断网重连机制：TCP连接断开后自动重连
-- [x] 防抖机制：避免重复处理同一按键事件（200ms防抖）
-- [x] 队列机制：40ms间隔串行发送，防止总线冲突
-- [x] 去重机制：50ms内不重复发送相同状态
-- [x] 初始化保护：部署期间不发送LED反馈
-
-### 4. Mesh功能完整性 ✅
-- [x] 全局共享状态管理：meshDeviceStates Map
-- [x] Mesh控制帧格式正确：移除多余参数，长度字段正确
-- [x] 设备持久化：自动保存和加载Mesh设备列表
-- [x] LED状态同步：继电器变化时自动同步到Mesh开关
-- [x] 支持1/2/3/4/6路Mesh开关
-
-### 5. 错误处理 ✅
-- [x] 所有异步操作都有try-catch
-- [x] 连接失败时有重连机制
-- [x] 错误日志清晰，便于排查问题
-
-## 文档完整性检查
-
-### 1. README.md ✅
-- [x] 版本号更新为v2.8.2
-- [x] 只保留最新版本的更新日志
-- [x] Mesh开关配置说明完整
-- [x] 安装步骤清晰
-- [x] 使用示例完整
-
-### 2. package.json ✅
-- [x] 版本号更新为2.8.2
-- [x] 依赖版本正确
-- [x] 关键词完整
-- [x] 仓库信息正确
-
-## 功能测试
-
-### 1. 基础功能 ✅
-- [x] Modbus主站轮询正常
-- [x] RS-485从站开关按键触发正常
-- [x] LED反馈正常
-
-### 2. Mesh功能 ✅
-- [x] Mesh设备扫描正常
-- [x] Mesh按键触发继电器正常
-- [x] 继电器状态变化同步到Mesh LED正常
-- [x] 无死循环问题
-
-### 3. 稳定性测试 ✅
-- [x] 长时间运行不卡顿
-- [x] 断网重连正常
-- [x] 重启Node-RED后状态恢复正常
-- [x] 无内存泄漏
-
-## 发布步骤
-
-1. ✅ 确认所有检查项通过
-2. ✅ 更新版本号（package.json和README.md）
-3. ⏳ 提交代码到Git
-4. ⏳ 发布到npm
-5. ⏳ 创建GitHub Release
-
-## 发布命令
-
-```bash
-# 1. 提交代码
-git add .
-git commit -m "Release v2.8.2: Mesh开关完整支持，修复LED同步问题"
-git push origin main
-
-# 2. 发布到npm
-npm publish
-
-# 3. 创建Git标签
-git tag v2.8.2
-git push origin v2.8.2
-```
-
-## 发布后验证
-
-- [ ] npm上版本号正确
-- [ ] 安装测试正常
-- [ ] 文档显示正确
-