Mindket

AFFiNE 文档白板工作区

新上架第 2 版 · 更新于
星标74.3k

概览

一款开源、本地优先的工作区,文档、白板和数据库都由同一套块搭成,所以同一份文档既能当页面读,也能展开成无边画布。安装说明涵盖各个应用、用 Docker Compose 自托管、AI 密钥、备份,以及通过 MCP 接入 Claude Code、Cursor 和 Cline。

AFFiNE 文档白板工作区 是一款 GitHub 上的开源项目,属于效率类,由 Mindket 上架。可免费获取。当前为第 2 版,最近更新于 。按它的 README 从 GitHub 安装。Mindket 的设置说明可在你的 Mindket 账户获取,以 zip 压缩包下载。

速览

用在
  • 工作区的 MCP 端点,让 Claude Code、Cursor、Cline,以及其他支持 Bearer 请求头或能启动本地 mcp-remote 桥接的 MCP 客户端搜索和读取一个工作区。只支持 OAuth 登录的客户端用不了
  • 应用里的 AI:用 AFFiNE AI,或者在自托管服务器上用你自己的 OpenAI、Anthropic、Gemini 或 FAL 密钥
  • 指向你自己服务器的桌面应用,从工作区列表面板里添加
  • 把文档导出成 Markdown 或 HTML,搬到另一台机器上
先运行
mkdir affine
cd affine
mkdir -p config

平台

Windows操作系统
macOS操作系统
Linux操作系统
iOS操作系统
Android操作系统
Claude Code编程智能体

用在哪里里还有 4 个

关于

它是什么

AFFiNE 是一款开源工作区,把文档、白板和数据库放进同一个应用。它们都由同一套块搭成:一行文字是一个块,画布上的一个形状也是一个块。每份文档都有两种模式。Page 模式是适配屏幕的线性页面,Edgeless 模式是一张无边画布,用来画思维导图、做幻灯片和画示意图。应用是本地优先的,本地工作区就放在你自己的磁盘上,离线也能用。AFFiNE Cloud 或你自己的服务器再加上跨设备同步和实时协作。

  1. 你在网页、桌面应用或自己的服务器上打开 AFFiNE
  2. 你在文档里输入 /,从斜杠菜单里挑选块
  3. 你把同一份文档切到 Edgeless 模式,在周围作画
  4. 选中的块变成带表格或看板视图的数据库
  5. Cloud 或自托管同步让别人和你实时一起编辑

适合谁

在一个应用里记笔记、又在另一个白板应用里画草图,更想把两者放进同一份文档的人。想把文档放在自己服务器上、也能自己搞定 Docker、备份和升级的小团队。文档也写明了谁该另找工具。AFFiNE 不是排版系统,如果你喜欢 Word、Google Docs 或 Pages 那种标尺和排版按钮,它不适合你。

谁在用,怎么用
用途谁在用怎么用例子
计划在笔记里跟踪任务的人把待办清单变成数据库,用看板来看有人选中一组待办,用 convert into database 转换,再把结果切到 Kanban 视图。
头脑风暴和幻灯片习惯在画布上思考的人用 Edgeless 模式打开文档,画思维导图、做演示和视觉化的工作一位用户在画布上把文字块、图片和形状排成一张幻灯片,再用一个 frame 把它们框在一起。
知识库要整理很多文档的人Collections 就像智能文件夹,按标签和 Doc info 挑选文档一位用户在 All docs 里加上过滤条件,点 Save as New Collection,符合规则的文档就会自动归进去。
重复使用的页面经常从同一种页面开始的人把一份文档标成 Template,设为 Journal 或每份新文档的模板一位用户在文档的 Property 里勾选 Template,再到 Settings、Preference、My Template 里选中它。
AI 助手想让 AI 从自己笔记里找答案的开发者把 Claude Code、Cursor 或 Cline 接到工作区的 MCP 端点一位开发者建了一个名为 Claude Code 的只读凭据,用一条 claude mcp add 命令把它加上。
自建服务器的团队会运行 Docker 的管理员运行 Docker Compose 这套服务,再把桌面应用连上去一位管理员下载 Compose 文件,设好 server.externalUrl,在 /admin 创建第一个管理员。

用在哪里

