Dropstone CLI

ACP 支持

在任何兼容 ACP 的编辑器中使用 Dropstone。

Dropstone 支持 Agent Client Protocol(简称 ACP),使您可以直接在兼容的编辑器和 IDE 中使用它。

Tip

有关支持 ACP 的编辑器和工具列表,请查看 ACP 进度报告

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


配置

要通过 ACP 使用 Dropstone,请将您的编辑器配置为运行 dropstone acp 命令。

该命令会将 Dropstone 作为兼容 ACP 的子进程启动,通过 stdio 使用 JSON-RPC 与您的编辑器通信。

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


Zed

添加到您的 Zed 配置(~/.config/zed/settings.json)中:

{
  "agent_servers": {
    "Dropstone": {
      "command": "dropstone",
      "args": ["acp"]
    }
  }
}

要打开它,请在命令面板中使用 agent: new thread 操作。

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

[
  {
    "bindings": {
      "cmd-alt-o": [
        "agent::NewExternalAgentThread",
        {
          "agent": {
            "custom": {
              "name": "Dropstone",
              "command": {
                "command": "dropstone",
                "args": ["acp"]
              }
            }
          }
        }
      ]
    }
  }
]

JetBrains IDE

根据文档将以下内容添加到您的 JetBrains IDE 的 acp.json 中:

{
  "agent_servers": {
    "Dropstone": {
      "command": "/absolute/path/bin/dropstone",
      "args": ["acp"]
    }
  }
}

要打开它,请在 AI Chat 代理选择器中选择新的“Dropstone”代理。


Avante.nvim

添加到您的 Avante.nvim 配置中:

{
  acp_providers = {
    ["dropstone"] = {
      command = "dropstone",
      args = { "acp" }
    }
  }
}

如果您需要传递环境变量:

{
  acp_providers = {
    ["dropstone"] = {
      command = "dropstone",
      args = { "acp" },
      env = {
        DROPSTONE_API_KEY = os.getenv("DROPSTONE_API_KEY")
      }
    }
  }
}

CodeCompanion.nvim

要在 CodeCompanion.nvim 中将 Dropstone 用作 ACP 代理,请将以下内容添加到您的 Neovim 配置中:

require("codecompanion").setup({
  interactions = {
    chat = {
      adapter = {
        name = "dropstone",
        model = "dropstone-pro",
      },
    },
  },
})

此配置将 CodeCompanion 设置为使用 Dropstone 作为聊天的 ACP 代理。

如果您需要传递环境变量(如 DROPSTONE_API_KEY),请参阅 CodeCompanion.nvim 文档中的配置适配器:环境变量部分以获取完整详情。

支持

Dropstone 通过 ACP 使用与在终端中完全相同。所有功能均受支持:

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

Note

某些内置斜杠命令(如 /undo/redo)目前不支持通过 ACP 使用。

Ctrl+I