摘要
1) 一句话总结 思源笔记(SiYuan)是一款基于 TypeScript 和 Golang 开发的隐私优先、自托管且完全开源的个人知识管理系统,主打细粒度块级引用与 Markdown 所见即所得编辑。
2) 关键要点
- 开源与技术栈:项目采用 GNU AGPL v3.0 开源协议,主要使用 TypeScript 和 Golang 开发,目前在 GitHub 拥有超 4.1 万 Stars。
- 核心特性:支持细粒度块级引用、双向链接、自定义属性、SQL 查询嵌入以及百万字级别的大文档编辑。
- 编辑与排版:提供 Markdown 所见即所得(WYSIWYG)编辑器,支持数学公式、各类图表(流程图、甘特图等)、网页剪藏及 PDF 标注链接。
- 高级功能:内置表格视图(数据库)、间隔重复闪卡、基于 OpenAI API 的 AI 写作与问答、OCR 识别以及多标签页分屏拖拽。
- 多平台支持:提供桌面端应用,以及 Android、iOS 和 HarmonyOS 移动端应用,支持通过应用商店或安装包进行部署。
- 生态系统:拥有完整的周边生态,包括 Lute(编辑器引擎)、Chrome/Edge 浏览器扩展、社区插件市场(Bazaar)以及开放的 API。
- 商业模式:绝大多数功能免费(包括商业用途),部分特定功能仅向付费会员开放。
3) 风险/不足
- 数据泄露风险:在 Docker 等自托管部署时,必须修改访问授权码(
accessAuthCode),否则任何人都可以访问其数据。 - 数据丢失风险:Docker 部署时必须确保挂载卷(mounted volume)配置正确,否则在删除容器后会导致数据丢失。
- Docker 版本功能限制:Docker 部署版本不支持连接桌面端和移动端应用(仅支持浏览器访问),不支持导出 PDF、HTML 和 Word 格式,且不支持导入 Markdown 文件。
功能与定位
A privacy-first, self-hosted, fully open source personal knowledge management software, written in typescript and golang.
典型使用场景
- 作为通用开发工具用于工程协作与效率提升。
- 适用于个人与团队的日常研发流程。
核心功能
- 提供稳定的通用工程能力。
- 支持跨平台或多环境使用。
- 依赖开源社区持续迭代。
特色与差异点
- 仓库长期活跃,最近更新时间为 2026-02-22T12:49:43Z。
- 项目创建于 2020-08-30T09:21:35Z,具备持续迭代与社区沉淀。
- 以
TypeScript为主语言,聚焦该技术栈的工程实践。
使用方式概览
- 阅读仓库 README 与官方文档,确认适配场景与依赖条件。
- 按项目推荐方式完成安装与初始化,再从示例或最小流程开始验证。
- 在生产使用前补齐权限控制、日志监控和版本固定策略。
限制与注意事项
- 使用前应先核对许可证、项目维护状态与安全边界。
链接
- 仓库:https://github.com/siyuan-note/siyuan
- 官网:https://b3log.org/siyuan
- README:https://raw.githubusercontent.com/siyuan-note/siyuan/master/README.md
- Releases:https://github.com/siyuan-note/siyuan/releases