整合與聯結器
智慧體聯結器
在你自己的機器上執行 Buda 智慧體——用一條命令把一臺主機註冊到空間，並從儀表盤檢視它的狀態。
有時候，工作必須在你自己的機器上完成。 本地檔案、只有你的筆記本才能訪問的某個工具、需要你本地環境才能跑的構建——聯結器會把你自己的一臺機器註冊到某個空間，讓 Buda 智慧體可以在那裡執行任務，同時你仍能從雲端儀表盤檢視狀態和心跳。
聯結器是什麼
聯結器是一個小型守護程序（daemon），執行在你掌控的機器上。註冊之後，它會以固定的心跳向 Buda Cloud 回報，並出現在當前空間的 設定 → 聯結器 中。每個聯結器都是空間級的——它繫結到你安裝它時所在的空間，而非某個單獨使用者，因此該空間中的任何人都能看到它。
安裝聯結器
開啟你想讓機器加入的空間的 設定 → 聯結器，點選 生成指令碼。
複製命令。 它看起來像下面這樣，其中已填入你的空間 ID：
npx -y @buda-ai/connector@latest daemon --space-id <your-space-id>在你想讓 Buda 智慧體使用的機器上，在終端中執行它。 守護程序會把這臺主機註冊到空間，並開始傳送心跳。
確認它已出現。 該聯結器會出現在列表中，顯示其裝置名稱、平臺，以及一個 線上 標記。
這種簡易模式標識的是空間，而非某個單獨使用者。Buda Desktop 則改用 OAuth 令牌模式來註冊聯結器。
線上、滯後、離線
每張聯結器卡片都會根據其最近一次心跳顯示即時狀態：
- 線上 —— 最近約 30 秒內有過心跳。機器已就緒，可以接受任務。
- 滯後 —— 約 30 秒到 2 分鐘內沒有心跳。很可能是短暫的網路抖動或程序被暫停。
- 離線 —— 超過 2 分鐘沒有心跳，或守護程序已被停止。
另有一個獨立的 Relay 標記，用於顯示該聯結器當前是否持有一條回到 Buda Cloud 的即時鏈路。頁面頂部的彙總卡片會統計整個空間的總數。
排查問題
- 始終不出現 —— 檢查終端是否有報錯，並確認機器能向
https://buda.im發起出站訪問。 - 卡在「滯後」 —— 程序在執行，但心跳被延遲了；檢查網路，然後點選 重新整理。
- 顯示「離線」 —— 守護程序已停止。重新執行安裝命令即可讓它恢復。
- 空間不對 —— 從正確的空間生成指令碼；命令中的
--space-id決定了主機註冊到哪裡。