在浏览器里打开 https://app.affine.pro ,或者用 Windows、macOS 和 Linux 的桌面应用,以及 iOS 和 Android 应用。手机应用主要用来随手记录和回看笔记,通过 AFFiNE Cloud 同步。桌面应用功能最全,带完整的 Edgeless 白板。除了应用本身,制作者的页面还列出了这些连接方式。

  • 工作区的 MCP 端点,让 Claude Code、Cursor、Cline,以及其他支持 Bearer 请求头或能启动本地 mcp-remote 桥接的 MCP 客户端搜索和读取一个工作区。只支持 OAuth 登录的客户端用不了
  • 应用里的 AI:用 AFFiNE AI,或者在自托管服务器上用你自己的 OpenAI、Anthropic、Gemini 或 FAL 密钥
  • 指向你自己服务器的桌面应用,从工作区列表面板里添加
  • 把文档导出成 Markdown 或 HTML,搬到另一台机器上
运行方式
路线你运行什么页面怎么说
网页浏览器里的 https://app.affine.pro文档首页说可以直接在那里试用 AFFiNE
桌面从 affine.pro/download 或 GitHub Releases 下载的安装包完全离线可用,不需要账号。支持 Windows 10 或更高版本(x64 和 ARM64)、macOS 11 或更高版本,Linux 有 AppImage、.deb 和 Flatpak
手机iOS 和 Android 应用用来随时记录和回看笔记,通过 AFFiNE Cloud 同步
自托管Docker Compose:AFFiNE、一个迁移任务、PostgreSQL 和 Redis推荐的自托管方式。至少准备 4 核 CPU 和 2 GB 内存
源码用 Node.js 22.12 或更高的 22.x 版本、Yarn 4 和 Rust 构建的克隆给贡献者用。BUILDING.md 讲网页应用的构建,桌面应用和服务器另有单独的指南

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹,里面按制作者的 README 和文档,给每种运行方式各写了一页。网页应用只要浏览器,桌面应用只要下载就能用。下面的步骤是运行你自己的服务器,也就是 Docker Compose 页面推荐的方式。

  1. 先装好 Docker。需要 Compose v2,docker compose version 能正常输出。
  2. 建一个部署文件夹。按下面的命令建好 affine,里面再建一个 config 文件夹。
  3. 下载两个文件。Compose 文件和示例配置都来自最新的发布版本。
  4. 设置外部地址。config/config.json 里的 server.externalUrl 是用户要打开的地址。
  5. 启动整套服务。运行 docker compose up -d,再用 docker compose ps 检查。
  6. 创建第一个管理员。打开 http://localhost:3010,按提示操作。
mkdir affine
cd affine
mkdir -p config
curl -L -o docker-compose.yml \
  https://github.com/toeverything/AFFiNE/releases/latest/download/docker-compose.yml
curl -L -o config/config.json \
  https://github.com/toeverything/AFFiNE/releases/latest/download/config.json.example
docker compose up -d
docker compose ps

一次性的迁移容器应该顺利跑完,而 AFFiNE、PostgreSQL 和 Redis 保持运行。如果有服务启动失败,页面给的是这条命令。

docker compose logs --tail=200 affine affine_migration

如何使用

在空行输入 / 打开斜杠菜单,挑一个块。基础块也支持 Markdown 快捷方式,Blocks 页面列出了这些。

#    放在行首,这一行变成标题
>    放在行首,这一行变成引用
---  后面加一个空格,变成分隔线

任何块都能拖着它的把手移动。选中几个块,用 convert into database,它们就变成一个带表格或看板视图的数据库。Blocks 页面说,这很适合把待办清单变成看板。在 Edgeless 模式里,文字块、图片和形状可以排成一张幻灯片,frame 和 group 把它们归成一组。Collections 就像智能文件夹。在 All docs 里加上过滤条件,点 Save as New Collection,所有符合规则的文档都会归进去。想重复使用某种版式,就在文档的 Property 里勾选 Template,再把它设为 Journal 或每份新文档的模板。

本地工作区只留在你的设备上。要共享它,先登录,再在工作区设置里开启 AFFiNE Cloud,然后从成员区域通过邮件邀请别人。对方接受邮件里的邀请后就加入了。

示例

