配對 Amazon Alexa
依 Stable 2.0.55 的 Alexa 相容規則規劃第一座 Bridge：首次 commissioning 使用 5540、控制裝置規模，並把 cover、light 與 vacuum 的專用 flags 當成可回退的 workaround。
Alexa 的第一座 Bridge 需要特別規劃
Matter Hub 是 Bridge，Alexa 是 Matter Controller。Alexa 納管時不會理解 Home Assistant 的 Dashboard 或所有 domain，而是依 Bridge 宣告的 Matter device type 與 cluster 建立 Alexa 裝置。Stable 2.0.55 上游明確說明 Alexa 只會在埠 5540 完成配對；因此每座 Bridge 第一次交給 Alexa 納管時，目標 Bridge 都必須是當下使用 5540 的那一座。
埠規則、裝置規模、Feature Flags 是三件不同的事：5540 解決首次 commissioning 相容性；約 80–100 個 bridged devices 是上游文件所述的實務 Controller 規模規劃範圍，而非 Matter 協定硬上限；Alexa flags 則只針對特定 UI／命令差異。不要用其中一項解釋所有故障。
開始前的 Alexa 檢查表
| 項目 | 必要檢查 | 不符合時先做什麼 |
|---|---|---|
| Alexa App／帳號 | App 已更新、登入目標 Amazon 帳號，且你可管理正確的 Home。 | 先修正帳號與家庭，不開 commissioning window。 |
| 相容 Echo／Controller | 依 Amazon 官方 Matter 文件確認使用的 Echo 可作 Matter Controller。 | 不要只因有 Alexa 語音裝置就假設支援。 |
| 第一座 Bridge 埠 | 計畫給 Alexa 首次納管的 Bridge 使用 5540，且沒有其他程序占用。 | 停止建立重複 Bridge，先釐清埠占用與優先序。 |
| 本機網路 | Echo、手機與 Matter Hub 可透過 IPv6 與 mDNS 在區域網路發現。 | 修正 VLAN／multicast／介面，不做 port forwarding。 |
| 規模與內容 | 先用遠低於實務上限的小量基本型別，Devices 與 Filter 可預覽。 | 分拆或排除 unsupported 類型，不一次暴露全部 HA。 |
為何首次 commissioning 要用 5540
v2.0.55 固定文件明確指出：Alexa 在其他埠完成 AddNOC 後，配對仍會回復；只有當下位於 5540 的 Bridge 能完成 Alexa commissioning。實務策略是讓 Alexa 核心 Bridge 固定使用 UDP 5540 並以小規模納管；其他 Controller 可加入其他埠的 Bridge，或作為額外 Fabric 加入這座核心 Bridge。這不代表公開防火牆埠就能遠端配對。
- 5540 是本機 Matter 服務埠；不應轉送到網際網路，也不應公開暴露。
- 同一主機若已有 Bridge 使用 5540，不要讓第二座搶同一埠；先決定哪一座是 Alexa 核心 Bridge。
- 已配對後改埠會擴大變因。先備份、評估所有 Fabric、選維護窗，而不是為測試隨意切換。
- 看到非 5540 警告時，先把它當 Alexa 相容性風險；不代表其他 Controller 一定失敗。
約 80–100 個裝置是實務規劃值
上游文件對 Alexa 提供約 80–100 個 bridged devices 的實務 Controller 規模指引時，應把它當規劃區間，不是保證值、精確硬上限，也不是 Matter Hub 建立 Endpoint 的理論上限。實際容量會受 Echo 型號與軟體、Endpoint 複雜度、cluster 數量、訂閱、網路品質及同一 Alexa Home 既有裝置影響。
| 規模階段 | 做法 | 觀察 |
|---|---|---|
| 基線 | 先加入少量基本燈／開關。 | commissioning 時間、發現完整度、控制及狀態延遲。 |
| 逐批擴充 | 每批加入同類、有限數量 Endpoint。 | Alexa App 是否全部出現、語音是否重名、subscription 是否穩定。 |
| 接近實務區間 | 在遠低於出問題的點就規劃 Bridge 分拆。 | Echo 資源、重啟恢復、單一錯誤是否拖累全部。 |
| 超過區間 | 不要引用上游區間承諾可用；依區域／類型拆 Bridge 並逐座驗證。 | 多 Bridge 與埠策略也需 Alexa 實測。 |
裝置數應以 Alexa 實際建立的 bridged devices／Endpoint 規模理解，不以 Home Assistant entity 數直接換算；組合裝置可能有多個 Endpoint，某些 HA 實體則不會成功映射。記錄時只用數量與類型，不記內部識別資料。
Cover、light、vacuum 的相容 flags
| 用途 | Stable 2.0.55 行為意圖 | 代價／限制 |
|---|---|---|
| Cover as dimmable light | 把 Alexa 不易呈現的 cover 以可調光燈語意暴露，讓開關／百分比控制可用。 | 裝置類型與語音語意不再是窗簾；其他 Controller 可能顯示成燈，適合 Alexa 專用 Bridge。 |
| alexaPreserveBrightnessOnTurnOn | Alexa 開燈時保留既有亮度，避免 turn on 同時覆寫亮度。 | manifest 明確標 Alexa yes、Apple／Google no；不要把它當跨 Controller 通用改善。 |
| vacuumOnOff | 為 Controller 提供較簡化的吸塵器開／關式控制路徑。 | 不等於完整房間清掃、模式、進度、返回充電座能力；需逐項驗證 Alexa 支援。 |
| vacuumIncludeUnnamedRooms | 將沒有可用名稱的房間也納入吸塵器服務區域映射。 | 可能產生難辨識項目；先在 HA 為區域建立乾淨名稱。 |
Feature Flag 應一次只改一項，保存前截取不含秘密的設定紀錄，重啟後測 Alexa App、語音、HA 狀態及其他 Fabric。Cover-as-light 這類改變裝置語意的 workaround 最適合獨立 Alexa Bridge；如果同一 Bridge 同時給 Apple 或 Google，可能為解決 Alexa 而破壞其他 Controller 呈現。
Stable 不等於 Alexa 全型別支援
| 事實層 | 結論 | 不能延伸的承諾 |
|---|---|---|
| Release channel | 本章固定 Matter Hub Stable v2.0.55 與 pinned Stable Add-on。 | 不包含 Alpha／Testing 或後續 callback 架構。 |
| 產品成熟度 | 一般 Bridge 與上述既有 flags 位於 Stable。 | Server Mode、Camera／Security Plugins、部分 Matter 1.4 類型仍為 Stable 內實驗性。 |
| Alexa support | Amazon 官方列出 Alexa Matter 裝置支援；上游另提供少數 Alexa workaround。 | 不能因有 flag 就宣稱裝置獲 Amazon 認證或所有屬性完整。 |
| 規模 | 約 80–100 是有上游來源的實務 Controller 規劃區間。 | 不是最低保證、精確上限或所有 Echo 共通 SLA。 |
建立並配對 Alexa 核心 Bridge
保留 5540 與核心內容
在 Matter Hub 建立或編輯預計最先給 Alexa 的 Bridge，確認使用 5540 且無衝突；Filter 先只含少量已知基本裝置。
啟動並做 Matter Hub 端預檢
確認 Bridge 執行、Devices 無映射失敗、HA 原始實體可操作。備份持久化資料，配對期間凍結埠、名稱與結構。
開啟 commissioning window
從目標 Bridge 顯示當次 QR。不要截圖、轉傳、記錄或把手動資料貼到 Amazon 支援內容。
在 Alexa App 新增 Matter 裝置
於 Devices 的新增流程選 Matter device 或當前 App 的同義入口，掃描本機 QR，選擇目標 Home 並保持 App 前景。
等待探索 bridged devices
納管完成後讓 Alexa 完成裝置探索，不在此時 Force Sync、改 Filter 或重啟 Echo。確認少量基線裝置出現。
測 App、語音與雙向狀態
從 Alexa App 與語音各操作一個裝置，再由 HA 操作並確認 Alexa 更新。記錄類型與結果，不記任何內部識別值。
小批擴充或分拆
一次增加同類少量裝置；若需要 cover-as-light 或 vacuum workaround，優先在 Alexa 專用 Bridge 測，避免改變其他 Fabric 的語意。
Alexa 常見卡關
出現非 5540 警告
停止首次納管，確認這是否為第一座 Alexa Bridge。若尚未配對，重新規劃讓核心 Bridge 使用 5540；若已有 Fabric，不要直接換埠，先備份與評估影響。
Alexa App 找不到 Bridge
確認 Echo 支援 Matter、window 有效，以及 Echo／手機與 Matter Hub 間的 IPv6、mDNS 路徑。不要用公網轉送或分享 QR 繞過本機發現。
只探索到部分裝置
比較 Devices、Filter 與 Alexa 官方 device type 支援；檢查是否接近實務規模、名稱重複或 Endpoint 過於複雜。先分批，不 reset 全部。
窗簾沒有可用控制
先確認 Alexa 原生 cover 呈現限制；若評估 cover-as-dimmable-light，放在 Alexa 專用 Bridge 並接受類型變成燈的代價。
開燈時亮度跳變
只在可重現 Alexa turn-on 覆寫亮度時測 alexaPreserveBrightnessOnTurnOn；此 flag 的 Controller support 是 Alexa yes，不是跨平台設定。
吸塵器只有開關或房間不完整
基本 on/off 不代表完整 vacuum 支援。核對 vacuum flags、區域名稱及 Alexa 官方能力；房間／模式／進度逐項記為 yes、partial 或 unknown。
常見問題
Alexa commissioning 一定要在 5540 嗎？
80–100 個裝置是保證容量嗎？
Cover as light 會影響 Apple 或 Google 嗎？
開啟 alexaPreserveBrightnessOnTurnOn 能改善所有 Controller 嗎？
Alexa 有吸塵器卡片就代表完整支援房間清掃嗎？
固定版本與 Amazon 官方來源
- v2.0.55 Bridge Configuration（5540 與約 80–100 實務規模）
- Matter Hub v2.0.55 README 與 release notes
- v2.0.55 Feature Flags
- Pinned Add-on changelog
- Amazon Alexa Smart Home：Matter support
- Amazon Help：Connect Your Matter Device to Alexa
約 80–100 的數字只應作上游實務規模規劃，不作 Amazon 官方硬上限或保證容量。