Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 22 additions & 22 deletions packages/web/src/content/docs/zh-cn/acp.mdx
Original file line number Diff line number Diff line change
@@ -1,31 +1,31 @@
---
title: ACP 支持
description: 在任何 ACP 兼容编辑器中使用 opencode
description: 在任何兼容 ACP 的编辑器中使用 OpenCode
---

opencode 支持 [Agent Client Protocol](https://agentclientprotocol.com) (ACP),允许您直接在兼容的编辑器和 IDE 中使用它。
OpenCode 支持 [Agent Client Protocol](https://agentclientprotocol.com)ACP),允许你直接在兼容的编辑器和 IDE 中使用它。

:::tip
有关支持 ACP 的编辑器和工具的列表,请查看 [Zed ACP progress report](https://zed.dev/blog/acp-progress-report#available-now)。
有关支持 ACP 的编辑器和工具列表,请查看 [ACP 进展报告](https://zed.dev/blog/acp-progress-report#available-now)。
:::

ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之间的通信。
ACP 是一个开放协议,用于标准化代码编辑器与 AI 编码代理之间的通信。

---

## 配置

要通过 ACP 使用 opencode,须编辑器配置为运行 `opencode acp` 命令。
要通过 ACP 使用 OpenCode,请在编辑器中配置运行 `opencode acp` 命令。

该命令将 opencode 作为 ACP 兼容的子进程启动,通过 stdio 通过 JSON-RPC 与您的编辑器进行通信
该命令会将 OpenCode 作为兼容 ACP 的子进程启动,通过 stdio 上的 JSON-RPC 与编辑器进行通信

以下是支持 ACP 的流行编辑器的示例
以下是支持 ACP 的常用编辑器的配置示例

---

### Zed

添加到您的 [Zed](https://zed.dev) 配置 (`~/.config/zed/settings.json`)
添加到你的 [Zed](https://zed.dev) 配置文件(`~/.config/zed/settings.json`)中

```json title="~/.config/zed/settings.json"
{
Expand All @@ -38,9 +38,9 @@ ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之
}
```

要打开它,请使用 **命令面板** 中的 `agent: new thread` 操作。
打开方式:在**命令面板**中执行 `agent: new thread` 操作。

您还可以通过编辑 `keymap.json` 来绑定键盘快捷键:
你也可以通过编辑 `keymap.json` 来绑定键盘快捷键:

```json title="keymap.json"
[
Expand All @@ -67,9 +67,9 @@ ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之

---

### JetBrains IDE
### JetBrains IDEs

根据 [文档](https://www.jetbrains.com/help/ai-assistant/acp.html) 添加到你的 [JetBrains IDE](https://www.jetbrains.com/) `acp.json`
根据[文档](https://www.jetbrains.com/help/ai-assistant/acp.html),将以下内容添加到你的 [JetBrains IDE](https://www.jetbrains.com/) acp.json

```json title="acp.json"
{
Expand All @@ -82,13 +82,13 @@ ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之
}
```

要打开它,请在 AI Chat 代理选择器中使用新的 "opencode" 代理。
打开方式:在 AI Chat 代理选择器中选择新的 'OpenCode' 代理。

---

### Avante.nvim

添加到您的 [Avante.nvim](https://github.com/yetone/avante.nvim) 配置
添加到你的 [Avante.nvim](https://github.com/yetone/avante.nvim) 配置中

```lua
{
Expand Down Expand Up @@ -121,7 +121,7 @@ ACP 是一种开放协议,用于标准化代码编辑器和 AI 编码代理之

### CodeCompanion.nvim

相当于 opencode 网关 [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim) 中的 ACP 代理,接下来将以下内容添加到 Neovim 配置中:
要在 [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim) 中将 OpenCode 用作 ACP 代理,请将以下内容添加到你的 Neovim 配置中:

```lua
require("codecompanion").setup({
Expand All @@ -136,21 +136,21 @@ require("codecompanion").setup({
})
```

此配置将 CodeCompanion.nvim 设置为使用 opencode 作为聊天的 ACP 代理。
此配置将 CodeCompanion 设置为使用 OpenCode 作为聊天的 ACP 代理。

如果您需要传递环境变量(如 `OPENCODE_API_KEY`),请参阅 CodeCompanion.nvim 文档中的 [Configuration: Adapters](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) 了解完整信息
如果需要传递环境变量(如 `OPENCODE_API_KEY`),请参阅 CodeCompanion.nvim 文档中的[配置适配器:环境变量](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key)了解详细信息

## 支持

opencode 通过 ACP 的工作方式与在终端中的工作方式相同。支持所有功能
OpenCode 通过 ACP 使用时与在终端中使用的效果完全一致。所有功能均受支持

:::note
目前不支持某些内置斜杠命令,例如 `/undo` 和 `/redo`。
部分内置斜杠命令(如 `/undo` 和 `/redo`)目前暂不支持
:::

- 内置工具(文件操作、终端命令等)
- 自定义工具和斜杠命令
- 在 opencode 配置中配置的 MCP 服务器
- `AGENTS.md` 的项目特定规则
- 自定义程序和 linter
- 在 OpenCode 配置中配置的 MCP 服务器
- 来自 `AGENTS.md` 的项目级规则
- 自定义格式化工具和代码检查工具
- 代理和权限系统
Loading