思源笔记简易指北

001 - 思源笔记本地优先的数据储存方案

知识库路径

思源笔记与其他本地优先的笔记软件类似,Obsidian、Logseq、(TiddlyWiki的社区客户端)Tidgi类似,将应用程序和您的知识库放在不同的磁盘路径下。

  • 电脑端中,你可以自行创建多个知识库并分别设置对应的路径,但是一定一定不要把知识库放到应用程序的安装目录下
  • 但是在移动端,思源笔记目前是将数据放在应用程序的Data目录下的,卸载应用会同步移除知识库。

知识库与文件夹中对应的结构

思源会按照文档树的结构将笔记文件储存在磁盘中,不过文件名称为文档ID而非文档名。

这带来了一些不便

  • 想在不开启思源的情况下打开笔记文件不是很方便

但也带来了很多好处

  • 保证文件历史的唯一
  • 修改上级文档的名称不会导致下级文档的路径、索引全部修改。

另外,思源中任意文档都可以是文件夹,当新建子文档后,磁盘中会自动创建一个同文档ID的文件夹。

工作空间的结构

工作空间的目录结构思源的目录结构非常明确

  • conf 主题等配置文件

  • history 文件历史,单一文件的文件历史

  • repo 数据快照,允许思源按照时间线对整个工作空间进行回滚

  • temp 临时文件

  • data 工作空间

    • 20240519003228-3xmludz 这种ID的文件夹中的放的是.sy笔记文件,按照文档树的层级进行嵌套。使用ID对真实文件进行命名:
    • .siyuan 搜索等功能的忽略文件
    • storage 用于保存查询条件、布局和闪卡数据等
    • assets 用于保存所有插入的资源文件
    • emojis 自定义表情包
    • snippets 代码片段
    • templates 用于保存模板片段
    • widgets 用于保存挂件
    • plugins 用于保存插件
    • public 用于保存公开的数据