編碼 agent 和 ACP 編輯器(ACP)
wickrunAI 支援 ACP(Agent Client Protocol),兩個方向都能用,都需要 wickrunAI 桌面版 6.1 或更新:
- 把 OpenCode、Gemini CLI 等 ACP agent 當作執行客戶端:在 Work 裡選它,它在你的電腦上動手,按你的 Work 許可權檔案放行或先問。
- 在 Zed、JetBrains、Neovim 裡把 wickrunAI 當作 agent:編輯器裡的對話由 wickrunAI 回答,背後是你的路由、Work 許可權檔案和保密層。
兩個方向都在 設定 → 工具 → 執行客戶端 裡設定。
把 ACP agent 當作執行客戶端
新增
- 先在電腦上裝好 agent,例如 OpenCode 或 Gemini CLI。
- 開啟 設定 → 工具 → 執行客戶端:
- 點「自動發現」,已安裝的 OpenCode(
opencode acp)和 Gemini CLI(gemini --acp)會被加進來; - 或者點「新增 ACP agent」,填名字、圖示、命令和引數(例如
opencode acp,或程式的完整路徑加引數),可選預設工作目錄,以及要交給它的環境變數名(例如OPENCODE_API_KEY;值取自這臺電腦,不儲存在設定裡)。
- 點「自動發現」,已安裝的 OpenCode(
- 點「檢測」確認它能啟動,並看到它提供的模型。
加好的 agent 出現在輸入框下方的本機 AI 面板、模型選擇和 @ 提及裡。
用起來是什麼樣
- 許可權:它要改檔案、跑命令或聯網時,按這臺電腦的 Work 許可權檔案處理。需要確認的操作會彈出「確認 OpenCode 的操作」這樣的卡片,寫明資料夾、檔案和命令。agent 自己的「總是允許」不會被替你選上,長期放行只在你的 Work 許可權檔案裡設定。
- 改動:它改過的檔案進入這次執行的記錄,可以在程式碼改動面板裡審閱和回滾。
- 保密層:開啟脫敏時,它在脫敏副本里工作,交出去的內容先脫敏,結果還原後再寫回。
- 協作文件:檔案在雲工作區時,它以「R 的 OpenCode」這樣的成員即時出現在協作文件裡,執行結束時留下一個 Work 版本。
在編輯器裡把 wickrunAI 當作 agent
開啟
- 在 設定 → 工具 → 執行客戶端 裡開啟「讓編輯器把 wickrunAI 當作 agent(wickrun acp)」。
- 設定頁會給出這臺電腦可以直接複製的 Zed、JetBrains 配置片段。下面的示例裡,尖括號的部分以設定頁給出的為準。
- 要在編輯器裡用 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。
用起來是什麼樣
- 編輯器裡的每個會話都是一段 wickrunAI 對話,標題是「<編輯器> · <資料夾>」,側欄標著「來自 Zed」這樣的來源。之後可以在編輯器裡接著聊,也可以回到 wickrunAI 裡繼續;對話像其他對話一樣同步。
- 這一輪改過的檔案會顯示在編輯器裡,也成為這條回答的工作產出,可以在 wickrunAI 的程式碼改動面板裡審閱和回滾。
- 在編輯器裡取消的一輪會保留為「已取消」,不進入之後的上下文。
你可能會遇到的限制
- wickrunAI 桌面版要開著。應用沒開時,編輯器會收到一條看得懂的提示。
- wickrunAI 只能把關 agent 主動申請許可權的操作。不申請就直接改檔案或跑命令的 agent 不會被攔下;資料夾裡的改動仍有記錄、可以回滾。命令不在沙箱裡執行。
- 開啟「逐項修改前確認」時,ACP agent 不能執行 Work。
- ACP agent 暫時不用於委派、雲工作區任務和網頁版的「使用本機 AI」。
- 編輯器裡的會話使用預設的 Work 許可權檔案,不會自動放進專案。
- 編輯器在會話裡傳來的 MCP 伺服器會被忽略。
- 一輪進行中你在編輯器裡改過、還沒儲存的檔案,會被 wickrunAI 寫回的內容覆蓋。
- 被取消的一輪不記錄檔案改動,但它已經寫下的檔案仍在磁碟上。