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