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 之间互发消息,提前发现冲突、商定顺序

官方举的例子:

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"]

要点:

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 主聊天下一轮收到一条交流记录

设计取舍:

  1. 不打断:消息进 fork 出来的副聊天,B 的主对话照常进行。Aryaman 的说法是 "Nothing blocks your conversation with your agent"。
  2. 防提示注入:对方 agent 发来的内容被标成不可信输入,只作参考,不当成主人的指令。涉及主人的个人文件或连接器数据时先问。
  3. 副聊天权限最小:只能回答,不能改看板、不能提问、不能接源码管理、不能管理 routine。人可以查看、停止或归档它,但不能给它发消息。
  4. fork 而不是共享主上下文:副聊天继承 B 主聊天的已有知识,所以能代 B 回答,主聊天的上下文窗口也不会被别人的问题塞满。

如果需要真人回答,发起方的 coordinator 不会干等,会先做别的任务,等对方的人回复(Aryaman 回复)。

2.3 冲突感知

官方说 agent 会"开工前共享计划、工作中标出冲突"。公开的机制有两层:

推断:看板上的重叠检测大概率由 coordinator(LLM)读看板、对比自己的计划来判断,不是某种静态的文件锁。Cursor 的研究博客写过,早期试过让 agent 用共享状态文件加锁来自协调,结果"20 个 agent 的吞吐降到 1–3 个",后来放弃了锁(见 2.5)。

2.4 运行时与基础设施

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),只在上面加了两样东西:

  1. 把 Store 和看板从"一个人的"改成"一个团队的";
  2. 只在 coordinator 层开一条受限的 A2A 通道,worker 之间仍然隔离。研究里"不要横向通信"的结论在 worker 层继续成立,跨人协作只在 coordinator 层发生。

3. 社区反应

正面

质疑

同期竞品:同一天 Google Antigravity 发布了 /swarm,也是把 agent 放到共享看板上规划、互相要上下文(@Daniel24xiang)。

Reddit:r/cursor 上还没有关于多人版的实质讨论。相关帖子只有一个关于新建 Project 默认模型被切到 Grok 4.7 high 的 bug 报告(链接)。

4. 书签里的相关参考

5. 想自己实现的话

  1. coordinator 和 worker 严格分开:coordinator 只调用"创建 worker、发消息、读写 store、读写看板"这类工具,不给它写代码的工具。
  2. 共享上下文用普通文件:挂载一个同步目录,约定 notes.md(进度)、preferences.md(规则)、workflows/(流程),让 agent 重写而不是一直追加。
  3. 个人 store 和团队 store 物理隔离,复制个人规则到团队要经过人批准。
  4. A2A 用 fork 出来的只读副会话:继承接收方上下文、标为不可信输入、只能回答、回复路由给发送方,接收方主会话下一轮只收到一条摘要。
  5. 冲突检测分两层:派活前用看板做语义重叠检查,PR 层定期跑 git merge-tree。
  6. worker 之间不通信,只向上交 handoff。

参考链接

Read this report as Markdown · Cite it (BibTeX)