企业官网建设流程全解析

Logseq DB 图谱快速上手指南：从文件笔记到实时同步的完整路径（Beta）

【免费下载链接】logseqA privacy-first, open-source platform for knowledge management and collaboration. Download link: http://github.com/logseq/logseq/releases. roadmap: https://logseq.io/p/NX4mc_ggEV项目地址: https://gitcode.com/GitHub_Trending/lo/logseq

Logseq 是一个隐私优先的开源知识管理工具，2025 年推出的 DB 版本在原有 Markdown 文件图谱之上，新增了数据库驱动的图谱模式，支持跨设备实时同步和移动端优先的交互。本指南面向想从文件图谱切换到 DB 图谱的用户，覆盖安装启动、功能使用与多设备同步的完整路径。

三步完成安装与启动

相比旧版，开发环境的依赖管理从 Yarn 换成了 pnpm，Node 版本要求也提升到 22 以上。按 docs/develop-logseq.md 的说明，先准备好 Node.js 与 Java + Clojure，然后执行下面这条命令链即可完成克隆与依赖安装：

git clone https://gitcode.com/GitHub_Trending/lo/logseq cd logseq pnpm install

浏览器版最简单：pnpm watch跑起后直接打开http://localhost:3001就能看到界面。桌面版多一步，等 watch 提示:electron和:app两个模块都 Build Completed 后，在另一个终端执行：

pnpm dev-electron-app

注意：启动前请关掉已打开的桌面版 Logseq，否则命令会失败。第一次打开后，新建一个 DB 类型图谱，就能看到数据库驱动的新界面替代了原来的文件目录树。

启用 DB 图谱：存储与写入逻辑在哪里

数据库层的位置

DB 图谱相比文件图谱最大的变化，是把块（block）的读写从"解析 Markdown 文件"换成了"向 Datomic 引擎提交事务"。这一层的代码集中在 src/main/frontend/db/ 目录：transact.cljs负责事务写入，persist.cljs负责数据落地，restore.cljs承担从旧数据格式到新 schema 的恢复与迁移。你不需要读源码，但出问题时知道看哪里，排错会快很多。

打开实时同步（RTC）

DB 图谱最实用的新功能是实时协作：多台设备连接同一远端图谱后，一端的修改会推送到另一端。本地联调同步服务有两种方式，都写在 docs/develop-logseq.md 的 "DB sync" 小节：

• Cloudflare Worker 适配器：在deps/db-sync下执行pnpm install && pnpm release，再运行wrangler d1 migrations apply DB --local做一次迁移，最后pnpm dev启动本地 Worker。
• Node 适配器（自托管）：同一目录下用pnpm build:node-adapter编译，再用pnpm start:node-adapter启动，端口和 Cognito 认证等环境变量都有默认值，适合内网团队。

应用侧需要用ENABLE_DB_SYNC_LOCAL=true pnpm watch重新构建才能启用本地同步配置。同步状态的调试面板在 src/main/frontend/db/rtc/debug_ui.cljs，能看到本地与远端图谱各自的 schema 版本，排查"两端数据不一致"时很有用。

移动端体验：触摸工具栏与深度链接

触摸交互组件

DB 版本的移动端为手指操作重做了编辑器工具栏和侧边导航，iOS 应用已发布，Android 端也已进入应用商店流程。移动端专属组件放在 src/main/mobile/components/，启动初始化逻辑在 src/main/mobile/init.cljs，比桌面端多了冷启动预加载，打开速度更快。

深度链接跳转

移动端支持从外部 App 直接跳转到指定页面或块，逻辑在 src/main/mobile/deeplink.cljs。配合共享图谱，你可以在手机上收到别人发的页面地址后一键打开，不需要手动输 URL 或切换应用。

实战组合：团队共享图谱 + 旧数据迁移

一个真实场景：小团队想把个人文件图谱升级到共享的 DB 图谱。推荐顺序是——先按下面"避坑"一节把文件图谱用 git 提交一版；然后在deps/db-sync起一个 Node 自托管同步服务；团队成员各自用ENABLE_DB_SYNC_LOCAL=true pnpm watch构建应用，连上同一个图谱。旧图谱的内容可以借助 src/main/frontend/db/restore.cljs 的恢复逻辑导入，导入后在新图谱里用[[页面名]]引用验证数据是否完整。

Beta 阶段的避坑与对策

📌 DB 图谱目前仍是 Beta，以下三条建议在正式使用前逐条做掉。

用 git 备份文件图谱

文件图谱的数据就是目录下的 Markdown 文件，最可靠的备份是版本控制：

git init git add . git commit -m "logseq backup"

对已有仓库，建议每次大改前手动打一个 commit 或 tag，出问题可回滚到任意历史版本。

定期导出 DB 图谱数据

DB 图谱不是散落的文本文件，git 备份不了它。对策是定期把重要页面导出为 Markdown（应用内页面菜单的导出功能），把导出产物放进备份仓库；同时关注 deps/db-sync/README.md 中关于快照与下载的说明，同步开启后可从服务端拉取整图快照。

已知短板

• 插件生态尚未完全适配 DB 图谱，写操作类插件可能只读或失效，重要插件先留在文件图谱里用。
• 实时同步依赖服务端适配器，断网期间的离线合并策略还在完善，敏感数据建议开启端到端加密密码再同步。
• 移动端部分高级功能（如白板协同）与桌面端仍有差距，重度协作建议以桌面端为主。

写在最后

DB 图谱让 Logseq 从"个人文件笔记"跨到了"可协作的数据库知识库"，代价是 Beta 阶段需要自己多留一手备份。下一步建议：先在测试环境网页版体验 DB 图谱，确认流程后再迁移正式数据；开发细节查 docs/develop-logseq.md，问题反馈走仓库的 issue 区即可。

【免费下载链接】logseqA privacy-first, open-source platform for knowledge management and collaboration. Download link: http://github.com/logseq/logseq/releases. roadmap: https://logseq.io/p/NX4mc_ggEV项目地址: https://gitcode.com/GitHub_Trending/lo/logseq