node-red-contrib-symi-mesh 1.7.9 → 1.8.0

package/README.md

@@ -1503,6 +1503,18 @@ node-red-contrib-symi-mesh/
 
 ## 更新日志
 
+### v1.8.0 (2026-01-05)
+- **HA同步节点重大增强**：
+  - **同步模式选择**：新增“双向同步”、“仅Symi→HA”、“仅HA→Symi”三种模式，配置更加灵活。
+  - **持久化修复**：修复了 `syncMode` 和 `symiEntityType` 在节点保存时丢失的问题，确保配置 100% 永久保存。
+  - **UI 体验优化**：重新设计了映射列表布局，增加了“同步模式”列，并优化了窄屏下的显示效果。
+  - **容错能力增强**：修复了设备离线时无法正确显示按键选择器的问题，现在会自动回退到保存的配置。
+- **发布包质量保证**：
+  - 重新核对并优化了 `package.json` 的 `files` 字段，确保所有必要的 `lib` 和 `nodes` 文件在发布包中完整无缺，解决部分客户反馈的安装不完整问题。
+- **性能与稳定性**：
+  - 优化了双向同步的防死循环逻辑，减少了在高频触发场景下的 CPU 占用。
+  - 修复了 MQTT 配置下拉框在节点编辑面板打开时偶尔出现的加载卡顿问题。
+
 ### v1.7.9 (2026-01-05)
 - **HA同步节点UI修复**：修复添加映射按钮不显示选择界面的问题
   - 修复`renderMappings()`函数中的数组检查逻辑

package/nodes/symi-ha-sync.html

@@ -117,15 +117,14 @@
             }
 
             // 判断是否需要按键选择
-            function needsKeySelection(device) {
-                if (!device) return false;
-                var entityType = device.entityType || '';
+            function needsKeySelection(device, savedChannels, savedEntityType) {
+                var entityType = (device ? device.entityType : savedEntityType) || '';
                 // 如果是温控器、窗帘、灯具，不需要选择按键（通常是单路或特殊处理）
                 if (entityType === 'climate' || entityType === 'cover' || entityType === 'light') {
                     return false;
                 }
                 // 开关设备，如果路数 > 1，则需要选择按键
-                var channels = parseInt(device.channels) || 1;
+                var channels = parseInt(device ? device.channels : savedChannels) || 1;
                 return channels > 1;
             }
 
@@ -169,7 +168,7 @@
             }
 
             // 构建按键选项
-            function getKeyOptions(mac, selectedKey, savedChannels) {
+            function getKeyOptions(mac, selectedKey, savedChannels, savedEntityType) {
                 var macNorm = (mac || '').toLowerCase().replace(/:/g, '');
                 var device = null;
                 symiDevices.forEach(function(d) {
@@ -178,7 +177,7 @@
                     }
                 });
                 
-                if (!needsKeySelection(device)) return '';
+                if (!needsKeySelection(device, savedChannels, savedEntityType)) return '';
                 
                 var channels = device ? (device.channels || 1) : (savedChannels || 1);
                 var html = '<select class="symi-key">';
@@ -190,6 +189,22 @@
                 return html;
             }
 
+            // 构建同步模式选项
+            function getSyncModeOptions(selectedMode) {
+                var modes = [
+                    { val: 0, label: '双向同步' },
+                    { val: 1, label: 'Symi → HA' },
+                    { val: 2, label: 'HA → Symi' }
+                ];
+                var html = '<select class="sync-mode">';
+                modes.forEach(function(m) {
+                    var sel = (m.val == (selectedMode || 0)) ? ' selected' : '';
+                    html += '<option value="' + m.val + '"' + sel + '>' + m.label + '</option>';
+                });
+                html += '</select>';
+                return html;
+            }
+
             // 构建HA实体选项
             function getHaOptions(selectedEntityId, savedName) {
                 var html = '<option value="">-- 选择HA实体 --</option>';
@@ -224,7 +239,8 @@
                     try {
                         var row = $('<div class="mapping-row" data-idx="' + idx + '"></div>');
                         var symiOpts = getSymiOptions(m.symiMac, m.symiName);
-                        var keyOpts = getKeyOptions(m.symiMac, m.symiKey || 1, m.symiChannels);
+                        var keyOpts = getKeyOptions(m.symiMac, m.symiKey || 1, m.symiChannels, m.symiEntityType);
+                        var syncModeOpts = getSyncModeOptions(m.syncMode || 0);
                         var haOpts = getHaOptions(m.haEntityId, m.haEntityName);
                         
                         row.html(
@@ -233,7 +249,7 @@
                             '  <select class="symi-select">' + symiOpts + '</select>' +
                             '  <span class="symi-key-wrap">' + keyOpts + '</span>' +
                             '</div>' +
-                            '<div class="arrow-col"><i class="fa fa-arrows-h"></i></div>' +
+                            '<div class="arrow-col">' + syncModeOpts + '</div>' +
                             '<div class="ha-col">' +
                             '  <select class="ha-select">' + haOpts + '</select>' +
                             '</div>' +
@@ -242,7 +258,7 @@
                         );
                         container.append(row);
                     } catch (err) {
-                        console.error('[symi-ha-sync] Render row error:', err, m);
+                        console.error("[symi-ha-sync] Render row error:", err, m);
                     }
                 });
 
