@linanw/homebridge-mijia-remote-camera 0.1.2 → 0.2.0

package/README.md

@@ -64,6 +64,29 @@ mijia-camera-setup --from /homebridge/homebridge-mijia-remote-camera-0.1.0.tgz -
 
 夜视目前仅支持已核对 MIOT 定义的 `chuangmi.camera.061a01`／`chuangmi.camera.061a03`。插件设置页先读取设备实际状态，再选择“自动／开启／关闭”并应用；写入后会回读确认。Apple“家庭”的“夜视”开关表示允许夜视：自动模式显示为开，重复开不会把自动改为强制开启；关掉后重新打开会设置为始终开启。需要恢复自动时，请在插件设置页选择。该开关表示夜视策略，不表示红外灯此刻是否点亮。启动和轮询只读状态，不更改策略。
 
+## Matter 摄像头（0.2.0，实验性）
+
+可在保留现有 HomeKit 配对的同时启用独立的 Matter Camera（设备类型 `0x0142`，端点 `1`）。它实现 Camera AV Stream Management 与 WebRTC Transport Provider，包含 H.264 视频、Opus 现场声音、双向对讲、JPEG 快照、音量／静音和支持型号的夜视模式。当前使用 matter.js 0.18.0 的 Matter 1.6.1 模型，已与 matter-server 1.5.3 控制器进行协议对接。MatterDesk Qt 客户端是当前目标客户端；客户端需要实现摄像头播放。Apple“家庭”仍使用本插件原有的 HomeKit 配件。
+
+在插件设置页勾选“启用 Matter 摄像头”，选定 NAS 的局域网接口（群晖 host 容器通常为 `eth0`），保存并重启摄像头子桥。默认端口为 `5540`，需可用且允许同一局域网的 TCP／UDP；mDNS 与 IPv6 也需可用。高级配置示例：
+
+```json
+{
+  "platform": "MijiaRemoteCamera",
+  "enableMatter": true,
+  "matterInterface": "eth0",
+  "matterPort": 5540
+}
+```
+
+升级默认不开启 Matter。启用后，从受保护的插件设置页点击显示 Matter 配对信息，将手动配对码或 `MT:` 内容输入控制器。它与 HomeKit Setup Code 不同。已配对后增加其他控制器时可在设置页重新打开配对窗口，操作完成后可以关闭窗口。配对码和 Matter 私钥不会写入脱敏报告。Matter fabric／设备身份保存在插件私有存储的 `matter/` 内，升级和正常重启保留身份；删除该目录会使已有配对失效。
+
+这是未认证的开发设备，使用 SDK 的测试 VID／开发证书。matter-server 默认会拒绝这种证书；只在明确信任此开发设备时，使用它的 `--enable-test-net-dcl`（或 `ENABLE_TEST_NET_DCL=true`）选项。插件不冒充通过认证的产品，客户端普通启动应保留严格验证。
+
+Matter 信令及 WebRTC 播放目前面向同一局域网，无外部 STUN／TURN，不能据此承诺跨网 Matter 播放。远端摄像头与 NAS 可以继续处于不同网络，由原有小米远程连接取流。最多一路 Matter 实时会话，默认视频上限 640×360、12 fps、700 kbps，可使用已有 `maxWidth`／`maxHeight`／`maxFPS`／`maxBitrate` 配置调整。没有声明录像、云台、运动事件或云存储能力。Matter 和 HomeKit 共享同一个远程源，分别编码；群晖上同时播放会增加 CPU 使用。
+
+打开直播时客户端会唤起插件取流；小米中继仍可能间歇连接失败，与是否先打开米家 App 无关。连接失败时会结束当前 Matter 会话，待源恢复后在客户端重新打开。当前未完成长时间稳定性验证。
+
 ## 数据和运行管理
 
 会话、设备选择和导入的组件保存在：
@@ -74,6 +97,7 @@ mijia-camera-setup --from /homebridge/homebridge-mijia-remote-camera-0.1.0.tgz -
   selection.json
   region.json
   runtime/
