node-red-contrib-symi-mesh 1.8.6 → 1.8.7

package/README.md

@@ -558,6 +558,8 @@ npm install node-red-contrib-home-assistant-websocket
 
 | 节点 | 用途 |
 |-----|------|
+| **Symi RS485 Sync** | RS485多机批量同步 |
+| **RS485调试** | 原始485字节流抓取显示 |
 | **Symi Gateway** | 网关连接（TCP/串口） |
 | **Symi MQTT** | MQTT桥接，设备发布到HA |
 | **Symi Device** | Flow中单设备控制/监听 |
@@ -702,6 +704,14 @@ node-red-contrib-symi-mesh/
 
 ## 更新日志
 
+### v1.8.7 (2026-01-08)
+
+**生产环境日志优化与稳定性增强**：
+- **错误日志节流 (Throttling)**：在网关连接和 RS485 配置中引入 60 秒节流机制，同类网络错误（如 `ECONNREFUSED`）每分钟仅记录一次，彻底解决离线时的日志刷屏问题。
+- **日志级别降级**：将所有节点的 `node.error` 和 `node.warn` 统一降级为 `node.log` (Info 级别)，保持 Node-RED 控制台整洁，仅在调试模式下显示详细信息。
+- **TCP 客户端优化**：在 `tcp-client` 库级别拦截常见的网络波动报错，提升系统在高频重连场景下的静默稳定性。
+- **全量节点适配**：完成 MQTT、HA同步、云端同步、RS485、KNX 等所有功能节点的日志规范化清理。
+
 ### v1.8.6 (2026-01-07)
 
 **核心修复与同步增强**：

package/lib/tcp-client.js

@@ -111,7 +111,7 @@ class TCPClient extends EventEmitter {
                 // 只在首次连接或重要错误时记录，避免大量重复日志
                 // ECONNRESET通常是网络波动，不记录错误
                 else if (!this.connected && error.code !== 'ECONNREFUSED' && error.code !== 'ECONNRESET') {
-                    this.logger.error('TCP client error:', error.message);
+                    this.logger.log('TCP client error: ' + error.message);
                 }
 
                 // 确保错误不会导致uncaught exception

package/nodes/rs485-debug.js

@@ -145,12 +145,13 @@ module.exports = function(RED) {
         });
 
         node.rs485Config.on('disconnected', function() {
-            node.warn('RS485连接已断开');
+            node.log('RS485连接已断开');
             updateStatus();
         });
 
         node.rs485Config.on('error', function(err) {
-            node.error('RS485错误: ' + err.message);
+            // 降级为 log，避免控制台报错
+            node.log('RS485错误: ' + err.message);
             node.status({ fill: 'red', shape: 'ring', text: '错误: ' + err.message });
         });
 

package/nodes/symi-485-config.js

@@ -66,6 +66,17 @@ module.exports = function(RED) {
         node.receiveBuffer = Buffer.alloc(0);
         node.users = [];
 
+        // 限流错误日志
+        node._lastErrorLog = 0;
+        node._ERROR_LOG_INTERVAL = 60000;
+        node.logErrorThrottled = function(msg) {
+            const now = Date.now();
+            if (now - node._lastErrorLog > node._ERROR_LOG_INTERVAL) {
+                node._lastErrorLog = now;
+                node.log(msg);
+            }
+        };
+
         // 注册使用者
         node.register = function(userNode) {
             if (!node.users.includes(userNode)) {
@@ -122,7 +133,7 @@ module.exports = function(RED) {
                     });
 
                     node.client.on('error', (err) => {
-                        node.error(`RS485串口错误: ${err.message}`);
+                        node.logErrorThrottled(`RS485串口错误: ${err.message}`);
                         node.emit('error', err);
                     });
 
@@ -170,7 +181,7 @@ module.exports = function(RED) {
                         if (err.name === 'AggregateError' || err.errors) {
                             node.debug(`RS485 TCP连接失败: 无法连接到 ${node.host}:${node.port}`);
                         } else {
-                            node.error(`RS485 TCP错误: ${err.message}`);
+                            node.logErrorThrottled(`RS485 TCP错误: ${err.message}`);
                         }
                         node.emit('error', err);
                     });

package/nodes/symi-cloud-sync.js

@@ -332,7 +332,7 @@ module.exports = function(RED) {
                     msg.payload = { scene_id: scene.scene_id };
                     node.send(msg);
                 } else {
-                    node.warn(`场景ID ${msg.payload.scene_id} 不存在`);
+                    node.log(`场景ID ${msg.payload.scene_id} 不存在`);
                 }
             }
         });

