使用 Facade

在远端机器上运行 Agent

通过 SSH 连到另一台电脑，用那里的项目文件、工具和账号运行 Agent。

1. 连上项目所在的机器

在 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。确认工作位置是远端项目文件夹。

确认运行环境

告诉我你所在的操作系统和项目目录，以及这个项目的检查怎么运行。

看回复里的环境和路径对不对。它执行的命令、改动的文件都在那台机器上。

打开远端文件夹后，依次选择 Open Settings → Facade: Home → Edit in facade.json。远端窗口如果以 JSON 形式打开 Settings，Open Settings 会直接打开 facade.json。字段说明见Agent 配置。

API 密钥、可执行文件路径和其他环境变量都要在那台机器上准备；你本地的环境不会带过去。

保持本地项目和 SSH 连接都打开。访问设置允许时，Agent 之间可以通过 Facade 找到对方并互相发消息。

联系远端 Agent

用 Facade 问一下远端 Agent，它在哪个项目里工作，那边有哪些检查可以跑。

如果 Agent 找不到另一个 Agent，看审批与 Agent 协作范围。想在一个对话里跟进多个功能 Agent（本地或远端），用让一个 Agent 管理团队这个模式。

每台机器有自己的项目文件。要在不同系统之间比较测试结果，先在两边检出同一个提交。