AppFlowy 完整安装指南:3 条路线搭好开源 Notion 替代品与本地 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 知识库跑起来。
安装前确认:系统要求与依赖清单
动手前先对照下表自查,全部达标即可继续,无需逐项展开:
| 项目 | 要求 | 判断标准 |
|---|---|---|
| 操作系统 | macOS 10.15+ / Windows 10+ / Ubuntu 18.04+ | 满足最低版本 |
| 内存 | 8GB 以上 | 建议值下限 |
| 存储空间 | 5GB 以上可用 | 要容纳依赖与编译产物 |
| 开发工具 | Flutter SDK、Rust 工具链 | 两条验证命令均无报错 |
| 网络 | 稳定互联网 | 用于下载依赖 |
用下面两条命令验证环境:
flutter doctor rustc --version任一命令报错,就先补齐 Flutter 或 Rust 安装再继续后面的步骤。
安装路线选择:预编译还是源码
先判断自己的角色,再决定走哪条路,避免做无用功:
| 路线 | 适合人群 | 代价 |
|---|---|---|
| 预编译包 | 普通用户 | 几分钟下载安装即可 |
| 源码编译 | 开发者、想改功能的人 | 预留 30 分钟以上和完整工具链 |
预编译路线:下载安装包
- 桌面端:到项目发布页下载对应平台的安装包,按向导安装即可。
- 移动端:在应用商店搜索 AppFlowy 安装,iPhone 走 App Store,Android 需要 10 及以上版本。
- 装好后直接启动应用,进入下一节的初始配置,不需要碰终端。
AppFlowy 从源码编译步骤
想改代码或定制功能就走源码路线。Flutter 和 Rust 装好后,先拿代码:
git clone https://gitcode.com/GitHub_Trending/ap/AppFlowy cd AppFlowy/frontend/appflowy_flutter flutter pub getflutter pub get拉取全部 Dart 依赖,命令正常结束、无红色报错即依赖就绪。
再编译 Rust 原生库:
cd frontend/rust-lib cargo build首次编译耗时最长,等待结束即可。完成后启动应用:
flutter run窗口弹出 AppFlowy 登录界面,说明编译路线走通了。
装完后的第一步:最小可用配置
应用启动后先做三件事:选语言、定深色或浅色主题、确认本地数据存储路径——默认数据都保存在本机。然后建一个工作区:
在侧栏点"+",输入名称,权限按公开或私密二选一。个人知识库选私密即可。
接下来接入 AI。AppFlowy 自带 AI 助手,无需额外安装:在设置里填入模型 API Key 或选择本地模型,之后从侧栏的 "Ask AI" 入口就能发起对话:
如果手机也要用,装移动端并用同一账号登录,文档编辑栏已做触控适配:
常见坑排查
安装和首跑阶段最容易卡住的四类问题,按"现象 → 原因 → 解法"处理:
| 现象 | 原因 | 解法 |
|---|---|---|
flutter run报原生库加载错误 | Rust 库没编译或没编译成功 | 先在frontend/rust-lib跑完cargo build再运行 |
flutter pub get中途失败 | 网络不稳定 | 重跑该命令;持续失败先检查网络 |
| 写项目目录时报权限拒绝 | 当前用户对目录无读写权限 | 换有权限的目录克隆,或给目录补写权限 |
flutter doctor列出缺失组件 | 平台工具链不全 | 按提示补装对应组件后重新验证 |
进阶选项:跨平台构建与调优
要发布到其他平台,每个平台一条命令就够:
flutter build linux --release flutter build windows --release flutter build apk --releaseiOS 需要 macOS 环境和签名证书,细节以官方文档为准。性能调优记住两个高频点即可:内存缓存大小和 SQLite 参数,另外同步频率策略可在设置里调整;其余内容不必展开,参考文档与版本说明就好。
保持版本更新用这三条:
git pull origin main flutter pub get cargo update接下来做 3 件事
- 把一份真实文档导入知识库,试用 AI 摘要和问答。
- 阅读 doc/roadmap.md 了解后续功能规划。
- 想参与贡献,从 doc/CONTRIBUTING.md 入手,AI 相关源码在 frontend/appflowy_flutter/lib/plugins/ai_chat/。
社区讨论主要在官方 Discord 和论坛(直接搜索 "AppFlowy" 即可找到);遇到 Bug 或有功能建议,以 Issue 形式提交到项目仓库。
【免费下载链接】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),仅供参考