siyuan-note GitHub avatar

siyuan

TypeScript
自托管知识工作空间siyuan-note最近推送 2026年11月19日
RAG 与知识库AGPL-3.047.3k3,1244 issues7 天 +93

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

隐私优先、可自托管的块级知识管理工具,支持人与 AI 智能体协作。

思源笔记(SiYuan)是一个隐私优先的个人知识管理系统,支持细粒度块级引用和 Markdown 所见即所得编辑。它开源、可自托管,提供桌面端、移动端和 Docker 部署,并支持通过 OpenAI API 进行 AI 写作与问答。

推荐指数

5.0

功能完整、社区活跃的本地优先笔记系统,适合重视数据掌控的开发者长期使用。

近 7 天

+93

新增 Star

总 Star 排名

#116

雷达追踪的 3,958 个 AI 仓库中

创建于

2020

2020年8月30日

核心亮点

  • 1块级引用

    内容以块为单位,支持块级引用、双向链接和自定义属性。

  • 2Markdown 所见即所得

    采用块式编辑器,支持百万字大文档和公式、图表等富内容。

  • 3多端与自托管

    提供 Android/iOS/HarmonyOS 应用,也支持 Docker 等方式部署。

  • 4AI 与扩展

    可通过 OpenAI API 做 AI 写作问答,支持 JS/CSS 片段和社区市场。

  • 5开放 API

    提供 HTTP API 和 siyuan:// 协议,便于二次开发和集成。

适用场景

  • 个人知识库

    例如:用块级引用把读书笔记和项目文档互相链接,形成网状知识库。

  • 自托管部署

    例如:在 NAS 或服务器上用 Docker 运行,数据完全保存在自己的设备上。

  • AI 辅助写作

    例如:配置 OpenAI API 后,在笔记内直接进行 AI 问答和内容生成。

  • 团队文档协作

    例如:通过自托管实例共享知识库,配合 API 接入内部工具。

它是怎么工作的

  1. 第 1 步

    本地存储

    笔记以 Markdown 等格式保存在本地数据目录,数据由用户掌控。

  2. 第 2 步

    块级编辑

    编辑器把内容拆成块,支持引用、嵌入和 SQL 查询。

  3. 第 3 步

    多端同步

    可通过自建或第三方同步盘同步数据,也支持 Docker 部署访问。

  4. 第 4 步

    AI 集成

    配置 OpenAI API 后,在应用内调用 AI 写作和问答。

快速上手

  1. 1

    下载安装

    从 GitHub Releases 下载对应平台安装包,或使用应用市场。

  2. 2

    Docker 部署

    使用官方镜像 b3log/siyuan 在服务器上运行。

    docker run -d --name siyuan -p 6806:6806 b3log/siyuan
  3. 3

    配置 AI

    在设置中填入 OpenAI API 密钥以启用 AI 功能。

适合谁

  • 重视数据隐私、希望自托管的个人用户
  • 需要块级引用和双向链接的知识工作者
  • 希望用 API 做二次开发的开发者

不太适合

  • 只想用纯云端、零配置笔记工具的用户
  • 不接受 AGPL 许可证约束的商业项目

成熟度

  • 活跃度最近一次推送在 2026 年 11 月,提交活跃。
  • 文档README 完整,有在线用户指南和 API 文档。
  • 社区约 4.7 万 star、3 千多 fork,社区市场活跃。
  • 上手难度提供安装包和 Docker,开箱即用,但自托管需一定配置。

同类项目怎么选

  • Obsidian闭源免费,插件生态大,但核心不开源、自托管能力弱。
  • Logseq同样开源、块级大纲,但界面和存储模型不同。
  • Joplin开源 Markdown 笔记,偏传统笔记同步,块级引用较弱。

使用前注意

  • · 许可证为 AGPL-3.0,商用或分发需遵守其条款。
  • · 部分高级功能仅对付费会员开放。
  • · 自托管和同步需要自行维护服务器或同步盘。
  • · AI 功能依赖外部 OpenAI API,会产生调用成本。

主题标签

note-takinglocal-firstknowledge-basemarkdownself-hostedsiyuanai-agentmcpagentic-aiworkspacemindmap