README

从思考到洞见，与智能体同行






















English
| 中文
| 日本語
| Türkçe
| Português


---

 目录

- 💡 简介
- 🔮 特性
- 🏗️ 架构和生态
- 🗺️ 路线图
- 🚀 下载安装
  - 应用市场
  - 安装包
  - 包管理器
  - Docker 部署
  - Kubernetes 部署
  - Unraid 部署
  - TrueNAS 部署
  - 宝塔面板部署
  - 小皮面板部署
  - 1Panel 面板部署
  - 测试通道
- ⌨️ 命令行接口
- 🏘️ 社区
- 🛠️ 开发指南
- ❓ 常见问题和解答
  - 思源是如何存储数据的？
  - 支持通过第三方同步盘进行数据同步吗？
  - 思源是开源的吗？
  - 如何升级到新版本？
  - 有的块（比如在列表项中的段落块）找不到块标怎么办？
  - 数据仓库密钥遗失怎么办？
  - 使用需要付费吗？
- 🙏 鸣谢
  - 贡献者列表

---

 💡 简介

思源笔记是一款隐私优先的个人知识管理系统，支持细粒度块级引用和 Markdown 所见即所得。

!feature0.png

!feature5-1.png

如需了解更多，请阅读在线用户指南或前往思源笔记官方讨论区交流。

 🔮 特性

大部分功能是免费的，即使是在商业环境下使用。

- 内容块
  - 块级引用和双向链接
  - 自定义属性
  - SQL 查询嵌入
  - 协议 siyuan://
- 编辑器
  - Block 风格
  - Markdown 所见即所得
  - 列表大纲
  - 块缩放聚焦
  - 百万字大文档编辑
  - 数学公式、图表、流程图、甘特图、时序图、五线谱等
  - 网页剪藏
  - PDF 标注双链
- 导出
  - 块引用和嵌入块 
  - 带 assets 文件夹的标准 Markdown
  - PDF、Word 和 HTML
  - 复制到微信公众号、知乎和语雀
- 数据库
  - 表格视图
- 闪卡间隔重复
- 连接 OpenAI 接口支持人工智能写作和问答聊天
- Tesseract OCR
- 模板片段
- JavaScript/CSS 代码片段
- Android/iOS/鸿蒙 App
- Docker 部署
- API
- 社区集市

部分功能需要付费会员才能使用，更多细节请参考定价。

 🏗️ 架构和生态

!思源笔记架构设计

| Project                                                  | Description  | Forks                                                                           | Stars                                                                                | 
|----------------------------------------------------------|--------------|---------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|
| lute                    | 编辑器引擎        | !GitHub forks                 | !GitHub Repo stars                 |
| chrome   | Chrome/Edge 扩展 | !GitHub forks  | !GitHub Repo stars  |
| bazaar          | 社区集市         | !GitHub forks         | !GitHub Repo stars         |
| dejavu          | 数据仓库         | !GitHub forks         | !GitHub Repo stars         |
| petal            | 插件 API       | !GitHub forks          | !GitHub Repo stars          |
| android | Android App  | !GitHub forks | !GitHub Repo stars |
| ios         | iOS App      | !GitHub forks     | !GitHub Repo stars     |
| harmony         | 鸿蒙 App       | !GitHub forks     | !GitHub Repo stars     |
| riff              | 间隔重复         | !GitHub forks           | !GitHub Repo stars           |

 🗺️ 路线图

- 思源笔记开发计划和进度
- 思源笔记版本变更和公告

 🚀 下载安装

桌面端和移动端建议优先考虑通过应用市场安装，这样以后升级版本时可以一键更新。

 应用市场

移动端：

- App Store
- Google Play
- F-Droid
- 华为应用市场
- 小米应用商店
- 酷安

桌面端：

- Microsoft Store

 安装包

- B3log
- GitHub

 包管理器

 siyuan



 siyuan-note



 Docker 部署


Docker 部署文档

 概述

在服务器上伺服思源最简单的方案是通过 Docker 部署。

- 镜像名称 b3log/siyuan
- 镜像地址

 文件结构

整体程序位于 /opt/siyuan/ 下，基本上就是 Electron 安装包 resources 文件夹下的结构：

- appearance：图标、主题、多语言
- guide：帮助文档
- stage：界面和静态资源
- kernel：内核程序

 启动入口

入口点在构建 Docker 镜像时设置：ENTRYPOINT ["/opt/siyuan/entrypoint.sh"]。该脚本允许更改将在容器内运行的用户的 PUID 和 PGID。这对于解决从主机挂载目录时的权限问题尤为重要。PUID 和 PGID 可以作为环境变量传递，这样在访问主机挂载的目录时就能更容易地确保正确的权限。

使用 docker run b3log/siyuan 运行容器时，请指定以

Top issues

Latest release

Upgrade notice

Document titles can now include /. Use the new version to open and edit these documents. We recommend updating the devices that access the same data and checking that your plugins are compatible, to avoid older versions overwriting your changes. See the compatibility details.

 Overview

This release adds support for / in document titles and improves mind maps, database automations, mobile editing, and file change detection.

 Mind maps and editing

Mind maps gain themes, global styling, node selection and clipboard operations, improved summaries, and list-style editi