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

package/README.md

@@ -1503,6 +1503,36 @@ node-red-contrib-symi-mesh/
 
 ## 更新日志
 
+### v1.8.1 (2026-01-05)
+- **三合一面板深度集成**：
+  - **子设备选择**：HA同步节点新增三合一子设备选择功能，可分别选择“空调”、“新风”、“地暖”进行独立映射。
+  - **完整属性同步**：支持空调（开关/模式/温度/风速）、新风（开关/风速）、地暖（开关/温度）的全功能双向同步。
+- **配置与文档优化**：
+  - **纯配置同步**：明确HA同步节点为纯配置模式，无需额外连线即可实现双向同步。
+  - **文档更新**：全面更新README，增加三合一配置示例和Config-Only说明。
+- **稳定性修复**：
+  - 修复 Symi→HA 同步时的调试日志重复输出问题。
+  - 增强 HA 事件监听的健壮性，支持多种输入格式。
+- **窗帘双向同步修复**：
+  - **运动状态跟踪**：新增 `coverMoving` 状态跟踪机制，记录窗帘运动的发起方（Symi/HA）和开始时间
+  - **步进反馈过滤**：当 HA 发起窗帘控制时，自动忽略 Mesh 窗帘运动过程中的步进位置反馈，避免干扰
+  - **运动中状态过滤**：当 HA 窗帘处于 `opening`/`closing` 状态时，不同步位置变化到 Mesh，只同步最终位置
+  - **专用防死循环时间**：窗帘使用 30 秒防死循环窗口（普通设备 2 秒），适应窗帘较长的运动时间
+  - **防抖时间优化**：窗帘防抖时间从 500ms 增加到 1500ms，确保位置稳定后再同步
+  - **自动清理机制**：运动状态超时（30秒）自动清理，防止内存泄漏
+
+### 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()`函数中的数组检查逻辑
@@ -1559,80 +1589,6 @@ node-red-contrib-symi-mesh/
   - 完善的节点关闭清理逻辑
   - 防死循环机制增强：双向时间戳检查
 
-### 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协议
-  - 支持自定义码协议
-  - 双向状态同步，2秒防抖防止死循环
-  - 多组映射配置，持久化保存
-  - **反馈选项**：新增"反馈"复选框，控制RS485收码后是否发送反馈码
-  - **Mesh→RS485方向**：
-    - 修复开关控制：只同步配置的通道，避免其他通道变化误触发
-    - 修复空调风速：fanMode变化正确发送fanSendHigh/Mid/Low/Auto码
-    - 修复空调中速(fanMode=2)事件触发
-    - 修复空调开关：去重处理，避免switch和acSwitch重复发送
-    - 添加自动风速(fanSendAuto/fanRecvAuto)配置支持
-  - **RS485→Mesh方向**：
-    - 修复收码匹配触发Mesh实体状态变化
-    - 自定义开关recvOn/recvOff正确触发开关动作
-    - 自定义空调acRecvOn/acRecvOff/fanRecvHigh等正确触发空调控制
-  - **事件系统优化**：
-    - DeviceManager事件添加完整字段（isUserControl、isSceneExecution等）
-    - 用户控制事件允许绕过首次状态缓存
-    - 修复单路温控器开关事件丢失问题
-    - fanMode事件同时发送acFanSpeed别名字段
-  - **防死循环优化**：
-    - 使用映射特定时间戳，避免不同设备同步互相影响
-    - Mesh→RS485和RS485→Mesh双向都记录同步时间
-    - 500ms冷却时间防止状态回环
-    - 空调命令去重（同类命令只发送一次）
-  - **生产稳定性**：
-    - 初始化延迟从10秒缩短为5秒
-    - 详细日志改为debug级别，减少生产环境日志量
-    - 保留关键同步日志便于问题排查
-  - **UI优化**：
-    - 自定义码折叠按钮移到同一行，减少占用空间
-    - 修复MAC地址大小写匹配问题
-    - 添加自动风速配置框（发自动/收自动）
-- **RS485-to-RS485空调桥接**：SYMI空调面板与中弘VRF系统双向同步
-  - 支持SYMI 485空调面板协议（7E...7D帧格式，CRC8校验）
-  - 支持中弘VRF空调协议（求和校验，功能码0x31-0x34控制，0x50查询）
-  - 双向状态同步：SYMI面板操作→中弘VRF执行，中弘状态→SYMI面板显示
-
-### v1.7.1 (2025-12-21)
-- **自定义协议全面修复**：完善自定义开关/窗帘/空调双向同步
-  - **空调风速控制**：修复风速变化事件触发机制
-    - 添加fanMode字段支持（mesh空调实际使用的字段）
-    - 修复DeviceInfo事件触发，正确发送device-state-changed事件
-    - 支持风速值1-4（1=高, 2=中, 3=低, 4=自动）
-    - 自动识别温控器0x02消息中的风速控制
-  - **空调开关控制**：修复开关状态变化事件触发
-    - 温控器0x02开关消息正确触发device-state-changed事件
-    - 自定义空调开关码（acSendOn/acSendOff）正确发送到RS485总线
-  - **RS485收码匹配**：修复hexStr格式处理
-    - hexStr完全去掉空格，确保标准格式（如030610330001BD27）
-    - 用户录入支持带空格格式（如01 06 10 34 00 01 0D 04）
-    - 自动匹配并触发mesh实体动作
-  - **事件系统优化**：
-    - DeviceInfo添加manager引用，正确触发事件
-    - 修复事件名称不匹配问题（stateChange -> device-state-changed）
-    - 确保所有自定义码双向同步正常
-  - **队列处理**：
-    - 命令队列顺序处理，防止并发冲突
-    - 500ms防死循环机制
-    - 队列限制100条，防止内存溢出
-  - **调试日志**：添加详细调试日志，方便排查问题
-
 ## 许可证
 
 MIT License
