適用版本：0.7.1 中文名稱：裝置平台同步 English name: Cross-Platform Device Sync
「裝置平台同步」是 Home Assistant 的自訂整合。它可以把一組指定的裝置， 自動同步到 Google Home、HomeKit 或 Matterbridge。
這份手冊以一般使用者為主，不需要了解程式設計。
- 這個外掛在做什麼
- 開始前要準備什麼
- 安裝外掛
- 第一次設定
- 如何選擇同步來源
- 如何選擇目標平台
- 額外加入與排除怎麼用
- 如何暫停與重新啟用
- 外掛什麼時候會同步
- 如何修改設定
- 預覽與立即同步
- 規劃各平台的安全規則
- 常見問題
- 更新或移除外掛
- 快速設定範例
這個外掛監視的是：
哪些裝置應該出現在各個智慧家庭平台。
例如，您可以指定：
- 以 Home Assistant 某幾個儀表板頁面中的裝置為準。
- 自己手動勾選一組裝置。
- 以目前 HomeKit、Google Home 或 Matterbridge 中的裝置為準。
- 再選擇要同步到 Google Home、HomeKit、Matterbridge 中的哪些平台。
它會自動比較來源與目標：
- 沒有變更時，不會重複同步。
- 有新增裝置時，加入已選的目標平台。
- 有移除裝置時，從已選的目標平台移除曝光。
- 各平台可以另外指定一定要加入或一定要排除的裝置。
- 更新失敗時，會盡量回復到更新前的設定。
每個已勾選目標都會收斂成精確清單：（來源 − 該平台排除）∪ 該平台額外加入，
再套用相容性與受保護規則。即使某個裝置在安裝外掛前就已存在於目標，只要它不在
最終清單中，也會從此外掛管理的曝光設定移除。未勾選的目標平台不會被修改。
這個外掛不會：
- 開燈、關燈或切換任何開關。
- 控制門鎖、保全、空調、攝影機或媒體播放。
- 因為溫度、亮度或其他感測值改變就重新同步。
- 刪除 Home Assistant 裡的裝置或實體。
- 複製儀表板的卡片樣式與版面配置。
- 建立額外的感測器或按鈕實體。
- 傳送手機、webhook、外部服務或自訂儀表板通知。
它只管理「裝置是否顯示在目標平台」。配對與重新啟動提示只會顯示在 Home
Assistant 原生的「持續通知」面板。如果自訂儀表板另外把所有 HA 持續通知複製顯示，
該儀表板應自行排除以 platform_sync_ 開頭的通知 ID，避免重複呈現。
第一次啟用前，建議先建立一份 Home Assistant 完整備份。
只需要準備您打算使用的平台：
| 平台 | 事前準備 |
|---|---|
| Google Home | 先完成 Home Assistant 的 Google Assistant 整合與 Google 帳號連結 |
| HomeKit | 先在 Home Assistant 建立並配對 HomeKit Bridge 或 Accessory |
| Matterbridge | 先安裝並啟用 Matterbridge，以及 matterbridge-hass 外掛 |
如果只使用手動來源或 Home Assistant 儀表板來源，不需要先設定所有三個平台； 只要準備您勾選的目標平台即可。
Google Home 作為目標時，需要使用獨立的裝置設定檔。預設檔名是：
google_assistant_entity_config.yaml
Google Assistant 必須關閉「預設曝光全部裝置」。相關設定可合併到原本的 Google Assistant 設定中：
google_assistant:
expose_by_default: false
entity_config: !include google_assistant_entity_config.yaml請不要因此刪除原本 Google Assistant 需要的其他設定。如果您不熟悉 YAML， 建議先請熟悉 Home Assistant 的管理者完成這項一次性設定。
- HomeKit 作為來源時：先建立可正常使用的 HomeKit Bridge／Accessory。
- HomeKit 作為目標時：先決定哪些 HomeKit Bridge／Accessory 可以交給此外掛更新。
- Apple 家庭 App 內原生配對的裝置，不會出現在 HomeKit 來源選單中。
- Matterbridge 必須正在運作。
matterbridge-hass必須已安裝、啟用並連上 Home Assistant。- 準備 Matterbridge 的主機名稱、IP，或完整安全管理端點，以及管理連接埠。
- 若 Matterbridge 已啟用前端驗證，請準備前端密碼。
- 預設管理連接埠是
8283。
本專案採用原始碼公開的非商業授權，因此請用 HACS 自訂儲存庫安裝；它不會列入 HACS 預設目錄。
- 如果尚未安裝 HACS，請先完成 HACS 安裝與設定。
- 開啟自訂儲存庫，在 Repository 欄位輸入
jameslu34/ha-platform-sync，類別選擇整合。 - 在 HACS 找到 Cross-Platform Device Sync 並點選下載。
- 建立 Home Assistant 備份。
- 重新啟動 Home Assistant。
也可以使用 GitHub 專案 README 裡的 Open in HACS 按鈕加入自訂存放庫。
- 從 GitHub 下載最新 Release。
- 將
custom_components/platform_sync資料夾複製到/config/custom_components/platform_sync。 - 確認中間沒有多包一層資料夾。
- 建立 Home Assistant 備份。
- 重新啟動 Home Assistant。
-
前往設定 → 裝置與服務 → 整合。
-
點選右下角的新增整合。
-
搜尋：
- 中文介面：裝置平台同步
- 英文介面：Cross-Platform Device Sync
-
點選整合並開始設定。
此整合只需要建立一個設定項目。如果已經安裝過，請直接打開原本的設定。
設定畫面會依您的選擇自動顯示下一步需要的內容，不需要一次填完所有平台。
畫面上有兩個主要選項：
- 啟用同步：勾選後開始使用跨平台同步。
- 同步來源：選擇哪一組裝置要當作同步基準。
如果不勾選「啟用同步」，按下一步後會直接完成設定，不會再要求其他資料。
下一頁會依來源顯示不同內容：
| 同步來源 | 下一頁會顯示 |
|---|---|
| Home Assistant 儀表板中的裝置 | 選擇一個或多個儀表板頁面 |
| 手動選取的裝置 | 直接勾選實體 |
| HomeKit 中的裝置 | 勾選 HomeKit Bridge／Accessory 設定項目 |
| Google Home 中的裝置 | 直接前往選擇目標平台 |
| Matterbridge 中的裝置 | 直接前往選擇目標平台，連線資料稍後填寫 |
至少勾選一個要同步到的平台：
- Google Home
- HomeKit
- Matterbridge
只會顯示您有勾選的平台設定。
例如：
- 只勾 Google Home，就不會看到 HomeKit 的額外加入與排除設定。
- 只勾 HomeKit，就不會看到 Google Home 的設定檔欄位。
- Matterbridge 若被選為來源，仍需填寫主機與連接埠。
最後一頁會顯示：
- 是否啟用
- 選擇的來源
- 選擇的目標平台
- 儀表板頁面或 HomeKit 來源項目
確認無誤後送出。完成最後一步前，外掛不會先修改任何目標平台。
適合希望「儀表板上有哪些裝置，其他平台就同步哪些裝置」的使用者。
設定方式：
- 選擇「Home Assistant 儀表板中的裝置」。
- 按下一步。
- 複選一個或多個儀表板頁面。
- 按下一步選擇目標平台。
多個頁面中的裝置會合併，重複裝置只計算一次。
如果頁面沒有出現在選單中，可以選擇手動輸入路徑。例如：
- 儀表板路徑：
lovelace - 頁面路徑：
default-view
請不要同時勾選頁面清單與手動輸入路徑。
注意：
- 每個選取的頁面都必須可以正常讀取。
- 所選頁面至少要有一個裝置實體。
- 外掛同步裝置清單，不會同步卡片外觀或排列順序。
適合希望完全自己決定裝置清單的使用者。
設定方式：
- 選擇「手動選取的裝置」。
- 按下一步。
- 勾選一個或多個實體。
- 按下一步選擇目標平台。
之後若要新增或移除裝置，需要回到此外掛設定中修改。裝置的開關狀態不會改變 這份清單。
適合希望以 Home Assistant 目前提供給 Google Home 的裝置清單為準。
選擇後會直接前往目標平台頁面，不需要再選一次裝置。
注意：
- 讀取的是 Home Assistant Google Assistant 整合中的清單。
- 不是直接登入 Google Home App 讀取原生裝置。
- 需要先完成 Google Assistant 整合。
選擇後，下一頁會用核取方塊列出 Home Assistant 中的 HomeKit Bridge／Accessory。
設定方式：
- 勾選一個或多個要作為來源的 HomeKit 項目。
- 按下一步選擇目標平台。
注意：
- 勾選的是整個 HomeKit Bridge／Accessory 設定項目。
- 不是在此頁逐一勾選項目內的每一個實體。
- 不是 Apple 家庭 App 內原生配對的裝置。
- 任一被選項目失效時，外掛會停止本次同步，不會只同步剩下的一部分。
適合希望以 Matterbridge 現有裝置清單為準。
選擇後會直接前往目標平台頁面。Matterbridge 的主機或完整端點、連接埠與 選填的前端密碼，會在稍後的平台設定頁出現。
注意：
- Matterbridge 與
matterbridge-hass必須已正常運作。 - 外掛會使用 Matterbridge 的精確裝置清單。
- 不使用 Home Assistant 標籤來決定同步裝置。
勾選 Google Home 後，需要設定：
- Google Assistant 裝置設定檔
- 選填的「Google Home 額外加入」
- 選填的「Google Home 排除」
同步成功後，外掛會通知 Google Home 重新取得裝置清單。
若目前安裝的 Home Assistant Google 原生分類器明確判定某個 sensor 或
binary_sensor 沒有可用特徵，外掛會把它另計為「平台原生不支援」，不會偽裝成
開關。這類裝置無法靠人工配對補足。攝影機、門鎖、保全及其他可控裝置若有原生
特徵，仍會嚴格驗證裝置類型與 payload；若 Home Assistant 原生分類器判定不支援，
則只從 Google 的有效曝光中略過該實體，並在通知列出確切裝置與修正方式，不會拖垮
HomeKit 或 Matter 的同步。例如沒有原生 STREAM 能力的 camera 無法在 Google
Home 變成可觀看攝影機，也不會被偽裝成開關。
勾選 HomeKit 後，需要選擇：
- 受管理的 HomeKit 目標項目
- HomeKit 主 Bridge
- 選填的「允許外掛建立或移除的 HomeKit accessory」
- 有匯入式 accessory 時使用的專用 YAML 檔相對路徑
- 選填的「HomeKit 額外加入」
- 選填的「HomeKit 排除」
只會更新您在此處明確勾選且由 UI 建立的 HomeKit Bridge／Accessory；匯入的 單實體側項目固定為唯讀。作為來源的 HomeKit 項目，不會因為被選為來源就自動取得 修改權限。 若要讓外掛長期自動更新，主 HomeKit Bridge 必須透過 Home Assistant UI 建立。 YAML 管理的項目仍可作為唯讀來源，也能以「固定且精確的匯入單實體側項目」留在 受管理目標配置中，不受儲存的 HomeKit 模式影響；外掛不會改寫這類匯入項目，避免 Home Assistant 重啟後又被 YAML 覆寫回去。
勾選 Matterbridge 後，需要設定：
- Matterbridge 主機
- Matterbridge 連接埠
- 選填的「Matterbridge 密碼」
- 選填的「Matterbridge 額外加入」
- 選填的「Matterbridge 排除」
有變更時，外掛會更新裝置清單並重新載入 matterbridge-hass。
Matter 本身沒有原生攝影機或保全系統裝置類型；這類選取仍會保留給 Matterbridge
探索同一台 Home Assistant 裝置上的其他相容端點，但通知會清楚標示限制，外掛不會
宣稱 Matter 控制器能顯示攝影機畫面或原生保全系統。
每個目標平台都有自己的例外設定。
除「額外加入」及受保護規則保留的項目外，已勾選目標中所有不在來源的既有曝光都會 移除；「排除」中的項目即使存在於來源也不會加入。這裡的移除不會刪除 Home Assistant 實體。若是你明確授權生命週期管理的 HomeKit 單裝置 accessory，外掛會 移除其 HA Config Entry；Apple 家庭中的失效圖塊仍可能需要家庭管理者手動移除。
即使來源中沒有這個裝置，也要讓指定平台包含它。
範例：
- 某個虛擬按鈕只需要出現在 Google Home。
- 將它加入「Google Home 額外加入」。
- 不需要加入 HomeKit 或 Matterbridge。
即使來源中有這個裝置，也不要同步到指定平台。
範例：
- 儀表板中有一台已原生配對 HomeKit 的燈。
- 將它放入「HomeKit 排除」，避免重複出現。
- 它仍可同步到 Google Home 或 Matterbridge。
注意：
- 同一個裝置不能同時放在同一平台的「額外加入」與「排除」。
- 每個平台的設定彼此獨立。
- 沒有勾選的平台不會顯示相關欄位。
- 未勾選平台原本的例外設定會保留，日後重新勾選仍可繼續使用。
- 前往設定 → 裝置與服務 → 整合。
- 找到裝置平台同步。
- 點選設定。
- 取消勾選啟用同步。
- 按下一步。
設定會立即完成。
停用後，外掛不會：
- 監視來源變更
- 定期檢查來源
- 在 Home Assistant 開機時執行同步
- 更新任何目標平台
原本的來源、目標與例外設定會保留。
停用不會撤銷上一次已同步的裝置。Google Home、HomeKit 與 Matterbridge 會保留 停用當下的裝置清單。
- 再次打開整合設定。
- 勾選啟用同步。
- 依畫面重新確認來源與目標。
- 完成最後確認。
重新啟用後會先完整檢查一次，再決定是否需要更新平台。
只要「啟用同步」有勾選，Home Assistant 或此外掛啟動後一定會完整檢查一次。
重新載入 Platform Sync Config Entry，以及 Home Assistant 的全域快速重新載入
（homeassistant.reload_all）後，也一定會執行完整檢查。若快速重新載入後，HomeKit
的曝光清單仍精確一致、Config Entry 也都是 loaded，但某個 runtime 沒有恢復，
外掛只會重新載入該停止的 Entry，再次驗證完整清單；不會在這個復原流程中修改
篩選條件或配對資料。
儀表板或相關實體資料有變化時，通常會很快開始檢查。短時間內的多次變更會合併， 避免重複同步。另有大約每 15 秒執行一次的本機儀表板指紋檢查作為補償；儀表板 沒有變更時，不會連線或重寫任何目標平台。
外掛會優先使用 HomeKit 設定變更通知。若目前的 Home Assistant 版本無法使用 通知機制，才會改成定期檢查。
已明確選取的可更新 HomeKit 目標若發生設定變更，也會立即觸發重新檢查。平台仍在 啟動時不會阻止保存完整設定，之後會由有上限的背景重試等待收斂。
攝影機、門鎖、支援的電視／接收器／投影機，以及有 activity 的 remote 若需要
HomeKit accessory 模式，會在其他平台的可回復交易完成後自動建立獨立 accessory。
完成設定的確認頁會先列出預計需要 Apple 家庭配對的裝置；實際建立後，Home
Assistant 會保留一則不含 PIN／Token 的通知，逐項列出仍需人工配對的裝置。
尚未配對的主 Bridge 只會列成一次 Bridge 配對；Bridge 內的一般裝置不需逐台配對，
只有每個獨立 side accessory 需要分別加入 Apple 家庭。
若 Matterbridge 啟用 enableServerRvc，獨立的掃地機器人 server node 也會列在
確認頁與通知中。請到 Matterbridge 的 Devices 頁確認；只有在尚未配對時才掃描
該裝置的 QR code。外掛不會讀取 QR／PIN，也無法可靠讀回控制器 fabric 狀態。
來源移除獨立 accessory 時，必須連續兩次讀到相同來源與候選清單，且間隔至少 15
秒才會執行。只有「允許外掛建立或移除」中明確納管的項目可刪；主 Bridge、HomeKit
來源、無關 accessory 與受保護的 Apple TV 項目不會自動刪除。匯入式 accessory
還需要設定專用 YAML include 檔，並通過精確比對、備份與讀回。
configuration.yaml 本身不能當作這個專用檔；路徑錯誤、找不到唯一的
name／port／entity 區塊或身份中途變更，都會在刪除 Config Entry 前停止。若 Home
Assistant 回報必須重新啟動，外掛會持久顯示此狀態，且在 Core 真正重新啟動前不會
宣稱同步完成。
大約每 60 秒檢查一次裝置清單。偵測到變更後才會開始同步。
啟用同步後，背景檢查也會確認 Matterbridge、matterbridge-hass、精確裝置清單
與已載入裝置都已就緒。若只有執行狀態異常，且安全條件全部成立，外掛會先等待
Matterbridge 備份真正完成，再優先重新啟動 Home Assistant 外掛；精確讀回仍未
收斂時，才會重新啟動完整 Matterbridge 程序。開機後先保留三分鐘啟動寬限期，
避免正常載入過程誤觸重啟。每個故障階段最多執行一次，並保留五分鐘冷卻時間。
持續失敗時，重試間隔依序為 15、30、60、120、300 秒。
如果管理介面無法連線、缺少憑證、外掛已停用、精確清單為空或不一致，或有其他 篩選器正在作用，系統不會自動重啟。停用同步時，也會一併停用這項自動復原。
不需要定期檢查。只有修改整合設定、重新啟動或手動執行同步時才會重新計算。
穩定的定期稽核只會記錄「沒有變更」，不會：
- 重複通知 Google Home
- 重載 HomeKit
- 重新載入 Matterbridge
- 控制任何裝置
但手動同步、系統啟動、重新載入或剛偵測到新的來源版本時，即使本機 YAML 清單 沒有變更，仍會驗證 Google 原生 payload、送出一次 Request Sync，再驗證一次。 因為本機清單不變，不能證明 Google Home 已經重新整理。
此外掛不會建立設定用實體。請從整合頁修改：
設定 → 裝置與服務 → 整合 → 裝置平台同步 → 設定
可以修改：
- 是否啟用
- 同步來源
- 儀表板頁面或手動裝置
- 目標平台
- 各平台額外加入與排除
- Google Assistant 設定檔
- 受管理的 HomeKit 項目
- Matterbridge 連線資料
再次開啟設定時，所有已儲存參數都會自動回填。若某個欄位驗證失敗，當頁其他 剛輸入的內容不會消失。取消勾選某個目標平台時，該平台的連線資料、額外加入與排除 會暫時隱藏且不生效，但仍會保存；日後重新勾選便會完整恢復。
一般使用者平時不需要使用這兩個進階功能。
前往開發者工具 → 動作，選擇：
platform_sync.preview
它只會顯示預計新增或移除的內容，不會修改平台。重大調整前可先用它確認結果。
前往開發者工具 → 動作，選擇：
platform_sync.sync_now
它會立刻檢查並套用必要變更，不必等待下一次自動檢查。
如果「啟用同步」沒有勾選，這兩個動作都不會讀取或更新來源。
每個家庭的裝置不同。啟用同步前，請先找出只應出現在單一平台的裝置，以及已經 原生配對、不應重複曝光的裝置。
以下使用泛用的虛擬實體作為示範：
input_boolean.google_presence只需要出現在 Google Home。input_boolean.apple_presence只需要出現在 HomeKit。input_boolean.someone_arrived需要出現在 Google Home 與 HomeKit，但不需要 出現在 Matterbridge。
可以在各目標平台分別設定：
| 範例實體 | Google Home | HomeKit | Matterbridge |
|---|---|---|---|
input_boolean.google_presence |
額外加入 | 排除 | 排除 |
input_boolean.apple_presence |
排除 | 額外加入 | 排除 |
input_boolean.someone_arrived |
額外加入 | 額外加入 | 排除 |
這些只是範例，不是此外掛內建的實體或預設規則。請在各平台的「額外加入」與 「排除」欄位選擇自己的實體。
HomeKit 目標也建議視情況排除：
- 已直接在 Apple 家庭原生配對的裝置，避免產生重複配件。
- 已透過 Apple 原生配對使用，而且由 Home Assistant Apple TV 整合提供的媒體 裝置。
Matterbridge 使用精確裝置清單。此外掛不會建立或依賴專門用於跨平台選取的 Home Assistant 標籤。
- 確認資料夾位置是
/config/custom_components/platform_sync。 - 確認沒有多包一層資料夾。
- 安裝後重新啟動 Home Assistant。
- 查看 Home Assistant 記錄是否有載入錯誤。
部分 YAML 或無法自動列出的儀表板不會出現在清單中。請使用「手動輸入儀表板 路徑」，填入網址中的儀表板與頁面路徑。
- 確認頁面仍存在並可以開啟。
- 確認頁面中至少放了一個具有實體 ID 的裝置。
- 確認所有被選頁面都可以正常讀取。
- 確認選的是 Home Assistant HomeKit Bridge／Accessory。
- 暫時尚未載入的項目仍可保存，但要等 HomeKit runtime 已載入且可驗證為執行中， 才會完成同步。
- 確認項目使用明確的裝置清單，而不是「全部某類裝置」之類的寬鬆條件。
- Apple 家庭原生配對裝置不會出現在這份來源清單中。
請先在 Home Assistant 建立主 HomeKit Bridge，再回到此外掛設定中選取。需要 accessory 模式的新裝置可由外掛建立原生獨立 Config Entry，但 Apple 家庭的最後 配對仍必須由家庭管理者完成；裝置名稱會出現在確認頁與持續通知中。
若確認頁列出 Matter 掃地機器人，請在 Matterbridge Devices 頁確認該獨立 server node；已配對就不需動作，未配對才掃 QR。一般 Bridge 內的 Matter 裝置不需 逐台再配對。
若主 Bridge 由 YAML 管理，請改用 Home Assistant UI 重新建立。要讓外掛自動移除 既有匯入式單實體 accessory，必須同時將它列入明確生命週期授權，並填入專用 HomeKit YAML include 檔的安全相對路徑；外掛只會在 name、port 與單一 entity 完全吻合且備份／讀回成功時修改。其他 YAML 項目維持唯讀。
確認：
- Google Assistant 整合已載入。
- 已完成 Google 帳號連結。
- 已設定
expose_by_default: false。 - 已使用獨立的 Google Assistant 裝置設定檔。
- 設定檔路徑是相對路徑，不是完整磁碟路徑。
Google Home 完成一次帳戶連結後，一般不需逐裝置配對。設定完成頁所列的人工工作 只會包含 HomeKit Bridge／獨立 accessory，以及需要確認的 Matter 獨立 server node； Google 原生不支援的感測類別是能力限制，不會混入配對清單。
確認：
- 主機名稱、IP，或完整 ws／wss／http／https 端點正確。
- 管理連接埠正確。
- 選填的前端密碼正確。
- WSS 端點的憑證可被 Home Assistant 信任。
- Matterbridge 正在運作。
matterbridge-hass已啟用並連上 Home Assistant。
外掛可以確認 Home Assistant 端與平台連接端的設定，但 Google Home、 Apple 家庭或 Matter 控制器 App 仍可能需要一些時間更新。
如果 App 仍未顯示，請：
- 稍候片刻再重新開啟 App。
- 確認帳號、家庭與 Bridge 配對正確。
- 在原生 App 中手動確認。
這種情況應理解為「Home Assistant 端已完成，原生 App 尚未確認」。
- 先不要連續重按「立即同步」。
- 打開整合設定，檢查來源與目標平台是否仍可使用。
- 可先執行「預覽同步」查看預計變更。
- 在整合選單中下載診斷資料。
- 若畫面顯示回復未完成，請使用 Home Assistant 或平台備份進行還原。
分享診斷資料前，仍應確認內容中沒有密碼、Token、Cookie、私鑰或 API key。
- 暫時關閉「啟用同步」。
- 建立 Home Assistant 完整備份。
- 用新版本覆蓋
custom_components/platform_sync。 - 重新啟動 Home Assistant。
- 打開整合設定，確認來源、目標與例外規則。
- 仔細確認所有設定後再重新啟用；送出最後確認頁就會開始自動檢查。
升級後，舊版的設定會盡量安全保留。舊版的第二個自動套用開關、輪詢時間、 合併等待時間、自訂名稱與狀態實體已不再使用。
移除整合只會停止後續管理，不會自動撤銷最後一次同步的裝置清單。
如果要回到安裝前的狀態：
- 先停用同步。
- 使用 Home Assistant 或各平台備份還原。
- 確認三個平台的裝置清單。
- 從「裝置與服務」移除整合。
- 刪除
/config/custom_components/platform_sync。 - 重新啟動 Home Assistant。
以 Home Assistant 首頁為準，同步到 Google Home、HomeKit 與 Matterbridge。
- 新增「裝置平台同步」整合。
- 勾選「啟用同步」。
- 選擇「Home Assistant 儀表板中的裝置」。
- 選擇首頁所在的儀表板頁面，例如
lovelace / default-view。 - 目標勾選 Google Home、HomeKit、Matterbridge。
- 填入 Google Assistant 裝置設定檔。
- 勾選受管理的 HomeKit 目標項目。
- 明確選擇其中的 HomeKit 主 Bridge。
- 只把確定交由外掛建立／移除的單裝置 accessory 勾入生命週期授權；有匯入式 accessory 時再填專用 YAML 檔相對路徑。
- 填入 Matterbridge 端點、連接埠與選填密碼。
- 視需要設定各平台的額外加入與排除。
- 在確認頁核對「需額外人工配對或確認」清單後送出。
之後：
- Home Assistant 或外掛啟動時會檢查一次。
- 首頁裝置變更時會自動重新計算。
- 沒有差異時不會重複更新平台。
- 有差異時才會同步並驗證。
從 0.6.1 版開始，本外掛採用 PolyForm Noncommercial License 1.0.0。使用者可以在授權允許的 非商業用途下查看、使用、修改及分享原始碼或修改版，但不得用於商業用途。
這是「原始碼公開的非商業授權」，不是 OSI 核准的開放原始碼授權。0.6.1 以前的版本仍適用當時隨附的授權條款。
Home Assistant 使用繁體中文時顯示「裝置平台同步」；使用英文時顯示 「Cross-Platform Device Sync」。兩種語言的功能與設定流程相同。