你把项目笔记放在一个 AFFiNE Cloud 工作区里,想让 Claude Code 从里面找答案。你在 AFFiNE 里依次打开 Settings、Integrations、MCP Server,建一个名为 Claude Code 的凭据。访问模式保持 Read only,复制端点和令牌,因为令牌只显示一次。然后运行 AFFiNE MCP 页面上的这条命令。

claude mcp add --transport http affine \
  "https://app.affine.pro/api/workspaces/<workspace-id>/mcp" \
  --header "Authorization: Bearer <your-credential>"

按 MCP 页面的说法,Claude Code 这时就有了 AFFiNE 的两个工具。doc_search 在整个工作区里做关键词和语义搜索,白板上的文字也算在内,返回带页面或画布定位的短段落。read_document 按 ID 取回整份文档。两者都只在这一个工作区和你的权限范围内,撤销这个凭据也只会断开这一个客户端。

新手与专家

新手:本地优先的意思是,你的工作区存在你自己的机器上,没有网络也能编辑。下载页面说,桌面应用只有在你选择登录 AFFiNE Cloud 时才会同步。块就是文档里任何可以移动的部分,可以是一段文字、一条待办、一个形状或一个数据库。先从桌面应用和一个本地工作区开始。不需要账号。自托管适合本来就在运行服务器的人。自托管文档说,如果你不想自己照看 Postgres、Redis、备份和升级,托管的工作区通常更省事。

专家:编辑器是 BlockSuite,Toeverything 的开源协作编辑器。README 说 y-octo 是让 AFFiNE 客户端和服务器实现本地优先功能的核心引擎,它是一个原生、线程安全的 Yjs CRDT 实现。README 还提到 OctoBase,一个用 Rust 写的数据引擎。桌面应用是包着预构建网页应用的 Electron 应用,原生模块用 Rust 写,通过 napi-rs 构建。

自托管服务器从 ./config 读取 config/config.json。server.externalUrl 必须是用户最终打开的地址,copilot.byok.enabled 让工作区所有者添加自己的服务商密钥。在 Admin Panel 的 /admin/settings 里保存的设置会立即生效。服务商密钥属于工作区,绝不放进服务器配置。AI 页面给的这段配置用来允许兼容 OpenAI 的端点。

{
  "copilot": {
    "enabled": true,
    "byok": {
      "enabled": true,
      "allowCustomEndpoint": true,
      "allowPrivateEndpoint": false
    }
  }
}

除非每位工作区管理员都可信,可以把服务商请求发进内网,否则保持 allowPrivateEndpoint 关闭。转写和工作区索引需要一个存在服务器上的 Gemini 密钥,或者在可用时由 AFFiNE AI 套餐兜底,索引还需要开启 indexer。官方的 Compose 文件已经自带带 pgvector 的 PostgreSQL。MCP 端点是 POST /api/workspaces/{workspace-id}/mcp,走无状态的 Streamable HTTP。凭据轮换后,旧令牌最多还能用 24 小时,如果原本的到期时间更早,就到那时为止。

注意事项

以下几点来自 README、LICENSE 和制作者的页面。

  • 许可证:GitHub 标为 Other。LICENSE 文件把 packages/backend 和 packages/common/native 之外的代码放在 MIT 许可之下。README 说社区版(Community Edition)可以按 MIT 许可免费自托管。但 packages/backend/server 里的许可证文件说,这两个文件夹中随社区版发布的部分采用 MPL 2.0。其余部分适用 AFFiNE Enterprise Edition 许可证,自托管页面说它是源码可见(source-available)的,只有持有订阅(席位数相符)才能用于生产环境
  • 席位:文档说自托管实例上的每个工作区免费提供最多 10 个席位。要更多席位,需要付费的 Team Plan(按年付每席位每月 10 美元,按月付 12 美元),或者在连不上 AFFiNE 许可服务的网络里,向销售购买 Installable License
  • 对外发送的数据:自托管页面说,在断网环境里,来自 cdn.affine.pro 的字体、默认的客户端遥测和来自 ghcr.io 的镜像都要另作安排。Team Plan 会向 app.affine.pro 校验许可证
  • 升级:先读发布说明、做好备份,再对比新旧 Compose 文件。Upgrade 页面说不要把 latest 当作盲目的生产升级路径。0.27.4 版移动了数据文件夹,所以旧的 Compose 文件要小心处理
  • 备份:完整备份包括 Postgres 转储、存放上传文件的 ./data/storage 和配置文件。只恢复数据库不会带回上传的文件。文档要求测试一次恢复
  • 身份:自托管页面列出用 OIDC 做单点登录,MFA 在你的身份提供方那里强制执行。页面说如果你需要 SAML 或 SCIM 配置、内置审计日志或官方的 Kubernetes 部署,目前不要选 AFFiNE
  • MCP 写入:默认只读。MCP 页面说,它在 2026 年 10 月 26 日审阅的实现把写入工具限制在开发版或 canary 部署上
  • 版本通道:Stable 用于日常工作,Beta 预览新功能、测试较少,Canary 一构建出来就发布
  • 贡献:每位提交者都签了贡献者许可协议(CLA)之后,拉取请求才能合并

