wickrunAI

编码 agent 和 ACP 编辑器（ACP）

wickrunAI 支持 ACP（Agent Client Protocol），两个方向都能用，都需要 wickrunAI 桌面版 6.1 或更新：

两个方向都在 设置 → 工具 → 执行客户端 里设置。

把 ACP agent 当作执行客户端

添加

  1. 先在电脑上装好 agent，例如 OpenCode 或 Gemini CLI。
  2. 打开 设置 → 工具 → 执行客户端：
    • 点「自动发现」，已安装的 OpenCode（opencode acp）和 Gemini CLI（gemini --acp）会被加进来；
    • 或者点「添加 ACP agent」，填名字、图标、命令和参数（例如 opencode acp，或程序的完整路径加参数），可选默认工作目录，以及要交给它的环境变量名（例如 OPENCODE_API_KEY；值取自这台电脑，不保存在设置里）。
  3. 点「检测」确认它能启动，并看到它提供的模型。

加好的 agent 出现在输入框下方的本机 AI 面板、模型选择和 @ 提及里。

用起来是什么样

在编辑器里把 wickrunAI 当作 agent

打开

  1. 在 设置 → 工具 → 执行客户端 里打开「让编辑器把 wickrunAI 当作 agent（wickrun acp）」。
  2. 设置页会给出这台电脑可以直接复制的 Zed、JetBrains 配置片段。下面的示例里，尖括号的部分以设置页给出的为准。
  3. 要在编辑器里用 Work，项目文件夹需要在 设置 → 工具 → 工作目录 里授权；不在授权目录里时只能对话。

Zed

在 ~/.config/zed/settings.json 里加入：

{
  "agent_servers": {
    "wickrunAI": {
      "type": "custom",
      "command": "<设置页给出的程序路径>",
      "args": ["<设置页给出的启动脚本路径>", "acp"],
      "env": { "ELECTRON_RUN_AS_NODE": "1" }
    }
  }
}

然后在 Zed 里运行 agent: new thread，选择 wickrunAI。

JetBrains IDE（AI Assistant）

在 AI Chat 的 agent 选择器里打开 ACP agent 配置（acp.json），加入：

{
  "agent_servers": {
    "wickrunAI": {
      "command": "<设置页给出的程序路径>",
      "args": ["<设置页给出的启动脚本路径>", "acp"],
      "env": { "ELECTRON_RUN_AS_NODE": "1" }
    }
  }
}

Neovim

avante.nvim：

acp_providers = {
  ["wickrunai"] = { command = "<设置页给出的 wickrun 路径>", args = { "acp" } },
}

CodeCompanion 的 ACP 适配器用同样的命令和参数。

如果你已经把 wickrun 命令加进了 PATH（见 VS Code 插件说明），在任何编辑器里都可以把命令写成 wickrun，参数写成 acp。

用起来是什么样

你可能会遇到的限制