logseq/logseq
A privacy-first, open-source platform for knowledge management and collaboration.
github.com · logseq/logseq
Logseq - 开源琅嬛阁
项目介绍
Logseq 是隐私优先、开源的知识管理平台，围绕本地文件、双向链接和大纲式写作组织知识。它不直接属于 AI 工具，但对开发者的长期学习、研究和项目记录很有帮助，并支持插件扩展与团队协作场景。
核心特性
- 大纲式双链笔记，页面与块级引用灵活
- 本地优先，数据以 Markdown 等格式存储在用户设备
- 支持日记、任务、PDF 批注与查询
- 插件 API 与活跃社区生态
- 提供桌面端与 Web 测试版，支持 DB 图（新版本数据模型）
对用户价值
Logseq 适合沉淀「可连接」的知识，而不是只保存孤立文档。开发者可以用它记录问题、方案、阅读笔记和项目日志，通过链接与查询逐步形成可检索、可回顾的个人知识系统。
与替代方案
- 相比 Obsidian，Logseq 默认大纲驱动、日记中心更强，界面哲学不同。
- 相比 Notion 等云端协作，Logseq 更强调本地文件与隐私控制。
- 若团队需要强实时协同编辑，应评估 Notion、飞书文档等云端方案。
适应人群
- 重视本地数据和 Markdown 文件的知识管理用户。
- 需要整理研究、学习和项目笔记的开发者。
- 想研究 local-first 应用形态的产品和工程团队。
如何使用
前置条件
- macOS / Windows / Linux 桌面环境，或现代浏览器（Web 版）。
- 了解 AGPL-3.0 许可对衍生与网络部署的要求。
安装方式
从 GitHub Releases 或 logseq.com 下载对应平台安装包。
首次运行
创建或打开一个 graph，从每日笔记开始记录，尝试用 [[页面链接]] 与 #标签 组织内容。
验证是否成功
创建几条互链笔记并使用查询（如 {{query [[某主题]]}}），确认链接与搜索正常工作。
常见坑 / 注意事项
- 团队同步需自行规划（Git、Syncthing 或官方同步方案），备份策略要提前定好。
- DB 版与文件版数据模型不同，迁移前阅读官方说明。
- 插件质量参差，生产环境谨慎启用第三方扩展。