使用 Facade

在遠端機器上執行 Agent

在另一台電腦上執行 Agent，同時從本機編輯器工作。

1. 透過 SSH 連上專案

在 VS Code 中安裝 Remote - SSH，並確認你能從終端機登入該主機：

換成你的 SSH 使用者名稱與主機

ssh user@hostname

從命令面板執行 Remote-SSH: Connect to Host…。連上主機後，在那台機器上開啟專案資料夾。查看編輯器狀態列，確認目前連線的主機。

在 SSH 連線的視窗中開啟擴充功能檢視，找到 Facade Code，並將它安裝到 SSH 主機上。Window Component 會留在你的電腦上，負責把遠端專案連接到你的其他 Facade 專案。

在遠端的整合式終端機中，安裝你要使用的 CLI，並完成登入或供應商設定。確認它能在那裡回應請求。

你的電腦	遠端機器
編輯器介面與 SSH 連線	Facade 的專案擴充套件、Agent CLI、專案檔案、建置與測試

遠端 Agent 使用那台機器的工具與憑證。只在你的電腦上安裝的 CLI，遠端 Agent 無法使用。

在已連線的專案中開啟 Facade，選擇 New Agent，再選擇 CLI。確認選取的位置是遠端專案資料夾。

確認環境

告訴我你正在哪個作業系統與專案目錄中工作，以及如何執行這個專案的各項檢查。

確認回覆中描述的環境與路徑正確。Agent 會在那台機器上執行命令、修改檔案。

開啟遠端資料夾後，選擇 Open Settings → Facade: Home → Edit in facade.json。如果遠端視窗以 JSON 形式開啟設定，Open Settings 會直接前往 facade.json。欄位說明請見Agent 設定。

API 金鑰、執行檔路徑與其他環境變數都要在遠端機器上備妥；本機環境不會帶過去。

保持本機專案與 SSH 連線開啟。在存取設定允許的情況下，Agent 可以透過 Facade 找到彼此並互傳訊息。

聯絡遠端 Agent

用 Facade 問遠端 Agent：它正在哪個專案中工作，以及那裡有哪些可用的檢查。

如果某個 Agent 找不到另一個 Agent，請看核准與 Agent 存取範圍。想從同一個對話追蹤多個功能 Agent（本機或遠端），可以使用Facade 模式。

每台機器都有自己的專案檔案。跨作業系統比較測試結果前，請先確認各機器簽出的是同一個提交。