文档 / MCP 与 ACP
Kiro、Codex 与 Antigravity
Yuli 同时作为 ACP 客户端和 MCP 服务器,让你在 IDE 中使用自己的 Kiro、Codex 或 Antigravity。
除了 Claude Code,Yuli 还支持 Kiro、Codex 和 Antigravity,每个都使用你自己的账户。对它们而言,Yuli 既是一个 ACP 客户端(Agent Client Protocol),与其他 IDE 一样,同时也是它们的 MCP 服务器。
| 通道 | 用途 |
|---|---|
| ACP | Yuli 发送你的需求,并实时接收回复、推理过程、权限请求和计划。 |
| MCP | 智能体使用 yuli_* 工具:构建、测试、验证、质量、数据库、Web Studio…… |
每个智能体都有自己的对话、任务和更改窗口。切换智能体绝不会混淆各自的状态。
选择智能体
在聊天上方的 你和谁一起工作? 选择器中,“你的订阅 · 你的账户”分组:
| 智能体 | 账户 |
|---|---|
| Claude Code | 你的 Claude 账户(Pro、Max 或 Console)。参见 Claude Code。 |
| Kiro | 你的 AWS Builder ID、Google 或 GitHub 账户。 |
| Codex | 你的 ChatGPT 账户。 |
| Antigravity | 你的 Google 账户。 |
Yuli 从不下载或再分发这些智能体:它只检测你已安装的那个。
Kiro
| 步骤 | 说明 |
|---|---|
| 安装 | 如果缺失,会显示 “安装 Kiro CLI 以在此使用”,并附带 kiro.dev/cli 链接和官方命令。需要 1.28.2 或更高版本。 |
| 提示 | “开始使用 Kiro 之前”:Kiro 使用你的账户和额度,它读取的代码会依据你的条款发送至 AWS。 |
| 登录 | 登录 会在 Yuli 的终端中打开 kiro-cli login。对于远程机器,使用 使用设备代码。 |
| 规则 | 位于 .kiro/steering/yuli.md 和流程文件中;如果配置保存在项目之外,则随第一个需求一起发送。 |
Yuli 通过 kiro-cli acp 启动 Kiro,由 CLI 自身完成认证。令牌保留在 Kiro 中。
Codex
| 步骤 | 说明 |
|---|---|
| 安装 | npm install -g @openai/codex @agentclientprotocol/codex-acp。Yuli 使用官方 ACP 适配器 codex-acp;如果只找到 codex,会提示你缺少适配器。 |
| 提示 | “开始使用 Codex 之前”。 |
| 登录 | 在 Yuli 的终端中运行 codex login,或使用设备代码。 |
| 规则 | 位于 AGENTS.md 的受管理区块中;如果配置保存在项目之外,则随第一个需求一起发送。 |
Antigravity
| 步骤 | 说明 |
|---|---|
| 安装 | 下载 Google 发布的 Antigravity ACP 服务器,并解压到 ~/.antigravity/acp/。 |
| 提示 | “开始使用 Antigravity 之前”。 |
| 登录 | 没有登录用的 CLI:服务器会在浏览器中打开 Google 页面,会话会自动建立。 |
| 规则 | 位于 .agent/rules/yuli.md;如果配置保存在项目之外,则随第一个需求一起发送。 |
Google 指出,使用非官方工具访问 Antigravity 可能违反其条款。Yuli 会在事前提示中说明这一点。使用前请先阅读相关条款。
使用 ACP 智能体工作
- 采用 Yuli 设计的对话界面:边写边显示的回复、可折叠的推理过程、以时间线呈现的工具调用、计划、已更改的文件和验证结果。
- 输入框:
Enter发送,Shift+Enter换行,@提及文件,/显示智能体公布的命令。 - 队列:如果智能体正在工作,你发送的内容会进入队列。停止(或
Esc)取消本轮。 - 模型、强度和模式:使用智能体自身公布的列表。
- 历史记录:打开之前的会话或开始新会话。
- 权限:每个请求都以 Yuli 卡片的形式呈现,选项与智能体提供的完全一致。Yuli 绝不会编造选项,也不会替你作答。
完成标准
这些智能体没有可以阻止结束本轮的 hook,因此 Yuli 以客户端身份执行这一标准:如果本轮修改了代码,而验证或度量未通过,它会发送一条简短的自动跟进消息,说明还缺什么。
- 它在对话中显示为 Yuli 的消息。
- 有次数上限(默认 3 次),并且由于会消耗你的额度,你可以通过 自动跟进 关闭它。
- 如果与智能体的连接中断,Yuli 绝不会自行重新发送任何内容。
相同的规则
仅在你要求时使用 Git、CI 和 DevOps;仅在你要求时创建分支;机密受到保护;结构和命名受到检查;项目 hooks 生效。与 Claude Code 完全相同。
其他智能体:仅导出规则
Gemini CLI、Cursor 和 GitHub Copilot 不在 Yuli 内部运行。不过你可以为它们提供相同的项目规则:在治理中心的 智能体 → 上下文 中,导出到 GEMINI.md、.cursor/rules/yuli.mdc 和 .github/copilot-instructions.md。参见 Gate 与治理中心。