+  matter/
 ```
 
 私有目录权限为 `0700`，凭据和选择文件为 `0600`。小米 Token 不写入 Homebridge `config.json`。设置页通过 Homebridge 的受保护接口和本机 Unix socket 通信；原始视频和音频仅监听临时的本机回环端口，不保存录音。对讲接口也仅允许本机访问。Homebridge 启动后恢复所选摄像头，关闭时清理 Java、FFmpeg 和 UDP 会话，临时网络故障会自动重连。

package/THIRD_PARTY_NOTICES.md

@@ -29,3 +29,12 @@ are separate from the package and retain their original rights and notices.
 
 The HomeKit streaming delegate uses Homebridge's public HAP API and requires
 neither `homebridge-camera-ffmpeg` nor an independent relay service.
+
+The optional Matter camera implementation resolves `@matter/main` and
+`@matter/nodejs` 0.18.0 (Apache-2.0) and `werift` 0.25.1 (MIT), together with
+their transitive npm dependencies under their own licenses. These libraries
+are installed by npm, not bundled in this package tarball. Matter development
+attestation credentials are supplied by the SDK. This package is an experimental
+development device and makes no certification claim. WebRTC media encryption and
+signaling use these libraries; FFmpeg conversion continues to use the separately
+imported local binary described above.

package/config.schema.json

@@ -83,6 +83,26 @@
         "type": "boolean",
         "title": "在家庭中显示夜视开关",
         "default": true
+      },
+      "enableMatter": {
+        "type": "boolean",
+        "title": "启用 Matter 摄像头（开发设备）",
+        "default": false
+      },
+      "matterPort": {
+        "type": "integer",
+        "title": "Matter UDP 端口",
+        "default": 5540,
+        "minimum": 1024,
+        "maximum": 65535
+      },
+      "matterInterface": {
+        "type": "string",
+        "title": "Matter 局域网网卡",
+        "default": "eth0",
+        "minLength": 1,
+        "maxLength": 40,
+        "pattern": "^[A-Za-z0-9_.:-]+$"
       }
     }
   }

package/homebridge-ui/public/index.html

@@ -35,6 +35,16 @@
     <label><input id="enableNightVision" type="checkbox" style="width:auto"> 在 Apple“家庭”中显示夜视开关</label>
     <div class="row"><button id="saveFeatures" class="secondary">保存功能配置</button></div><p id="featureState" class="small" aria-live="polite" style="margin-top:12px">功能配置保存后需重启摄像头子桥。对讲时，在“家庭”直播页面使用对讲按钮。</p>
   </section>
+  <section id="matterSection"><div class="step">04 · MATTER</div><h2>Matter 摄像头 · 开发设备</h2>
+    <p class="small">可在支持 Matter 摄像头的控制器中测试实时视频、声音与对讲。MatterDesk 配对时需允许开发证书；当前不承诺 Apple“家庭”支持 Matter 摄像头。</p>
+    <label><input id="enableMatter" type="checkbox" style="width:auto"> 启用独立 Matter 摄像头</label>
+    <div class="columns"><div><label for="matterPort">Matter TCP／UDP 端口</label><input id="matterPort" type="number" min="1024" max="65535" step="1" value="5540"></div><div><label for="matterInterface">局域网网卡</label><input id="matterInterface" maxlength="40" value="eth0" autocomplete="off" spellcheck="false"></div></div>
+    <div class="row"><button id="saveMatter" class="secondary">保存 Matter 配置</button></div><p id="matterConfigState" class="small" aria-live="polite" style="margin-top:12px">配置保存后需重启摄像头子桥。</p>
+    <div class="note"><div id="matterStatus" aria-live="polite">正在读取 Matter 状态…</div><div id="matterMedia" class="small"></div><p class="small" style="margin:8px 0 0">仅支持可直接互通的局域网；当前不使用 STUN 或 TURN。请填写 Homebridge 容器内实际连接局域网的网卡名称。</p></div>
+    <div class="row"><button id="matterPairing" disabled>显示私密配对码</button><button id="matterOpen" class="secondary" disabled>打开配对窗口</button><button id="matterClose" class="secondary" disabled>关闭配对窗口</button></div>
+    <p id="matterActionState" class="small" aria-live="polite" style="margin-top:12px"></p>
+    <div id="matterPairingPanel" class="linkbox hide"><p class="small">配对码仅供管理员在自己的控制器中使用，请勿转发。此处内容不会加入脱敏诊断。</p><label for="matterManualCode">手动配对码</label><input id="matterManualCode" readonly autocomplete="off" spellcheck="false"><label for="matterQrCode">二维码内容（MT:）</label><input id="matterQrCode" readonly autocomplete="off" spellcheck="false"></div>
+  </section>
   <div id="error" class="error" role="alert"></div>
   <div class="footer small"><p>首次连接可能需要一两分钟。提供实时视频、快照、现场声音和双向对讲；夜视模式可在上方控制。</p><p>配件发布后，在“Apple 家庭 → 添加配件 → 更多选项”中选择摄像头，使用摄像头启动日志中的 Setup Code 添加；子桥配对码可能与主桥不同。</p><p>登录数据只保存在 Homebridge 的私有插件目录，不写入插件配置。</p></div>
 </main>
@@ -75,6 +85,41 @@
   const record = value => value !== null && typeof value === 'object' && !Array.isArray(value);
   const count = value => Number.isSafeInteger(value) && value >= 0;
   const timestamp = value => value === null || (typeof value === 'string' && /^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d\.\d{3}Z$/.test(value));
+  const matterStates = new Set(['disabled','starting','ready','failed','stopped']);
+  const matterReasons = new Set(['matter_disabled','matter_not_ready','matter_start_failed','matter_port_in_use','matter_configuration_invalid','matter_pairing_unavailable','matter_window_failed','matter_closed']);
+  const matterMessages = {matter_disabled:'Matter 尚未启用。',matter_not_ready:'Matter 尚未就绪，请检查配置并重启摄像头子桥。',matter_start_failed:'Matter 启动失败，请检查端口、网卡和插件状态。',matter_port_in_use:'Matter 端口已被占用，请修改配置并重启。',matter_configuration_invalid:'Matter 配置无效，请检查端口和网卡。',matter_pairing_unavailable:'暂时无法取得 Matter 配对码。',matter_window_failed:'配对窗口操作未完成，请重试。',matter_closed:'Matter 已停止。'};
+  let matterValue={}, matterBusy=false, matterGeneration=0, matterDirty=false, matterRestartPending=false;
+  function safeMatterStatus(value={}) {
+    if(!record(value))return {};
+    const result={};
+    for(const key of ['enabled','running','commissioned','commissioningWindowOpen'])if(typeof value[key]==='boolean')result[key]=value[key];
+    if(matterStates.has(value.state))result.state=value.state;
+    if(matterReasons.has(value.reason))result.reason=value.reason;
+    if(value.deviceType===322)result.deviceType=322;
+    for(const key of ['activeSessions','videoStreams','audioStreams','snapshotStreams'])if(count(value[key])&&value[key]<=100)result[key]=value[key];
+    if(record(value.media)){
+      const media={};for(const key of ['sessions','failures','videoPackets','audioPackets','talkPackets','talkBytes'])if(count(value.media[key]))media[key]=value.media[key];
+      for(const key of ['active','microphoneMuted','speakerMuted'])if(typeof value.media[key]==='boolean')media[key]=value.media[key];
+      if(Object.keys(media).length)result.media=media;
+    }
+    return result;
+  }
+  function clearMatterPairing(){++matterGeneration;$('matterManualCode').value='';$('matterQrCode').value='';$('matterPairingPanel').classList.add('hide');}
+  function matterReady(){return connected&&!authBusy&&!regionNeedsLogin&&!matterDirty&&!matterRestartPending&&configs[0]?.enableMatter===true&&$('enableMatter').checked&&matterValue.enabled===true&&matterValue.running===true&&matterValue.state==='ready';}
+  function renderMatter(){
+    const ready=matterReady(), value=matterValue;
+    $('matterPairing').disabled=!ready||matterBusy||value.commissioningWindowOpen!==true;
+    $('matterOpen').disabled=!ready||matterBusy||value.commissioningWindowOpen===true;
+    $('matterClose').disabled=!ready||matterBusy||value.commissioningWindowOpen!==true;
+    if(!ready||(value.commissioningWindowOpen!==true&&($('matterManualCode').value||$('matterQrCode').value)))clearMatterPairing();
+    const state=matterRestartPending?'配置已保存，请重启摄像头子桥并重新打开本页。':matterDirty?'配置尚未保存。':!$('enableMatter').checked?'Matter 尚未启用。':value.reason?matterMessages[value.reason]:value.running===true?`${value.commissioned?'已配对':'尚未配对'} · 配对窗口${value.commissioningWindowOpen?'已打开':'已关闭'}`:value.state==='starting'?'Matter 正在启动…':'Matter 尚未就绪，请重启摄像头子桥。';
+    $('matterStatus').textContent=state;
+    const details=[];if(count(value.activeSessions))details.push(`活动会话 ${value.activeSessions}`);
+    if(count(value.media?.videoPackets))details.push(`视频包 ${value.media.videoPackets}`);
+    if(count(value.media?.audioPackets))details.push(`声音包 ${value.media.audioPackets}`);
+    if(count(value.media?.talkBytes))details.push(`对讲 ${value.media.talkBytes} 字节`);
+    $('matterMedia').textContent=details.join(' · ');
+  }
   
   function safeMediaDiagnostics(value) {
     const result = {};
@@ -148,6 +193,7 @@
       if ([1, 2].includes(value.audio.channels)) audio.channels = value.audio.channels;
       result.audio = audio;
     }
+    if(record(value.matter)){const matter=safeMatterStatus(value.matter);if(Object.keys(matter).length)result.matter=matter;}
     if (value.media === null) result.media = null;
     else if (record(value.media)) {
       const media = safeMediaDiagnostics(value.media);
@@ -197,21 +243,21 @@
   function options(select,items,render,empty){select.replaceChildren(); if(!items.length){const option=document.createElement('option');option.textContent=empty;select.append(option);select.disabled=true;return;} items.forEach((item,index)=>{const option=document.createElement('option');option.value=String(index);option.textContent=render(item);select.append(option)});select.disabled=false;}
   function chosenHome(){return homes[Number($('homes').value)];}
   function chosenDevice(){return devices[Number($('devices').value)];}
-  function setLoginBusy(busy){authBusy=busy;$('login').disabled=busy||!connected; $('load').disabled=busy||!connected||regionNeedsLogin; $('region').disabled=busy; $('cancel').classList.toggle('hide',!busy);}
+  function setLoginBusy(busy){authBusy=busy;$('login').disabled=busy||!connected; $('load').disabled=busy||!connected||regionNeedsLogin; $('region').disabled=busy; $('cancel').classList.toggle('hide',!busy);renderMatter();}
   function hideLoginLink(){$('loginLink').classList.add('hide');$('officialLogin').removeAttribute('href');}
-  async function status(){try{const value=await request('/status');connected=true;$('components').classList.add('hide');$('bootstrap').classList.add('hide');if(regions.includes(value.region)){runtimeRegion=value.region;if(!regionTouched&&!authBusy)$('region').value=runtimeRegion;}regionNeedsLogin=$('region').value!==runtimeRegion;setLoginBusy(authBusy);diagnosticValue=safeDiagnostics(value);statusReceivedAt=Date.now();$('diagnosticsReport').textContent=JSON.stringify(diagnosticValue,null,2);$('copyDiagnostics').disabled=false;renderRuntime();}catch(error){connected=false;$('login').disabled=true;$('load').disabled=true;$('runtimeStatus').dataset.live='false';$('runtimeText').textContent='等待插件启动';$('connectionDetail').textContent='';$('mediaDetail').textContent='';showError(error);}}
+  async function status(){try{const value=await request('/status');connected=true;$('components').classList.add('hide');$('bootstrap').classList.add('hide');if(regions.includes(value.region)){runtimeRegion=value.region;if(!regionTouched&&!authBusy)$('region').value=runtimeRegion;}regionNeedsLogin=$('region').value!==runtimeRegion;matterValue=safeMatterStatus(value.matter);setLoginBusy(authBusy);diagnosticValue=safeDiagnostics(value);statusReceivedAt=Date.now();$('diagnosticsReport').textContent=JSON.stringify(diagnosticValue,null,2);$('copyDiagnostics').disabled=false;renderRuntime();renderMatter();}catch(error){connected=false;matterValue={};clearMatterPairing();renderMatter();$('login').disabled=true;$('load').disabled=true;$('runtimeStatus').dataset.live='false';$('runtimeText').textContent='等待插件启动';$('connectionDetail').textContent='';$('mediaDetail').textContent='';showError(error);}}
   $('copyDiagnostics').onclick=async()=>{try{if(typeof navigator==='undefined'||typeof navigator.clipboard?.writeText!=='function')throw Error('clipboard_unavailable');await navigator.clipboard.writeText($('diagnosticsReport').textContent);$('diagnosticsHint').textContent='已复制脱敏诊断。';}catch{$('diagnosticsHint').textContent='浏览器无法自动复制，请手动选中上方诊断报告并复制。';}};
-  async function loadHomes(){clearError();$('selectionState').textContent='正在读取家庭…';try{const response=await request('/homes');homes=Array.isArray(response)?response:(response.homes||[]);options($('homes'),homes,home=>(home.name||'未命名家庭')+(home.shared?' · 共享家庭':''),'当前地区没有可访问的家庭');$('selectionState').textContent=homes.length?'请选择目标家庭。':'请检查地区及账号的家庭访问权限。';devices=[];options($('devices'),[],()=>'', '先选择家庭');$('save').disabled=true;$('cameraName').disabled=true;if(homes.length)await loadDevices();}catch(error){$('selectionState').textContent='';showError(error);}}
-  async function loadDevices(){const home=chosenHome();if(!home)return;clearError();$('selectionState').textContent='正在读取此家庭的摄像头…';$('save').disabled=true;try{const response=await request('/devices',{homeId:String(home.id),homeOwner:String(home.ownerId)});devices=Array.isArray(response)?response:(response.devices||[]);options($('devices'),devices,device=>(device.name||device.model||'摄像头')+(device.online===false?' · 离线':''),'此家庭没有摄像头');$('selectionState').textContent='';deviceChanged();}catch(error){devices=[];options($('devices'),[],()=>'', '读取设备失败');$('selectionState').textContent='';showError(error);}}
-  function deviceChanged(){const device=chosenDevice();$('cameraName').disabled=!device;$('save').disabled=!device;$('cameraName').value=device?(device.name||'米家摄像头'):'';}
+  async function loadHomes(){clearMatterPairing();clearError();$('selectionState').textContent='正在读取家庭…';try{const response=await request('/homes');homes=Array.isArray(response)?response:(response.homes||[]);options($('homes'),homes,home=>(home.name||'未命名家庭')+(home.shared?' · 共享家庭':''),'当前地区没有可访问的家庭');$('selectionState').textContent=homes.length?'请选择目标家庭。':'请检查地区及账号的家庭访问权限。';devices=[];options($('devices'),[],()=>'', '先选择家庭');$('save').disabled=true;$('cameraName').disabled=true;if(homes.length)await loadDevices();}catch(error){$('selectionState').textContent='';showError(error);}}
+  async function loadDevices(){const home=chosenHome();if(!home)return;clearMatterPairing();clearError();$('selectionState').textContent='正在读取此家庭的摄像头…';$('save').disabled=true;try{const response=await request('/devices',{homeId:String(home.id),homeOwner:String(home.ownerId)});devices=Array.isArray(response)?response:(response.devices||[]);options($('devices'),devices,device=>(device.name||device.model||'摄像头')+(device.online===false?' · 离线':''),'此家庭没有摄像头');$('selectionState').textContent='';deviceChanged();}catch(error){devices=[];options($('devices'),[],()=>'', '读取设备失败');$('selectionState').textContent='';showError(error);}}
+  function deviceChanged(){clearMatterPairing();const device=chosenDevice();$('cameraName').disabled=!device;$('save').disabled=!device;$('cameraName').value=device?(device.name||'米家摄像头'):'';}
   async function pollAuth(){try{const value=await request('/auth/status',{loginId});if(value.state==='waiting'||value.state==='starting'){$('authState').textContent=`等待你在小米页面确认，剩余 ${value.remainingSeconds||0} 秒。`;pollTimer=setTimeout(pollAuth,1200);return;}setLoginBusy(false);hideLoginLink();if(value.success||value.state==='complete'){$('authState').textContent='登录成功。正在读取家庭列表…';await status();await loadHomes();}else $('authState').textContent=messages[value.reason]||'本次登录未完成，可重新生成链接。';}catch(error){setLoginBusy(false);hideLoginLink();showError(error);}}
   $('login').onclick=async()=>{resetNight();clearError();hideLoginLink();clearTimeout(pollTimer);setLoginBusy(true);$('authState').textContent='正在生成官方登录链接…';try{const value=await request('/auth/start',{region:$('region').value});const url=new URL(value.loginUrl);if(url.protocol!=='https:'||!(url.hostname==='mi.com'||url.hostname.endsWith('.mi.com')||url.hostname==='xiaomi.com'||url.hostname.endsWith('.xiaomi.com')))throw Error('unsafe_url');loginId=value.loginId;$('officialLogin').href=url.href;$('loginLink').classList.remove('hide');$('authState').textContent='请打开链接完成授权。';pollTimer=setTimeout(pollAuth,1000);}catch(error){setLoginBusy(false);showError(error);$('authState').textContent='';}};
   $('cancel').onclick=async()=>{clearTimeout(pollTimer);try{await request('/auth/cancel',{loginId});}catch(error){showError(error);}hideLoginLink();setLoginBusy(false);$('authState').textContent='已取消。已有登录数据保留。';};
   $('region').onchange=()=>{resetNight();regionTouched=true;regionNeedsLogin=$('region').value!==runtimeRegion;setLoginBusy(authBusy);$('authState').textContent=regionNeedsLogin?'已切换地区，请生成新登录链接后读取家庭。':'';}; $('load').onclick=loadHomes; $('homes').onchange=loadDevices; $('devices').onchange=deviceChanged;
-  $('save').onclick=async()=>{const home=chosenHome(),device=chosenDevice();if(!home||!device)return;clearError();$('save').disabled=true;try{const result=await request('/select',{homeId:String(home.id),homeOwner:String(home.ownerId),deviceId:String(device.deviceId||device.did),name:$('cameraName').value.trim()||device.name,model:device.model,region:$('region').value});resetNight();$('selectionState').textContent=result.restartRequired?'已保存新的摄像头。请重启 Homebridge 使配件变更生效。':'选择已保存，正在连接摄像头。配对码见摄像头启动日志中的 Setup Code。';await status();}catch(error){showError(error);}finally{$('save').disabled=false;}};
+  $('save').onclick=async()=>{const home=chosenHome(),device=chosenDevice();if(!home||!device)return;clearMatterPairing();clearError();$('save').disabled=true;try{const result=await request('/select',{homeId:String(home.id),homeOwner:String(home.ownerId),deviceId:String(device.deviceId||device.did),name:$('cameraName').value.trim()||device.name,model:device.model,region:$('region').value});resetNight();$('selectionState').textContent=result.restartRequired?'已保存新的摄像头。请重启 Homebridge 使配件变更生效。':'选择已保存，正在连接摄像头。配对码见摄像头启动日志中的 Setup Code。';await status();}catch(error){showError(error);}finally{$('save').disabled=false;}};
   $('enable').onclick=async()=>{clearError();try{if(!configs.length){configs=[{platform:'MijiaRemoteCamera',name:'米家远程摄像头',region:$('region').value}];await homebridge.updatePluginConfig(configs);}await homebridge.savePluginConfig();$('bootstrapText').textContent='已保存。请在 Homebridge 首页重新启动，再回到这里检查连接。';}catch(error){showError(error);}};
   $('check').onclick=status;
-  function resetNight(){++nightGeneration;$('nightMode').disabled=true;$('nightSave').disabled=true;$('nightState').textContent='读取摄像头实际模式后可修改。';}
+  function resetNight(){clearMatterPairing();++nightGeneration;$('nightMode').disabled=true;$('nightSave').disabled=true;$('nightState').textContent='读取摄像头实际模式后可修改。';}
   async function nightRequest(write=false){
     if(nightBusy)return;nightBusy=true;const generation=nightGeneration;$('nightRead').disabled=true;$('nightSave').disabled=true;$('nightMode').disabled=true;
     $('nightState').textContent=write?'正在修改并核对摄像头模式…':'正在读取摄像头实际模式…';
@@ -231,8 +277,27 @@
     configs=[next,...configs.slice(1)];await homebridge.updatePluginConfig(configs);await homebridge.savePluginConfig();
     $('featureState').textContent='配置已保存，请重启摄像头子桥以应用。';
   }catch(error){showError(error);}};
-  async function init(){try{homebridge.hideSchemaForm();try{const components=await request('/components');if(components.ready===false)$('components').classList.remove('hide');}catch{}configs=await homebridge.getPluginConfig();if(!Array.isArray(configs))configs=[];for(const key of ['enableAudio','enableTalkback','enableNightVision'])$(key).checked=configs[0]?.[key]!==false;$('enableTalkback').disabled=!$('enableAudio').checked;const region=configs[0]?.region;if(regions.includes(region))$('region').value=region;if(!configs.length)$('bootstrap').classList.remove('hide');await status();try{const pending=await request('/auth/status');if(pending.state==='waiting'){loginId=pending.loginId;setLoginBusy(true);$('authState').textContent='先前的授权仍在等待确认。也可取消后生成新链接。';pollTimer=setTimeout(pollAuth,1000);}}catch{}statusTimer=setInterval(status,5000);clockTimer=setInterval(()=>{if(connected)renderRuntime();},1000);}catch(error){showError(error);}}
-  window.addEventListener('beforeunload',()=>{clearInterval(statusTimer);clearInterval(clockTimer);clearTimeout(pollTimer);});
+  for(const key of ['enableMatter','matterPort','matterInterface'])$(key).onchange=()=>{matterDirty=true;clearMatterPairing();renderMatter();};
+  $('saveMatter').onclick=async()=>{clearMatterPairing();try{
+    const port=Number($('matterPort').value), networkInterface=$('matterInterface').value.trim();
+    if(!Number.isInteger(port)||port<1024||port>65535||!/^[A-Za-z0-9_.:-]{1,40}$/.test(networkInterface)){ $('matterConfigState').textContent='请填写 1024–65535 的整数端口和有效的网卡名称。';return; }
+    const next={...(configs[0]||{platform:'MijiaRemoteCamera',name:'米家远程摄像头',region:$('region').value}),enableMatter:$('enableMatter').checked,matterPort:port,matterInterface:networkInterface};
+    const updated=[next,...configs.slice(1)];await homebridge.updatePluginConfig(updated);await homebridge.savePluginConfig();configs=updated;matterDirty=false;matterRestartPending=true;
+    $('matterConfigState').textContent='配置已保存，请重启摄像头子桥并重新打开本页。';renderMatter();
+  }catch{ $('matterConfigState').textContent='Matter 配置未能保存，请重试。';renderMatter();}};
+  async function matterAction(action){
+    if(!matterReady()||matterBusy)return;clearMatterPairing();const generation=matterGeneration;matterBusy=true;renderMatter();$('matterActionState').textContent='正在处理…';
+    try{const value=await request('/matter/'+action);if(generation!==matterGeneration)return;
+      if(action==='pairing'){
+        if(!/^(?:\d{11}|\d{21})$/.test(value?.manualPairingCode)||typeof value?.qrPairingCode!=='string'||!/^MT:[0-9A-Z.:-]{10,250}$/.test(value.qrPairingCode))throw Error('matter_pairing_unavailable');
+        $('matterManualCode').value=value.manualPairingCode;$('matterQrCode').value=value.qrPairingCode;$('matterPairingPanel').classList.remove('hide');$('matterActionState').textContent='已显示私密配对码，请在自己的控制器中完成配对。';
+      }else{matterValue=safeMatterStatus(value);$('matterActionState').textContent=action==='open-window'?'配对窗口已打开，可显示配对码。':'配对窗口已关闭。';}
+    }catch(error){if(generation!==matterGeneration)return;clearMatterPairing();$('matterActionState').textContent=matterMessages[reason(error)]||'Matter 操作未完成，请检查状态后重试。';}
+    finally{matterBusy=false;renderMatter();}
+  }
+  $('matterPairing').onclick=()=>matterAction('pairing');$('matterOpen').onclick=()=>matterAction('open-window');$('matterClose').onclick=()=>matterAction('close-window');
+  async function init(){try{homebridge.hideSchemaForm();try{const components=await request('/components');if(components.ready===false)$('components').classList.remove('hide');}catch{}configs=await homebridge.getPluginConfig();if(!Array.isArray(configs))configs=[];for(const key of ['enableAudio','enableTalkback','enableNightVision'])$(key).checked=configs[0]?.[key]!==false;$('enableTalkback').disabled=!$('enableAudio').checked;$('enableMatter').checked=configs[0]?.enableMatter===true;$('matterPort').value=String(Number.isInteger(configs[0]?.matterPort)?configs[0].matterPort:5540);$('matterInterface').value=typeof configs[0]?.matterInterface==='string'?configs[0].matterInterface:'eth0';const region=configs[0]?.region;if(regions.includes(region))$('region').value=region;if(!configs.length)$('bootstrap').classList.remove('hide');await status();try{const pending=await request('/auth/status');if(pending.state==='waiting'){loginId=pending.loginId;setLoginBusy(true);$('authState').textContent='先前的授权仍在等待确认。也可取消后生成新链接。';pollTimer=setTimeout(pollAuth,1000);}}catch{}statusTimer=setInterval(status,5000);clockTimer=setInterval(()=>{if(connected)renderRuntime();},1000);}catch(error){showError(error);}}
+  window.addEventListener('beforeunload',()=>{clearMatterPairing();clearInterval(statusTimer);clearInterval(clockTimer);clearTimeout(pollTimer);});
   init();
 })();
 </script></body></html>

package/homebridge-ui/server.js

@@ -13,7 +13,9 @@ const SAFE_REASONS = new Set(['plugin_not_running', 'invalid_request', 'unauthen
   'unsupported_transport', 'no_video', 'connect_timeout', 'backend_failed', 'storage_failed',
   'runtime_in_use', 'query_timeout', 'unsupported_platform', 'bundled_runtime_missing', 'not_selected', 'auth_in_progress',
   'runtime_components_missing', 'runtime_components_invalid', 'night_vision_unsupported', 'night_vision_unavailable',
-  'night_vision_rejected', 'night_vision_not_applied', 'night_vision_timeout']);
+  'night_vision_rejected', 'night_vision_not_applied', 'night_vision_timeout',
+  'matter_disabled', 'matter_not_ready', 'matter_start_failed', 'matter_port_in_use', 'matter_configuration_invalid',
+  'matter_pairing_unavailable', 'matter_window_failed', 'matter_closed']);
 
 function failureReason(error) {
   if (['ENOENT', 'ECONNREFUSED'].includes(error?.code)) return 'plugin_not_running';
@@ -52,6 +54,9 @@ export function createUiHandlers(runtime) {
       deviceId: id(payload?.deviceId), name: label(payload?.name, '米家摄像头'), model: label(payload?.model, 'Xiaomi Camera'),
       region: ['cn', 'de', 'us', 'ru', 'sg', 'i2'].includes(payload?.region) ? payload.region : 'cn' }),
     '/status': () => runtime.request('status', {}),
+    '/matter/pairing': () => runtime.request('matter.pairing', {}),
+    '/matter/open-window': () => runtime.request('matter.openWindow', {}),
+    '/matter/close-window': () => runtime.request('matter.closeWindow', {}),
     '/night/get': () => runtime.request('night.get', {}),
     '/night/set': payload => {
       if (!['auto', 'on', 'off'].includes(payload?.mode)) throw new Error('invalid_request');

package/lib/diagnostics.mjs

@@ -1,3 +1,4 @@
+import { safeMatterStatus } from './matter-diagnostics.mjs';
 const states = new Set(['idle', 'starting', 'ready', 'retrying', 'blocked', 'stopped', 'paused']);
 const stages = new Set(['device_lookup', 'provisioning', 'relay_connect', 'authentication', 'waiting_video']);
 const reasons = new Set(['not_selected', 'starting', 'ready', 'stopped', 'retrying', 'connect_timeout',
@@ -95,6 +96,10 @@ export function safeDiagnostics(value = {}) {
     if ([1, 2].includes(value.audio.channels)) audio.channels = value.audio.channels;
     result.audio = audio;
   }
+  if (record(value.matter)) {
+    const matter = safeMatterStatus(value.matter);
+    if (Object.keys(matter).length) result.matter = matter;
+  }
   if (value.media === null) result.media = null;
   else if (record(value.media)) {
     const media = safeMediaDiagnostics(value.media);