接入 Application

Application 轉接器是一個小型 manifest，宣告桌面應用如何連接到 Bricoop、接受哪些模型，以及 Bricoop 如何偵測和設定它。一個 manifest 就能覆蓋每一個受支援的 Provider，所以你只需發布一次，每個已連線的 Provider 就都能被該 Application 使用。轉接器絕不嵌入 Provider 憑證或 Provider 專屬邏輯；它只描述連線中屬於 Application 的那一側。

轉接器做什麼

轉接器告訴 Bricoop 應用把設定存在哪裡、使用者可以對映哪些模型槽位，以及 Application 期望使用哪些能力。Bricoop 讀取 manifest，在使用者啟用某個 Provider 時修補應用的本機設定檔，並透過本機連線層路由請求。應用仍然像以往一樣運作；Bricoop 只把 Provider 端點寫進 manifest 宣告的槽位裡。

開始之前

確認你擁有應用穩定的 lowercase id、它所需的 Bricoop Desktop minimal_client_version、它暴露的模型槽位，以及它寫入的 config 路徑。你還需要 Application 的 schema_version 和 minimal_application_version，以便 Bricoop 能明確拒絕不相容的組合。manifest 準備好後，前往 Application manifest 參考。

編寫 manifest

把 manifest 寫成單一 YAML 檔案，宣告 id、name、version、schema_version、minimal_client_version、minimal_application_version、model_slots 和 configs。configs 條目告訴 Bricoop 如何在 macOS、Linux 和 Windows 上定位並修補應用的 config。完整的欄位參考和完整範例見 Application manifest 頁面。

本機測試

執行 Bricoop Desktop，把它指向你的本機 manifest，並確認應用被偵測到。啟用一個 Provider，透過應用做一次請求往返，並確認回應無錯誤傳回。如果偵測失敗，請重新檢查各平台的 configs[].path 值。

提交拉取請求

當 manifest 在本機可用時，按照 registry 貢獻指南 向 bricoop-releases 提交一個可審查的拉取請求。倉庫的校驗會在 PR 合併前執行，所以在請求審查前修復每一個回報的問題。PR 合併後會發布一個 release manifest，Bricoop Desktop 會自動取得它。若要改為建置 Provider 轉接器，請參閱 Provider 總覽。