node-red-contrib-symi-mesh 1.7.4 → 1.7.7

package/README.md

@@ -1462,6 +1462,20 @@ node-red-contrib-symi-mesh/
 
 ## 更新日志
 
+### v1.7.5 (2025-12-24)
+- **API路径兼容性修复**：修复HassOS环境下节点配置界面无法加载设备列表的问题
+  - **根本原因**：HassOS Node-RED使用nginx反向代理，绝对路径`/api`会被拦截，需使用相对路径`api`
+  - **修复范围**：所有节点HTML中的`$.getJSON()`调用统一使用相对路径
+  - **开发规范**：后续开发节点时，所有前端API调用必须使用相对路径，不带前导斜杠
+- **KNX Bridge双向同步修复**：修复Mesh控制KNX开关不工作的问题
+  - **根本原因**：knxUltimate节点当`setTopicType: "str"`时使用`msg.topic`作为目标地址，而非`msg.destination`
+  - **修复方案**：发送消息同时包含`topic`和`destination`字段，确保兼容所有knxUltimate配置
+  - **消息格式**：`{ topic, destination, payload, dpt, event }`
+  - **防死循环**：不包含`knx`对象，避免触发knxUltimate的循环引用保护机制
+- **用户体验优化**：
+  - 设备列表加载时显示"加载中..."提示
+  - API调用失败时显示"加载失败，请重试"提示
+
 ### v1.7.4 (2025-12-24)
 - **串口配置完善**：完整的串口参数配置，解决HassOS环境串口锁定问题
   - **完整参数**：波特率、数据位(7/8)、停止位(1/2)、校验位(None/Even/Odd)
@@ -1508,7 +1522,16 @@ node-red-contrib-symi-mesh/
   - 内存安全，无调试日志，断电断网恢复后正常工作
   - 缓存队列处理，符合MQTT协议要求
 
-### v1.7.2 (2025-12-22)
+### v1.7.7 (2026-01-05)
+- **RS485桥接节点逻辑优化**：
+  - 修复自定义码模式下"反馈"按钮点击部署后依旧开启的问题
+  - 完善 `oneditsave` 逻辑，确保反馈选项状态被持久化保存
+  - **防循环优化**：优化 `loopKey` 生成逻辑，加入 `meshChannel` 字段，支持多通道设备独立防循环，解决多路开关干扰问题
+  - **冷却时间调整**：将防死循环冷却时间从 500ms 延长至 800ms，提高复杂网络环境下的同步稳定性
+  - **反馈逻辑细化**：严格执行"反馈"勾选逻辑，未勾选时禁止回环发送自定义码到总线
+  - **调试增强**：增加自定义码匹配成功的详细日志（包含设备 MAC 和具体动作）
+
+### v1.7.5 (2025-12-24)
 - **RS485双向同步节点**：新增`symi-rs485-sync`独立节点实现两种不同RS485协议之间的双向同步
   - 支持中弘VRF网关协议（功能码0x31-0x34控制，0x50查询）
   - 支持SYMI空调面板Modbus协议
@@ -1585,23 +1608,6 @@ node-red-contrib-symi-mesh/
   - 防死循环机制优化
   - 内存优化，防止日志溢出
 
-### v1.6.9 (2025-12-20)
-- **KNX-HA双向同步**：新增`symi-knx-ha-bridge`节点
-  - 直接连接KNX与HA实体，实现双向同步
-  - 支持Tab分隔格式导入KNX组地址配置（与KNX桥接节点100%一致）
-  - 使用共享HA服务器节点，通过REST API自动加载HA实体列表
-  - 支持开关、灯光、窗帘、空调、风扇等设备类型
-  - 完整双向同步：KNX↔HA实时状态同步
-  - 事件驱动架构，通过HA events-state节点实时接收事件
-  - 智能防抖：调光300ms、窗帘500ms，只同步最终值
-  - 内置防死循环机制（800ms防抖）
-  - 快速输入框：支持输入实体ID或名称搜索，自动提示806+实体
-  - 手动刷新按钮，随时重新加载HA实体
-  - 宽屏界面：对话框最小1000px宽度
-  - 持久化配置保存，内存优化
-  - 连接knxUltimate节点，无缝集成
-  - 适用于已有KNX系统与HA整合的场景
-
 ## 许可证
 
 MIT License
