思源笔记：一个把数据仓库和编辑器绑在一起的开源知识管理方案
一个隐私第一、自托管、完全开源的个人知识管理软件，用 typescript 和 golang 编写。
秒懂
- 它是什么？
- 思源笔记（SiYuan）是 TypeScript 与 Go 编写的隐私优先知识管理软件，核心是把内容切成块、用数据仓库管理历史，并允许自托管。它功能多，但 AGPL 许可和同步限制决定了它不是所有人的答案。
- 适合谁用？
- 思源笔记适合那些重视数据自主、愿意用 Docker 或桌面应用管理知识，并且能接受 AGPL-3.0 许可约束的个人用户和小团队。它不适合需要把知识库与团队协作流程深度绑定的人，也不适合对同步实时性要求极高、又不愿购买会员服务的用户。
- 能商用吗？
- 可以，但条件严格。AGPL-3.0 是网络 copyleft 许可证：如果别人通过网络使用你修改过的版本（例如作为托管服务），你必须以同一许可证向他们提供源代码。
- 还在维护吗？
- 在维护。仓库在最近一天内有新的提交。
- 用什么语言写的？
- 主要是 TypeScript（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月15日）和我们的分析，不构成法律意见。
开源项目深度解析
它解决的是块级知识组织，不是普通笔记
思源笔记定位为隐私优先的个人知识管理系统，但它的核心差异不在隐私，而在块（block）。普通 Markdown 笔记以文件为最小单位，思源把内容切成块，支持块级引用和双向链接。这意味着你可以精确引用某一段、某一行，而不是整个文件。文档还提到支持 SQL 查询嵌入，这让你能用结构化方式从笔记里捞数据。它面向的是需要长期积累、交叉引用知识的用户，比如研究者、写作者、技术文档维护者。如果你只是随手记几条待办，这个粒度反而是一种负担。
数据仓库与编辑器分离，但绑得很紧
思源把编辑器内核拆成了独立的 lute 项目，数据仓库拆成了 dejavu 项目，插件 API 是 petal，间隔重复是 riff。这个架构说明它不是单体应用，而是围绕核心仓库的一组项目。数据仓库负责管理历史版本和同步，编辑器负责渲染和交互。但两者通过私有协议绑定，不像 Logseq 那样直接用纯 Markdown 文件。文档 FAQ 里明确说，数据仓库密钥丢失会导致历史数据无法恢复，这说明仓库是加密且带版本控制的。这种设计换来了块级历史的可靠性，代价是你不能随便用第三方工具打开数据目录。
部署方式：Docker 是服务器首选，但不是唯一
官方推荐优先用应用市场安装桌面和移动端，这样能一键升级。服务器部署则通过 Docker 镜像 b3log/siyuan，程序位于 /opt/siyuan/ 下。命令行接口也有专门文档。如果你用 Unraid 或 TrueNAS，官方直接列出了托管方式，说明它对 NAS 用户很友好。一个实际例子：在 Docker 里跑思源，你需要映射数据目录和监听端口，具体命令在 README 里有，但这里不重复。关键是，桌面端和移动端应用都支持，这意味着你可以本地用桌面版，服务器上用 Docker 版，两者之间怎么同步是下一个问题。
同步是最大的坑：第三方盘不受支持
FAQ 里有一条直接回答：是否支持通过第三方同步盘同步数据？答案是明确的不推荐。原因是思源的数据仓库是加密的，而且块级结构依赖内部状态，用 Dropbox 或坚果云同步容易产生冲突或损坏。这是它和 Obsidian 的根本区别。Obsidian 把数据存成纯 Markdown 文件，天然适合任何文件同步工具。思源为了块级引用和 SQL 查询，牺牲了文件的可移植性。如果你已经依赖某同步盘，或者团队需要多人协作编辑同一份笔记，思源可能不是合适工具。它更偏向单用户、自托管、自己控制同步节奏的场景。
AI 功能有，但依赖外部 API
思源支持 AI 写作和问答，但通过 OpenAI API 实现。这意味着它不是本地模型，数据会发送到第三方服务，这与隐私优先的定位存在张力。文档里没有提离线模型支持，也没有说数据匿名化处理。如果你对隐私有严格需求，使用 AI 功能时需要自己权衡。从架构看，AI 是附加功能，不是核心，所以你可以完全不用它，不影响其他功能。对比来看，Logseq 也有 AI 插件，但同样依赖外部服务，这个领域目前没有完全本地化的主流方案。
许可与商业使用：AGPL-3.0 的边界
思源采用 AGPL-3.0 许可，文档强调大部分功能免费，甚至允许商业使用。但 AGPL 的 copyleft 条款意味着，如果你修改了代码并作为网络服务提供，你需要开放源代码。这对个人用户没影响，但如果你打算基于思源做 SaaS，或者把它嵌入到商业产品中，就必须仔细评估。官方有付费会员功能，比如某些高级特性，但核心编辑和数据管理是免费的。另一个实际问题是，数据仓库密钥丢失后无法恢复，这不仅是技术问题，也是运维责任。部署前必须设计备份策略，否则历史数据可能永久丢失。
编辑结论
思源笔记适合那些重视数据自主、愿意用 Docker 或桌面应用管理知识，并且能接受 AGPL-3.0 许可约束的个人用户和小团队。它不适合需要把知识库与团队协作流程深度绑定的人，也不适合对同步实时性要求极高、又不愿购买会员服务的用户。采用前需要验证两件事：一是你的使用场景是否依赖第三方同步盘，官方文档明确不推荐这种用法，二是你的分发方式是否会触发 AGPL 的 copyleft 义务，尤其是如果你计划基于它做商业服务。数据仓库密钥一旦丢失，历史数据无法恢复，这是部署前必须建立备份流程的硬性前提。
社区笔记