🌟 无需在多个工具间切换，一个平台满足文档、白板与数据库全需求

在信息碎片化的时代，我们常常陷入这样的困境：在 Notion 中记录文档、在 Miro 上进行头脑风暴、在 Trello 中管理任务，频繁切换导致工作效率低下。而现在，一个全新的开源解决方案——AFFiNE，正试图打破这些壁垒，将规划、分类和创作整合到一个统一的平台中。

📖 什么是 AFFiNE？

AFFiNE（发音为 [ə‘fain]）是一款开源知识库平台，它的核心目标是创建一个统一的数字工作空间，将传统知识管理中的计划、整理和创建功能无缝融合。你可以将其理解为：

🎯 Notion 的强大文档编辑能力 + Miro 的自由可视化白板能力 = AFFiNE

与许多云服务不同，AFFiNE 采用 "本地优先" 理念，优先将你的数据存储在本地设备上。这意味着你对自己的知识拥有绝对控制权，无需担心服务商政策变动或数据泄露风险，同时也支持离线使用。

AFFiNE 项目在 GitHub 上已经获得了超过 45k 的 Stars，展现了其在开发者社区中的高度关注和认可。

✨ AFFiNE 的核心功能与优势

🌈 革命性的双模态编辑

AFFiNE 最引人注目的特性之一是其创新的双模态编辑界面：

  • 📝 Paper 模式：提供结构化的文档编辑体验，采用先进的块编辑器，支持 Markdown 快捷方式，适合撰写笔记、文章和报告
  • 🎨 Edgeless 模式：提供一个无限延伸的画布，你可以在上面自由绘制、放置文本块、图片、任务卡片、连接线等，进行头脑风暴、流程图设计、视觉规划等

💡 关键亮点：这两种模式并非孤立。你可以在白板上添加的文本块，无缝拖拽到文档模式中继续编辑，反之亦然。这种内容块的互通性极大地提升了信息流转的效率。

🔒 隐私优先与数据主权

AFFiNE 致力于解决 Notion 和 Miro 在安全和隐私方面的一些局限性。你的数据首先存储在本地设备上，对自己知识拥有绝对控制权。这对于处理敏感信息的个人和企业来说是一个重要优势。

🔓 开源透明

AFFiNE 遵循 MIT 许可证，代码完全公开。这意味着：

  • 🔍 更高的透明度和安全性（社区可审查代码）
  • 🛠️ 自由度更高（可自托管、定制）
  • 🚫 永无供应商锁定之忧

👥 实时协作

基于 CRDTs 技术，AFFiNE 支持多用户实时、无冲突地在同一文档或白板上进行编辑，确保团队协作的流畅性。即使使用云端同步，也旨在确保数据的最终所有权和安全性。

🧱 块状编辑器与灵活性

所有内容都以"块"（Block）为基本单元（文本、图片、待办事项等）。这些块不仅可以自由组合，还能进行结构化管理，未来支持类似数据库的功能，实现内容的智能组织。

🤖 多模态 AI 合作伙伴

AFFiNE 集成了 AI 助手能力，可辅助进行文本生成、幻灯片制作、思维导图构建甚至代码和原型设计，提升创作效率。虽然该功能可能仍处于规划或早期阶段，但展示了工具的未来发展方向。

⚖️ AFFiNE 与同类产品的对比

🔄 AFFiNE vs Notion

特性AFFiNENotion
数据存储🏠 本地优先☁️ 云端优先
开源情况✅ 完全开源❌ 闭源
费用💰 完全免费💵 免费版+付费版
离线使用✅ 支持⚠️ 有限支持
白板功能🎨 内置🔗 需集成其他工具

🔄 AFFiNE vs Miro

特性AFFiNEMiro
文档编辑📝 强大的块编辑器🎨 侧重白板
价格💰 完全免费💵 免费版+付费版
自托管✅ 支持❌ 不支持
数据结构🗃️ 支持数据库功能⚠️ 有限

🏆 AFFiNE 的独特优势

  1. 🎨 真正的画布体验：AFFiNE 是极少数允许你将任何元素放入无边框画布的应用之一——富文本、便签、任何嵌入式网页、多视图数据库、链接页面、形状甚至幻灯片
  2. 🔓 无供应商锁定：因开源特性，你可以完全掌控自己的数据和工具
  3. 🔄 一体化工作流：无需在不同工具间切换，减少上下文丢失
  4. 🎛️ 高度可定制：可根据需要自托管、分叉和构建自己的 AFFiNE

🛠️ AFFiNE 详细使用指南

🚀 初次设置与界面熟悉

首次启动 AFFiNE 后，你会看到一个简洁的界面：

  1. 🏠 创建工作空间：点击"New Workspace"创建你的第一个工作空间，为其命名
  2. 👀 选择视图模式：在页面顶部，你可以找到切换"Paper"（文档）和"Edgeless"（白板）模式的按钮
  3. 📁 侧边栏功能：左侧边栏用于导航，可以创建文件夹、收藏页面

📝 文档编辑技巧（Paper 模式）

在 Paper 模式下，AFFiNE 提供了强大的块编辑器：

  • ⚡ 快速命令菜单：在任何空白行输入 / 即可唤起快速命令菜单，可以插入各种类型的内容块

  • ⌨️ Markdown 快捷键：AFFiNE 支持丰富的 Markdown 快捷方式，如：

    • 输入 # + 空格创建一级标题
    • 输入 - + 空格创建无序列表
    • 输入 [] + 空格创建待办事项
  • 🧩 内容块类型：AFFiNE 支持多种内容块，包括文本、标题、列表、图片、代码块、数据库等

