Dropstone Docs

ACP 支援

在任何相容 ACP 的編輯器中使用 Dropstone。

Dropstone 支援 Agent Client Protocol(ACP),讓你可以直接在相容的編輯器和 IDE 中使用它。

提示:

如需支援 ACP 的編輯器和工具清單,請查看 ACP 進度報告

ACP 是一個開放協議,用於標準化程式碼編輯器和 AI 編碼代理之間的通訊。


設定

若要透過 ACP 使用 Dropstone,請設定你的編輯器執行 dropstone acp 命令。

該命令會啟動 Dropstone 作為相容 ACP 的子程序,透過 JSON-RPC 經由 stdio 與你的編輯器通訊。

以下是支援 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