
AFFiNE 是一个开源协作知识库,GitHub 上 7.3 万星,主体用 TypeScript 写、数据层有 Rust 部分。它把文档、白板、多维表格三种形态放在同一块无边画布上:同一个页面里既能按块写正文,又能一键切到无边模式,把段落、便签、图形、网页嵌入、数据库视图随手拖到任意位置。定位就是 Notion 与 Miro 的合并替代品,本地优先存储,可以自己用 Docker 部署,也可以装桌面端完全离线使用。
它想解决的麻烦
团队里最常见的割裂是:文档写在 Notion,流程图去 Miro 画,任务表又放在第三个工具。开会时三个窗口来回切,白板上改了架构、文档里的说明忘了同步,过两周谁也说不清哪一份才是对的;换个人接手,先得把散在三个地方的上下文拼起来。
AFFiNE 的做法是不让「切换」发生。写作模式是块级编辑器,跟常见的笔记工具手感接近;按一下切到无边模式,同一页里的每个块都能自由摆放,正文和图表就成了同一张画布上的元素。改的始终是同一份数据,不存在「复制一份到白板再改」导致的两份不一致。这也是它和「笔记工具里塞个白板插件」最大的差别——两者不是集成关系,是同一个内核的两种视图。
能干什么
- 文档与白板同源:正文的每一段、每张表、每个嵌入网页都能拖到画布上摆位置,画布上的形状也能反向嵌回文档流。
- 多维表格:表里每一行本身就是一个页面,能在表格、看板、日历视图之间切换,任务和它的背景文档挂在同一条数据上。
- 本地优先 + 实时协作:写入先落本地数据库,多人同时编辑靠 CRDT 自动合并,断网可以继续写,联网后自动同步,冲突不用手动解。
- AI 帮工:能从大纲生成演示稿、把长文压成思维导图、把散落的记录整理成任务清单。这部分要模型额度,自建环境可以接自己的模型接口。
- 多端齐:Windows、macOS、Linux、iOS、Android 都有客户端,浏览器也能直接打开,移动端能看能改。
项目概况
| 开发语言 | TypeScript 为主,数据层含 Rust |
| GitHub 星数 | 7.3 万(fork 5300 余) |
| 形态 | 文档 + 白板 + 多维表格,同一画布 |
| 部署方式 | 官方云 / Docker 自建 / 桌面客户端 |
| 自建依赖 | PostgreSQL + Redis |
| 许可 | 开源(仓库标注为自定义组合许可,含 MIT 与 AGPL 部分) |
适合哪些人
- 小团队想找 Notion 加 Miro 的合并方案,又不想把资料放在别人服务器上的。
- 产品和设计团队:需求文档、原型草图、讨论结论本来就该长在一个页面上。
- 个人做长期知识库,要求离线能写、数据存在自己硬盘里的。
- 学校、机构的内网环境,法规上不能连外网、必须自建的。
怎么开始用
- 只想试试:装桌面客户端,建一个本地工作区就能写,不需要任何服务器,也不要求注册账号。
- 团队共用:找一台能跑 Docker 的机器(2 核 4G 起步),先把 PostgreSQL 和 Redis 各起一个容器。
- 把仓库里的 compose 配置拉下来,改三处:数据库密码、对外端口、服务地址;然后一条命令拉起全部容器。
- 浏览器打开映射的端口,第一个注册的账号自动成为工作区管理员,之后在成员设置里发邀请。
- 迁移旧资料:Notion 页面和 Markdown 文件都能导入,导完先建一个索引页把散落的页面串起来,再开始日常写作。
常见问题
问:这个要收费吗,哪些功能是付费的?
答:软件开源,自建不收费;官方云有付费档位,AI 功能按额度计。自建环境里想用 AI,在配置里接自己的模型接口就行,费用转给自己用的模型服务。
问:桌面端断网还能写吗?
答:能。它是本地优先架构,内容先写进本地数据库,联网后再和服务器或其他成员同步,出差和断网场景不影响记录。
问:自建需要什么配置,人多会不会卡?
答:除本体外要一个 PostgreSQL 和一个 Redis,2 核 4G 够小团队日常用。人数上到几十个、页面里图表和嵌入特别多时,再考虑加到 4 核 8G。
问:以后想搬走,数据会不会被锁死?
答:页面能导出 Markdown 和 PDF,工作区可以整包备份;表格数据同时存在关系库里,不会只剩一个专有格式。定期把数据库备份拉一份到别的机器上就更稳。
最后更新:2026-10-28
