VS Code、Cursor、Windsurf、Kiro 外掛

wickrunAI 外掛把燈芯協作帶進你已經在用的編輯器。開啟雲工作區專案裡的檔案，側欄「燈芯協作」顯示還有誰在這個檔案裡，每個人的光標出現在編輯器裡，版本歷史就在程式碼旁邊。專案本身不變：不復制檔案，不匯入設定，快捷鍵和主題仍是編輯器自己的。

安裝

外掛以 VSIX 檔案隨每個版本釋出（wickrunAI-<版本>-vscode.vsix），在 wickrunAI 釋出頁的附件裡下載。它暫時沒有上架擴充套件市場。

編輯器	在介面裡	在終端裡
VS Code	擴充套件檢視 → `···` → 從 VSIX 安裝 → 選擇檔案	`code --install-extension wickrunAI-<版本>-vscode.vsix`
Cursor	命令面板 → Extensions: Install from VSIX…	`cursor --install-extension wickrunAI-<版本>-vscode.vsix`
Windsurf	命令面板 → Extensions: Install from VSIX…	`windsurf --install-extension wickrunAI-<版本>-vscode.vsix`
Kiro	命令面板 → Extensions: Install from VSIX…	`kiro --install-extension wickrunAI-<版本>-vscode.vsix`

更新時用同樣的方式裝新版本的 VSIX。解除安裝和其他擴充套件一樣，在擴充套件視圖裡移除。

登入一次

桌面版開著（推薦）：執行「wickrunAI: Sign in」，或點狀態列上的 wickrunAI。編輯器顯示一個六位程式碼，桌面版會問你是否允許這個編輯器用你的 wickrunAI 賬號開啟協作文件，程式碼相同就點允許。之後編輯器通過桌面版使用同一個賬號，編輯器拿不到桌面版的登入資訊。
沒裝桌面版：同一個命令會開啟瀏覽器登入（先用 Google 登入，再輸入編輯器裡顯示的程式碼）。

要一次斷開所有編輯器，在桌面版選單裡選檔案 → 撤銷編輯器授權。桌面版換了賬號時，編輯器也會斷開；配對 30 天后需要重新確認。

哪些檔案會變成協作文件

在雲工作區工作的專案：wickrunAI 專案的工作資料夾就是這個資料夾，並且開啟了雲工作區，裡面的文本檔案就是協作文件。
沒裝桌面版時：執行「wickrunAI: Link this folder to a cloud workspace」，貼上這個雲工作區裡任意一份協作文件的連結。連結只儲存在編輯器裡，不寫進專案。
連結：網盤檔案、共享對話裡的檔案這類本地沒有的協作文件，可以從連結直接開啟，打字即時同步，不用再儲存。

你會看到什麼

側欄「燈芯協作」：當前檔案、連線狀態，以及誰在這個檔案裡（人是圓形頭像，agent 是帶機器人角標的方形頭像），正在打字的人標著「正在改」。下面是版本歷史：可以「與當前對比」「對比所選兩版」，「恢復到此版」會先問你，並生成一個新版本，不會丟東西；「標記版本」給當前狀態起個名字。
編輯器裡：其他成員的游標和選區用各自的顏色顯示，名字標籤在他們停下幾秒後淡出。
狀態列：線上人數、正在重連或離線；點一下開啟側欄。

編輯器自帶 agent 的改動

Cursor、Windsurf、Kiro 等編輯器的 agent 改檔案時，改動署名是「R 的 Cursor」（R 是你的名字），在歷史裡和你自己敲的字分開顯示。它和通過 MCP 進來的同一個 agent 是同一個成員。

編輯器不會告訴外掛哪些改動來自 agent，所以外掛按你的操作來判斷：在你的游標處輸入、貼上、撤銷算你本人；視窗不在前臺、不是當前檔案、或者遠離所有游標的改動算 agent。全部替換也會被算作 agent；不需要這個區分時，可以在設定裡關閉 wickrun.agentAttribution。

你已有的規則照樣有效

外掛第一次在一個資料夾裡啟用時，如果發現 AGENTS.md、CLAUDE.md、.cursor/rules 等規則檔案，會提示一次「這些規則 Butler 會遵守」。它只檢查檔案是否存在，不復制、不匯入、不修改。

連結和 wickrun 命令

連結	開啟
`wickrun://doc/<文件 ID>`	在 wickrunAI 桌面版裡開啟這份協作文件
`wickrun://open?folder=<路徑>`	在這個資料夾工作的專案
`vscode://wickrun.wickrunai/open?doc=<文件 ID>`	在 VS Code 裡開啟（Cursor、Windsurf、Kiro 分別用 `cursor://`、`windsurf://`、`kiro://`）

桌面版自帶 wickrun 命令。把它加進 PATH 一次：

macOS：ln -s "/Applications/wickrunAI.app/Contents/Resources/cli/wickrun" /usr/local/bin/wickrun
Linux（deb）：sudo ln -s /opt/wickrunAI/resources/cli/wickrun /usr/local/bin/wickrun
Windows：把 %LOCALAPPDATA%\Programs\wickrunAI\resources\cli 加進使用者的 Path

wickrun open .          # 開啟在這個資料夾工作的專案
wickrun doc notes/plan.md  # 開啟這個檔案的協作文件
wickrun link notes/plan.md # 只打印連結
wickrun acp             # 給 Zed、JetBrains、Neovim 用的 ACP agent（見 ACP 說明）

wickrun acp 的用法見 ACP 說明。

你可能會遇到的限制

只有文本檔案會即時共編。.env 等金鑰檔案、二進位制檔案和超過 8 MB 的檔案仍是普通檔案；受限模式下的資料夾不會連線。
加密空間裡的文件不在外掛裡編輯，側欄會提示「在 wickrunAI 中開啟」。
表格和輪流編輯的檔案（如 pptx、docx）請在 wickrunAI 裡開啟。
外掛不做脫敏，脫敏只在桌面版裡進行。
伺服器退回一批改動時，文件會重新開啟，你的其他內容保留，通知裡可以「複製被退回的內容」。