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

本贴最后更新于 508 天前,其中的信息可能已经时过境迁

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

image.png

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

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

image.png

data 文件夹

image.png

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

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

笔记本和笔记

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

image.png

image.png

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

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

history 文件夹

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

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

根据官方帮助文档,操作类型有:

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

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

image.png

repo 文件夹

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

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

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

temp 文件夹

image.png

temp 文件夹主要内容如下:

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

conf 文件夹

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

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

appearance 文件夹内容如下图:

image.png

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

    思源笔记是一款隐私优先的个人知识管理系统,支持完全离线使用,同时也支持端到端加密同步。

    融合块、大纲和双向链接,重构你的思维。

    18130 引用 • 66884 回帖
3 操作
qiancang 在 2022-11-06 18:19:47 更新了该帖
qiancang 在 2022-11-06 17:59:10 更新了该帖
qiancang 在 2022-11-06 17:49:05 更新了该帖

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
请输入回帖内容 ...