@@ -1613,8 +1619,8 @@ Copyright (c) 2025 SYMI 亖米
 ## 关于
 
 **作者**: SYMI 亖米
-**版本**: 1.7.4
+**版本**: 1.7.6
 **协议**: 蓝牙MESH网关（初级版）串口协议V1.0
-**最后更新**: 2025-12-24
+**最后更新**: 2026-01-05
 **仓库**: https://github.com/symi-daguo/node-red-contrib-symi-mesh
 **npm包**: https://www.npmjs.com/package/node-red-contrib-symi-mesh

package/examples/knx-sync-example.json

@@ -80,12 +80,12 @@
         "notifyreadrequest": false,
         "notifyresponse": false,
         "notifywrite": true,
-        "name": "Universal KNX",
+        "name": "Universal KNX Output",
         "outputtype": "write",
         "outputRBE": "false",
         "inputRBE": "false",
         "passthrough": "no",
-        "listenallga": true,
+        "listenallga": false,
         "buttonEnabled": false,
         "x": 620,
         "y": 120,

package/nodes/rs485-debug.html

@@ -34,7 +34,7 @@
             
             function loadHistory() {
                 if (!node.id) return;
-                $.getJSON('/rs485-debug/history/' + node.id, function(messages) {
+                $.getJSON('rs485-debug/history/' + node.id, function(messages) {
                     var container = $('#debug-history');
                     
                     if (messages.length === 0) {

package/nodes/symi-485-bridge.html

@@ -43,7 +43,7 @@
                     if (callback) callback(); 
                     return; 
                 }
-                $.getJSON('/symi-rs485-bridge/mesh-devices/' + gatewayId)
+                $.getJSON('symi-rs485-bridge/mesh-devices/' + gatewayId)
                     .done(function(devices) {
                         meshDevices = devices || [];
                         console.log('[RS485 Bridge] 加载Mesh设备:', meshDevices.length);
@@ -56,7 +56,7 @@
             }
 
             // 加载协议模板
-            $.getJSON('/symi-rs485-bridge/protocols', function(data) {
+            $.getJSON('symi-rs485-bridge/protocols', function(data) {
                 protocolData = data || { brands: {} };
                 // 延迟加载设备，确保gateway选择框已初始化
                 setTimeout(function() {
@@ -662,7 +662,8 @@
                     brand: $(this).find('.brand-select').val() || '',
                     device: $(this).find('.device-select').val() || '',
                     address: address,
-                    rs485Channel: parseInt($(this).find('.rs485-channel').val()) || 1
+                    rs485Channel: parseInt($(this).find('.rs485-channel').val()) || 1,
+                    feedback: $(this).find('.feedback-checkbox').is(':checked')
                 };
                 // 保存杜亚窗帘2字节地址
                 if (m.brand === 'duya') {

package/nodes/symi-485-bridge.js

@@ -964,7 +964,7 @@ module.exports = function(RED) {
         node.commandQueue = [];
         node.processing = false;
         node.syncLock = false;
-        node.lastSyncTime = 0;
+        node.lastSyncTime = {};
         node.pendingVerify = false;
 
         // RS485连接信息
@@ -1597,7 +1597,7 @@ module.exports = function(RED) {
                 }
             } finally {
                 node.processing = false;
-                node.lastSyncTime = Date.now();
+                node.lastQueueProcessTime = Date.now();
             }
         };
 
@@ -1709,12 +1709,12 @@ module.exports = function(RED) {
                 const codes = mapping.customCodes;
                 
                 // 检查反馈选项：如果feedback=false，检查是否是RS485触发的状态变化
-                // 如果是RS485触发的（500ms内有同步记录），则跳过发送反馈码
-                const loopKey = `${mapping.meshMac}_${mapping.device}`;
+                // 如果是RS485触发的（800ms内有同步记录），则跳过发送反馈码，防止死循环
+                const loopKey = `${mapping.meshMac}_${mapping.device}_${mapping.meshChannel || 1}`;
                 if (mapping.feedback === false) {
-                    const lastSync = node.lastSyncTime ? node.lastSyncTime[loopKey] : 0;
-                    if (lastSync && Date.now() - lastSync < 500) {
-                        node.debug(`[Mesh->自定义] 反馈已禁用，跳过发送`);
+                    const lastSync = (node.lastSyncTime && typeof node.lastSyncTime === 'object') ? node.lastSyncTime[loopKey] : 0;
+                    if (lastSync && Date.now() - lastSync < 800) {
+                        node.debug(`[Mesh->自定义] 反馈已禁用，跳过回环发送`);
                         return;
                     }
                 }
@@ -1753,7 +1753,7 @@ module.exports = function(RED) {
                         const hexCode = switchValue ? codes.sendOn : codes.sendOff;
                         if (hexCode) {
                             // 记录发送时间用于防死循环
-                            const loopKey = `${mapping.meshMac}_${mapping.device}`;
+                            const loopKey = `${mapping.meshMac}_${mapping.device}_${mapping.meshChannel || 1}`;
                             if (!node.lastSyncTime) node.lastSyncTime = {};
                             node.lastSyncTime[loopKey] = Date.now();
                             
@@ -1811,7 +1811,7 @@ module.exports = function(RED) {
                             node.lastSentTime[cacheKey] = now;
                             
                             // 记录发送时间用于防死循环
-                            const loopKey = `${mapping.meshMac}_${mapping.device}`;
+                            const loopKey = `${mapping.meshMac}_${mapping.device}_${mapping.meshChannel || 1}`;
                             if (!node.lastSyncTime) node.lastSyncTime = {};
                             node.lastSyncTime[loopKey] = now;
                             
@@ -1825,7 +1825,7 @@ module.exports = function(RED) {
                     node.debug(`[自定义空调] 处理状态: ${JSON.stringify(state)}, codes存在: ${!!codes}`);
                     
                     // 记录发送时间用于防死循环
-                    const loopKey = `${mapping.meshMac}_${mapping.device}`;
+                    const loopKey = `${mapping.meshMac}_${mapping.device}_${mapping.meshChannel || 1}`;
                     if (!node.lastSyncTime) node.lastSyncTime = {};
                     
                     // 去重处理：记录已处理的命令类型
@@ -2813,14 +2813,14 @@ module.exports = function(RED) {
                     if (matchedAction) {
                         // 防死循环：检查是否刚刚从Mesh发送过来
                         // 使用映射特定的时间戳，避免其他设备的同步影响
-                        const loopKey = `${mapping.meshMac}_${mapping.device}`;
+                        const loopKey = `${mapping.meshMac}_${mapping.device}_${mapping.meshChannel || 1}`;
                         if (!node.lastSyncTime) node.lastSyncTime = {};
-                        if (node.lastSyncTime[loopKey] && Date.now() - node.lastSyncTime[loopKey] < 500) {
+                        if (node.lastSyncTime[loopKey] && Date.now() - node.lastSyncTime[loopKey] < 800) {
                             node.debug(`[防循环] 忽略刚刚同步的帧: ${hexFormatted}`);
                             return;
                         }
                         
-                        node.log(`[自定义码匹配] ${mapping.device}: ${JSON.stringify(matchedAction)}, 帧: ${hexFormatted}`);
+                        node.log(`[自定义码匹配成功] 设备:${mapping.device}, MAC:${mapping.meshMac}, 动作:${JSON.stringify(matchedAction)}`);
                         
                         // 输出调试信息到节点输出端口
                         node.send({

package/nodes/symi-485-config.html

@@ -38,7 +38,7 @@
                 $btn.prop('disabled', true);
                 $select.empty().append('<option value="">搜索中...</option>').show();
                 
-                $.getJSON('/symi-gateway/serial-ports', function(ports) {
+                $.getJSON('symi-gateway/serial-ports', function(ports) {
                     $select.empty();
                     if (ports && ports.length > 0) {
                         $select.append('<option value="">-- 选择串口 --</option>');

package/nodes/symi-device.html

@@ -60,6 +60,7 @@
             
             var loadDevices = function(gatewayId) {
                 if (!gatewayId) {
+                    console.log('[symi-device] 网关ID为空，跳过加载');
                     return;
                 }
                 
@@ -67,11 +68,16 @@
                 var currentValue = deviceSelect.val();
                 
                 deviceSelect.empty();
-                deviceSelect.append('<option value="">-- 选择设备 --</option>');
+                deviceSelect.append('<option value="">加载中...</option>');
                 
-                $.getJSON('/symi-gateway/devices/' + gatewayId)
+                var apiUrl = 'symi-gateway/devices/' + gatewayId;
+                console.log('[symi-device] 加载设备列表, API:', apiUrl);
+                
+                $.getJSON(apiUrl)
                     .done(function(devices) {
-                        console.log('加载设备列表:', devices.length, '个设备');
+                        console.log('[symi-device] 加载成功:', devices ? devices.length : 0, '个设备');
+                        deviceSelect.empty();
+                        deviceSelect.append('<option value="">-- 选择设备 --</option>');
                         if (devices && devices.length > 0) {
                             devices.forEach(function(device) {
                                 var label = device.name + ' (' + device.mac + ')';
@@ -99,8 +105,10 @@
                         
                         deviceSelect.trigger('change');
                     })
-                    .fail(function(err) {
-                        console.log('加载设备失败:', err);
+                    .fail(function(xhr, status, err) {
+                        console.log('[symi-device] 加载设备失败:', status, err, xhr.responseText);
+                        deviceSelect.empty();
+                        deviceSelect.append('<option value="">加载失败，请重试</option>');
                     });
             };
             

package/nodes/symi-gateway.html

@@ -37,7 +37,7 @@
                 $btn.prop('disabled', true).text('搜索中...');
                 $select.empty().append('<option value="">搜索中...</option>');
                 
-                $.getJSON('/symi-gateway/serial-ports', function(ports) {
+                $.getJSON('symi-gateway/serial-ports', function(ports) {
                     $select.empty();
                     if (ports && ports.length > 0) {
                         $select.append('<option value="">-- 选择串口 --</option>');

package/nodes/symi-knx-bridge.js

@@ -760,9 +760,12 @@ module.exports = function(RED) {
                 const destAddr = knxMsg.knx.destination;
                 node.lastKnxAddrSent[destAddr] = Date.now();
                 
-                // knxUltimate官方格式: https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Device
-                // 必须包含: destination, payload, dpt, event
+                // knxUltimate输入格式：topic + destination + payload + dpt + event
+                // topic: 当setTopicType=str时，knxUltimate使用msg.topic作为目标地址
+                // destination: 官方备用字段
+                // 注意：不能包含knx对象，否则会触发knxUltimate的循环引用保护
                 const sendMsg = {
+                    topic: destAddr,
                     destination: destAddr,
                     payload: knxMsg.payload,
                     dpt: knxMsg.dpt || knxMsg.knx.dpt,
@@ -784,7 +787,7 @@ module.exports = function(RED) {
                     timestamp: new Date().toISOString()
                 };
                 
-                node.log(`[Mesh->KNX] 发送: destination=${sendMsg.destination}, payload=${sendMsg.payload}, dpt=${sendMsg.dpt}, event=${sendMsg.event}`);
+                node.log(`[Mesh->KNX] 发送: topic=${sendMsg.topic}, payload=${sendMsg.payload}, dpt=${sendMsg.dpt}`);
                 
                 // 同时发送到两个输出端口（一次send调用）
                 node.send([sendMsg, debugMsg]);

package/nodes/symi-mqtt-sync.html

@@ -59,7 +59,7 @@
                     if (callback) callback();
                     return;
                 }
-                $.getJSON('/symi-gateway/devices/' + gatewayId, function(devices) {
+                $.getJSON('symi-gateway/devices/' + gatewayId, function(devices) {
                     meshDevices = devices || [];
                     if (callback) callback();
                 }).fail(function() {
@@ -76,7 +76,7 @@
                     if (callback) callback();
                     return;
                 }
-                $.getJSON('/symi-mqtt-brand/devices/' + brandConfigId, function(devices) {
+                $.getJSON('symi-mqtt-brand/devices/' + brandConfigId, function(devices) {
                     brandDevices = devices || [];
                     if (callback) callback();
                 }).fail(function() {

package/package.json

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