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。

用起來是什麼樣

你可能會遇到的限制