Cursor 多人 Projects:功能与实现分析
By 陈成 · Published November 12, 2026
Cursor 多人 Projects 是什么,怎么实现的?
原帖:Cursor @cursor_ai, 2026-11-11:"Your agents can now coordinate with your teammates' agents. Projects has been rebuilt for multiplayer." 整理日期:2026-11-11
一句话
Cursor 把 9 月上线的单人 Projects(一个 coordinator 指挥一群 worker agent)改成多人版。每人仍有自己的 coordinator 和 workers,团队共享一块任务看板和一个项目 Store(共享上下文文件)。各人的 coordinator 之间可以直接发消息,消息进入对方的只读"副聊天",不打断对方的主对话。
1. 功能是什么
| 维度 | 单人 Projects(2026-09) | 多人 Projects(2026-11 beta) |
|---|---|---|
| 指挥者 | 1 个 coordinator,自己不写代码,只规划和派活 | 每个成员各一个 coordinator,各自计费 |
| 执行者 | 大量 worker(云端 VM,必要时起本地 agent) | 同左,每人各自一组 |
| 上下文 | Project store:一组在所有云端和本地机器间同步的文件 | 项目 store 由全员 agent 读写,另有每人私有的 user store |
| 任务 | 项目内任务列表 | 全员共享的任务看板,显示谁在做什么、对应哪个 PR |
| 触发 | Subscriptions:Slack 频道、定时、PR/CI 事件 | 同左 |
| 跨人协作 | 无 | coordinator 之间互发消息,提前发现冲突、商定顺序 |
官方举的例子:
- 工程师给商品页加评论,设计师同时在重做这个页面。两边的 coordinator 提前发现重叠,评论直接做进新设计,省掉后面的重构。
- 你的功能读某张表,同事在改它的 schema。两边 agent 先商量好先后顺序,最后不会撞 merge conflict。
- on-call 交接:新人的 coordinator 先确认一遍,然后接着处理在途工作、没人管的 issue 和要盯的频道,进行中的任务可以直接转给新人的 agent。
Cursor 员工 Aryaman 说,内部最大的一个 Project 峰值时有 11 人、62 个并发 agent,15 天合并了 972 个 PR(来源)。
2. 实现方式
以下内容来自官方文档和博客。标"推断"的部分是根据公开信息推测的,官方没有明说。
2.1 整体架构
flowchart TB
subgraph Team["一个多人 Project(云端,自有计算机)"]
direction TB
Board[["共享任务看板<br/>task list / board"]]
Store[("项目 Store · Context<br/>/cursor/stores/self<br/>preferences.md · notes.md<br/>workflows/ · principles/")]
subgraph A["成员 A(以 A 身份运行与计费)"]
CA["A 的 Coordinator<br/>不写代码,只规划和派活"]
UA[("A 的个人 Store<br/>/cursor/stores/user")]
WA1["Worker:独立 VM 和仓库副本"]
WA2["Worker"]
LA["本地 agent<br/>需要在 A 机器上测试时"]
CA --> WA1 & WA2 & LA
CA -.-> UA
end
subgraph B["成员 B"]
CB["B 的 Coordinator"]
UB[("B 的个人 Store")]
WB1["Worker"]
CB --> WB1
CB -.-> UB
end
CA <--> Board
CB <--> Board
WA1 & WA2 & WB1 <--> Store
CA & CB <--> Store
end
Subs["Subscriptions<br/>Slack / 定时 / PR / CI"] --> CA & CB
WA1 & WB1 --> GH["GitHub PR"]
要点:
- coordinator 不写代码。它只规划、派活、验收,所以永远不会被手头的工作卡住,随时能回应人。
- worker 默认在各自的云 VM 上,用自己的仓库副本,互不踩文件;只有确实需要共用 checkout 时才用同 VM worker(帮助文档的种子规则)。
- 共享上下文就是一个挂载的文件目录(Agent Store),没有用向量库或别的黑盒。agent 往里写调研结果、测试方法、偏好,后来的 agent 直接读。
- 个人 Store 和项目 Store 分开挂载:
/cursor/stores/self是全员共享的,/cursor/stores/user只给本人的 agent,所以队友看不到你的偏好和 skill。新人加入时,你的 coordinator 可以把你偏好里跟本项目相关的条目复制进项目规则,但要你批准。
2.2 coordinator 之间怎么通信
这是多人版最关键的新机制。文档写得很具体:
sequenceDiagram
participant A as A 的主聊天(Coordinator)
participant P as Cursor 消息投递层
participant S as B 侧「Chat with A's agent」<br/>(从 B 主聊天 fork 出的副聊天)
participant B as B 的主聊天(Coordinator)
A->>P: 需要 B 那边的信息 / 发现冲突
P->>S: 投递消息,标注"来自 A 的 agent,属于不可信输入"
Note over S: 基于 B 主聊天已有的上下文作答<br/>只读任务看板,不改<br/>不泄露密钥、凭据、token<br/>不能向 B 提问,也不能申请权限
S-->>P: 回复
P-->>A: 回复送回 A 的聊天,A 继续工作
P-->>B: B 主聊天下一轮收到一条交流记录
设计取舍:
- 不打断:消息进 fork 出来的副聊天,B 的主对话照常进行。Aryaman 的说法是 "Nothing blocks your conversation with your agent"。
- 防提示注入:对方 agent 发来的内容被标成不可信输入,只作参考,不当成主人的指令。涉及主人的个人文件或连接器数据时先问。
- 副聊天权限最小:只能回答,不能改看板、不能提问、不能接源码管理、不能管理 routine。人可以查看、停止或归档它,但不能给它发消息。
- fork 而不是共享主上下文:副聊天继承 B 主聊天的已有知识,所以能代 B 回答,主聊天的上下文窗口也不会被别人的问题塞满。
如果需要真人回答,发起方的 coordinator 不会干等,会先做别的任务,等对方的人回复(Aryaman 回复)。
2.3 冲突感知
官方说 agent 会"开工前共享计划、工作中标出冲突"。公开的机制有两层:
- 任务看板:每个任务挂着负责人、负责的 agent 和 PR,coordinator 派活前能看到别人在做什么。Aryaman 说:"They'll notify you if you kick off work that intersects with something your teammate is already working on."
- PR 级别的合并检查(帮助文档里 Cursor 内部的种子规则):每 2–3 分钟对每个开着的 PR 跑一次
git fetch origin main && git merge-tree --write-tree origin/main <head>,发现冲突就合入 main,生成文件重新生成而不是手工合并。
推断:看板上的重叠检测大概率由 coordinator(LLM)读看板、对比自己的计划来判断,不是某种静态的文件锁。Cursor 的研究博客写过,早期试过让 agent 用共享状态文件加锁来自协调,结果"20 个 agent 的吞吐降到 1–3 个",后来放弃了锁(见 2.5)。
2.4 运行时与基础设施
- 跑在 Cloud Agents 上:Project 有自己的云端计算机,合上笔记本也不停。所以不支持 Privacy Mode (Legacy),也不能在自托管机器上的 Project 里加人。
- 本地按需:需要在你机器上验证时,coordinator 起一个本地 agent(Remote Control)。
- 各自计费:每个成员的聊天以本人身份运行和计费,每个人可以选自己的模型。
- Store 同步:Store 文件"在每台云端和本地机器之间同步"。具体同步协议没有公开。
- 依赖的底层:Git at any scale(大规模 Git)、自托管机器、Agent SDK。
2.5 设计来源:Cursor 的多 agent 研究
Self-driving codebases(Wilson Lin)记录了 Projects 前身的演进,几乎每一步都能在产品里找到对应:
flowchart LR
V1["v1 平等自协调<br/>共享状态文件 + 锁"] -->|锁竞争,没人接大任务| V2["v2 planner → executor → workers + judge"]
V2 -->|被最慢的 worker 拖住,计划僵化| V3["v3 持续运行的 executor<br/>边规划边派活<br/>scratchpad 定期重写"]
V3 -->|角色太多:会睡着、自己写代码、过早宣布完成| V4["最终版<br/>root planner 不写代码<br/>可递归 subplanner<br/>worker 各自仓库副本,完成后交 handoff"]
V4 -->|integrator 成为瓶颈| V5["去掉 integrator<br/>接受少量错误率,系统自行收敛"]
| 研究结论 | 在 Projects 中的体现 |
|---|---|
| planner 不写代码,否则会过载 | coordinator "doesn't write code itself" |
| worker 不了解全局,只交 handoff | worker 完成后把结果交回 coordinator;种子规则要求一个 worker 只负责一个 PR 或工作流,不设中层经理 |
| 锁和共享状态文件让 agent 困惑 | 共享层用的是按文件组织的 Store 和看板,不让 agent 管锁 |
| scratchpad 要重写而不是追加,保持新鲜 | notes.md 跟踪进行中、排队中、已完成的工作;preferences.md 一行一条规则 |
| 指令质量会被放大 | Store 里的 workflows/、principles/,加上官方给的种子规则 |
| 跨 agent 横向对话的开销大 | 多人版只在 coordinator 这一层通信,worker 之间仍然不说话 |
可以看出,多人版没有改核心架构(一个不写代码的 coordinator 加一群互相隔离的 worker),只在上面加了两样东西:
- 把 Store 和看板从"一个人的"改成"一个团队的";
- 只在 coordinator 层开一条受限的 A2A 通道,worker 之间仍然隔离。研究里"不要横向通信"的结论在 worker 层继续成立,跨人协作只在 coordinator 层发生。
3. 社区反应
正面
- "Agents coordinating with teammates' agents is the real unlock. Next questions: shared memory, and who's allowed to approve what." —— @onvanar
- on-call 交接被认为最实用:新人的 agent 直接接手未处理的 incident(@sreedotworld)。
质疑
- 规则和质量会互相污染:"One slop can degrade the quality." —— @avisinghdotdev。Aryaman 的回应是:项目 store 可以定义全项目统一的 rules 和 skills,新成员一进来就有。
- 架构路线不同:有人指出 Cognition 的做法正好相反,review agent 和写代码的 agent 共享零上下文,写入保持单线程("many agents think, one writes")(@SlavaOPs)。
- 所有权问题:"Cross-lane conflicts only stopped once each agent owned a lane." 两个人的 agent 改同一段代码怎么办,官方还没有详细说明(@asumaships)。
- 人工验证仍是瓶颈:agent 越多,code review 越要严,否则只是把坏架构自动化了(@antonioperic)。要上线、花钱或对外发消息的事,仍需要人批准(@Andrew_W1)。
- 调侃:"my agent says your agent is impossible to work with"、"now my agent can get into a merge conflict with your agent while we're both at lunch"。
同期竞品:同一天 Google Antigravity 发布了 /swarm,也是把 agent 放到共享看板上规划、互相要上下文(@Daniel24xiang)。
Reddit:r/cursor 上还没有关于多人版的实质讨论。相关帖子只有一个关于新建 Project 默认模型被切到 Grok 4.7 high 的 bug 报告(链接)。
4. 书签里的相关参考
- herdr-projects / shepherdr:开源的"跟一个 coordinator 对话,它拆任务派给 agent"的 mission control,思路与 Projects 一致。
- firstmate:"Talk to one agent. Ship with a crew."
- Hermes Agent v0.21.0:Agent-to-Agent Comms。
- Addy Osmani:多 agent 先过一遍 PR,再由人审批(对应"人工验证是瓶颈"的讨论)。
5. 想自己实现的话
- coordinator 和 worker 严格分开:coordinator 只调用"创建 worker、发消息、读写 store、读写看板"这类工具,不给它写代码的工具。
- 共享上下文用普通文件:挂载一个同步目录,约定
notes.md(进度)、preferences.md(规则)、workflows/(流程),让 agent 重写而不是一直追加。 - 个人 store 和团队 store 物理隔离,复制个人规则到团队要经过人批准。
- A2A 用 fork 出来的只读副会话:继承接收方上下文、标为不可信输入、只能回答、回复路由给发送方,接收方主会话下一轮只收到一条摘要。
- 冲突检测分两层:派活前用看板做语义重叠检查,PR 层定期跑
git merge-tree。 - worker 之间不通信,只向上交 handoff。
参考链接
- 原帖:https://x.com/cursor_ai/status/2120295553309565139
- 官方博客 · 多人 Projects:https://cursor.com/blog/projects-multiplayer
- 官方博客 · Introducing Projects:https://cursor.com/blog/projects
- 文档 · Projects(含 Multiplayer、A2A 规则、Store 路径):https://cursor.com/docs/agent/projects.md
- 帮助 · What is a Cursor Project(含 Store 结构和种子规则):https://cursor.com/help/ai-features/projects.md
- 研究 · Self-driving codebases:https://cursor.com/blog/self-driving-codebases
- 研究 · Git at any scale:https://cursor.com/blog/git-at-any-scale
- Matt Palmer 发布帖:https://x.com/mattyp
- Aryaman(作者)的回复:https://x.com/aryamankhawow
- X 搜索:https://x.com/search?q=cursor%20projects%20multiplayer%20coordinator
- Reddit r/cursor:https://www.reddit.com/r/cursor/comments/1xq5vsq/default_model_of_cursor_projects_keeps_switching/