README 和文件

README

AFFiNE:安装说明

这个工具包里只有安装说明,由 Mindket 编写。AFFiNE 本身来自制作者的网页应用、桌面和手机应用、Docker 镜像和源代码:https://github.com/toeverything/AFFiNE

这些说明不是 AFFiNE 团队(Toeverything)写的,也没有得到他们的认可。README 称 AFFiNE 是“a privacy-focused, local-first, open-source, and ready-to-use alternative for Notion & Miro”,意思是:一款注重隐私、本地优先、开源、开箱即用的 Notion 和 Miro 替代品。README 还说文档、画布和表格在它里面融为一体。文档在 https://docs.affine.pro/

许可证:GitHub 把它标为“Other”。LICENSE 文件(https://github.com/toeverything/AFFiNE/blob/canary/LICENSE)说,两个文件夹之外的内容适用 LICENSE-MIT 里的 MIT 许可证。packages/backend 和 packages/common/native 下的内容适用 packages/backend/server/LICENSE:其中随社区版(CE)发布的部分采用 MPL 2.0,其余部分是 AFFiNE Enterprise Edition(EE)许可证,只有持有 EE 订阅(席位数相符)才能用于生产环境。第三方组件沿用各自的许可证。README 说社区版(CE)“is free for self-host under the MIT license”,即按 MIT 许可证免费自托管。自托管页面(https://affine.pro/self-host)说,服务器后端按 AFFiNE EE 许可证源码可见,编辑器和大部分客户端代码则是 MIT 许可。

会安装什么

  • 如果你在浏览器里用 https://app.affine.pro 上的网页应用,什么都不用装。来源见 https://docs.affine.pro/
  • 从 https://affine.pro/download 下载的 Windows、macOS 或 Linux 桌面应用,或者 iOS、Android 手机应用。见 setup/desktop-and-web.md。
  • 自托管时是一套 Docker Compose 服务:AFFiNE 服务器、一个一次性迁移任务、PostgreSQL 和 Redis,数据放在 ./data 下,配置放在 ./config 下。见 setup/docker-compose.md。
  • 你的编程智能体里不会装任何东西,除非你加上可选的 MCP 连接:setup/claude-code.md、setup/cursor.md 和 setup/other-mcp-clients.md。

事先需要准备

主要安装命令

最快的开始方式什么都不用装:打开 https://app.affine.pro ,或者下载桌面应用。要运行你自己的服务器,Docker Compose 页面给出了下面这些步骤。在部署文件夹要长期存放的位置执行(页面说这个文件夹要放在固定的位置):

mkdir affine
cd affine
mkdir -p config
curl -L -o docker-compose.yml \
  https://github.com/toeverything/AFFiNE/releases/latest/download/docker-compose.yml
curl -L -o config/config.json \
  https://github.com/toeverything/AFFiNE/releases/latest/download/config.json.example
docker compose up -d
docker compose ps

然后打开 http://localhost:3010 ,创建第一个管理员账号。来源见 https://docs.affine.pro/self-host-affine/install/docker-compose-recommended

各平台说明

  • setup/desktop-and-web.md:网页应用、桌面和手机应用,以及本地或云端工作区
  • setup/docker-compose.md:用 Docker Compose 运行你自己的服务器
  • setup/configuration-and-ai.md:config/config.json、Admin Panel,以及用你自己的服务商密钥开启 AI
  • setup/backup-and-upgrade.md:自托管服务器的备份、恢复和升级
  • setup/claude-code.md:在 Claude Code 里接入工作区的 MCP 端点
  • setup/cursor.md:在 Cursor 里接入同一个端点
  • setup/other-mcp-clients.md:Cline,以及 Claude Desktop 这样的本地 stdio 客户端
  • setup/build-from-source.md:从仓库构建网页应用、桌面应用和服务器

更新或移除

下载页面说,桌面应用通过内置的更新程序更新,最新的安装包也一直放在那个页面上。来源见 https://affine.pro/download

自托管服务器请按 setup/backup-and-upgrade.md 操作。Upgrade 页面说,不要把 latest 当作盲目的生产升级路径。来源见 https://docs.affine.pro/self-host-affine/install/upgrade

这些说明参考的页面没有给出卸载步骤。手动卸载的办法如下,这是 Mindket 的说明,不是制作者的:桌面应用按你的系统卸载普通应用的方式移除。服务器那边,在部署文件夹里运行 docker compose down 会停掉整套服务,你的数据和设置会一直留在 ./data 和 ./config 里,直到你删掉它们。Upgrade 页面说,在升级后的部署确认无误之前,不要运行 docker compose down --volumes。

使用数据和对外连接

来源

  • README:https://github.com/toeverything/AFFiNE/blob/canary/README.md
  • LICENSE:https://github.com/toeverything/AFFiNE/blob/canary/LICENSE
  • 文档首页:https://docs.affine.pro/
  • 下载页面:https://affine.pro/download
  • 自托管页面:https://affine.pro/self-host
  • MCP Server 页面:https://affine.pro/mcp
  • Self-host AFFiNE:https://docs.affine.pro/self-host-affine
  • Requirements:https://docs.affine.pro/self-host-affine/install/requirements
  • Docker Compose:https://docs.affine.pro/self-host-affine/install/docker-compose-recommended
  • After Installation:https://docs.affine.pro/self-host-affine/install/after-installation
  • Configuration:https://docs.affine.pro/self-host-affine/install/configuration
  • Upgrade:https://docs.affine.pro/self-host-affine/install/upgrade
  • Basic User Quota:https://docs.affine.pro/self-host-affine/features/basic-user-quota
  • Team License:https://docs.affine.pro/self-host-affine/features/team-license
  • Backup and Restore:https://docs.affine.pro/self-host-affine/administer/backup-and-restore
  • AI:https://docs.affine.pro/self-host-affine/administer/ai
  • Workspaces:https://docs.affine.pro/core-concepts/elements-of-affine/workspaces
  • BUILDING.md:https://github.com/toeverything/AFFiNE/blob/canary/docs/BUILDING.md
文件
README.md  7 KB
setup/backup-and-upgrade.md  5 KB
setup/build-from-source.md  3 KB
setup/claude-code.md  3 KB
setup/configuration-and-ai.md  3 KB
setup/cursor.md  1 KB
setup/desktop-and-web.md  3 KB
setup/docker-compose.md  4 KB
setup/other-mcp-clients.md  2 KB

9 个文件,共 31 KB,以 zip 压缩包下载。

更新内容

  • 第 2 版 · 2026-11-09

    Updated by Mindket to the current version of this kit.

  • 第 1 版 · 2026-11-03

评价

还没有评分

写评价

还没有评价。

大家怎么说

Hacker News、Bluesky、X、Reddit、Facebook 和 YouTube 上提到这个项目的帖子和评论,来自每周一次的搜索和 Trendshift。它们不是 Mindket 写的,也未经核实,点开即可在原帖处阅读。

entherheTo replace Notion&Miro, we build a next-gen open-source knowledge baseCheck out at:https://github.com/toeverything/AFFiNE#stay-up-to-date We built an open-source, privacy first Notion/Miro alternative! We call it Affine, and we built it with Typescript/React/Rust. We know that there have been so called notion or airtable "open source alternative"s, but we want to…5 分 · 2 条回复Marek 'seqre' GrzelakI haven't used them myself, but heard of those projects which sound like could work: github.com/toeverything... github.com/AppFlowy-IO/...4 赞@awe0_io$81r/opensourcevietnamTỰ DO SÁNG TẠO KHÔNG GIỚI HẠN VỚI AFFINE: SỰ KẾT HỢP HOÀN HẢO GIỮA MIRO WHITEBOARD VÀ NOTION DOCS TỰ HOSTsimonpureToeverything/AFFiNE: privacy first knowledge base4 分DavidAFFiNE 0.27.4 brings GPT 5.6 and Gemini 3.7 support, better memory usage during GC, and improved BYOK model editing. Heads up: major breaking changes to server config and version compatibility. #selfhosted #homelab https://github.com/toeverything/AFFiNE/releases/tag/v0.27.42 赞@RepoLogsTired of paying for Notion AND Miro? AFFiNE is the open-source knowledge base combining docs, whiteboards, and planning into a single lightning-fast workspace. Built for privacy-first teams who want total control over their data stack... https://t.co/pK2MWv2ap7square_usualI built a faster Notion in RustThere's a ton of these right now. I did some research the other day and found at least five "open source" (to various degrees, all of these are not strictly speaking open source but open core) notion alternatives, and they're all in some ways better, in some ways worse than notion. I settled on…DavidAFFiNE 0.27.4 brings GPT 5.6 and Gemini 3.7 support, better memory usage during GC, and OneNote import improvements. Heads up: config now uses config.json over env vars. #selfhosted #homelab https://github.com/toeverything/AFFiNE/releases/tag/v0.27.42 赞@the_osps• Docs and whiteboard fully merged on an edgeless canvas • Multimodal AI partner for reports, slides, mindmaps, and prototypes • Local-first with real-time sync and self-hosting supportxet7Show HN: Kan.bn – An open-source alterative to TrelloFor replacing Notion Kanban, maybe AFFiNE, that is mostly MIT license: https://github.com/toeverything/AFFiNE But some part of server code license may need checking: https://github.com/toeverything/AFFiNE/blob/canary/packages/...GitHub Trending JS/TS🎉 Celebrating! 🎉 (500+ new stars) 📦 toeverything / AFFiNE ⭐ 64,112 (+536) 🗒 TypeScript There can be more than Notion and Miro. AFFiNE(pronounced [ə‘fain]) is a next-gen knowledge base that brings planning, sorting and creating all together. Privacy first, open-source, customizable an...2 条回复

搜索日期

Mindket 的更多商品

查看 Mindket 的全部商品

DeepSeek-R1-GGUF

unsloth · 工具包

671B 参数 DeepSeek-R1 推理模型的 GGUF 版本,带 1.58-bit 和 2-bit 动态量化,可在内存足够的本机上用 llama.cpp 运行。

新上架

Axion-1.0-35B-GGUF

prithivMLmods · 工具包

提供 Axion-1.0-35B 的 GGUF 文件,这是一个有约 30 亿激活参数的 35B 混合专家模型,面向科学推理、信息查找和工具使用。适合配合 llama.cpp 在本地使用。

新上架

HEART

Phips · 工具包

用一个超分辨率网络放大低分辨率图像,可以在一块消费级 GPU 上训练,并导出为 ONNX。适合训练或运行图像放大模型的人。

新上架

vscode

microsoft · 工具包

这里是 Visual Studio Code 背后的开源代码,这是一款带调试、扩展和工具集成的编辑器,可用于 Windows、macOS 和 Linux。适合想阅读或跟进它如何构建的开发者。

新上架195k

Bun 一体化 JS 工具包

oven-sh · 工具包

面向 JavaScript 和 TypeScript 应用的一体化工具包。一个可执行文件里装着兼容 Node.js 的运行时、包管理器、测试运行器和打包器。说明涵盖各个平台、Docker、GitHub Actions、Claude Code 和 Cursor。

新上架96.7k

Memos 自托管笔记应用

usememos · 工具包

一款免费、MIT 许可的笔记应用,由你自己托管,零碎的想法和较长的 Markdown 笔记会汇集成一条个人时间线。安装说明涵盖 Docker、Compose、二进制文件、Kubernetes、HTTPS、备份、升级、Web Clipper、API、webhook,以及通过 MCP 接入 Claude Code。

新上架64.4k