node-red-contrib-symi-mesh 1.6.6 → 1.6.8

package/nodes/symi-485-config.js

@@ -6,6 +6,37 @@
 const { SerialPort } = require('serialport');
 const net = require('net');
 
+// 全局禁用 Happy Eyeballs 算法，防止 AggregateError 导致 Node-RED 崩溃
+// 这会影响所有使用 net.Socket 的模块（包括第三方模块如 KNX Ultimate）
+if (typeof net.setDefaultAutoSelectFamily === 'function') {
+    net.setDefaultAutoSelectFamily(false);
+}
+
+// 全局未捕获异常处理 - 防止网络错误导致 Node-RED 崩溃
+if (!global._symiErrorHandlerInstalled) {
+    global._symiErrorHandlerInstalled = true;
+    
+    process.on('uncaughtException', (err) => {
+        // 网络相关错误不崩溃
+        const netErrors = ['ECONNREFUSED', 'ECONNRESET', 'ETIMEDOUT', 'ENETUNREACH', 'EHOSTUNREACH', 'ENOTFOUND'];
+        if (err && err.code && netErrors.includes(err.code)) {
+            console.error('[symi] 网络错误已捕获，继续运行:', err.message);
+            return; // 不崩溃
+        }
+        // AggregateError
+        if (err && (err.name === 'AggregateError' || (err.errors && Array.isArray(err.errors)))) {
+            console.error('[symi] AggregateError已捕获:', err.message);
+            return; // 不崩溃
+        }
+        // 其他错误打印但不崩溃（保护Node-RED）
+        console.error('[symi] 未捕获异常:', err);
+    });
+    
+    process.on('unhandledRejection', (reason) => {
+        console.error('[symi] Promise rejection:', reason?.message || reason);
+    });
+}
+
 module.exports = function(RED) {
     
     function SymiRS485ConfigNode(config) {
@@ -114,7 +145,7 @@ module.exports = function(RED) {
 
                     node.client.on('connect', () => {
                         node.connected = true;
-                        node.warn(`[RS485] TCP已连接: ${node.host}:${node.port}`);
+                        node.log(`[RS485] TCP已连接: ${node.host}:${node.port}`);
                         node.emit('connected');
                     });
 
@@ -151,9 +182,13 @@ module.exports = function(RED) {
                         }
                     });
 
-                    // 使用try-catch包装connect，防止AggregateError导致崩溃
+                    // 使用family:4强制IPv4，避免Node.js 18+ Happy Eyeballs导致AggregateError
                     try {
-                        node.client.connect(node.port, node.host);
+                        node.client.connect({
+                            port: node.port,
+                            host: node.host,
+                            family: 4  // 强制IPv4，避免IPv6连接失败导致AggregateError
+                        });
                     } catch (connectErr) {
                         node.error(`RS485 TCP连接异常: ${connectErr.message}`);
                     }

package/nodes/symi-gateway.js

@@ -2,36 +2,36 @@
  * Symi Gateway Configuration Node
  */
 
+const net = require('net');
 const TCPClient = require('../lib/tcp-client');
 const SerialClient = require('../lib/serial-client');
 const { DeviceManager } = require('../lib/device-manager');
 const { ProtocolHandler, parseStatusEvent, OP_RESP_DEVICE_LIST } = require('../lib/protocol');
 
-// 全局异常处理 - 防止AggregateError等网络错误导致Node-RED崩溃
-// 只在模块首次加载时设置一次
-if (!global._symiGatewayErrorHandlerSet) {
-    global._symiGatewayErrorHandlerSet = true;
+// 全局禁用 Happy Eyeballs 算法
+if (typeof net.setDefaultAutoSelectFamily === 'function') {
+    net.setDefaultAutoSelectFamily(false);
+}
+
+// 全局未捕获异常处理 - 防止网络错误导致 Node-RED 崩溃
+if (!global._symiErrorHandlerInstalled) {
+    global._symiErrorHandlerInstalled = true;
     
     process.on('uncaughtException', (err) => {
-        // 只处理网络相关的错误，其他错误继续抛出
-        if (err.name === 'AggregateError' || 
-            (err.code && ['ECONNREFUSED', 'ECONNRESET', 'ETIMEDOUT', 'ENETUNREACH', 'EHOSTUNREACH'].includes(err.code))) {
-            console.error('[symi-gateway] 网络异常已捕获，避免崩溃:', err.message || err);
-            // 不重新抛出，防止崩溃
-        } else {
-            // 非网络错误，继续原有行为
-            throw err;
+        const netErrors = ['ECONNREFUSED', 'ECONNRESET', 'ETIMEDOUT', 'ENETUNREACH', 'EHOSTUNREACH', 'ENOTFOUND', 'EADDRNOTAVAIL'];
+        if (err && err.code && netErrors.includes(err.code)) {
+            console.error('[symi] 网络错误已捕获，继续运行:', err.message);
+            return;
         }
+        if (err && (err.name === 'AggregateError' || (err.errors && Array.isArray(err.errors)))) {
+            console.error('[symi] AggregateError已捕获:', err.message);
+            return;
+        }
+        console.error('[symi] 未捕获异常:', err);
     });
     
-    process.on('unhandledRejection', (reason, promise) => {
-        // 检查是否是网络相关的Promise rejection
-        if (reason && (reason.name === 'AggregateError' || 
-            (reason.code && ['ECONNREFUSED', 'ECONNRESET', 'ETIMEDOUT', 'ENETUNREACH', 'EHOSTUNREACH'].includes(reason.code)))) {
-            console.error('[symi-gateway] 网络Promise rejection已捕获:', reason.message || reason);
-            // 不重新抛出，防止崩溃
-        }
-        // 其他rejection由Node-RED默认处理
+    process.on('unhandledRejection', (reason) => {
+        console.error('[symi] Promise rejection:', reason?.message || reason);
     });
 }
 
@@ -217,6 +217,13 @@ module.exports = function(RED) {
                         Buffer.from([frame.checksum])
                     ]).toString('hex').toUpperCase();
                     this.log(`[场景执行] 收到场景执行通知事件: 场景ID=${sceneId}, 设备地址=0x${event.networkAddress.toString(16).toUpperCase()}, 原始帧=${frameHex}`);
+                    
+                    // 发出场景执行事件，让桥接节点知道需要查询设备状态
+                    this.emit('scene-executed', {
+                        sceneId: sceneId,
+                        triggerAddress: event.networkAddress,
+                        timestamp: Date.now()
+                    });
                     continue;
                 }
 

package/nodes/symi-knx-bridge.html

@@ -0,0 +1,368 @@
+<script type="text/javascript">
+    RED.nodes.registerType('symi-knx-bridge', {
+        category: 'Symi Mesh',
+        color: '#88AA55',
+        defaults: {
+            name: { value: '' },
+            gateway: { value: '', type: 'symi-gateway', required: true },
+            mappings: { value: '[]' },
+            knxEntities: { value: '[]' }
+        },
+        inputs: 1,
+        outputs: 2,
+        outputLabels: ['KNX输出', '调试信息'],
+        icon: 'bridge.svg',
+        label: function() { return this.name || 'KNX Bridge'; },
+        paletteLabel: 'KNX桥接',
+        oneditprepare: function() {
+            const node = this;
+            let mappings = [], devices = [], knxEntities = [];
+            const typeLabels = {switch:'开关',light_mono:'单调',light_cct:'双调',light_rgb:'RGB',light_rgbcw:'RGBCW',cover:'窗帘',climate:'空调',fresh_air:'新风',floor_heating:'地暖'};
+
+            try { mappings = JSON.parse(node.mappings || '[]'); } catch(e) { mappings = []; }
+            try { knxEntities = JSON.parse(node.knxEntities || '[]'); } catch(e) { knxEntities = []; }
+
+            function loadDevices() {
+                const gid = $('#node-input-gateway').val();
+                if (!gid) { devices = []; renderMappings(); return; }
+                $.getJSON('symi-knx-bridge/devices/' + gid, function(data) {
+                    devices = data || [];
+                    renderMappings();
+                });
+            }
+
+            // 下载模板
+            $('#download-tpl-btn').on('click', function() {
+                const tpl = `# KNX实体导入模板 (Tab分隔)
+# 格式: 名称	类型	命令地址	状态地址	扩展1	扩展2	扩展3
+# 类型: switch, light_mono, light_cct, light_rgb, light_rgbcw, cover, climate, fresh_air, floor_heating
+#
+# 开关 (命令, 状态)
+玄关射灯	switch	1/1/28	1/2/28
+客厅射灯	switch	1/1/25	1/2/25
+# 单色调光 (开关, 状态, 亮度)
+卧室筒灯	light_mono	1/1/1	1/2/1	1/3/1
+# 双色调光 (开关, 状态, 亮度, 色温)
+客厅吊灯	light_cct	1/1/10	1/2/10	1/3/10	1/4/10
+# RGB (开关, 状态, 亮度, RGB)
+氛围灯	light_rgb	1/1/20	1/2/20	1/3/20	1/5/20
+# RGBCW (开关, 状态, 亮度, 色温, RGB)
+主灯	light_rgbcw	1/1/30	1/2/30	1/3/30	1/4/30	1/5/30
+# 窗帘 (上下, 位置, 停止)
+客厅布帘	cover	2/1/5	2/2/5	2/3/5
+# 空调 (开关, 温度, 模式, 风速, 当前温度)
+主卧空调	climate	3/1/1	3/2/1	3/3/1	3/4/1	3/5/1
+# 新风 (开关, 风速)
+全屋新风	fresh_air	4/1/1	4/2/1
+# 地暖 (开关, 温度, 当前温度)
+客厅地暖	floor_heating	5/1/1	5/2/1	5/3/1`;
+                const blob = new Blob([tpl], {type:'text/plain;charset=utf-8'});
+                const a = document.createElement('a'); a.href = URL.createObjectURL(blob);
+                a.download = 'knx-template.txt'; a.click();
+            });
+
+            // 渲染KNX实体表格
+            function renderKnxEntities() {
+                const c = $('#knx-list'); c.empty(); $('#knx-cnt').text(knxEntities.length);
+                if (!knxEntities.length) { c.html('<div class="tips">点击"导入"或"添加"管理KNX实体</div>'); return; }
+                let h = '<table class="tbl"><tr><th>名称</th><th>类型</th><th>命令</th><th>状态</th><th>扩展</th><th style="width:60px">操作</th></tr>';
+                knxEntities.forEach((e,i) => {
+                    const ext = [e.ext1,e.ext2,e.ext3].filter(x=>x).join(',');
+                    const inv = e.type==='cover' ? '<input type="checkbox" class="e-inv" title="位置反转"'+(e.invert?' checked':'')+'>' : '';
+                    h += '<tr data-ei="'+i+'"><td>'+e.name+'</td><td>'+(typeLabels[e.type]||e.type)+inv+'</td><td>'+e.cmdAddr+'</td><td>'+(e.statusAddr||'-')+'</td><td>'+(ext||'-')+'</td><td><button class="red-ui-button red-ui-button-small e-edit" title="编辑"><i class="fa fa-pencil"></i></button> <button class="red-ui-button red-ui-button-small e-del" title="删除"><i class="fa fa-times"></i></button></td></tr>';
+                });
+                c.html(h+'</table>');
+                // 绑定实体事件
+                $('.e-inv').off('change').on('change', function() {
+                    const ei = $(this).closest('tr').data('ei');
+                    knxEntities[ei].invert = $(this).is(':checked');
+                    saveKnxData();
+                });
+                $('.e-edit').off('click').on('click', function() {
+                    const ei = $(this).closest('tr').data('ei');
+                    editKnxEntity(ei);
+                });
+                $('.e-del').off('click').on('click', function() {
+                    const ei = $(this).closest('tr').data('ei');
+                    knxEntities.splice(ei, 1);
+                    renderKnxEntities(); renderMappings();
+                });
+            }
+            
+            // 设备类型对应的字段配置
+            const typeFields = {
+                'switch': ['命令地址*','状态地址'],
+                'light_mono': ['开关地址*','状态地址','亮度地址'],
+                'light_cct': ['开关地址*','状态地址','亮度地址','色温地址'],
+                'light_rgb': ['开关地址*','状态地址','亮度地址','RGB地址'],
+                'light_rgbcw': ['开关地址*','状态地址','亮度地址','色温地址','RGB地址'],
+                'cover': ['上下地址*','位置地址','停止地址'],
+                'climate': ['开关地址*','温度地址','模式地址','风速地址','当前温度'],
+                'fresh_air': ['开关地址*','风速地址'],
+                'floor_heating': ['开关地址*','温度地址','当前温度']
+            };
+            
+            // 统一的添加/编辑KNX实体面板
+            let editingIndex = -1;
+            function showEntityPanel(index) {
+                const isEdit = index >= 0;
+                const e = isEdit ? knxEntities[index] : {name:'',type:'switch',cmdAddr:'',statusAddr:'',ext1:'',ext2:'',ext3:'',invert:false};
+                editingIndex = index;
+                const typeOpts = Object.keys(typeLabels).map(t => '<option value="'+t+'"'+(t===e.type?' selected':'')+'>'+typeLabels[t]+'</option>').join('');
+                const title = isEdit ? '编辑: '+e.name : '添加KNX实体';
+                const btnText = isEdit ? '保存' : '添加';
+                $('#edit-panel').html(
+                    '<div class="edit-form"><h4>'+title+'</h4>'+
+                    '<div class="form-row"><label>名称*</label><input type="text" id="edit-name" value="'+(e.name||'')+'" placeholder="如: 客厅灯"></div>'+
+                    '<div class="form-row"><label>类型</label><select id="edit-type">'+typeOpts+'</select></div>'+
+                    '<div class="form-row" id="row-cmd"><label id="lbl-cmd">命令地址*</label><input type="text" id="edit-cmd" value="'+(e.cmdAddr||'')+'"></div>'+
+                    '<div class="form-row" id="row-status"><label id="lbl-status">状态地址</label><input type="text" id="edit-status" value="'+(e.statusAddr||'')+'"></div>'+
+                    '<div class="form-row" id="row-ext1"><label id="lbl-ext1">扩展1</label><input type="text" id="edit-ext1" value="'+(e.ext1||'')+'"></div>'+
+                    '<div class="form-row" id="row-ext2"><label id="lbl-ext2">扩展2</label><input type="text" id="edit-ext2" value="'+(e.ext2||'')+'"></div>'+
+                    '<div class="form-row" id="row-ext3"><label id="lbl-ext3">扩展3</label><input type="text" id="edit-ext3" value="'+(e.ext3||'')+'"></div>'+
+                    '<div class="form-row" id="row-inv" style="display:none"><label>位置反转</label><input type="checkbox" id="edit-inv"'+(e.invert?' checked':'')+'></div>'+
+                    '<div class="form-row"><button id="save-edit" class="red-ui-button red-ui-button-small">'+btnText+'</button> <button id="cancel-edit" class="red-ui-button red-ui-button-small">取消</button></div>'+
+                    '</div>'
+                ).show();
+                
+                function updateFieldLabels() {
+                    const type = $('#edit-type').val();
+                    const fields = typeFields[type] || ['命令地址*','状态地址'];
+                    const rows = ['row-cmd','row-status','row-ext1','row-ext2','row-ext3'];
+                    const labels = ['lbl-cmd','lbl-status','lbl-ext1','lbl-ext2','lbl-ext3'];
+                    rows.forEach((row,i) => {
+                        if (i < fields.length) {
+                            $('#'+row).show();
+                            $('#'+labels[i]).text(fields[i]);
+                        } else {
+                            $('#'+row).hide();
+                        }
+                    });
+                    $('#row-inv').toggle(type === 'cover');
+                }
+                updateFieldLabels();
+                $('#edit-type').on('change', updateFieldLabels);
+                
+                $('#save-edit').on('click', function() {
+                    const name = $('#edit-name').val().trim();
+                    const cmd = $('#edit-cmd').val().trim();
+                    if (!name || !cmd) { RED.notify('请填写名称和命令地址', 'warning'); return; }
+                    const entity = {
+                        id: isEdit ? e.id : 'k'+Date.now()+Math.random().toString(36).substr(2,4),
+                        name: name,
+                        type: $('#edit-type').val(),
+                        cmdAddr: cmd,
+                        statusAddr: $('#edit-status').val().trim(),
+                        ext1: $('#edit-ext1').val().trim(),
+                        ext2: $('#edit-ext2').val().trim(),
+                        ext3: $('#edit-ext3').val().trim(),
+                        invert: $('#edit-inv').is(':checked')
+                    };
+                    if (isEdit) { knxEntities[editingIndex] = entity; }
+                    else { knxEntities.push(entity); }
+                    $('#edit-panel').hide().empty();
+                    renderKnxEntities(); renderMappings();
+                    RED.notify(isEdit?'已更新':'已添加', 'success');
+                });
+                $('#cancel-edit').on('click', function() { $('#edit-panel').hide().empty(); });
+            }
+            function editKnxEntity(index) { showEntityPanel(index); }
+
+            // 渲染映射表格 - 一行显示
+            function renderMappings() {
+                const c = $('#map-list'); c.empty();
+                if (!mappings.length) { c.html('<div class="tips">点击"添加"创建映射</div>'); return; }
+                let h = '<table class="tbl"><tr><th style="width:24px">#</th><th style="width:38%">Mesh设备</th><th style="width:45px">通道</th><th style="width:45%">KNX实体</th><th style="width:32px">删除</th></tr>';
+                mappings.forEach((m, i) => {
+                    const dev = devices.find(d => d.mac === m.meshMac);
+                    h += '<tr data-i="'+i+'"><td>'+(i+1)+'</td>';
+                    // Mesh设备选择
+                    h += '<td><select class="m-dev"><option value="">--选择Mesh--</option>';
+                    devices.forEach(d => {
+                        const tl = d.type==='cover'?'窗帘':d.type==='switch'?d.channels+'键':d.type==='light'?'灯':d.type==='climate'?'温控':d.type;
+                        h += '<option value="'+d.mac+'" data-ch="'+d.channels+'" data-t="'+d.type+'"'+(d.mac===m.meshMac?' selected':'')+'>'+d.name+'['+tl+']</option>';
+                    });
+                    h += '</select></td>';
+                    // 通道
+                    h += '<td><select class="m-ch">';
+                    if (dev && dev.type === 'switch') {
+                        for(let j=1; j<=dev.channels; j++) h += '<option value="'+j+'"'+(j===m.meshChannel?' selected':'')+'>'+j+'</option>';
+                    } else { h += '<option value="1">-</option>'; }
+                    h += '</select></td>';
+                    // KNX实体选择
+                    h += '<td><select class="m-knx"><option value="">--选择KNX--</option>';
+                    knxEntities.forEach(e => {
+                        const inv = e.invert ? '↕' : '';
+                        h += '<option value="'+e.id+'"'+(e.id===m.knxEntityId?' selected':'')+'>'+e.name+'['+e.cmdAddr+']('+inv+(typeLabels[e.type]||'')+')</option>';
+                    });
+                    h += '</select></td>';
+                    h += '<td><button class="red-ui-button red-ui-button-small m-del" title="删除"><i class="fa fa-times"></i></button></td></tr>';
+                });
+                c.html(h+'</table>');
+                bindEvents();
+            }
+
+            function bindEvents() {
+                $('.m-dev').off('change').on('change', function() {
+                    const i = $(this).closest('tr').data('i');
+                    mappings[i].meshMac = $(this).val();
+                    mappings[i].meshChannel = 1;
+                    renderMappings();
+                });
+                $('.m-ch').off('change').on('change', function() {
+                    const i = $(this).closest('tr').data('i');
+                    mappings[i].meshChannel = parseInt($(this).val()) || 1;
+                });
+                $('.m-knx').off('change').on('change', function() {
+                    const i = $(this).closest('tr').data('i');
+                    mappings[i].knxEntityId = $(this).val();
+                });
+                $('.m-del').off('click').on('click', function() {
+                    mappings.splice($(this).closest('tr').data('i'), 1);
+                    renderMappings();
+                });
+            }
+
+            $('#add-map-btn').on('click', function() {
+                mappings.push({ meshMac:'', meshChannel:1, knxEntityId:'' });
+                renderMappings();
+            });
+            $('#clear-map-btn').on('click', function() { if(confirm('清空映射？')) { mappings=[]; renderMappings(); } });
+
+            $('#import-btn').on('click', function() { $('#import-modal').show(); });
+            $('#import-cancel').on('click', function() { $('#import-modal').hide(); });
+            $('#import-confirm').on('click', function() {
+                const text = $('#import-input').val().trim();
+                if (!text) { $('#import-modal').hide(); return; }
+                let cnt = 0;
+                text.split('\n').forEach(line => {
+                    line = line.trim();
+                    if (!line || line.startsWith('#')) return;
+                    const p = line.split(/\t+/);
+                    if (p.length >= 2 && p[1] && /\d+\/\d+\/\d+/.test(p[2]||'')) {
+                        const id = 'k' + Date.now() + Math.random().toString(36).substr(2,4);
+                        knxEntities.push({ id, name:p[0].trim(), type:p[1].trim(), cmdAddr:p[2].trim(), statusAddr:(p[3]||'').trim(), ext1:(p[4]||'').trim(), ext2:(p[5]||'').trim(), ext3:(p[6]||'').trim(), invert:false });
+                        cnt++;
+                    }
+                });
+                $('#import-modal').hide(); $('#import-input').val('');
+                renderKnxEntities(); renderMappings();
+                RED.notify('导入 '+cnt+' 个实体'+(cnt?'':'（需要有效组地址格式如1/2/3）'), cnt?'success':'warning');
+            });
+            $('#add-knx-btn').on('click', function() { showEntityPanel(-1); });
+            $('#clear-knx-btn').on('click', function() { if(confirm('清空KNX实体？')) { knxEntities=[]; renderKnxEntities(); renderMappings(); } });
+
+            // 保存KNX实体到隐藏字段
+            function saveKnxData() { $('#knx-data').val(JSON.stringify(knxEntities)); }
+            
+            // 渲染后保存
+            const origRender = renderKnxEntities;
+            renderKnxEntities = function() { origRender(); saveKnxData(); };
+
+            $('#node-input-gateway').on('change', loadDevices);
+            setTimeout(function() { loadDevices(); renderKnxEntities(); }, 100);
+        },
+        oneditsave: function() {
+            const maps = [];
+            $('#map-list tr[data-i]').each(function() {
+                const m = { meshMac: $(this).find('.m-dev').val(), meshChannel: parseInt($(this).find('.m-ch').val())||1, knxEntityId: $(this).find('.m-knx').val() };
+                if (m.meshMac && m.knxEntityId) maps.push(m);
+            });
+            this.mappings = JSON.stringify(maps);
+            this.knxEntities = $('#knx-data').val() || '[]';
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="symi-knx-bridge">
+    <style>
+        #dialog-form { min-width: 950px; }
+        .tbl { width:100%; border-collapse:collapse; font-size:11px; }
+        .tbl th, .tbl td { padding:3px 5px; border:1px solid #ddd; }
+        .tbl th { background:#f0f0f0; }
+        .tbl select { width:100%; font-size:11px; padding:2px; }
+        .tbl input[type="checkbox"] { margin:0; }
+        #knx-list, #map-list { max-height:180px; overflow-y:auto; border:1px solid #ccc; margin:5px 0; padding:3px; }
+        .tips { color:#666; padding:8px; text-align:center; font-size:12px; }
+        .sec { display:flex; justify-content:space-between; align-items:center; margin:10px 0 4px; padding-bottom:4px; border-bottom:1px solid #ddd; }
+        .sec b { font-size:12px; }
+        .btns button { margin-left:4px; }
+        .modal-overlay { display:none; position:fixed; top:0; left:0; right:0; bottom:0; background:rgba(0,0,0,0.5); z-index:99999; }
+        .modal-box { position:fixed; top:50%; left:50%; transform:translate(-50%,-50%); background:#fff; padding:15px; border-radius:5px; box-shadow:0 4px 20px rgba(0,0,0,0.3); z-index:100000; }
+        #import-modal .modal-box { width:650px; }
+        #import-input { width:100%; height:160px; font-family:monospace; font-size:10px; }
+        .modal-box h4 { margin:0 0 10px; }
+        .modal-box .mbtns { text-align:right; margin-top:10px; }
+        .info { background:#f8f8e8; border:1px solid #e0e0c0; padding:5px 8px; margin:6px 0; font-size:11px; border-radius:3px; }
+        .edit-form h4 { margin:0 0 10px; color:#333; }
+        .edit-form .form-row { margin-bottom:8px; display:flex; align-items:center; }
+        .edit-form .form-row label { width:70px; font-size:12px; }
+        .edit-form .form-row input, .edit-form .form-row select { flex:1; padding:4px; font-size:12px; }
+    </style>
+
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> 名称</label>
+        <input type="text" id="node-input-name" placeholder="KNX Bridge">
+    </div>
+    <div class="form-row">
+        <label for="node-input-gateway"><i class="fa fa-server"></i> Mesh网关</label>
+        <input type="text" id="node-input-gateway">
+    </div>
+
+    <div class="info"><b>连接:</b> <code>[knxUltimate-in] → [KNX桥接] → [knxUltimate-out]</code> | KNX IP网关由knx-ultimate配置(端口3671)</div>
+
+    <div class="sec">
+        <b><i class="fa fa-database"></i> KNX实体库 (<span id="knx-cnt">0</span>)</b>
+        <span class="btns">
+            <button type="button" class="red-ui-button red-ui-button-small" id="download-tpl-btn"><i class="fa fa-download"></i> 模板</button>
+            <button type="button" class="red-ui-button red-ui-button-small" id="import-btn"><i class="fa fa-upload"></i> 导入</button>
+            <button type="button" class="red-ui-button red-ui-button-small" id="add-knx-btn"><i class="fa fa-plus"></i> 添加</button>
+            <button type="button" class="red-ui-button red-ui-button-small" id="clear-knx-btn"><i class="fa fa-trash"></i></button>
+        </span>
+    </div>
+    <div id="knx-list"><div class="tips">点击"导入"或"添加"管理KNX实体</div></div>
+    <div id="edit-panel" style="display:none;background:#fffde7;border:1px solid #ffc107;padding:10px;margin:5px 0;border-radius:4px;"></div>
+    <input type="hidden" id="knx-data">
+
+    <div class="sec">
+        <b><i class="fa fa-exchange"></i> 设备映射</b>
+        <span class="btns">
+            <button type="button" class="red-ui-button red-ui-button-small" id="add-map-btn"><i class="fa fa-plus"></i> 添加</button>
+            <button type="button" class="red-ui-button red-ui-button-small" id="clear-map-btn"><i class="fa fa-trash"></i> 清空</button>
+        </span>
+    </div>
+    <div id="map-list"><div class="tips">添加Mesh↔KNX映射</div></div>
+
+    <div id="import-modal" class="modal-overlay">
+        <div class="modal-box">
+            <h4>导入KNX实体</h4>
+            <p style="font-size:11px;margin:0 0 8px">Tab分隔: <code>名称  类型  命令地址  状态地址  扩展...</code>（无效行自动忽略）</p>
+            <textarea id="import-input" placeholder="玄关射灯	switch	1/1/28	1/2/28
+客厅吊灯	light_cct	1/1/10	1/2/10	1/3/10	1/4/10
+客厅布帘	cover	2/1/5	2/2/5	2/3/5"></textarea>
+            <div class="mbtns">
+                <button type="button" class="red-ui-button" id="import-cancel">取消</button>
+                <button type="button" class="red-ui-button red-ui-button-primary" id="import-confirm">导入</button>
+            </div>
+        </div>
+    </div>
+
+</script>
+
+<script type="text/html" data-help-name="symi-knx-bridge">
+    <p>Symi Mesh与KNX双向同步桥接</p>
+    <h3>使用步骤</h3>
+    <ol>
+        <li>点击"下载模板"获取KNX实体导入格式</li>
+        <li>填写后点击"导入"</li>
+        <li>点击"添加映射"，选择Mesh设备和KNX实体</li>
+    </ol>
+    <h3>设备类型</h3>
+    <ul>
+        <li><b>switch</b> - 开关 (命令+状态)</li>
+        <li><b>light_mono/cct/rgb/rgbcw</b> - 调光灯</li>
+        <li><b>cover</b> - 窗帘 (上下+位置+停止)</li>
+        <li><b>climate</b> - 空调</li>
+        <li><b>fresh_air/floor_heating</b> - 新风/地暖</li>
+    </ul>
+</script>