AppFlowy 安装与上手指南：30 分钟跑通你的 AI 知识库-编程实验室

AppFlowy 安装与上手指南：30 分钟跑通你的 AI 知识库

【免费下载链接】AppFlowyBring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.项目地址: https://gitcode.com/GitHub_Trending/ap/AppFlowy

AppFlowy 是一个开源的 AI 协同工作空间，常被称为"开源版 Notion"：文档、数据库、看板、AI 助手一应俱全，数据默认存在你自己的设备上。这篇指南按两条路线走——普通用户直接装预编译版，几分钟就能开工；开发者则从源码把项目编译跑起来，最后统一讲首配、AI 接入和多设备同步。

⚡ 最快路线：用预编译版把 AppFlowy 跑起来

只想用、不想改代码的话，完全可以跳过环境搭建。

桌面端：到官方发布页下载对应平台的安装包（macOS、Windows、Linux 都有），Linux 用户也可以用 Flatpak 或 Snap 渠道装；
移动端：在 App Store 或 Google Play 搜 AppFlowy，Android 要求 10 及以上系统。

安装方式和其他软件没有区别。首次启动会进入欢迎页，跟着提示选语言、建第一个 workspace 即可。

小贴士：语言、深浅色主题之后都能在设置里改，不用现在纠结。

🛠️ 从源码跑：开发者路线

走源码这条路的收益是能改代码、能跑最新提交，还能顺便看懂一个"Flutter 前端 + Rust 内核"的项目是怎么组织的——README 里说得很清楚：界面层是 Flutter，数据库、同步、存储这些核心能力由 Rust 实现，两侧通过 FFI 通信。

先备好两套工具链

你需要 Flutter 和 Rust 两个工具链。项目对 Flutter 锁定了 3.27.4 版本，各系统的检查脚本都放在 frontend/scripts/install_dev_env/ 目录下，对着自己系统跑一遍最省事。核心步骤等价于：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh flutter config --enable-linux-desktop

Linux 用户额外要装 keybinder-3、libnotify、libmpv 这几个系统库，否则 Flutter 桌面端编译会直接报错；安装脚本里写好了 apt/dnf 两种包管理器的命令，复制执行即可。

避坑：Rust 首次拉依赖编译可能长达几十分钟，这是正常现象，别中途关终端。

三步完成编译与启动

git clone https://gitcode.com/GitHub_Trending/ap/AppFlowy cd AppFlowy/frontend cargo make appflowy-flutter-dev

这个 cargo-make 任务会编译 Rust 内核库 dart-ffi，并把产物拷贝进 Flutter 工程。随后切到frontend/appflowy_flutter目录执行：

flutter run

看到欢迎页就说明跑通了，此后在代码里改动可以靠热重载即时生效。

🧩 第一次打开后，把 workspace 配置顺手做掉

首配只需要三件事：定语言、挑主题、决定数据放哪。语言在欢迎页或设置里选；主题支持深色/浅色切换；存储方面不用额外配置，本地数据默认由 Rust 侧的 SQLite 管理，开箱即用。

AI 助手怎么接上

AI 功能不用另外装包，设置里的 AI 一栏直接配置即可：选择模型提供方、填入对应的 API Key，保存后就能在文档和数据库里直接唤起 AI。项目也在frontend/rust-lib/flowy-ai里内置了本地模型支持，不想把 Key 交给云端时可以选这条路。

小贴士：API Key 只填给信任的官方渠道，别贴到公开截图或 issue 里。

☁️ 多台设备用：开启云同步

默认情况下 AppFlowy 是本地优先的，数据只留在当前设备。当你希望在手机和电脑之间无缝切换时，登录 AppFlowy 云端账号即可：同一个 workspace 在多端打开，改动会自动同步，还能把共享区（shared section）开放给团队成员。

移动端体验以竖屏长列表为主，同步状态和离线改动都会收敛到云账户里统一处理。

🧯 卡住了，按这个顺序排查

flutter doctor报错：按提示补齐缺失工具，最常见的是 Flutter 版本不是 3.27.4；
编译报找不到 keybinder/libnotify：回到 frontend/scripts/install_dev_env/ 对应系统的脚本，把系统库装上；
改了代码没生效：Rust 侧的改动不走热重载，需要重跑cargo make appflowy-flutter-dev；
跑测试或调试崩溃：日志等级可以在frontend/Makefile.toml的RUST_LOG环境变量里调。

🧭 接下来可以做什么

装好只是开始：建议先把手头的一个真实项目搬进来，体验文档加数据库的组合，顺便验证一下多端同步是否稳定。如果想改功能或修 bug，先读一遍 doc/CONTRIBUTING.md 里的协作约定，再动手提交 PR，会顺利很多。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

AppFlowy 安装与上手指南：30 分钟跑通你的 AI 知识库