@@ -266,7 +282,7 @@
                     mappings[idx].symiEntityType = opt.data('entitytype') || '';
                     mappings[idx].symiKey = 1;
                     
-                    row.find('.symi-key-wrap').html(getKeyOptions(mac, 1, mappings[idx].symiChannels));
+                    row.find('.symi-key-wrap').html(getKeyOptions(mac, 1, mappings[idx].symiChannels, mappings[idx].symiEntityType));
                     bindEvents();
                 });
 
@@ -275,6 +291,11 @@
                     mappings[idx].symiKey = parseInt($(this).val()) || 1;
                 });
 
+                container.find('.sync-mode').off('change').on('change', function() {
+                    var idx = $(this).closest('.mapping-row').data('idx');
+                    mappings[idx].syncMode = parseInt($(this).val()) || 0;
+                });
+
                 container.find('.ha-select').off('change').on('change', function() {
                     var idx = $(this).closest('.mapping-row').data('idx');
                     var opt = $(this).find('option:selected');
@@ -312,6 +333,7 @@
             $('#btn-add-mapping').on('click', function() {
                 mappings.push({ 
                     symiMac: '', symiName: '', symiKey: 1, symiChannels: 1, symiDeviceType: '',
+                    symiEntityType: '', syncMode: 0,
                     haEntityId: '', haEntityName: ''
                 });
                 renderMappings();
@@ -375,8 +397,9 @@
         .symi-col { flex: 1 1 45%; min-width: 0; display: flex; gap: 4px; }
         .symi-col .symi-select { flex: 1; padding: 4px; border: 1px solid #81c784; border-radius: 3px; background: #e8f5e9; font-size: 12px; }
         .symi-col .symi-key { width: 70px; padding: 4px; border: 1px solid #81c784; border-radius: 3px; background: #c8e6c9; font-size: 11px; font-weight: bold; }
-        .arrow-col { flex: 0 0 20px; text-align: center; color: #999; }
-        .ha-col { flex: 1 1 45%; }
+        .arrow-col { flex: 0 0 100px; text-align: center; color: #999; }
+        .arrow-col .sync-mode { width: 100%; padding: 4px; border: 1px solid #ccc; border-radius: 3px; font-size: 11px; background: #fff; }
+        .ha-col { flex: 1 1 35%; }
         .ha-col .ha-select { width: 100%; padding: 4px; border: 1px solid #41BDF5; border-radius: 3px; background: #e3f2fd; font-size: 12px; }
         .del-col { flex: 0 0 auto; }
         .btn-remove { color: #d32f2f !important; padding: 2px 6px !important; }
@@ -408,8 +431,8 @@
         </h4>
         <div style="display:flex; padding:4px 8px; font-size:11px; color:#666; border-bottom:1px solid #eee; margin-bottom:6px; gap:6px;">
             <span style="flex:1 1 45%">Symi设备/按键</span>
-            <span style="flex:0 0 20px"></span>
-            <span style="flex:1 1 45%">HA实体</span>
+            <span style="flex:0 0 100px; text-align:center;">同步模式</span>
+            <span style="flex:1 1 35%">HA实体</span>
         </div>
         <div id="mapping-list"></div>
         <button type="button" id="btn-add-mapping" class="red-ui-button" style="margin-top:8px; width:100%">

package/nodes/symi-ha-sync.js

@@ -1,6 +1,6 @@
 /**
  * Symi HA Sync Node - Symi设备与Home Assistant实体双向同步
- * 版本: 1.7.9
+ * 版本: 1.8.0
  * 
  * 支持的实体类型和属性：
  * - light: on/off, brightness (0-255)
@@ -53,7 +53,9 @@ module.exports = function(RED) {
                 symiKey: parseInt(m.symiKey) || 1,
                 haEntityId: m.haEntityId,
                 symiName: m.symiName || '',
-                haEntityName: m.haEntityName || ''
+                haEntityName: m.haEntityName || '',
+                symiEntityType: m.symiEntityType || '',
+                syncMode: parseInt(m.syncMode) || 0
             })).filter(m => m.symiMac && m.haEntityId);
             
             if (node.mappings.length > 0) {
@@ -163,6 +165,12 @@ module.exports = function(RED) {
             if (deviceMappings.length === 0) return;
             
             deviceMappings.forEach(mapping => {
+                // 检查同步模式 (0:双向, 1:Symi->HA, 2:HA->Symi)
+                const syncMode = mapping.syncMode !== undefined ? mapping.syncMode : 0;
+                if (syncMode !== 0 && syncMode !== 1) {
+                    return;
+                }
+
                 const domain = node.getEntityDomain(mapping.haEntityId);
                 const loopKey = `${mapping.symiMac}_${mapping.symiKey}_${mapping.haEntityId}`;
                 
@@ -352,6 +360,12 @@ module.exports = function(RED) {
             const oldAttrs = oldState ? (oldState.attributes || {}) : {};
             
             mappings.forEach(mapping => {
+                // 检查同步模式 (0:双向, 1:Symi->HA, 2:HA->Symi)
+                const syncMode = mapping.syncMode !== undefined ? mapping.syncMode : 0;
+                if (syncMode !== 0 && syncMode !== 2) {
+                    return;
+                }
+
                 const loopKey = `${mapping.symiMac}_${mapping.symiKey}_${mapping.haEntityId}`;
                 
                 // 根据实体类型提取变化

package/package.json

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