siyuan-note/siyuan
⭐ 43,781 · TypeScript · GitHub 仓库
一款隐私优先、自托管、完全开源的个人知识管理软件，采用TypeScript和Golang编写。
anki chatgpt deepseek electron evernote knowledge-base local-first markdown
一句话总结
思源笔记是一款隐私优先、支持自托管的知识管理系统，提供块级引用和本地优先控制能力。
🔥 核心能力与独特卖点
- 块级引用与双向链接： 与仅能链接整个页面的工具不同，思源笔记允许你引用和反向链接单个内容块（段落、图片、表格）。这解决了浅层连接的痛点，为研究人员和写作者构建深度、细粒度的知识图谱。
- 所见即所得 Markdown 编辑器： 将 Markdown 的简洁性与丰富的实时预览编辑体验融为一体。它能够处理数学公式、图表和百万字文档等复杂元素，解决了在编辑与预览模式间频繁切换的痛点。
- 本地优先与自托管： 数据默认存储在本地，并支持 Docker、WebDAV 或 S3 同步。这是核心独特卖点——它解决了数据所有权和供应商锁定的关键痛点，让你完全掌控自己的知识库。
- AI 集成与 OCR： 支持通过 OpenAI API（ChatGPT、DeepSeek）进行 AI 写作和问答，并利用 Tesseract OCR 从图片中提取文字。这解决了手动录入数据的痛点，并增强了所有内容类型的可搜索性。
- 跨平台与可扩展： 支持桌面端（Windows、macOS、Linux）、移动端（Android、iOS、HarmonyOS）以及 Docker 部署。社区插件和主题市场解决了工具僵化、一刀切的痛点。
技术架构
| 组件 | 技术栈 | 职责 |
|---|---|---|
| 前端 | TypeScript, Electron | 桌面和移动端应用 UI |
| 编辑器引擎 | Go (Lute) | Markdown 解析与所见即所得渲染 |
| 数据仓库 | Go (dejavu) | 本地与远程数据存储及同步 |
| 间隔重复 | Go (riff) | 类 Anki 的闪卡引擎 |
| 插件 API | Go (petal) | 插件与主题市场支持 |
| 同步/存储 | 本地文件系统, S3, WebDAV | 灵活、用户可控的数据托管 |
该架构采用双栈设计：TypeScript/Electron 前端负责用户界面，Go 语言后端负责核心引擎操作（编辑、存储、同步）。这种分离使得数据处理性能卓越，同时保持了丰富的跨平台 UI。
快速入门指南
最便捷的入门方式是通过 Docker 运行思源笔记，这将为你提供一个完全自托管的实例。
bash
# 拉取最新的思源笔记镜像
docker pull b3log/siyuan
# 运行思源笔记，挂载本地目录以持久化存储数据
docker run -d \
--name siyuan \
-v /path/to/your/data:/siyuan/workspace \
-p 6806:6806 \
b3log/siyuan运行后，在浏览器中打开 http://localhost:6806 即可访问 Web 界面。如需桌面端或移动端应用，请从官方发布页面下载安装程序。
优势、劣势与使用场景
优势
- 完全开源（AGPLv3）： 完全透明，社区驱动开发。
- 默认隐私优先： 本地存储，无强制云依赖。
- 功能丰富： 块引用、AI、OCR、间隔重复和图表支持，集于一身。
- 社区活跃： 43k+ 星标和频繁更新，表明项目健康且响应迅速。
劣势
- 付费功能： 高级云同步和 AI 功能需要付费订阅。
- 技术门槛： 通过 Docker 或 WebDAV 自托管需要一定的技术知识。
- 学习曲线： 块级范式功能强大，但与传统的基于页面的笔记方式有所不同。
不适合哪些人？
- 寻求完全免费、零设置的云解决方案的用户： 如果你想要一切免费且无需管理服务器，思源笔记的付费同步和自托管要求将构成障碍。
- 需要实时协作编辑的团队： 思源笔记专为个人知识管理设计，不支持像 Google Docs 或 Notion 那样的实时多用户协作。
- 偏好简单、扁平文件结构的用户： 如果你满足于文件夹中的纯 Markdown 文件，且不需要块级引用或所见即所得编辑器，那么 Obsidian 等工具可能更适合。
理想使用场景
- 注重隐私的研究人员和写作者，需要以块级精度构建深度互联的知识库。
- 开发者和技术用户，希望拥有一个自托管、开源、完全掌控数据所有权的 Notion 或 Evernote 替代品。
- 学生和终身学习者，希望将间隔重复（类 Anki 闪卡）直接集成到笔记工作流中。
- 高级用户，需要一个集 Markdown 编辑、AI 辅助、OCR 和跨平台访问于一体的工具。
社区与活跃度
思源笔记正处在强劲的发展轨道上，拥有 43,781 个星标和高度活跃的开发周期。该项目最近一次更新于 2026 年 5 月 10 日，展现了持续且快速的发布节奏。社区充满活力，拥有插件和主题市场，项目对隐私和自托管的关注引起了寻求专有工具替代品的用户的强烈共鸣。其发展势头极佳，是个人知识管理领域一个可靠且面向未来的选择。