@@ -1644,7 +1600,7 @@ Copyright (c) 2025 SYMI 亖米
 ## 关于
 
 **作者**: SYMI 亖米
-**版本**: 1.7.9
+**版本**: 1.8.1
 **协议**: 蓝牙MESH网关（初级版）串口协议V1.0
 **最后更新**: 2026-01-05
 **仓库**: https://github.com/symi-daguo/node-red-contrib-symi-mesh

package/nodes/symi-ha-sync.html

@@ -117,15 +117,20 @@
             }
 
             // 判断是否需要按键选择
-            function needsKeySelection(device) {
-                if (!device) return false;
-                var entityType = device.entityType || '';
+            function needsKeySelection(device, savedChannels, savedEntityType) {
+                var entityType = (device ? device.entityType : savedEntityType) || '';
+                
+                // 三合一面板必须选择子设备
+                if (entityType === 'three_in_one') {
+                    return true;
+                }
+                
                 // 如果是温控器、窗帘、灯具，不需要选择按键（通常是单路或特殊处理）
                 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;
             }
 
@@ -133,6 +138,7 @@
             function getDeviceTypeLabel(device) {
                 if (!device) return '';
                 var entityType = device.entityType || '';
+                if (entityType === 'three_in_one') return ' [三合一]';
                 if (entityType === 'climate') return ' [温控器]';
                 if (entityType === 'cover') return ' [窗帘]';
                 if (entityType === 'light') return ' [灯具]';
@@ -169,7 +175,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,14 +184,47 @@
                     }
                 });
                 
-                if (!needsKeySelection(device)) return '';
+                var entityType = (device ? device.entityType : savedEntityType) || '';
+                if (!needsKeySelection(device, savedChannels, savedEntityType)) return '';
                 
-                var channels = device ? (device.channels || 1) : (savedChannels || 1);
                 var html = '<select class="symi-key">';
-                for (var i = 1; i <= channels; i++) {
-                    var sel = (i == selectedKey) ? ' selected' : '';
-                    html += '<option value="' + i + '"' + sel + '>按键' + i + '</option>';
+                
+                // 三合一设备特殊处理
+                if (entityType === 'three_in_one') {
+                    var opts = [
+                        {v: 'aircon', l: '空调'},
+                        {v: 'fresh_air', l: '新风'},
+                        {v: 'floor_heating', l: '地暖'}
+                    ];
+                    opts.forEach(function(o) {
+                        var sel = (o.v == selectedKey) ? ' selected' : '';
+                        html += '<option value="' + o.v + '"' + sel + '>' + o.l + '</option>';
+                    });
+                } else {
+                    // 多路开关
+                    var channels = parseInt(device ? (device.channels || 1) : (savedChannels || 1)) || 1;
+                    for (var i = 1; i <= channels; i++) {
+                        var sel = (i == selectedKey) ? ' selected' : '';
+                        html += '<option value="' + i + '"' + sel + '>按键' + i + '</option>';
+                    }
                 }
+                
+                html += '</select>';
+                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;
             }
