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 里打开。
插件不做脱敏，脱敏只在桌面版里进行。
服务器退回一批改动时，文档会重新打开，你的其他内容保留，通知里可以「复制被退回的内容」。