Matter Hub 指南

Matter Hub 提示詞庫 · Stable 2.0.55

52 條可搜尋、可複製的工作提示

把中括號佔位符換成你的環境資料。提示詞預設先查證、先預覽、再變更;涉及 reset、restore、Fabric 或 Plugin 時仍要由你批准。

按下卡片的「複製」按鈕即可複製完整提示詞。

規劃與盤點

以 Home Assistant Matter Hub Stable 2.0.55 規劃 [住家/場域名稱]。先盤點 [HA 版本]、[實體數量]、[Controller 清單]、[網路區段] 與 [維運責任人],只提出缺口與待確認問題,不變更任何設定。

根據 [實體清單檔案] 產出 Matter Hub 導入範圍:依區域、domain、風險與 Controller 分組,列出建議納入、排除及需要實測的項目。

為 [場域名稱] 建立從實驗室到正式環境的分階段計畫,每階段寫清楚進入條件、測試樣本、驗收證據、回復點與停止條件。

比較 [目前架構] 與導入 Matter Hub 後的責任邊界,特別標出 Home Assistant、Matter Hub、外部 Matter Controller 與 Thread Border Router 各自負責什麼。

Bridge 設計

依 [樓層/區域清單]、[端點數量]、[Controller 清單] 與 [風險分級],提出 Bridge 分拆方案;說明每座 Bridge 的用途、filter 邊界與故障影響範圍。

為 [Bridge 名稱] 設計可長期維持的識別與命名規則。列出哪些欄位變更可能造成 Controller 端重複裝置或需要重新配對。

檢視 [現有 Bridge 設定],找出埠號衝突、啟動優先序、同步策略、session recovery 與 watchdog 的風險;只給建議,不直接修改。

為 [Controller 名稱] 規劃一座最小試點 Bridge,只選 [裝置類型清單] 中的低風險實體,並列出擴大前必須通過的測試。

Filters

把 [需求敘述] 轉成 Stable 2.0.55 Filter Engine 規則草案,分開寫 Include 與 Exclude,說明 ANY/ALL 的判斷,並提供預期命中與誤命中案例。

檢查 [filter 設定] 是否可能過度暴露。以 area、label、domain、platform、pattern 與 regex 逐條分析,優先採最小 include。

為 [區域名稱] 建立 filter 測試表,欄位含 [entity_id]、屬性、預期納入/排除、實際結果與差異原因;不要假設預覽等於 Controller 最終呈現。

重構 [現有 filter] 以降低重複 matcher,但保持命中結果不變。先列出等價性驗證方法與回退版本,再提供草案。

映射與組合實體

檢視 [實體清單] 的 Matter 映射候選,逐項列出來源 domain、建議 device type、必要屬性、關聯實體與 Controller 實測需求。

為 [主實體] 規劃 composed device,候選關聯實體為 [電量/功率/能源/溫濕度實體]。解釋每個關聯的價值、缺值行為與 debounce 測試。

分析 [映射失敗清單]:依缺少屬性、不支援 domain、override 錯誤、命名衝突與 Controller 不支援分類,給出可驗證的修正順序。

比較 [mapping profile A] 與 [mapping profile B] 對 [裝置類型] 的差異;只引用 v2.0.55 exact-tag 可證實欄位,未知處標示待實機驗證。

裝置類型

為 [燈/開關/鎖/窗簾/空調/風扇] 建立功能驗收矩陣,欄位含 HA 能力、Matter 映射、Controller 顯示、控制、狀態回報與限制。

為 [感測器/二元感測器/天氣/空氣品質/能源/電池] 建立只讀驗收清單,特別檢查單位、device class、精度與 unavailable 狀態。

評估 [媒體播放器/閥門/熱水器/警報/事件/吸塵器/割草機] 是否適合進正式 Bridge;區分 v2.0.55 支援、實驗性與 Controller 端待驗證。

檢查 [裝置類型] 的 feature flags。逐項說明預設值、改動目的、可能的 Controller workaround、回歸測試與回復方式。

Apple/Google/Alexa

為 Apple Home 與 [Bridge 名稱] 撰寫配對前檢查,只涵蓋家庭中樞、網路、Bridge 狀態、低風險測試裝置與去識別化證據,不輸出配對碼。

為 Google Home 的 [裝置類型清單] 建立同步與房間整理測試,記錄 app 顯示名稱、控制項、狀態回報、語音結果及不支援項目。

為 Amazon Alexa 的 [Bridge 名稱] 規劃首次配對與規模試驗,逐批增加 [批次大小] 個 endpoint;任何數量都只當環境觀察值,不寫成通用上限。

比較 Apple Home、Google Home 與 Amazon Alexa 對 [同一組裝置] 的呈現。按 Controller 分開結論,不用其中一個的成功推論另外兩個。

Aqara/SmartThings

為 Aqara [Hub 型號/韌體版本] 設計 Matter Hub 試點,列出需確認的地區、device type、app 顯示與基本控制;不可先承諾相容。