@@ -224,7 +263,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 +273,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 +282,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 +306,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 +315,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,9 +357,12 @@
             $('#btn-add-mapping').on('click', function() {
                 mappings.push({ 
                     symiMac: '', symiName: '', symiKey: 1, symiChannels: 1, symiDeviceType: '',
+                    symiEntityType: '', syncMode: 0,
                     haEntityId: '', haEntityName: ''
                 });
                 renderMappings();
+                var list = $('#mapping-list');
+                list.scrollTop(list.prop('scrollHeight'));
             });
 
             // 配置变化时重新加载
@@ -375,8 +423,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 +457,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.1
  * 
  * 支持的实体类型和属性：
  * - light: on/off, brightness (0-255)
@@ -15,10 +15,14 @@ module.exports = function(RED) {
     
     // 常量定义
     const LOOP_PREVENTION_MS = 2000;  // 防死循环时间窗口
-    const DEBOUNCE_MS = 500;          // 防抖时间（窗帘/调光用）
+    const DEBOUNCE_MS = 500;          // 防抖时间（调光用）
     const MAX_QUEUE_SIZE = 100;
     const CLEANUP_INTERVAL_MS = 60000;
     const TIMESTAMP_EXPIRE_MS = 60000;
+    
+    // 窗帘专用常量
+    const COVER_LOOP_PREVENTION_MS = 30000; // 30秒防死循环
+    const COVER_DEBOUNCE_MS = 1500;         // 1.5秒防抖
 
     // Mesh属性类型
     const ATTR_SWITCH = 0x02;
@@ -28,6 +32,14 @@ module.exports = function(RED) {
     const ATTR_TARGET_TEMP = 0x1B;
     const ATTR_FAN_MODE = 0x1C;
     const ATTR_CLIMATE_MODE = 0x1D;
+    
+    // 三合一属性
+    const ATTR_FRESH_AIR_SWITCH = 0x68;
+    const ATTR_FRESH_AIR_MODE = 0x69;
+    const ATTR_FRESH_AIR_SPEED = 0x6A;
+    const ATTR_FLOOR_HEATING_SWITCH = 0x6B;
+    const ATTR_FLOOR_HEATING_TEMP = 0x6C;
+    const ATTR_THREE_IN_ONE = 0x94;
 
     // 空调模式映射
     const AC_MODE_TO_HA = { 1: 'cool', 2: 'heat', 3: 'fan_only', 4: 'dry' };
@@ -48,13 +60,23 @@ module.exports = function(RED) {
         // 解析映射配置
         try {
             const rawMappings = JSON.parse(config.mappings || '[]');
-            node.mappings = rawMappings.map(m => ({
-                symiMac: m.symiMac,
-                symiKey: parseInt(m.symiKey) || 1,
-                haEntityId: m.haEntityId,
-                symiName: m.symiName || '',
-                haEntityName: m.haEntityName || ''
-            })).filter(m => m.symiMac && m.haEntityId);
+            node.mappings = rawMappings.map(m => {
+                // symiKey可能是数字（按键索引）或字符串（三合一子设备ID）
+                let key = m.symiKey;
+                if (typeof key !== 'string' || !isNaN(parseInt(key))) {
+                    key = parseInt(key) || 1;
+                }
+                
+                return {
+                    symiMac: m.symiMac,
+                    symiKey: key,
+                    haEntityId: m.haEntityId,
+                    symiName: m.symiName || '',
+                    haEntityName: m.haEntityName || '',
+                    symiEntityType: m.symiEntityType || '',
+                    syncMode: parseInt(m.syncMode) || 0
+                };
+            }).filter(m => m.symiMac && m.haEntityId);
             
             if (node.mappings.length > 0) {
                 node.log(`[HA同步] 已加载 ${node.mappings.length} 个映射`);
@@ -69,6 +91,7 @@ module.exports = function(RED) {
         node.lastSymiToHa = {};
         node.lastHaToSymi = {};
         node.pendingDebounce = {};  // 防抖定时器
+        node.coverMoving = {};      // 窗帘运动状态跟踪 { loopKey: { direction: 'symi'|'ha', startTime, targetPosition } }
         
         node.status({ fill: 'yellow', shape: 'ring', text: '初始化中' });
 
@@ -104,6 +127,13 @@ module.exports = function(RED) {
                     delete node.lastHaToSymi[key];
                 }
             }
+            
+            // 清理过期的窗帘运动状态
+            for (const key in node.coverMoving) {
+                if (now - node.coverMoving[key].timestamp > COVER_LOOP_PREVENTION_MS) {
+                    delete node.coverMoving[key];
+                }
+            }
         }, CLEANUP_INTERVAL_MS);
 
         // 防死循环检查 - 双向时间戳检查
@@ -163,6 +193,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}`;
                 
@@ -204,24 +240,116 @@ module.exports = function(RED) {
                             syncData = node.handleClimateModeChange(device, mapping, state);
                         }
                         break;
+
+                    case ATTR_THREE_IN_ONE: // 0x94 三合一全量状态
+                    case ATTR_FRESH_AIR_SWITCH: // 0x68 新风开关
+                    case ATTR_FRESH_AIR_MODE: // 0x69 新风模式
+                    case ATTR_FRESH_AIR_SPEED: // 0x6A 新风风速
+                    case ATTR_FLOOR_HEATING_SWITCH: // 0x6B 地暖开关
+                    case ATTR_FLOOR_HEATING_TEMP: // 0x6C 地暖温度
+                        syncData = node.handleThreeInOneChange(device, mapping, state, attrType);
+                        break;
                 }
                 
                 if (syncData) {
-                    if (node.shouldPreventSync('symi-to-ha', loopKey)) {
-                        node.debug(`[Symi->HA] 跳过(防死循环): ${loopKey}`);
-                        return;
-                    }
+                    // 支持返回数组（用于三合一同时同步多个属性）
+                    const syncDataList = Array.isArray(syncData) ? syncData : [syncData];
                     
-                    node.queueCommand({
-                        direction: 'symi-to-ha',
-                        mapping: mapping,
-                        syncData: syncData,
-                        key: loopKey
+                    syncDataList.forEach(data => {
+                        if (node.shouldPreventSync('symi-to-ha', loopKey)) {
+                            node.debug(`[Symi->HA] 跳过(防死循环): ${loopKey} ${data.type}`);
+                            return;
+                        }
+                        
+                        node.queueCommand({
+                            direction: 'symi-to-ha',
+                            mapping: mapping,
+                            syncData: data,
+                            key: loopKey
+                        });
                     });
                 }
             });
         };
 
+        // 处理三合一状态变化
+        node.handleThreeInOneChange = function(device, mapping, state, attrType) {
+            const subType = mapping.symiKey; // 'aircon', 'fresh_air', 'floor_heating'
+            
+            // 1. 空调部分 (通常通过0x94或标准温控指令更新)
+            if (subType === 'aircon') {
+                // 如果是标准温控属性更新，已经在switch case中处理了
+                // 这里主要处理0x94带来的全量更新
+                if (attrType === ATTR_THREE_IN_ONE) {
+                    // 此时state已经包含了所有更新
+                    // 需要检查哪些属性变了，但这里只能返回一个syncData
+                    // 我们可以返回一个特殊对象，或者分别检查
+                    // 为简化，这里假设HA端会处理部分更新，或者我们按优先级返回
+                    
+                    // 检查开关
+                    if (state.climateSwitch !== undefined) {
+                         // 注意：这里需要比对旧状态，但在handleSymiStateChange中难以获取旧状态
+                         // 我们可以利用node.queueCommand的去重机制，发送所有可能的状态
+                         // 但这样会产生大量流量。
+                         // 实际上DeviceManager触发事件时，如果是0x94，是全量更新。
+                         // 我们可以只处理核心属性。
+                         // 更好的方式是：在device-manager中，0x94更新会触发一次事件。
+                         // 这里我们返回一个复合对象，或者由上层逻辑拆分。
+                         // 由于syncData只能是一个对象，我们优先同步开关，然后是模式/温度
+                    }
+                }
+                // 由于0x94更新时，device-manager已经更新了state
+                // 我们可以直接从state读取当前值
+                
+                // 构造空调状态
+                // 这里我们可能需要多次调用queueCommand，但handle函数只能返回一个
+                // 解决方案：handleSymiStateChange支持返回数组
+                return [
+                    { type: 'switch', value: state.climateSwitch },
+                    { type: 'temperature', value: state.targetTemp },
+                    { type: 'hvac_mode', value: AC_MODE_TO_HA[state.climateMode] || 'off', meshValue: state.climateMode },
+                    { type: 'fan_mode', value: FAN_MODE_TO_HA[state.fanMode] || 'auto', meshValue: state.fanMode }
+                ];
+            }
+            
+            // 2. 新风部分
+            if (subType === 'fresh_air') {
+                // 新风开关 (0x68或0x94)
+                if (attrType === ATTR_FRESH_AIR_SWITCH || attrType === ATTR_THREE_IN_ONE) {
+                    if (state.freshAirSwitch !== undefined) {
+                        return { type: 'switch', value: state.freshAirSwitch };
+                    }
+                }
+                // 新风风速 (0x6A或0x94)
+                if (attrType === ATTR_FRESH_AIR_SPEED || attrType === ATTR_THREE_IN_ONE) {
+                    if (state.freshAirSpeed !== undefined) {
+                        return { type: 'fan_mode', value: FAN_MODE_TO_HA[state.freshAirSpeed] || 'auto', meshValue: state.freshAirSpeed };
+                    }
+                }
+                // 新风模式 (0x69或0x94)
+                // 目前HA Fan实体通常只支持on/off和speed，mode可能不支持或映射到preset_mode
+                // 暂时忽略模式，或视需求添加
+            }
+            
+            // 3. 地暖部分
+            if (subType === 'floor_heating') {
+                // 地暖开关 (0x6B或0x94)
+                if (attrType === ATTR_FLOOR_HEATING_SWITCH || attrType === ATTR_THREE_IN_ONE) {
+                    if (state.floorHeatingSwitch !== undefined) {
+                        return { type: 'switch', value: state.floorHeatingSwitch };
+                    }
+                }
+                // 地暖温度 (0x6C或0x94)
+                if (attrType === ATTR_FLOOR_HEATING_TEMP || attrType === ATTR_THREE_IN_ONE) {
+                    if (state.floorHeatingTemp !== undefined) {
+                        return { type: 'temperature', value: state.floorHeatingTemp };
+                    }
+                }
+            }
+            
+            return null;
+        };
+
         // 处理开关状态变化
         node.handleSwitchChange = function(device, mapping, state) {
             let isOn = false;
@@ -249,11 +377,24 @@ module.exports = function(RED) {
             return { type: 'brightness', value: haBrightness, meshValue: brightness };
         };
 
-        // 处理窗帘变化（带防抖）
+        // 处理窗帘变化（带防抖，避免步进反馈干扰）
         node.handleCurtainChange = function(device, mapping, state, attrType) {
             const domain = node.getEntityDomain(mapping.haEntityId);
             if (domain !== 'cover') return null;
             
+            const loopKey = `${mapping.symiMac}_${mapping.symiKey}_${mapping.haEntityId}`;
+            
+            // 检查是否是HA发起的运动，如果是则忽略Mesh的位置反馈（步进码）
+            if (node.coverMoving[loopKey] && node.coverMoving[loopKey].direction === 'ha') {
+                const elapsed = Date.now() - node.coverMoving[loopKey].startTime;
+                if (elapsed < COVER_LOOP_PREVENTION_MS) {
+                    node.debug(`[Symi->HA] 窗帘忽略(HA发起运动中): ${loopKey}`);
+                    return null;  // 忽略HA发起运动期间的Mesh反馈
+                } else {
+                    delete node.coverMoving[loopKey];  // 超时清理
+                }
+            }
+            
             // 窗帘位置变化 - 使用防抖，只同步最终位置
             if (attrType === ATTR_CURTAIN_POSITION) {
                 const position = state.curtainPosition !== undefined ? state.curtainPosition : device.state.curtainPosition;
@@ -265,27 +406,34 @@ module.exports = function(RED) {
                     clearTimeout(node.pendingDebounce[debounceKey]);
                 }
                 
+                // 标记Symi发起的运动
+                node.coverMoving[loopKey] = { direction: 'symi', startTime: Date.now(), targetPosition: position };
+                
                 // 延迟同步，等待位置稳定
                 node.pendingDebounce[debounceKey] = setTimeout(() => {
                     delete node.pendingDebounce[debounceKey];
-                    const loopKey = `${mapping.symiMac}_${mapping.symiKey}_${mapping.haEntityId}`;
-                    if (!node.shouldPreventSync('symi-to-ha', loopKey)) {
-                        node.queueCommand({
-                            direction: 'symi-to-ha',
-                            mapping: mapping,
-                            syncData: { type: 'position', value: position },
-                            key: loopKey
-                        });
-                    }
-                }, DEBOUNCE_MS);
+                    // 运动结束，清理状态
+                    delete node.coverMoving[loopKey];
+                    
+                    // 直接入队，跳过常规防死循环检查（窗帘有专门的运动状态跟踪）
+                    node.queueCommand({
+                        direction: 'symi-to-ha',
+                        mapping: mapping,
+                        syncData: { type: 'position', value: position },
+                        key: loopKey,
+                        skipLoopCheck: true
+                    });
+                }, COVER_DEBOUNCE_MS);
                 
                 return null;  // 不立即同步
             }
             
-            // 窗帘运行状态 - 可选同步动作
+            // 窗帘运行状态 - 同步停止动作
             if (attrType === ATTR_CURTAIN_STATUS) {
                 const action = state.curtainAction || device.state.curtainAction;
                 if (action === 'stopped') {
+                    // 停止时清理运动状态
+                    delete node.coverMoving[loopKey];
                     return { type: 'curtain_stop' };
                 }
             }
@@ -325,7 +473,16 @@ module.exports = function(RED) {
         
         // 方式A: 通过Input输入 (server-state-changed节点)
         node.on('input', function(msg) {
-            if (msg.data && msg.data.entity_id && msg.data.new_state) {
+            if (msg.payload && (msg.payload.entity_id || (msg.data && msg.data.entity_id))) {
+                const entityId = msg.payload.entity_id || msg.data.entity_id;
+                const newState = msg.payload.new_state || msg.data.new_state;
+                const oldState = msg.payload.old_state || msg.data.old_state;
+                
+                if (entityId && newState) {
+                    node.handleHaStateChange(entityId, newState, oldState);
+                }
+            } else if (msg.data && msg.data.entity_id && msg.data.new_state) {
+                // 兼容旧格式
                 node.handleHaStateChange(msg.data.entity_id, msg.data.new_state, msg.data.old_state);
             }
         });
@@ -333,12 +490,15 @@ module.exports = function(RED) {
         // 方式B: 尝试订阅HA Server事件总线
         if (node.haServer && node.haServer.eventBus) {
             node.haEventHandler = (evt) => {
+                // node.debug(`[HA事件] type=${evt.event_type}, data=${JSON.stringify(evt.data)}`);
                 if (evt && evt.event_type === 'state_changed' && evt.data) {
                     node.handleHaStateChange(evt.data.entity_id, evt.data.new_state, evt.data.old_state);
                 }
             };
             node.haServer.eventBus.on('ha_events:all', node.haEventHandler);
             node.log('[HA同步] 已订阅HA事件总线');
+        } else {
+            node.warn('[HA同步] 未能订阅HA事件总线，请确保HA节点配置正确且已连接');
         }
 
         node.handleHaStateChange = function(entityId, newState, oldState) {
@@ -352,6 +512,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}`;
                 
                 // 根据实体类型提取变化
@@ -385,17 +551,43 @@ module.exports = function(RED) {
                         break;
                         
                     case 'cover':
-                        // 窗帘位置
+                        const coverLoopKey = `${mapping.symiMac}_${mapping.symiKey}_${mapping.haEntityId}`;
+                        
+                        // 检查是否是Symi发起的运动，如果是则忽略HA的位置反馈
+                        if (node.coverMoving[coverLoopKey] && node.coverMoving[coverLoopKey].direction === 'symi') {
+                            const elapsed = Date.now() - node.coverMoving[coverLoopKey].startTime;
+                            if (elapsed < COVER_LOOP_PREVENTION_MS) {
+                                node.debug(`[HA->Symi] 窗帘忽略(Symi发起运动中): ${coverLoopKey}`);
+                                break;  // 忽略Symi发起运动期间的HA反馈
+                            }
+                        }
+                        
+                        // 运动中状态(opening/closing)不同步位置，避免步进反馈干扰
+                        if (newState.state === 'opening' || newState.state === 'closing') {
+                            node.debug(`[HA->Symi] 窗帘运动中，跳过位置同步: ${newState.state}`);
+                            break;
+                        }
+                        
+                        // 窗帘位置变化 - 只在停止状态时同步
                         if (attrs.current_position !== undefined) {
                             if (!oldState || oldAttrs.current_position !== attrs.current_position) {
+                                // 标记HA发起的运动
+                                node.coverMoving[coverLoopKey] = { 
+                                    direction: 'ha', 
+                                    startTime: Date.now(), 
+                                    targetPosition: attrs.current_position 
+                                };
                                 syncDataList.push({ type: 'position', value: attrs.current_position });
                             }
                         }
-                        // 窗帘动作
+                        
+                        // 窗帘动作 - open/closed 状态变化
                         if (newState.state !== oldState?.state) {
                             if (newState.state === 'open') {
+                                node.coverMoving[coverLoopKey] = { direction: 'ha', startTime: Date.now() };
                                 syncDataList.push({ type: 'curtain_action', value: 'open' });
                             } else if (newState.state === 'closed') {
+                                node.coverMoving[coverLoopKey] = { direction: 'ha', startTime: Date.now() };
                                 syncDataList.push({ type: 'curtain_action', value: 'close' });
                             }
                         }
@@ -405,7 +597,11 @@ module.exports = function(RED) {
                         // 开关状态
                         if (!oldState || newState.state !== oldState.state) {
                             const isOn = newState.state !== 'off' && newState.state !== 'unavailable';
-                            syncDataList.push({ type: 'switch', value: isOn });
+                            // 仅当状态从off变on，或on变off时才同步开关
+                            if ((oldState && oldState.state === 'off' && newState.state !== 'off') || 
+                                (oldState && oldState.state !== 'off' && newState.state === 'off')) {
+                                syncDataList.push({ type: 'switch', value: isOn });
+                            }
                         }
                         // 目标温度
                         if (attrs.temperature !== undefined) {
@@ -414,9 +610,10 @@ module.exports = function(RED) {
                             }
                         }
                         // HVAC模式
-                        if (attrs.hvac_mode !== undefined || newState.state !== oldState?.state) {
+                        // 过滤掉off模式的变化，因为off已经由开关状态处理
+                        if (newState.state !== 'off' && (attrs.hvac_mode !== undefined || newState.state !== oldState?.state)) {
                             const hvacMode = attrs.hvac_mode || newState.state;
-                            if (!oldState || (oldAttrs.hvac_mode || oldState.state) !== hvacMode) {
+                            if (hvacMode !== 'off' && (!oldState || (oldAttrs.hvac_mode || oldState.state) !== hvacMode)) {
                                 const meshMode = HA_TO_AC_MODE[hvacMode];
                                 if (meshMode !== undefined) {
                                     syncDataList.push({ type: 'hvac_mode', value: meshMode });
@@ -457,7 +654,9 @@ module.exports = function(RED) {
                 
                 // 队列同步命令
                 syncDataList.forEach(syncData => {
-                    if (node.shouldPreventSync('ha-to-symi', loopKey)) {
+                    // 窗帘使用专门的运动状态跟踪，不使用常规防死循环
+                    const isCover = domain === 'cover';
+                    if (!isCover && node.shouldPreventSync('ha-to-symi', loopKey)) {
                         node.debug(`[HA->Symi] 跳过(防死循环): ${loopKey} ${syncData.type}`);
                         return;
                     }
@@ -466,7 +665,8 @@ module.exports = function(RED) {
                         direction: 'ha-to-symi',
                         mapping: mapping,
                         syncData: syncData,
-                        key: loopKey
+                        key: loopKey,
+                        skipLoopCheck: isCover  // 窗帘跳过常规防死循环检查
                     });
                 });
             });
@@ -571,8 +771,9 @@ module.exports = function(RED) {
                             service = 'set_fan_mode';
                             serviceData.fan_mode = syncData.value;
                         } else if (domain === 'fan') {
+                            // 区分新风和普通风扇
+                            // 如果是新风且HA实体是fan
                             service = 'set_percentage';
-                            // 风速档位转百分比
                             const percentMap = { high: 100, medium: 66, low: 33, auto: 50 };
                             serviceData.percentage = percentMap[syncData.value] || 50;
                         }
@@ -594,7 +795,8 @@ module.exports = function(RED) {
                 
                 node.log(`[Symi->HA] ${mapping.symiName || mapping.symiMac} -> ${mapping.haEntityId}: ${syncData.type}=${JSON.stringify(syncData.value)}`);
                 
-                // 输出到debug
+                // 仅输出到debug，不再重复send
+                /*
                 node.send({
                     topic: 'ha-sync/symi-to-ha',
                     payload: {
@@ -607,6 +809,7 @@ module.exports = function(RED) {
                         timestamp: Date.now()
                     }
                 });
+                */
                 
             } catch (err) {
                 node.error(`[Symi->HA] 调用失败: ${err.message}`);
@@ -678,7 +881,8 @@ module.exports = function(RED) {
                 
                 node.log(`[HA->Symi] ${mapping.haEntityId} -> ${device.name || mapping.symiMac}: ${syncData.type}=${JSON.stringify(syncData.value)}`);
                 
-                // 输出到debug
+                // 仅输出到debug，不再重复send
+                /*
                 node.send({
                     topic: 'ha-sync/ha-to-symi',
                     payload: {
@@ -692,12 +896,82 @@ module.exports = function(RED) {
                         timestamp: Date.now()
                     }
                 });
+                */
                 
             } catch (err) {
                 node.error(`[HA->Symi] 控制失败: ${err.message}`);
             }
         };
 
+        // ========== 执行 三合一控制 ==========
+        node.syncThreeInOne = async function(cmd, device, networkAddr) {
+            const { mapping, syncData } = cmd;
+            const subType = mapping.symiKey;
+            
+            try {
+                let attrType, param;
+                
+                if (subType === 'aircon') {
+                    // 空调控制
+                    switch (syncData.type) {
+                        case 'switch':
+                            attrType = ATTR_SWITCH;
+                            param = [syncData.value ? 0x02 : 0x01];
+                            break;
+                        case 'temperature':
+                            attrType = ATTR_TARGET_TEMP;
+                            param = [syncData.value];
+                            break;
+                        case 'hvac_mode':
+                            attrType = ATTR_CLIMATE_MODE;
+                            // HA mode -> Mesh mode
+                            const haToMeshMode = { cool: 1, heat: 2, fan_only: 3, dry: 4, off: 0 };
+                            param = [haToMeshMode[syncData.value] || 1];
+                            break;
+                        case 'fan_mode':
+                            attrType = ATTR_FAN_MODE;
+                            // HA fan -> Mesh fan
+                            const haToMeshFan = { high: 1, medium: 2, low: 3, auto: 4 };
+                            param = [haToMeshFan[syncData.value] || 4];
+                            break;
+                    }
+                } else if (subType === 'fresh_air') {
+                    // 新风控制
+                    switch (syncData.type) {
+                        case 'switch':
+                            attrType = ATTR_FRESH_AIR_SWITCH;
+                            param = [syncData.value ? 0x02 : 0x01];
+                            break;
+                        case 'fan_mode':
+                            attrType = ATTR_FRESH_AIR_SPEED;
+                            const haToMeshFan = { high: 1, medium: 2, low: 3, auto: 4 };
+                            param = [haToMeshFan[syncData.value] || 4];
+                            break;
+                    }
+                } else if (subType === 'floor_heating') {
+                    // 地暖控制
+                    switch (syncData.type) {
+                        case 'switch':
+                            attrType = ATTR_FLOOR_HEATING_SWITCH;
+                            param = [syncData.value ? 0x02 : 0x01];
+                            break;
+                        case 'temperature':
+                            attrType = ATTR_FLOOR_HEATING_TEMP;
+                            param = [syncData.value];
+                            break;
+                    }
+                }
+                
+                if (attrType && param) {
+                    await gateway.sendControl(networkAddr, attrType, param);
+                    node.log(`[HA->Symi] ${mapping.haEntityId} -> ${mapping.symiName}(${subType}): ${syncData.type}=${JSON.stringify(syncData.value)}`);
+                }
+                
+            } catch (err) {
+                node.error(`[HA->Symi] 三合一控制失败: ${err.message}`);
+            }
+        };
+
         // ========== 节点关闭 ==========
         node.on('close', function(done) {
             if (node.cleanupInterval) {
@@ -708,6 +982,7 @@ module.exports = function(RED) {
                 clearTimeout(node.pendingDebounce[key]);
             }
             node.pendingDebounce = {};
+            node.coverMoving = {};  // 清理窗帘运动状态
             
             if (gateway) {
                 gateway.removeListener('device-state-changed', node.handleSymiStateChange);
@@ -725,7 +1000,7 @@ module.exports = function(RED) {
     // ========== HTTP API ==========
     
     // 加载Symi设备
-    RED.httpAdmin.get('/symi-ha-sync/symi-devices/:id', function(req, res) {
+    RED.httpAdmin.get('/symi-ha-sync/symi-devices/:id', RED.auth.needsPermission('symi-ha-sync.read'), function(req, res) {
         const mqttNode = RED.nodes.getNode(req.params.id);
         if (!mqttNode || !mqttNode.gateway) {
             return res.json([]);

package/package.json

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