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

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)
@@ -1585,23 +1599,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,7 +1610,7 @@ Copyright (c) 2025 SYMI 亖米
 ## 关于
 
 **作者**: SYMI 亖米
-**版本**: 1.7.4
+**版本**: 1.7.5
 **协议**: 蓝牙MESH网关（初级版）串口协议V1.0
 **最后更新**: 2025-12-24
 **仓库**: https://github.com/symi-daguo/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() {

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.5",
   "description": "Node-RED节点集合，用于通过TCP/串口连接Symi蓝牙Mesh网关，支持Home Assistant MQTT Discovery自动发现和云端数据同步",
   "main": "nodes/symi-gateway.js",
   "scripts": {