数据历史

概述

• 文件历史：按原始文件方式保存在 工作空间/history/ 文件夹下，人类可读，可手动拷贝到 data 对应位置恢复

• 数据快照：按文件分块、加密并压缩保存在 工作空间/repo/ 文件夹下，人类不可读，无法手动恢复

文件历史

文件历史生成规则

• 每隔 10 分钟会对这 10 分钟内更新过的文档生成历史（间隔时间可通过 设置 → 编辑器 → 历史生成间隔 进行调整），历史文件夹后缀为 -update

• 云端同步时，本地被云端覆盖的数据会生成历史，历史文件夹后缀为 -sync

• 手动删除笔记本、文档和资源文件时会生成历史，历史文件夹后缀为 -delete

• 使用清理未引用资源时会生成历史，历史文件夹后缀为 -clean

• 使用优化排版时会生成历史，历史文件夹后缀为 -format

• 使用 搜索替换 时会生成历史，历史文件夹后缀为 -replace

• 在大纲面板拖拽大纲项目时会生成历史，历史文件夹后缀为 -outline

浏览文件历史

• 点击顶部工具栏 数据历史 按钮或者 Alt+H 可打开数据历史界面，切换到 文件历史 页签，如果没有历史数据显示，可以试下该界面的 重建索引

• 在文件系统 工作空间/history/ 文件夹下浏览

通过文件历史回滚

• 笔记本删除：2022-05-01-091021-delete/20210808180117-czj9bvb/，即 历史生成日期-{操作}/{笔记本 ID}/

• 文档删除：2022-05-01-091209-delete/20210808180117-czj9bvb/20200812220555-lj3enxa.sy，即 历史生成日期-{操作}/{笔记本 ID}/{文档路径}

• 资源文件清理：2022-05-01-095621-clean/assets/image-20220501091157-qccp87e.png，即 历史生成日期-{操作}/assets/{资源文件名}

1. 退出思源，然后全量复制备份一下整个工作空间，避免后续误操作导致数据丢失

2. 进入 工作空间/history/ 文件夹，将 历史生成日期-{操作} 文件夹下的数据直接复制到 data 文件夹进行覆盖

3. 启动思源后手动执行重建索引

清理文件历史

数据快照

初始化密钥

• 导入密钥：将其他设备上的密钥字符串复制到此粘贴导入

• 自动生成密钥：使用随机数生成密钥，该方式只需在一台设备上执行一次，其他设备使用
导入密钥

• 通过密码生成密钥：使用自定义的密码短语生成密钥，该方式需要在所有设备上都使用相同的密码短语

创建数据快照

1. 点击顶部工具栏 数据历史 按钮或者 Alt+H 可打开数据历史界面

2. 切换到最后一个页签 数据快照

3. 点击 创建快照，填写 备注 并确认
 

浏览数据快照

回滚数据快照

清理数据快照

• 设置 - 关于 - 数据仓库清理 将删除所有未引用的快照和相关数据对象。“引用的快照”指的是 repo/refs/ 下指向的快照：
• ​latest​ 指向最新一个快照
• ​tags/*​ 指向手动标记的快照

• 手动删除 工作空间/repo/​​ 文件夹可以清空全部数据快照

忽略文件

• 20210808180117-6v0mkxr/**/*： 忽略 data/20210808180117-6v0mkxr 笔记本

• assets/*.pdf：忽略 data/assets/ 下的 PDF 文件