缓解数据焦虑，思源笔记文件存储介绍

思源笔记的用户数据都存储在工作空间下，可以通过 设置 → 关于 → 工作空间目录 进行设置。

下图是工作空间内的文件夹结构：

• conf。config 文件夹，也就是配置文件夹，设置页面里的配置信息都存在这里，下载的主题在里面。
• data。数据文件夹，最重要的文件夹，你的笔记都在里面。
• history。文件历史记录文件夹。
• repo。数据快照文件夹。
• temp。临时文件夹，主要是索引文件、升级安装文件之类的。

data 文件夹

先介绍最重要的 data 文件夹。

• .siyuan。里面只有一个 syncignore 文件，如果需要在创建快照时忽略一些文件，可以通过这个文件进行配置。
• assets。附件文件夹，插入到笔记的图片、PDF 等附件都在里面。
• emojis。自定义 emojis 表情包，在笔记中输入 /EMOJI 可以插入表情。把表情放到这个文件夹后，到 设置 → 外观 → 添加自定义表情 里刷新一下。
• snippets。代码片段文件夹，设置 → 外观 → 代码片段 的数据保存在这里。
• storage。保存当前工作空间一些信息，比如主题开关状态、搜索历史记录等。
• templates。模板文件夹，从 设置 → 集市 → 模板 页面下载的模板保存在这里。可以到里面修改下载的模板，也可以自己写了模板放进去。
• widgets。挂件文件夹，从 设置 → 集市 → 挂件 页面下载的模板保存在这里。
• 笔记本。上图框起来的部分就是笔记本文件夹，我总共有 7 个笔记本，所以有 7 个文件夹。

笔记本和笔记

思源的笔记文件是以 id 进行命名存储的，也就是 14 位日期时间数字-7 位随机字母数字，笔记本文件夹可以和笔记本一一对应起来。

进入《思源笔记用户指南》笔记本对应的文件夹，结构如上图。

思源的笔记文件是 .sy 格式的（内部以 json 格式保存），每个 .sy 文件都对应一篇文档。《请从这里开始》有子文档，所以有个同名的文件夹，文件夹里存放子文档。

history 文件夹

保存了笔记的文件历史，明文保存，人类可读。

里面有很多的文件夹，命名方式为：操作时间-操作类型。

根据官方帮助文档，操作类型有：

• update。思源每隔 10 分钟会对这 10 分钟内更新过的文档生成历史（间隔时间可通过 设置 → 编辑器 → 历史生成间隔 进行调整），历史文件夹后缀为 update。
• sync。云端同步时，本地被云端覆盖的数据会生成历史，历史文件夹后缀为 sync。
  当你同步回来的数据比本地的数据更旧的话，可以从 alt+h 文件历史界面恢复，也可以从 history 文件夹下找对应时间点的 sync 文件夹手动恢复本地数据。
• delete。手动删除笔记本、文档和资源文件时会生成历史，历史文件夹后缀为 delete。
• clean。用清理未引用资源时会生成历史，历史文件夹后缀为 clean。
• format。使用 优化排版 功能时会生成历史，历史文件夹后缀为 format。

下图是 20221030122740-qvuo2en.sy 文档每隔 10 分钟自动保存的历史记录文件。

repo 文件夹

数据快照文件夹。数据快照是按文件分块、加密并压缩保存的，人类不可读，无法手动恢复。

数据快照除了用于本地数据历史，还用于云端数据同步。

数据快照的相关说明详见官方帮助文档的《数据历史》文档。

temp 文件夹

temp 文件夹主要内容如下：

• install。自动下载的升级安装包。
• os。
• pandoc。导出文档时用于转换格式的 pandoc 程序。
• repo。
• blocktree.msgpack。里面应该是保存了块的层级关系？
• history.db。历史数据库。
• siyuan.db。笔记数据库，重建索引时会生成这个文件。
• siyuan.log。思源运行日志。

conf 文件夹

配置文件夹。主要是 conf.json 文件和 appearance 文件夹。

conf.json 文件保存的是设置页面的具体配置。

appearance 文件夹内容如下图：

• boot。启动界面用到的资源。
• emojis。自带 emoji 表情。
• icons。按钮图标。从 设置 → 集市 → 图标 下载的图标保存在这里。
• langs。语言文件。
• themes。主题文件，从设置 → 集市 → 主题 下载的主题保存在这里。