dalao.ai

Logseq

隐私优先、支持双向链接的大纲笔记开源

关于 Logseq

Logseq 是一款开源的大纲式笔记与知识库软件，以块为单位记录，用双向链接和每日日志把笔记连起来，提供桌面端、网页版和移动端。2026 年它分成两条线：基于 Markdown 文件的旧版改名 Logseq OG，只做安全与 Electron 维护；主线换成把数据存进本地数据库的 DB 版，2.0.2 于 2026-10-07 发布，仍标为 Beta。代码自 2020-10-12 起以 AGPL-3.0 发布。数据只存本地且不用官方服务器时，个人和公司都免费；同步测试自 2026-07-13 起向 Open Collective 每月付费的 Backers（5 美元起）和 Sponsors 开放。CERT Polska 2026-06-09 公开的 4 个桌面端漏洞覆盖到 0.10.15，其中命令拼接的写法在 2026-10-25 的主分支里仍在。

编辑部更新于 阅读约 11 分钟

它是什么

Logseq 是一款开源的笔记与知识库软件。它的基本单位是“块”：每一行都是一个可以折叠、引用和嵌入的块，页面之间靠双向链接相连，打开应用默认进入当天的日志页。仓库 logseq/logseq 的简介把它定位为“隐私优先、开源的知识管理与协作平台”。主体代码用 ClojureScript 写成，数据层基于 Datascript，桌面端用 Electron 打包；2026 年新加入的命令行工具改用 OCaml 编写。

项目的第一个提交 0f07cec 由 Tienson Qin 在 2019-12-11 08:35 (UTC+8) 提交，提交说明只有 init；GitHub 仓库的创建时间是 2020-05-23 08:06 (UTC+8)。官方博客 2022-05-05 的融资公告说，Logseq 最初是 Tienson Qin 的开源业余项目，用来管理自己的工作，也想做一个孩子更容易上手的工具；公司的联合创始人 Zhiyuan Chen、Huang Peng、An Vu 都是通过开源社区认识的。同一公告宣布 410 万美元种子轮，领投方包括 Patrick Collison、Nat Friedman、Tobias Lütke 等。隐私政策（最后更新 2023-07-28）写明运营主体是 Logseq, Inc.。

2026 年产品分成两条线。官方文章《Big update: Logseq is splitting into two versions》（署名 Kerim、danzu、tienson，页面时间 2026-04-24）说明：以 Markdown 文件为存储的旧版改名 Logseq OG，迁到 logseq/og 仓库，此后只接收安全修复和 Electron 升级，不加新功能；数据库版（DB 版）成为主线。logseq/og 仓库创建于 2025-12-25，发布过 OG 1.0.0（2026-04-16），最后一次推送在 2026-05-28。

截至 2026-10-25，主仓库星标 45,366、分叉 2,846，主分支 25,931 次提交；有 GitHub 账号的贡献者约 338 人（2026-10-25），提交数排前两位的是 tiensonqin（11,918 次）和 logseq-cldwalker（2,927 次）。未关闭的 issue 813 个、PR 185 个。

桌面端和网页版现在不需要、将来也不会需要商业许可，个人和公司使用都一样，只要数据存在本地、不使用我们的服务器。

Logseq Open Collective 页面（英文原文的中文译述）

核心能力

块与双向链接。任何块都能被引用或嵌入到别处，被引用的页面底部自动列出所有反向链接；页面之间的关系可以画成图谱。日志页按日期自动生成，内容可以先记下、再靠链接整理。

DB 版的数据模型。DB 版把整个笔记库存进本地 SQLite 数据库，而不是一堆 Markdown 文件。拆分公告列出的近期工作包括：桌面端和命令行的 MCP 服务器、可自托管的同步服务、对 5 万页规模大库的支持。2.0.1（2026-07-13）发布说明标题是“Logseq 2.0 Beta (DB version) is here!”，并提醒用户先备份数据；2.0.2（2026-10-07）修复了 Windows 11 24H2 上 NSIS 安装程序崩溃、文件版导入 DB 版的保真问题和若干 Android 问题。对 DB 库的 Markdown 支持，4 月的拆分公告写的是“计划中”、仍在研究；之后仓库的设计记录 ADR 0016《Electron Markdown Mirror》（2026-05-05，状态 Accepted）定下了一条有限的做法：桌面端加一个设置开关，把页面和日志单向导出为 Markdown 镜像文件，供外部工具读取、备份和检索，数据仍以数据库为准，镜像文件不会被读回。实现提交 06dbef8（2026-05-06）已在 2.0.1 的提交历史里。

同步与加密。按拆分公告，DB 版的同步使用用户自设的密码做端到端加密。仓库里的设计记录 ADR 0003（2026-02-11，状态为 Proposed）提议把加密做成可选：默认仍加密，关闭后数据以明文经 TLS 传输。

