幫助
故障排查
修復最常見的問題——聯結器無法上線、渠道連線斷開、沙箱啟動緩慢——並找到求助途徑。
大多數問題歸結為三件事之一：聯結器失去聯絡、渠道會話斷開，或沙箱正從休眠中喚醒。下面教你如何識別每一種情況並快速恢復工作。
聯結器無法上線
聯結器只有在持續傳送心跳時才會報告為線上。如果心跳停止超過約 30 秒，Buda 會把它標記為過期（stale），隨後標記為離線（offline）。
確認聯結器程序正在其宿主機上執行。 如果程序已退出或機器進入休眠，心跳就會停止，狀態會在約 30 秒內翻轉為過期。
檢查網路出站。 聯結器需要出站訪問才能連上 Buda Cloud。防火牆或代理阻斷該連線，看起來和程序已死完全一樣——先過期，再離線。
重啟聯結器。 全新啟動會重新註冊裝置並恢復心跳；狀態幾乎會立即回到線上。
核對 API 金鑰和目標空間。 聯結器使用一個繫結到某個空間的金鑰進行鑑權——被吊銷或錯誤的金鑰會讓它無法上線。
過期 vs 離線： 過期 指 Buda 近期沒收到聯結器的訊息，但還沒放棄；離線 指它已經斷開。兩者都會在下一次成功心跳時清除。
渠道二維碼 / 連線斷開
基於二維碼的渠道（WhatsApp、飛書、企業微信、微信、釘釘）通過掃碼完成關聯，隨後保持一條即時閘道器連線。
- 你還沒掃，二維碼就過期了。 二維碼有效期很短。重新開啟渠道的連線介面生成一個新的，並儘快掃描。
- 關聯後連線斷開。 閘道器會以退避策略自動重連。手動重連前先稍等片刻——反覆手動重啟可能會與自動重試相互干擾。
- 掃了碼但沒反應。 確認你用的是正確的賬號掃碼（例如正確的 WhatsApp 號碼或飛書工作區）。從一個新生成的二維碼重新掃描。
- 訊息沒有路由到智慧體。 確認渠道的預設空間就是承載你預期的那個智慧體所在的空間。渠道按使用者限定，並把任務投遞到其預設空間。
沙箱啟動緩慢
沙箱會空閒時休眠以避免無人值守地執行，並在有新任務時按需喚醒。休眠後的第一個任務會感覺慢一些，因為沙箱正在被喚醒。
- 暫停後的第一條訊息慢，之後的就快了。 那就是喚醒。一旦執行起來，沙箱會保持熱態以應對後續工作。
- 繁重任務持續緩慢。 CPU 和記憶體按你空間的套餐限定。如果大任務被卡了瓶頸，更高的套餐會為每個智慧體配給更多資源。
- 任務似乎卡在啟動階段。 發一條簡短的追問推它一下，或開啟會話詳情，即時觀察檔案、終端和瀏覽器中的進展。
在哪裡求助
如果以上都沒能解決，找真人：
- 郵箱： hi@buda.im——我們在 24 小時內回覆
- 社群： Discord
- 文件： 瀏覽常見問題以獲取常見問題的解答