---
title: "Cursor 多人 Projects"
author: "陈成"
author_url: "https://research.sorrycc.dev/@sorrycc"
question: "Cursor 多人 Projects 是什么，怎么实现的？"
url: "https://research.sorrycc.dev/@sorrycc/cursor-multiplayer-projects"
emoji: "👥"
published: 2026-11-12T07:18:57Z
updated: 2026-11-12T07:18:57Z
version: 3
cite: "https://research.sorrycc.dev/@sorrycc/cursor-multiplayer-projects.bib"
---

# Cursor 多人 Projects：功能与实现分析

By [陈成](https://research.sorrycc.dev/@sorrycc) · Published November 12, 2026

> Cursor 多人 Projects 是什么，怎么实现的？

> 原帖：[Cursor @cursor_ai, 2026-11-11](https://x.com/cursor_ai/status/2120295553309565139)："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（[来源](https://x.com/aryamankhawow)）。

## 2. 实现方式

以下内容来自官方文档和博客。标"推断"的部分是根据公开信息推测的，官方没有明说。

### 2.1 整体架构

```mermaid
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（[帮助文档的种子规则](https://cursor.com/help/ai-features/projects.md)）。
- **共享上下文就是一个挂载的文件目录**（Agent Store），没有用向量库或别的黑盒。agent 往里写调研结果、测试方法、偏好，后来的 agent 直接读。
- **个人 Store 和项目 Store 分开挂载**：`/cursor/stores/self` 是全员共享的，`/cursor/stores/user` 只给本人的 agent，所以队友看不到你的偏好和 skill。新人加入时，你的 coordinator 可以把你偏好里跟本项目相关的条目复制进项目规则，但要你批准。

### 2.2 coordinator 之间怎么通信

这是多人版最关键的新机制。文档写得很具体：

```mermaid
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 回复](https://x.com/aryamankhawow)）。

### 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](https://cursor.com/blog/git-at-any-scale)（大规模 Git）、[自托管机器](https://cursor.com/blog/self-hosted-machines)、[Agent SDK](https://cursor.com/blog/agent-sdk)。

### 2.5 设计来源：Cursor 的多 agent 研究

[Self-driving codebases](https://cursor.com/blog/self-driving-codebases)（Wilson Lin）记录了 Projects 前身的演进，几乎每一步都能在产品里找到对应：

```mermaid
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. 社区反应

**正面**
- "Agents coordinating with teammates' agents is the real unlock. Next questions: shared memory, and who's allowed to approve what." —— [@onvanar](https://x.com/onvanar)
- on-call 交接被认为最实用：新人的 agent 直接接手未处理的 incident（[@sreedotworld](https://x.com/sreedotworld)）。

**质疑**
- **规则和质量会互相污染**："One slop can degrade the quality." —— [@avisinghdotdev](https://x.com/avisinghdotdev)。Aryaman 的回应是：项目 store 可以定义全项目统一的 rules 和 skills，新成员一进来就有。
- **架构路线不同**：有人指出 Cognition 的做法正好相反，review agent 和写代码的 agent 共享零上下文，写入保持单线程（"many agents think, one writes"）（[@SlavaOPs](https://x.com/SlavaOPs)）。
- **所有权问题**："Cross-lane conflicts only stopped once each agent owned a lane." 两个人的 agent 改同一段代码怎么办，官方还没有详细说明（[@asumaships](https://x.com/asumaships)）。
- **人工验证仍是瓶颈**：agent 越多，code review 越要严，否则只是把坏架构自动化了（[@antonioperic](https://x.com/antonioperic)）。要上线、花钱或对外发消息的事，仍需要人批准（[@Andrew_W1](https://x.com/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](https://x.com/Daniel24xiang)）。

**Reddit**：r/cursor 上还没有关于多人版的实质讨论。相关帖子只有一个关于新建 Project 默认模型被切到 Grok 4.7 high 的 bug 报告（[链接](https://www.reddit.com/r/cursor/comments/1xq5vsq/default_model_of_cursor_projects_keeps_switching/)）。

## 4. 书签里的相关参考

- [herdr-projects / shepherdr](https://x.com/eliasstravik)：开源的"跟一个 coordinator 对话，它拆任务派给 agent"的 mission control，思路与 Projects 一致。
- [firstmate](https://github.com/kunchenguid/firstmate)："Talk to one agent. Ship with a crew."
- Hermes Agent v0.21.0：Agent-to-Agent Comms。
- Addy Osmani：多 agent 先过一遍 PR，再由人审批（对应"人工验证是瓶颈"的讨论）。

## 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。

## 参考链接

- 原帖：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/