🎨 白板创作技巧（Edgeless 模式）

Edgeless 模式为你提供了无限的创作空间：

  • 👋 自由拖拽：任何元素都可以自由拖拽、调整大小和旋转
  • 🔗 连接想法：使用连接线将不同的想法和概念连接起来，创建思维导图
  • 📑 模板使用：AFFiNE 内置多种模板，如脑图、任务计划、项目管理等，可以一键导入使用
  • ✏️ 绘图工具：支持笔写、橡皮擦等绘图工具，方便手写笔记和草图

🔧 高级功能使用

  1. 📥 导入导出：AFFiNE 支持导入 Markdown、HTML 等格式，也支持导出为 HTML 和 Markdown，方便内容迁移
  2. ☁️ 云端同步：如果需要跨设备同步或与他人协作，可以注册并登录 AFFiNE 账户，开启云同步功能
  3. 👥 团队协作：邀请成员加入工作空间进行实时编辑，可以查看他人的光标位置和编辑内容
  4. ⌨️ 快捷键使用：学习使用键盘快捷键可以极大提高效率，在设置中可查看完整的快捷键列表

💻 AFFiNE 的下载安装与部署

AFFiNE 提供了多种安装方式，以满足不同用户的需求和技术水平。

🖥️ 方式一：桌面应用（推荐大多数用户）

这是最简单、最推荐的方式，尤其适合非技术背景的普通用户。

  1. 🌐 访问官网下载：打开 AFFiNE 官方网站，进入下载页面
  2. 💾 选择系统版本：根据你的操作系统（Windows, macOS, Linux）下载对应的安装包

  3. 📥 安装应用：

    • Windows：双击 .exe 文件，按照安装向导提示完成安装
    • macOS：双击 .dmg 文件，将 AFFiNE 图标拖拽到"应用程序"文件夹中
    • Linux：根据下载的文件类型进行安装
  4. 🚀 启动使用：安装完成后，在应用程序列表或桌面上找到 AFFiNE 图标，双击启动即可

🐳 方式二：Docker 部署（适合有一定技术背景的用户）

如果你熟悉 Docker，这是一种快速部署 AFFiNE 的方式，特别适合在服务器上部署：

  1. 📥 拉取 AFFiNE 镜像：

    docker pull ghcr.io/toeverything/affine-self-hosted:pre-alpha

  2. ▶️ 运行容器：

    docker run -d -p 3000:3000 --name affine ghcr.io/toeverything/affine-self-hosted:pre-alpha
  3. 🌐 访问 AFFiNE：打开浏览器，访问 http://localhost:3000 即可使用

📝 注意：有些部署指南中使用的端口是 3010，根据你的具体配置调整。

🎛️ 方式三：使用 1Panel 部署（图形化界面）

对于喜欢图形化操作的用户，可以通过 1Panel 控制面板来部署 AFFiNE：

  1. 📥 安装 1Panel：按照官方文档安装 1Panel 控制面板
  2. 🚀 安装 AFFiNE：在 1Panel 的应用商店中搜索 AFFiNE，点击安装
  3. ⚙️ 配置参数：在安装过程中，可以设置管理员邮箱、密码和端口等参数
  4. 🔓 放行端口：在服务器防火墙中放行相应的端口（默认 3010）
  5. 🌐 访问使用：在浏览器中输入 http://你的IP:3010 即可访问

💻 方式四：从源代码构建（适合开发者）

如果你是开发者，希望深入了解代码或进行定制开发，可以选择从源码启动：

  1. 🔧 准备环境：确保已安装 Git、Node.js 和 pnpm

  2. 📥 克隆代码库：

    git clone https://github.com/toeverything/AFFiNE.git

  3. 📦 安装依赖：

    npm i -g pnpm
pnpm i

  4. 🚀 启动开发服务器：

    pnpm start
  5. 🌐 访问 AFFiNE：启动成功后，在浏览器中打开 http://localhost:8080 即可

🌍 进阶部署：配置公网访问

如果你希望将本地部署的 AFFiNE 分享给团队成员，可以通过内网穿透工具实现公网访问：

  1. 📥 安装 cpolar：按照官方指南安装 cpolar 内网穿透工具
  2. 🔗 创建隧道：在 cpolar 中创建一个指向本地 AFFiNE 端口的隧道
  3. 🌐 配置固定域名：如有需要，可以配置固定的二级子域名，方便长期访问
  4. 👥 分享访问：将生成的公网地址分享给团队成员即可

💫 结语

AFFiNE 作为一款融合了文档编辑、白板绘制和数据库功能的开源知识库工具，为追求数据隐私和工作流一体化的用户提供了极具吸引力的选择。它的本地优先架构、开源透明性和双模态编辑体验，使其在众多知识管理工具中脱颖而出。

无论你是个人用户寻找 Notion 和 Miro 的替代品，还是团队需要安全可靠的协作平台，AFFiNE 都值得一试。随着项目的持续发展和社区的不断贡献，AFFiNE 有望成为知识管理领域的重要参与者。

尝试 AFFiNE，重新思考知识管理的未来，体验规划、分类和创作的无缝融合。