# 常见问题

## 思源是如何存储数据的？

数据保存在工作空间[^1]文件夹下，在工作空间/data/ 文件夹下：

- ​`assets`​ 用于保存所有插入的资源文件[^2]
- ​`emojis`​ 用于保存自定义图标表情图片
- ​`snippets`​ 用于保存代码片段
- ​`storage`​ 用于保存查询条件、布局和闪卡[^4]数据等
- ​`templates`​ 用于保存模板片段[^5]
- ​`widgets`​ 用于保存挂件[^6]
- ​`plugins`​ 用于保存插件[^7]
- ​`public`​ 用于保存公开的数据
- 其余文件夹就是用户自己创建的笔记本文件夹，笔记本文件夹下 `.sy`​​​​ 后缀的文件用于保存文档数据，数据格式为 JSON

## 支持通过第三方同步盘进行数据同步吗？

不支持通过第三方同步盘进行数据同步，否则可能会导致数据损坏。虽然不支持第三方同步盘，但是支持对接第三方云端存储[^8]。

另外，也可以考虑手动导出导入 Data 实现数据同步：

- 桌面端：

设置

​ -

导出

​ -

导出 Data

​ /

导入 Data

​
- 移动端：

右侧栏

​ -

关于

​ -

导出 Data

​ /

导入 Data

​

在 macOS 上思源会访问桌面、文稿和 iCloud 云盘文件夹，目的是为了检测工作空间是否放置在 iCloud 同步路径下，思源绝不会窥探你的个人数据，请放心。

## 思源是开源的吗？

思源笔记是完全开源的，在 GitHub 上可以找到完整的源代码。

## 如何升级到新版本？

- 如果是通过应用商店安装的，请通过应用商店更新
- 如果是桌面端通过安装包安装的，可打开

设置

-

关于

-

自动下载更新安装包

选项，这样思源会自动下载最新版安装包并提示安装
- 如果是通过手动安装包安装的，请再次下载安装包安装

可在

设置

​ -

关于

​ -

当前版本

​ 中

检查更新

​，也可以通过关注[官方网站](https://b3log.org/siyuan/)来获取新版本。

## 有的块（比如在列表项中的段落块）找不到块标怎么办？

在列表项下的第一个子块是省略块标的。可以将光标移到这个块中，然后通过

Ctrl+/

触发它的块标菜单。

## 数据仓库密钥遗失怎么办？

- 如果之前在多个设备上正确初始化过数据仓库密钥的话，那么该密钥在所有设备上都是相同的，可以在

设置

-

关于

-

数据仓库密钥

-

复制密钥字符串

找回
- 如果之前没有正确配置（比如多个设备上密钥不一致）或者所有设备均不可用，已经无法获得密钥字符串，则可通过如下步骤重置密钥：

1. 手动备份好数据，可通过

导出 Data

​ 或者直接在文件系统上复制 `工作空间/data/`​ 文件夹
2.

设置

-

关于

-

数据仓库密钥

-

重置数据仓库

3. 重新初始化数据仓库密钥，在一台设备上初始化密钥以后，其他设备导入密钥
4. 云端使用新的同步目录，旧的同步目录已经无法使用，可以删除
5. 已有的云端快照已经无法使用，可以删除

## 使用需要付费吗？

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

会员特权[^10]需要付费后才能使用，请参考[定价](https://b3log.org/siyuan/pricing.html)。

如果你没有会员特权需求但又想支持开发，欢迎进行捐赠：[靠爱发电 - 链滴](https://ld246.com/sponsor)

## “思源”命名的由来

思源这个名字取自中国古代成语“饮水思源”，其字面意思是“喝水的时候，要想到水是从哪里来的”，比喻不忘本、知感恩。

我们希望用户在使用思源笔记进行知识管理的时候不要忘记知识的出处和关联，更重要的是不要忘记通过自己的所学回报社会，回报全人类。

[^1]: # 工作空间

## 概述

工作空间用于保存数据、历史、配置和运行时所需要的文件。

- 不同工作空间通过文件系统文件夹相互隔离
- 一个工作空间只能被一个内核进程伺服

## 切换工作空间

- 桌面端可以在顶栏左侧下拉菜单中打开多个工作空间

如果你的多个工作空间需要经常启动，可以考虑为每个工作空间创建不同的启动入口并指定启动参数 `--workspace="工作空间绝对路径"`​（请使用 `"`​ 将路径包裹起来）。比如 Windows 系统上可以复制多个快捷方式，并在每个快捷方式 - 属性 - 目标后跟随工作空间路径参数，例如 `--workspace="F:\SiYuan"`​。除此以外，还可以通过 `--port=12345`​ 来指定内核监听的端口。
- 移动端可以在右侧栏

关于

​​ 中切换不同的工作空间

## 文件系统结构

文件系统上工作空间下的结构：

- ​`conf`​ 用于保存工作空间配置
- ​`corrupted`​ 用于保存已经损坏的数据文件
- ​`data`​ 用于保存数据，具体结构请参考[这里](#20210428213927-rbcfx2y)
- ​`history`​ 用于保存文件历史
- ​`repo`​ 用于保存数据仓库数据
- ​`temp`​ 用于保存运行时所需的临时文件
- ​`.lock`​ 内核进程启动后会创建该文件，用于锁定工作空间

[^2]: # 资源文件

## 概述

通过编辑器插入的附件会被认为是资源文件，默认放置在 `工作空间/data/assets/` 文件夹下。

## 插入图片或文件

在编辑器中可以直接粘贴系统剪切板中复制好的图片或文件（Linux 端不支持），或者通过拖拽图片或文件到编辑器中也可以实现插入。插入时有两个选择：

- 复制为资源文件并插入：将图片或文件复制为资源文件并插入，快捷键

Ctrl

​+

V

​
- 使用 `file://`​ 绝对路径并链接：将图片或文件以本地绝对路径方式插入超链接，快捷键

Ctrl

​+

Shift

​+

V

​，或者按住

Alt

​ 后拖入

对于图片，如果排版时指定了图片标题，则标题会被渲染在图片下方作为图注。

![siyuan-128.png](assets/siyuan-128-20210604092205-djd749a.png "源于思考，饮水思源")

​#注意#​：插入图片不会进行压缩处理，所有图片和文件都以原始数据进行保存。

## 清理未引用资源

“引用”指的是通过超链接、插入图片或者 HTML 标签（例如 `` 、`