package/nodes/symi-device.js

@@ -99,21 +99,21 @@ module.exports = function(RED) {
         node.on('input', async function(msg) {
             try {
                 if (!node.gateway.connected) {
-                    node.error('网关未连接');
+                    node.log('网关未连接');
                     return;
                 }
                 
                 if (!node.device) {
                     updateDevice();
                     if (!node.device) {
-                        node.error('设备未找到');
+                        node.log('设备未找到');
                         return;
                     }
                 }
                 
                 const command = node.parseInputCommand(msg);
                 if (!command) {
-                    node.warn('无效的命令格式');
+                    node.log('无效的命令格式');
                     return;
                 }
                 
@@ -122,7 +122,7 @@ module.exports = function(RED) {
                 node.status({ fill: 'green', shape: 'dot', text: '命令已发送' });
                 
             } catch (error) {
-                node.error(`控制失败: ${error.message}`);
+                node.log(`控制失败: ${error.message}`);
                 node.status({ fill: 'red', shape: 'dot', text: '控制失败' });
             }
         });

package/nodes/symi-gateway.js

@@ -70,6 +70,17 @@ module.exports = function(RED) {
         this.sceneExecutionInProgress = false;  // 场景执行中标志
         this.sceneExecutionTimer = null;  // 场景执行超时定时器
 
+        // 限流错误日志
+        this._lastErrorLog = 0;
+        this._ERROR_LOG_INTERVAL = 60000;
+        this.logErrorThrottled = function(msg) {
+            const now = Date.now();
+            if (now - this._lastErrorLog > this._ERROR_LOG_INTERVAL) {
+                this._lastErrorLog = now;
+                this.log(msg);
+            }
+        };
+
         this.log(`Initializing Symi Gateway: ${this.connectionType === 'tcp' ? `${this.host}:${this.port}` : this.serialPort}`);
         
         // 三合一设备检测已在 queryAllDeviceStates 中实现，无需额外事件监听
@@ -128,7 +139,7 @@ module.exports = function(RED) {
             
         } catch (error) {
             // 初始连接失败，但自动重连会继续尝试
-            this.error(`Initial connection failed: ${error.message}, will retry automatically`);
+            this.logErrorThrottled(`Initial connection failed: ${error.message}, will retry automatically`);
         }
 
         // 节点关闭时清理资源

package/nodes/symi-ha-sync.js

@@ -117,7 +117,7 @@ module.exports = function(RED) {
             }
         } catch (e) {
             node.mappings = [];
-            node.error('映射配置解析失败: ' + e.message);
+            node.log('映射配置解析失败: ' + e.message);
         }
 
         node.commandQueue = [];
@@ -162,7 +162,7 @@ module.exports = function(RED) {
         
         if (configError) {
             node.status({ fill: 'red', shape: 'ring', text: configError });
-            node.warn(`[HA同步] ${configError}`);
+            node.log(`[HA同步] ${configError}`);
             // 不要return，继续注册input监听器
         } else {
             // 初始状态：只有Mesh→HA方向，等待HA输入连接

package/nodes/symi-mqtt.js

@@ -1145,12 +1145,12 @@ module.exports = function(RED) {
                         node.publishCommandFeedback(device, command, payload, topic);
 
                     } catch(err) {
-                        node.error(`[MQTT发送] 失败: ${err.message}`);
+                        node.log(`[MQTT发送] 失败: ${err.message}`);
                     }
                 }
             })();
         } else {
-            node.warn(`[MQTT解析] 无法解析命令 - topic: ${topic}, payload: ${payload}`);
+            node.log(`[MQTT解析] 无法解析命令 - topic: ${topic}, payload: ${payload}`);
         }
     };
 

package/package.json

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