本地接口与自动化。桌面端自 2022-12-29（提交 51aaa02，“Feat: APIs http server”）起内置一个 HTTP API 服务器，默认地址 127.0.0.1:12315，需要在设置里手动开启；MCP 服务器由单独的 :server/mcp-enabled? 选项控制。2026 年仓库加入了新的命令行工具和面向 AI 编程助手的技能说明文件。

插件与主题。插件运行在 iframe 里，但能调用宿主提供的 API。

和同类比

和 Obsidian 比。两者都把笔记放在本地，都有插件生态。Obsidian 的定价页（2026-10-25）列出：软件本体免费；Sync 每用户每月 4 美元（年付）或 5 美元（月付）；Publish 每站每月 8 美元（年付）或 10 美元（月付）；另有一次性 25 美元的 Catalyst 和每用户每年 50 美元的 Commercial 许可，页面说明这两项都是自愿支持。Logseq 的差别在于：代码以 AGPL-3.0 开源，组织方式以块和大纲为中心；而 DB 版改用数据库存储之后，“笔记就是一个文件夹里的 Markdown 文件”这一点已经只属于 Logseq OG。官方同步目前不单独售卖；按 Open Collective 2026-07-13 的更新，同步测试向每月付费的 Backers（5 美元起）和 Sponsors 开放。

和 Roam Research 比。Logseq 的大纲、块引用和每日日志与 Roam 的用法接近，2022 年的融资公告直接写到有用户从 Roam、Obsidian、Notion 等工具迁来。Logseq 默认把数据留在本机，代码以 AGPL-3.0 公开。

和 OG 版本身比。还在用 Markdown 文件库的用户面对的是两个产品：OG 的数据格式不变、可以继续用 Git 或任意同步盘管理文件，但官方只承诺维护，不再加功能；DB 版有新同步、MCP 和大库支持，但仍是 Beta，文件不再是可直接编辑的 Markdown。

适合谁 / 不适合谁

适合：

  • 习惯大纲式书写、需要块级引用的人，比如做读书笔记、研究记录、每日工作日志。
  • 希望数据留在自己设备上、并愿意自己做备份的人。
  • 需要用 MCP 或本地 HTTP API 让脚本、AI 助手读写笔记的开发者。
  • 想参与开源项目、或者需要能审计和自行构建源代码的组织。

不适合：

  • 需要稳定正式版的团队。截至 2026-10-25，GitHub Releases 上所有正式版本的标题仍带“Beta Testing”，2.0.1 的发布说明要求先备份。
  • 依赖“笔记就是 Markdown 文件”的工作流，又不想停在只维护不更新的 OG 版的人。
  • 需要成熟实时协作或企业权限管理的团队：同步仍在测试，只对 Open Collective 每月付费的支持者开放，自托管同步服务 2026 年才加入仓库。
  • 必须安装来源不明插件、又无法评估插件代码的用户：插件能拿到的权限较大。

上手路径

桌面端从 GitHub Releases 下载。2.0.2（2026-10-07）提供 macOS（x64 与 arm64）、Windows（x64 与 arm64，安装包与 zip）、Linux（x86_64 与 arm64，AppImage 与 zip）和 Android 安装包；桌面安装包约 147 到 196 MB，Android apk 约 44.2 MB。iOS 版按 2.0.2 发布说明在 TestFlight 上测试，App Store 审核尚在进行。2026-10-20Open Collective 的更新《Logseq Native iOS App Is Ready for Testing!》开始邀请支持者和社区成员通过报名表试用原生 iOS 版，并说原生 Android 版也将很快邀请社区测试。Releases 页另有每日构建的 nightly 标签。

系统要求按当前版本写：2.0.1 和 2.0.2 基于 Electron 42.3.0，按 Electron 的兼容性说明，最低需要 macOS 12 和 Windows 10。这条线是逐步抬高的：0.10.9 用 Electron 27.1.3，最低 macOS 10.15；0.10.13 升到 Electron 34.5.6，最低变为 macOS 11（Electron 33 起）；0.10.15（2025-12-01）升到 Electron 38.4.0，最低变为 macOS 12（Electron 38 起）。Windows 10 的下限自 Electron 23 起就已存在。主分支已用 Electron 42.11.16；Electron 44 将要求 macOS 13，并停止支持 32 位 Windows 和 Linux armv7l，截至 2026-10-25Logseq 还没有升到 44。

从旧版迁移：DB 版提供从文件库导入的功能，2.0.2 专门修了导入保真问题。继续使用文件库的 OG 版在 logseq/og 仓库下载。

