30分钟跑通AppFlowy：从零搭建AI协作工作空间的实操笔记

30分钟跑通AppFlowy从零搭建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/AppFlowyAppFlowy 是个开源的 AI 协作工作空间也是直接的 Notion 替代品文档、数据库、项目看板放在一处还内置了 AI。如果你想要数据完全留在自己机器上、或者想折腾一个可定制的 AI 工作空间它就适合你。这次我从源码把它本地跑起来全程记下来。AppFlowy 到底强在哪数据主权本地优先架构文档存在你自己的磁盘上支持自托管不依赖别人的服务器全平台一份代码Flutter 写 UI、Rust 写核心桌面Windows/macOS/Linux和移动端iOS/Android都能跑开源可扩展AGPL-3.0 协议仓库有几千个 star 的社区基础看懂代码就能改 动手前的自检项目要求必选/可选操作系统macOS 11 / Windows 10 / Ubuntu 20.04✅ 必选macOS 和 Linux 最稳内存8GB 起步✅ 必选Rust 编译吃内存磁盘空间至少 10GB 空闲✅ 必选首次构建下载量大Git任意近期版本✅ 必选Flutter3.27.4✅ 必选安装脚本会自动切到这个版本Rust 工具链1.70✅ 必选脚本可代装Linux 系统库keybinder-3.0、libnotify、libmpv仅 Linux 需要脚本代装核心部署流程第一步克隆仓库拿到源码进入项目根目录git clone https://gitcode.com/GitHub_Trending/ap/AppFlowy cd AppFlowy看到frontend/、doc/这些目录就说明克隆成功了。第二步跑官方安装脚本官方为每个平台都备了一键脚本系统依赖不用你手动装按自己的系统选一个执行平台执行命令macOS./frontend/scripts/install_dev_env/install_macos.shUbuntu / Debian./frontend/scripts/install_dev_env/install_linux.shWindows./frontend/scripts/install_dev_env/install_windows.sh在 bash 终端里跑脚本会问你要不要装 Rust没有就回y。跑完后 Flutter 会被自动切到项目要求的 3.27.4。结束时没报红色错误、并看到 Setting up Flutter 走完就算通过。第三步装依赖前端依赖单独装一下cd frontend/appflowy_flutter flutter pub get再回frontend/目录确认 cargo-make 可用安装脚本通常已经装好了cd ../.. cargo make --version看到Got dependencies!和版本号输出就 OK 了。第四步编译并启动最花时间的一步首次要编译 Rust 的 dart-ffi 动态库普通机器大概 10~30 分钟。cd frontend cargo make run-desktop编译走完会直接拉起 AppFlowy 窗口全程结束。验证 AppFlowy 跑通了新开一个终端验证工具链状态flutter doctor rustc --version你应该看到类似这样的输出Flutter 3.27.4 • channel stable rustc 1.78.0同时桌面上应该已经多了一个窗口在窗口里随便新建一篇文档敲两行字、再切到看板视图试试都能正常响应就说明完全跑通了。 用起来了之后的 3 个调优先看清楚整体架构再动手改前端和后端模块的对应关系长这样接自己的云端服务→ 不想走官方云的话把自托管地址填进frontend/appflowy_flutter/dev.env里的APPFLOWY_CLOUD_URL留空就是纯本地模式→ 数据完全不离开自己的服务器把日志开到最大→ 排查同步、存储问题时信息太少 → 改frontend/Makefile.toml的[env]块里RUST_LOG info为debug换 release 模式提速→ dev 模式运行偏慢 → 同一文件里把CARGO_PROFILE dev改成release注意首次编译会更久 踩坑速查症状flutter 编译报版本不匹配→ 项目锁定 Flutter 3.27.4 → 重跑对应平台的安装脚本它会自动 checkout 正确版本症状Linux 下编译失败提示找不到 keybinder-3.0→ 系统库没装全 → 执行sudo apt-get install keybinder-3.0-dev libnotify-dev libmpv-dev症状第一次 build 超过半小时不动了→ Rust 在后台编译几十个 crate属正常现象 → 别打断放着等症状手动 cargo build 报链接错误→ cargo make 会按平台自动改写 dart-ffi 的 crate 类型staticlib/cdylib手动编译拿不到这一步 → 始终用cargo make run-desktop别手动编译症状Windows 上 CMake 报错→ 缺 C 构建工具 → 在 Visual Studio Installer 里装使用 C 的桌面开发工作负载你现在应该处于这个状态工具链就位应用在本机跑着所有数据都在自己手里。下一步建议去设置里配一个 AI 服务找篇长文档让它总结一遍体验完整的 AI 工作流遇到卡壳的问题可以翻翻 doc/CONTRIBUTING.md或者去官方社区问响应通常很快。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考