第 27 章 多人协作：一份方案三个人和两个 Agent 一起改
一份方案，产品经理改第一稿，设计师调版式，项目负责人审终稿——这是常态。问题是中间总有人不在，等回复要半天。如果再加上 Agent 帮忙润色和排版，节奏就更难协调了。
WorkBuddy 的多人协作能力，就是为了让人和 Agent 能在同一份材料上一起干活，而不是轮流排队。
为什么要团队空间
没有团队空间时，协作者面对的是"文件传来传去"的困局：
- 你发一份 Word 给同事，对方改完发回来，你再合并修改。三更两改之后，没有人知道哪一版是最终版。
- 想让 Agent 帮忙审阅，得先把文件上传给它，改完再下载回来贴到原文档里。中间多了一次搬运。
- 权限靠口头约定。"你别改这块，那是我的部分"——说的人记得，不说的人不知道。
团队空间解决的是同一份材料的共同编辑和权限归属。人和 Agent 都在同一个空间里工作，谁改了什么一目了然，谁能改什么由权限控制。
创建团队空间和权限
创建团队空间
在资料库侧边栏找到"团队空间"区域，点击"+"按钮即可新建一个空间。创建后可以通过四种方式往空间里添加内容：
| 方式 | 说明 | 适合场景 |
|---|---|---|
| 新建文档 | 在空间内直接创建空白 MD 或 HTML 文件 | 从零开始写新方案 |
| 上传文件 | 把本地文件上传到空间 | 已有初稿需要协作 |
| 从我的文档移动 | 把个人空间的文件迁入团队空间 | 个人草稿转为团队协作 |
| Agent 生成并存入 | 在对话中让 Agent 把产出存到指定空间 | Agent 产出直接进入协作流程 |
四级权限体系
团队空间的权限分为四个级别，Agent 的权限与成员一致——你给某个人什么权限，Agent 在代表这个人工作时也拥有同样的权限。
| 权限级别 | 能做什么 | 不能做什么 |
|---|---|---|
| 查看 | 浏览文件内容、下载文件 | 修改、删除、分享 |
| 编辑 | 查看全部 + 修改文件内容 | 删除文件、管理成员和权限 |
| 管理 | 编辑全部 + 删除文件、管理成员 | 无（最高权限） |
| 无权限 | 不可见 | 一切操作 |
权限设计的核心原则是"最小够用"。给协作者编辑权限就够了，不要默认给管理权限；给外部审阅者查看权限就够了，不要给编辑权限。Agent 也是一样——如果只是让 Agent 审阅提建议，查看权限足矣；如果要让 Agent 直接修改，才给编辑权限。
创建一个名为"Q3产品方案"的团队空间。
把张三设为编辑权限，李四设为查看权限。
Agent 协作权限跟随编辑级别。审阅模式：和 AI 一起改 MD 文档
Markdown 文档是团队协作中最常用的格式，因为结构清晰、纯文本、好对比。WorkBuddy 为 MD 文档提供了专门的审阅模式，让人和 AI 的修改都有迹可循。
划词评论
选中一段文字，可以直接添加评论。这是最轻量的协作方式——不改动原文，只提意见。适合审阅者提出修改建议但不想直接动手的场景。
选中第三段"用户增长策略"，添加评论：
"这里缺少具体的时间节点和负责部门，建议补充 Q3 每月的增长目标和对应负责人。"修订建议
这是审阅模式的核心功能。AI 审阅文档后不会直接覆盖原文，而是生成修订建议。你可以逐条查看每条建议的对比视图，决定接受还是拒绝。
| 操作 | 说明 |
|---|---|
| AI 生成修订建议 | AI 审阅全文后提出修改建议，不改动原文 |
| 对比视图 | 原文和建议并排展示，差异一目了然 |
| 逐条接受/拒绝 | 每条建议独立判断，不需要全盘接受或全盘拒绝 |
| 按评论修订 | AI 根据你或他人的划词评论，针对性生成修订建议 |
这个设计的关键是"AI 不越权"。传统做法是直接让 AI 改，改完你不确定它动了哪里。审阅模式下，AI 的每一条修改都是建议，你不点接受，原文不变。
审阅这份方案，针对以下方面生成修订建议：
1. 逻辑连贯性：各章节之间的衔接是否顺畅；
2. 数据准确性：文中提到的数字是否有明显错误或前后矛盾；
3. 表达一致性：术语和口径是否统一。
每条建议标注修改位置和理由，不要直接覆盖原文。按评论修订
如果团队里有人通过划词评论提了修改意见，你可以让 AI 直接基于这些评论生成修订建议。这比逐条手动修改高效得多，而且仍然走"建议-接受"流程，不会失控。
读取这份文档中所有的划词评论，针对每条评论生成对应的修订建议。
保留对比视图，我逐条确认后再统一应用。多人协同编辑 HTML
MD 文档适合内容层面的协作，但有些任务的产出是网页——仪表盘、落地页、报告页面。WorkBuddy 的 HTML 协同编辑让多人可以同时编辑同一个 HTML 页面，并且能看到彼此的光标位置。
划词让 AI 修改
在 HTML 编辑界面，选中任意元素后可以直接调用 AI 修改。和 MD 的审阅模式不同，HTML 的 AI 修改是即时生效的——你选中一块区域，描述要改什么，AI 直接在页面上执行修改。
| 对比 | MD 审阅模式 | HTML 协同编辑 |
|---|---|---|
| 修改方式 | 提建议，逐条接受后写入 | 选中即改，即时生效 |
| 适用格式 | Markdown 文档 | HTML 网页 |
| 适合阶段 | 内容打磨、审阅定稿 | 版式调整、可视化修改 |
| 修改粒度 | 段落、句子级别 | 元素、区块级别 |
为什么 MD 和 HTML 的策略不同？因为 MD 是内容层，改错一个字可能影响整个文档的逻辑链，所以需要审慎的"建议-接受"流程。HTML 是表现层，改错了版式通常不影响内容本身，撤销即可，所以即时修改效率更高。
多人光标可见
多个人同时编辑一个 HTML 页面时，每个人的光标位置对其他人可见。这让协作更顺畅：你能看到同事正在改哪里，避免两个人改同一块区域产生冲突。
选中页面顶部的横幅区域，把背景色改成深蓝色，标题文字改成白色，居中显示。MD、CSV 与 HTML 分工
复杂任务往往不止一种文件格式。WorkBuddy 的团队空间支持 MD、CSV 和 HTML 三种格式的分工协作，让不同维度的内容各归各位。
| 格式 | 承担的角色 | 典型内容 |
|---|---|---|
| MD | 内容层 | 方案正文、会议纪要、需求文档、分析报告 |
| CSV | 数据层 | 产品清单、订单记录、任务台账、统计数据 |
| HTML | 表现层 | 仪表盘、落地页、报告页面、可视化展示 |
这个分工的核心思路是数据和视觉分离。CSV 存数据，HTML 做展示，两者之间通过数据引用关联。好处是：改数据时只改 CSV，HTML 页面刷新后自动更新；改版式时只改 HTML，不需要动数据。
在团队空间"Q3项目"中：
1. 用 MD 写一份产品上线方案正文；
2. 用 CSV 维护一份功能清单和排期表；
3. 用 HTML 做一个项目进度看板，数据来自 CSV。
三者放在同一空间，互相引用。这种分工比"把所有东西塞进一个 Word"要好得多。Word 里的表格改一个数字，整个文档的页码和排版都可能错位；CSV 和 HTML 分离后，数据更新不影响版式，版式调整不影响数据。
使用建议
先定权限再开始改。 团队空间创建后，第一件事是把成员和权限分配好，再开始协作。不要等改了三版才发现有人不该有编辑权限。Agent 的权限也要想清楚：是只让它提建议（查看权限），还是让它直接改（编辑权限）。
MD 做内容，HTML 做版式。 如果一份产出同时需要内容审阅和版式调整，先用 MD 把内容定稿，再转成 HTML 做版式。不要在 HTML 里调内容逻辑——HTML 编辑适合改版式和视觉，不适合改长篇文字。
修订建议要逐条看。 AI 生成的修订建议不要全盘接受。每条建议都看一眼对比视图，判断这个修改是否真的更好。AI 的建议方向对但细节可能不到位，拒绝一条不影响其他条。
数据放 CSV，不要放 HTML 里。 如果页面里有表格数据，用 CSV 存储再用 HTML 引用，不要把数据直接写死在 HTML 代码里。写死的数据改起来要翻代码，CSV 改一个格子就行。
用划词评论做分工标记。 如果团队里不同人负责不同章节，可以用划词评论做标记——"这部分张三负责""这段待李四确认"。比口头分配更留痕，也方便 AI 按评论生成针对性修订。