夜雨聆风手上能写文档的地方已经够多了：飞书文档、各种笔记应用、本地的 markdown 文件夹。两天前我又在自己机器上起了一个 Outline。
起因很具体，而且跟"多人协同"没什么关系——我要的是人和 AI 同时在同一份文档上工作。
我在打通一条从需求到研发的链路：AI 陪我把需求磨清楚，它生成初版 PRD，我在上面改，开发的进展再往同一份文档上叠。整个过程里，写这份文档的不是一个人：一个 Agent 陪我磨需求、生成初稿，一个在开发环里往上叠进展，一个把运维阶段的东西补回来。加上我自己，一份文档四个作者。
听着简单，但绝大多数文档工具接不住。它们的编辑能力是给人设计的，AI 想进去要么没接口，要么只能读不能写，要么每次都得整段导出再整段贴回——一来一回，格式和结构就掉了。
01写 Markdown 的手感
先说最日常的部分：它的编辑器写起来很舒服。
原生吃 Markdown 语法，敲 ## 直接变标题，- 变列表，不用去工具栏找按钮，也不会像某些富文本编辑器那样偷偷把你的格式改掉。粘贴一段 Markdown 进去，它就是 Markdown 的样子。
底层用的是 ProseMirror，所以它不是"支持导入导出 Markdown"，是内部结构就跟 Markdown 对得上。这个差别在人和 AI 一起写的时候会被放大：我在编辑器里敲的东西，和程序直接生成的东西，是同一个形态——不需要谁去迁就谁。
02Agent 直接往里写，很顺
翻它的依赖清单时看到 @modelcontextprotocol/sdk——Outline 官方把 MCP 集成进代码里了。也就是说，它一开始就打算被 AI 直接读写，而不是当成一个需要人在中间搬运的网页。
实际用下来，Agent 写进去完全没问题，非常顺畅。不是那种"能写，但格式会乱、标题层级会塌、表格会散架"的能写，是它生成什么，页面上就长什么样，我打开就能接着改。这一点比我预期的好。
这两天下来，那个空间里躺着五篇 PRD 和一份运维日记，四十多次修订记录，都是这么攒出来的。文档不再是"交出去就作废的一次性交付物"，它成了贯穿整条链的活载体。
03批注变成了指令
还有一个功能，本身很常见，但在人和 AI 一起写的场景里性质完全变了：每一段旁边都可以加评论。
我 review 一份 AI 写的 PRD，看到哪一段不对，就在那一段边上写一句"这里的口径改成什么什么"。这条评论 Agent 读得到，读到就照着改。
以前要让 AI 改文档，你得在对话框里描述半天：第三节第二段那个地方，把什么什么改成什么什么——你得先替它定位，还经常定位错。现在评论自带锚点，你写在哪，它就知道是哪一段。
批注从"给人看的意见"变成了"给 AI 的指令"，而且是带精确坐标的指令。
这件事让整个 review 的动作回到了它本来该有的样子：我不需要为了指挥 AI 而重新组织语言，我就像给同事的稿子写批注一样写，剩下的它自己接。
04一个为多人设计的技术，接住了人和 AI
有意思的是，让这件事成立的底层技术，本来不是为这个场景准备的。
Outline 的协同编辑用的是 Yjs 这套 CRDT，加上 Hocuspocus 做同步。这类技术当年解决的是多个人同时改同一段文字时怎么自动合并，不用谁先锁上谁才能改。
现在它接住了一类新的协同对象。AI 写它那部分的时候，我可以同时在别的段落改；它更新完，我这边不用刷新也不用担心把它的改动覆盖掉。人和 AI 成了同一份文档上的共同作者，而底下那套合并机制不在乎坐在另一端的是人还是程序。
这大概是我这段时间挑工具的一个新判据：它有没有把 AI 当成一个正经的协作者，而不是一个需要人代劳搬运的外挂。
05自建的成本比想象低
我是用 Docker 起的，四个容器：Outline 本体、Postgres、Redis、一个收邮件的小服务（本地用来接注册邀请邮件）。跑起来占用很轻，一个端口就能访问。
官方也有云托管，十来个人的小团队每月十美元起。但我要的是能塞进自己流水线的那个版本，所以还是自建。
06一个容易搞错的地方
它在 GitHub 上有近四万 star，很多人默认它是开源的——严格说不是。它用的是 BSL 1.1（Business Source License）：源码公开、可以自己部署自己用，但有商业使用限制，要等四年后才自动转成真正的开源协议。
自用、内部用完全没问题，但如果打算基于它做点对外的生意，得先把协议看一遍。"GitHub 上开源"和"你可以随便商用"是两件事。
07还没验证的
真正的多人协同我还没跑过。 我这边到现在只有一个账号，人和 AI 同时编辑是天天在发生，但"好几个同事同时在线改同一篇"没试过。技术方案看着是对的，实际体感说不出来。
另一个悬着的问题不在工具上：当一份文档变成人和 AI 共处的上下文，它就需要一个主人。谁来改、改了算谁的、AI 改错了谁负责——这些不是换个编辑器能回答的。
工具/项目：Outline（getoutline.com，GitHub: outline/outline），团队知识库，Markdown 原生、Yjs 实时协同、官方集成 MCP；BSL 1.1 协议，可自建（Docker），云托管 $10/月起。
2026 年 7 月 · 以上判断约 6 个月有效
