配對 Google Home
用最小 Bridge 與 Google-optimized 設定建立可驗證基線，完成 Google Home App 納管、同步、房間與名稱整理，並正確解讀 Google Controller 的類型限制。
Google Home 是 Controller，不是 HA 同步服務
Home Assistant Matter Hub 將選定實體映射成 Matter Bridge；Google Home 將這座 Bridge 納入 Google 的 Matter Fabric。這條路徑與傳統雲端 Works with Google Home 連結不同：你不是把整個 Home Assistant 帳號同步給 Google，而是讓 Google Controller 在本機 Matter 網路中管理 Bridge 宣告的 Endpoint。
因此，「同步」有兩個不同語意：Matter subscription 負責裝置狀態持續回報；Google Home App 的房間、顯示名稱與家庭資料則由 Google 生態系統管理。不要期待 HA Area、Dashboard 或自動化完整複製，也不要把語音重新同步指令當成修復 Fabric 的萬用步驟。
開始前確認 App、Hub 與本機網路
| 前提 | 檢查方式 | 風險 |
|---|---|---|
| Google Home App | 更新 App，登入目標 Google 帳號，確認你可在目標家庭新增裝置。 | 加到錯誤家庭或缺少管理權限。 |
| Matter Hub／Thread border router | 依 Google 官方支援清單確認家中有相容的 Google Hub；Matter Hub Bridge 本身走區域網路，並非 Thread 終端。 | 遠端與長期連線不穩，或誤把 Thread 問題套到 Ethernet／Wi-Fi Bridge。 |
| IPv6 與 mDNS | 手機、Google Hub 與 Matter Hub 之間有可達的本機 IPv6 與 multicast 服務發現。 | 找不到、加入逾時、裝置離線。 |
| Bridge 內容 | Bridge 正在執行，Devices 映射與篩選預覽只含預期實體。 | 加入成功後大量 unsupported 或重複裝置。 |
| 持久化備份 | 確認 Stable Add-on 或容器的資料路徑已備份且重啟後保留。 | 身分遺失造成 Google Home 出現舊、新兩份 Bridge。 |
Google Home Optimized 範本與 Google Home profile
Stable 2.0.55 有兩個不同概念。Google Home Optimized 是 Bridge template：include all entities，並開啟 autoForceSync、battery、humidity、pressure mapping。Google Home 是 Controller profile：除了同一組 flags，還額外開啟 autoComposedDevices。兩者都只是起始設定，不是 Google 認證或永久鎖定；選其中一個不等於也選了另一個，最終仍由 Filter、Entity Mapping、Feature Flags 與 Google 支援的 Matter device types 共同決定結果。
分開選範本與 profile
新 Bridge 可選 Google Home Optimized template；Controller 階段再獨立選 Google Home profile。先閱讀兩者 flags，不直接以名稱推斷全部相容，也不要假設選一個會連動另一個。
縮小 Filter
先納入少量基本燈、開關或插座；排除 unavailable、診斷實體與尚未驗證的新型別。
預覽映射
逐項確認 Matter device type、名稱及失敗原因。範本不會把 Google 尚未呈現的類型變成可用 UI。
保存並建立基線
啟動 Bridge 後先在 Matter Hub 測試 HA 狀態，再進入 Google Home commissioning。納管後避免同時切換多個 profile／flag。
Release channel、成熟度、Google 支援
| 面向 | 可確認事實 | 保守解讀 |
|---|---|---|
| Release channel | 本章只使用 Matter Hub Stable v2.0.55 與 pinned Stable Add-on。 | 不引用 Testing／Alpha 的 callback 行為或未固定畫面。 |
| 產品成熟度 | 一般 Bridge、Filter、Mapping 與 commissioning 屬 Stable 流程。 | Server Mode 多實體、Camera／Security Plugins 與部分 Matter 1.4 類型仍是 Stable 內實驗性。 |
| Google Controller | Google 官方列出 Google Home 的 Matter device type 支援與相容 Hub。 | upstream manifest 未逐型別認證 Google；裝置出現、控制與狀態回報要實測。 |
版本號也分層：Matter Hub 的 v2.0.55 不是 Matter 規格版本；Google Home App、Google Hub firmware 與 Matter device type 支援又各自演進。寫排錯紀錄時分開記，不要只寫「都是最新版」。
在 Google Home App 納管 Bridge
凍結 Bridge 設定
在 Matter Hub 的 Bridges 與 Devices 確認目標 Bridge 執行中、內容精簡，配對期間不變更埠、網路介面、Filter、名稱或映射。
顯示當次配對入口
在 Bridge 配對區開啟 commissioning window。只讓 Google Home App 直接掃描本機 QR；不要拍照保存、轉傳或記錄任何手動配對資料。
在 Google Home 新增 Matter 裝置
開啟 Google Home App 的新增裝置流程，選擇 Matter-enabled device 或畫面中的同義入口，掃描 QR，確認加入的是目標家庭。
保持 App 前景並等待完成
讓手機留在可達本機網路，避免 VPN 改變路徑；期間不重啟 Google Hub、Matter Hub 或路由器。若逾時，先確認是否其實已建立 Fabric。
指派初始房間與名稱
依 App 提示指派代表裝置；大量 Endpoint 可在配對後逐房整理。使用簡短唯一名稱，避免與房間或其他生態系統的語音名稱衝突。
驗證控制與 subscription
Google Home 操作一個低風險裝置並看 HA 狀態；再從 HA 操作並確認 Google Home 更新。控制成功但狀態停舊值要查 subscription，而非重配。
在穩定後才擴充
經過 Matter Hub 重啟與日常觀察仍正常，再一次加入少量同型別 Endpoint。每次保留可回退的 Filter 與設定紀錄。
Google Home 的 sync、room、name 行為
| 資料 | 主要管理處 | 是否應期待跨系統同步 |
|---|---|---|
| HA 實體狀態 | Home Assistant；經 Matter Hub 映射與 Matter subscription 回報。 | 應驗證雙向更新，但不是複製 HA 歷史或 Dashboard。 |
| Google 顯示名稱 | Google Home App。 | 不保證回寫 HA，也不會自動同步 Apple／Alexa。 |
| Google 房間 | Google 家庭內。 | 不等同 HA Area；Multi-Fabric 不複製房間。 |
| 語音別名 | Google Assistant／Home 的名稱解析。 | 需避免同音與重複，不靠修改 HA entity_id 解決。 |
| 新增／移除 Endpoint | Matter Hub Bridge 結構。 | Controller 對動態 Bridge 變更的反應可能不同；大量變更前先測。 |
Google 生態系統的「同步我的裝置」語音命令常與雲端帳號連結一起討論；Matter Fabric 的裝置發現與訂閱不是同一機制。若新 Endpoint 沒出現，先看 Bridge 結構、Controller 對 bridged endpoint 動態變更的處理與 Matter Hub Force Sync 說明，不要只重複語音同步。
用官方 device type 清單界定限制
Google 官方文件列出的 Matter 支援類型，是判斷 Google Controller 能力的第一層證據；未列出、只在較新 Matter 規格出現或需要特定 cluster 的類型，應標「unknown」或「partial」，而非依 Matter Hub 可映射就寫成支援。即使列出，也可能只有基本命令，進階模式、能源資料、事件、服務區域或通知未被 Google Home UI 使用。
- 房間不會自動指派：v2.0.55 會透過 FixedLabel 傳送 HA area 名稱，但 Google Home 等主要 Controller 目前不讀它來自動分房；你要在 App 手動指派。
- Standalone ModeSelect 無控制 UI：Google 公開 device type 清單沒有獨立 ModeSelect，App 只會顯示通用資訊而沒有 options 控制；雲端 Google Assistant 的 Modes 是另一條非 Matter 路徑。
- 窗簾不能作 Google Home Automation action：WindowCovering 可基本控制，但上游固定文件記錄在 Automation 選動作時沒有可用 action；可改由 HA automation 或語音 routine。
- Robot vacuum 是部分支援：基本 start／stop 可用，room selection 與 cleaning modes 依 Google 版本而異，不應因卡片出現就宣稱完整。
- 較新 Matter 1.4 類型：Water heater、energy override 等在 Google 清單可能是 no 或 unknown；Matter Hub 端若標實驗性，還要另揭露產品成熟度。
Google Home 常見卡關
App 掃描後找不到裝置
確認 window 尚有效、Bridge 正在執行、手機與 Google Hub 可達 Matter Hub 的 IPv6／mDNS。停用會改路徑的 VPN 後再試，不公開配對資料。
停在連線或準備裝置
保持 App 前景並停止其他網路變更；查看 Matter Hub 是否已出現 Google Fabric。若已建立，不要立即重掃造成重複與不明狀態。
有些 Endpoint 未出現
先看 Devices 映射與 Filter，再對照 Google 官方 supported device types。以同 Bridge 的基本燈作對照；特殊型別可分拆測試。
可操作但狀態延遲
比較 HA 與 Google Home，觀察 session／subscription；查上游 v2.0.55 已固定的 Google subscription 行為，不以移除 Fabric 當第一步。
房間或名稱沒有跟 HA 一致
這不是同步失敗。Google room/name 是 Controller 資料；在 Google Home 整理，避免同時改 HA、Bridge 與 Google 三層名稱。
重啟後出現重複 Bridge
停止再次配對，確認持久化資料與 Stable Identity，保留現有 Fabric。先備份並比對 Bridge 是否失去原身分，再規劃 Controller 端清理。