為 SmartThings [Hub 型號/韌體版本] 建立配對、driver/device type、房間、控制與狀態回報測試表。

比較 Aqara 與 SmartThings 對 [裝置類型清單] 的已驗證、未驗證與不適用項目;每個結論附來源或實測證據欄位。

收到 [Controller 錯誤訊息] 後,建立最小重現流程:同網段基準、單一 Bridge、單一裝置類型、去識別化 log 與停止條件。

Multi-Fabric

為 [Bridge 名稱] 規劃加入 [Controller A] 與 [Controller B] 的 multi-fabric 流程;先備份,記錄加入順序、狀態、責任人與移除回復方式,不顯示任何配對秘密。

檢視 [Fabric 狀態摘要] 是否有 orphan、session 或 subscription 異常。只提出唯讀檢查與證據需求,不執行移除或 reset。

設計 multi-fabric 回歸測試:在 [Controller A] 操作 [裝置],確認 [Controller B] 與 HA 狀態回報,並記錄延遲、離線與重連結果。

為移除 [指定 Fabric] 寫變更計畫,包含影響盤點、批准、備份、停機通知、操作後驗證與失敗時回復;不要直接執行。

網路與發現

依 [網路拓撲] 檢查 Matter Hub、Controller、VLAN、IPv6、mDNS 與防火牆前提。輸出測試順序,不要求提供私有 IP 或 hostname。

針對 [配對找不到裝置] 建立診斷樹:先確認服務狀態,再查 IPv6、mDNS、跨 VLAN、Wi-Fi/Thread 與 Controller;每步寫預期證據。

分析 [去識別化 mDNS 測試結果],區分沒有廣播、無法跨網段、回覆被防火牆擋下、名稱解析與應用層錯誤。

為 [反向代理/Ingress 路徑] 寫 base path 與驗證檢查。Basic Auth 只當單層驗證,不推論成多帳號、RBAC 或 SSO。

診斷與維運

根據 [去識別化 Health 摘要],按 HA 連線、Bridge、Fabric、session、subscription、mDNS 與資源使用排序可能原因,先做無破壞檢查。

分析 [去識別化系統紀錄] 的 [時間範圍],依重複訊息分組,標出第一個根因候選、連鎖錯誤與需要更多證據的地方。

為 [No Response 症狀] 建立最小排錯 runbook,從 Controller、Bridge、HA 實體到網路逐層隔離;不要把 reset 當第一步。

為 [Bridge 名稱] 建立日常監控基線:啟動時間、同步時間、endpoint 數、記憶體、錯誤率、session 與 Controller 回應,門檻使用 [門檻值] 佔位。

安全與審查

審查 [部署設計] 的攻擊面:管理介面、Ingress、反向代理、Basic Auth、IP allowlist、Plugin、API、WebSocket 與秘密儲存,按嚴重度列修正。

檢查 [文件/截圖清單] 是否含 QR payload、manual pairing code、setup PIN、discriminator、Fabric/Node ID、token、cookie、憑證、私有 IP 或 hostname。只回報位置,不重述秘密。

為 [安全關鍵實體清單] 設計最小暴露政策,區分可讀、可控、需要人工確認與禁止暴露,附例外批准流程。

審查 [變更計畫] 是否在 Plugin 安裝、reset、restore、Fabric 移除前包含備份、影響、回復與授權;缺少時阻止執行。

Plugins/API

盤點 Stable 2.0.55 的 Plugin、REST API、WebSocket、health 與 metrics。每項標示來源、release channel、成熟度、驗證方式與是否為實驗性。

為安裝 [Plugin 套件佔位] 寫安全審查表:來源、版本、完整性、權限、schema、secret、circuit breaker、停用與移除回復;不要執行安裝。

根據 [API 需求] 設計最小權限與唯讀優先的呼叫流程。所有 URL、token、header 與識別值均使用佔位符,並處理錯誤與 rate limit。

為 [WebSocket 事件] 建立觀察測試,記錄連線、訂閱、事件格式、斷線重連與敏感欄位遮蔽;不得把 callback architecture 寫成 Stable 功能。

備份與復原

為 [部署方式:Add-on/Docker/npm] 產出 Stable 2.0.55 備份範圍,包含持久化設定、Bridge 身份、assets、Plugin 資料與外部依賴;未知路徑先查 exact-tag。

設計 [Bridge 名稱] 的復原演練:驗證備份可讀、建立隔離環境、還原、比對身份與 endpoint、測 Controller;不得直接在正式環境 Restore。

為從 [舊主機] 遷移到 [新主機] 寫停機計畫,包含版本鎖定、資料複製、網路身份、驗證、回退與 Fabric 風險,不輸出任何秘密。

針對 [升級/損毀/誤刪情境] 建立災難復原表,欄位含 RPO [目標值]、RTO [目標值]、責任人 [角色]、操作步驟、證據與宣告失敗條件。