网页版可以自己用 Docker 运行：官方文档的示例命令把容器端口映射到 127.0.0.1:3001，只在本机可访问。

定价与许可证

软件本身免费。Open Collective 页面写明：桌面端和网页版现在不需要、将来也不会需要商业许可，个人和公司使用都一样，前提是数据存在本地、不使用官方服务器。

付费只出现在 Open Collective 的赞助档（2026-10-25）：Backers 每月 5 美元，Sponsors 每月 15 美元，另有每月 100、250、500 美元的铜、银、金档，回报是标志展示。同步的测试资格以 Open Collective 2026-07-13 的更新《Logseq DB beta and RTC sync are ready for all active monthly backers》为准：DB 测试版和实时同步向所有按月付费的 Sponsors 和 Backers 开放。Backers 档位的说明文字仍写同步“很快”开放、目前只有每月 15 美元的 Sponsors 在测，这段文字早于该更新。

该账户 2020-09-22 创建。截至 2026-10-25，累计流入 958,502.57 美元，这是未扣平台和支付手续费的毛额；页面显示的“Total raised”是扣费后的 762,204 美元；支持者账户 12,205 个。

许可证要看完整历史。最早的许可证文件由 2020-02-20 的提交 ee10679（“Add backend”）以 backend/LICENSE 加入，内容是 EPL-2.0；2020-04-09 的提交 b0c0b6a 把它原样移到根目录；2020-10-12 的提交 09e70cd 加入 AGPL-3.0 的 LICENSE.md，5 分钟后的 25526c5 删除了 EPL 文件；2020-11-03 的提交 a72ca41 在 LICENSE.md 末尾加入依据 GPL 第 7 条的附加许可，允许与以 EPL 发布的 Clojure 库组合。此后到 2026-10-25 这个文件没有再变。GitHub API 识别的仓库许可证为 AGPL-3.0；OG 仓库同样是 AGPL-3.0。

仓库内其他部分的许可证不全相同：libs/cljs-sdk 自带 MIT 许可证（2025-10-21 加入）；npm 上的命令行包 @logseq/cli 标为 MIT，而它对应的旧命令行代码已在 2026-05-28 从主仓库删除。随仓库分发的第三方代码包括：Mozilla 的 PDF.js 查看器（Apache-2.0）、DOMPurify（Apache-2.0 与 MPL-2.0 双许可）、spa-github-pages 的跳转脚本（MIT）、.prettierrc.js 里沿用的 Facebook MIT 文件头。

风险与局限

桌面端漏洞。CERT Polska 于 2026-06-09 公开 4 个漏洞，报告者为 striga.ai 的 Bartłomiej Dmitruk，受影响版本写作“到 0.10.15 为止的所有版本”；页面说明只测试了 0.10.15，其他版本状态未知，因为厂商没有处理。具体是：CVE-2026-9279，IPC 接口把参数和命令名拼成一个字符串，以 shell: true 交给 child_process.spawn，白名单只检查命令名，评分 8.7；CVE-2026-47899，preload 暴露的接口不校验路径，可读写或删除任意文件，8.7；CVE-2026-47900，插件 package.json 的 name 字段经 innerHTML 渲染，4.6；CVE-2026-47901，插件可从沙箱 iframe 向宿主元素注入属性，加上 CSP 被禁用，可在宿主环境执行脚本，4.6。CERT 页面本身不列评分，这些分数来自各条 CVE 记录，评分方为 CERT-PL，采用 CVSS 4.0，记录发布于 2026-06-09 21:23 (UTC+8)。

利用前提分两类。前两个要求攻击者已能在渲染进程里执行 JavaScript，例如通过 XSS 或恶意插件；后两个只需要用户装了恶意插件，就能让插件代码在宿主环境里执行，这正好满足前两个的前提，几个漏洞可以串成一条从装插件到执行系统命令、读写文件的链路。2026-10-25 主分支 f8fb34b 的 shell.cljs 仍以 shell: true 执行拼接后的命令，白名单为 git、pandoc、ag、grep、alda 加上用户配置项；utils.js 仍会删掉响应头里的 Content-Security-Policy 和 X-Frame-Options。OG 1.0.0（2026-04-16）的代码与 0.10.15 写法相同：shell.cljs 同样以 shell: true 执行拼接后的命令，utils.js 同样删掉 CSP，Electron 同为 38.4.0。

更早的两项。GitHub 安全公告 GHSA-92h5-2358-7xjv（2025-08-18，严重，CVSS 4.0 评分 9.3）标题为“Remote Code Execution in Logseq Desktop <= 0.10.13”，原因是旧版 pdfjs-dist 的 CVE-2024-4367 加上 git 执行接口，用户打开恶意 PDF 即可触发；公告的已修复版本栏为空，0.10.14 的发布说明写明把 pdf.js 升到 4.2.67。CVE-2025-56683 是 0.10.9 插件市场页面里经恶意 README 触发的 XSS；NVD 页面列出的 CVSS 3.1 评分 9.6 来自 CISA-ADP，NVD 自己没有评分，记录状态为 Deferred；主分支的修复提交 4cdf49a（2025-04-25）不在 0.10.15 标签的提交历史里，2.0.1 包含它。

监听地址。桌面端 HTTP API 服务器默认绑定 127.0.0.1:12315，默认不自动启动；如果从未设置过 :server/tokens，服务器不检查令牌，任何本机进程都能调用，设置过令牌后缺少或错误的令牌返回 401。主机和端口都可在配置里改。自托管同步服务的 Node 适配器（2026-01-30 加入）调用 listen 时只传端口不传主机，Node 会监听所有网卡；端口默认值在代码里是 8080，README 示例和启动脚本用 8787；鉴权依赖 Cognito JWT，管理令牌 DB_SYNC_ADMIN_TOKEN 可选。

代码里能看到的。没有许可证密钥或激活检查。非开发构建默认初始化 PostHog 使用统计和 Sentry 错误上报，PostHog 配置关闭了自动采集和会话录屏、屏蔽页面文字；设置里的“Send usage data and diagnostics to Logseq”可以关闭，说明文字是“Logseq 不会收集你的本地图谱数据库，也不会出售你的数据”。关闭后 PostHog 立即停止上报，Sentry 要到下次启动应用时才不再初始化。

隐私政策与许可证写的。隐私政策把应用自动收集的技术数据列为设备信息、操作系统、平台和版本号，处理方包括 AWS、Sentry、PostHog；适用纽约州法律；政策称不出售个人信息。许可证层面，AGPL-3.0 要求把修改后的版本通过网络向用户提供时公开源代码，这与是否收费无关。

稳定性。所有正式版仍标 Beta；OG 承诺维护，但仓库最后一次推送停在 2026-05-28，早于 CERT 公开漏洞的日期，之后没有针对这些漏洞的提交。README 仍写“Android 即将推出”，Releases 已附 Android 安装包。

我们的判断

Logseq 的特点是：AGPL-3.0 许可证、以块为单位的大纲、默认本地存储、开放的本地 API 和 MCP 接口，个人和公司在本地使用都不用付钱。2020 年至今 Open Collective 累计流入约 95.9 万美元（未扣手续费，扣费后约 76.2 万美元）、12,205 个支持者账户（2026-10-25），2022 年拿到 410 万美元种子轮。

过渡期的情况是：主线已经从 Markdown 文件换成本地数据库，旧版 OG 只做维护；新版 2.0.x 仍是 Beta，同步仍在测试，只对 Open Collective 每月付费的支持者开放。安全方面，对 2026-06-09 公开的 4 个桌面端漏洞，CERT 称厂商未处理（not addressed by the vendor），其中命令拼接和禁用 CSP 的写法在 2026-10-25 的主分支里仍在。

亮点

Logseq 是一款支持双向链接、每日日志和关系图谱的大纲笔记工具，主体用 ClojureScript 在 Datascript 之上写成，数据保存在本地。它现在分两条线：Logseq OG 把每一页存成本地的 Markdown 普通文件；新的数据库版本则把整个图谱存进一个 SQLite 文件（db.sqlite）。

Tienson Qin 在 2019 年 12 月提交了第一版代码，最初把它当作自用工具，并很早就开源了；现在项目由 Logseq, Inc. 维护。数据库版本是一次从头开始的重写，Clojure 的传统也体现在它把数据模型本身当作产品来对待；2026 年起仓库里还多了一个用 OCaml 写的命令行工具。

它开源，数据保存在本地：Logseq OG 用 Markdown 文件，数据库版本用单个 SQLite 文件。

资料来源

官方

  1. GitHub - logseq/logseq: A privacy-first, open-source platform for knowledge management and collaboration.GitHub · 访问于 2026 年 10 月 25 日
  2. LICENSE.md at f8fb34b - logseq/logseqGitHub · 访问于 2026 年 10 月 25 日
  3. History for LICENSE.md - logseq/logseqGitHub · 访问于 2026 年 10 月 25 日
  4. Add backendGitHub · 访问于 2026 年 10 月 25 日
  5. History for LICENSE (commits b0c0b6a, 25526c5) - logseq/logseqGitHub · 访问于 2026 年 10 月 25 日
  6. init (commit 0f07cec)GitHub · 访问于 2026 年 10 月 25 日
  7. Releases - logseq/logseqGitHub · 访问于 2026 年 10 月 25 日
  8. Big update: Logseq is splitting into two versionslogseq.io · 访问于 2026 年 10 月 25 日