新版数据仓库的同步使用参考（新手向）
省流版
按需阅读，使用右侧大纲进行跳转：
第一次使用思源的数据仓库同步
直接去设置关于里初始化数据仓库密匙，然后开启云端同步即可，细节参考下面的“初次使用数据仓库进行同步的流程”部分。
因为云端同步出错想重新配置
按照以下流程操作即可
- 所有设备暂停同步（不暂停加密的数据会自动上传，换云端目录配置新密匙就无意义了）
- 所有设备的思源更新到最新版
- 设置——导出里导出 data 压缩包
- 复制备份密钥字符串，重置所有设备的数据仓库并重新导入密钥
- 用新名称新建云端同步目录，并切换到新目录同步
细节请看下面的“遇到同步错误的解决方法”部分。
同步后发现由内容丢失：
通过数据快照和文件历史进行恢复，详情请看本文“数据快照”和“文件历史”这部分。
PS：如果你是旧版用户，升级后发现云端不显示旧版数据，是因为新版已经完全不支持旧版同步机制了，旧版数据如果需要导出请用 v2.0.25 之前的版本。另外，旧版数据目前暂定保留到月底，如果需要请尽快导出下载。
初次使用数据仓库进行同步的流程
生成密匙
初次使用数据仓库同步需要去主力设备（数据最完整的设备）的 设置——关于——中初始化数据仓库密匙。
（设置在左上角，快捷键是 Alt+P）
我们在这步需要生成自己的密匙给数据加密，这样即使笔记上传到云端也是加密状态，完全杜绝了除你之外的人看到你的笔记。
可以看到这里有三个按钮：
导入密匙：在这里可将其他设备上的密钥字符串复制到此粘贴导入，如果你是初次同步，主设备不需要导入密匙。
自动生成密匙：是使用随机数生成密钥，生成后需要复制密匙粘贴到其它设备。（随机生成的密匙要保存好）
通过密码生成密钥：使用你自己设定的密码来生成密匙，这样每个设备只需要输入“密码”即可，即使忘了自己设定的密码，也可以将密匙复制出来。（这种方式要比自动生成密匙好保存，缺点是，如果你输错密码导致同步失败，会无法定位究竟是官方同步系统出错，还是你自己操作失误导致出错）
启用云端同步
生成好密匙后，如果你是自动生成的密匙，需要复制密匙导入其它端。固定密码则不需要导入，需要在其他端输入你自己设定的密码生成密匙。
之后去设置——云端 启用同步，设定下同步模式，手动点下左上角的同步按钮（默认快捷键 F9，可以在设置——快捷键——通用里更改）即可。
PS：如果是初次使用数据仓库同步，默认会生成一个云端同步目录 main
PS2：同步模式如果选择了手动同步，睡眠或关机等突然断网的情况下不会触发同步，关机前（比如下班的时候）请手动点击同步按钮进行同步
数据快照
数据快照对我们有什么作用？
数据快照会按文件分块、加密并压缩保存在本地，我们进行云端同步时，需要用到数据快照。
我们可以拿它做什么？
数据快照除了可以进行云端同步外，我们还可以拿来当本地备份和云端备份（即使不使用官方同步），以及使用标记实现上传数据进行单方向覆盖（应该有人会有这种需求）。
在我们配置好数据仓库密匙后，会在数据历史中自动生成一次数据快照，每次同步完成、同步合并也会自动生成次快照，同样可以手动创建数据快照。
在进行同步后如果发现有部分内容丢失，可以去数据快照里进行回滚，确认回滚的话将使用快照数据完全替换现有数据。
查看方法：
左上角点击数据历史（快捷键 Alt+H）
在数据历史界面找到数据快照页签
在这里我们可以看到第一次配置密匙后自动生成的快照，鼠标放上去会有“标记”和“回滚”这两个按钮。
在快照时间列表条目右侧都有一个回滚按钮，点击以后将弹出确认对话框，如果确认回滚的话将使用快照数据完全替换现有数据。
而在“本地快照”里标记的数据快照会进入“本地标记的快照”。
在本地标记的快照里，我们可以点击“上传”按钮将快照上传到云端作为云端备份使用，这也意味着我们可以使用标记这个功能，将数据单方向上传，再用其它设备手动下载标记好的数据进行覆盖（使用场景多为冲突文件很多时，不想进行数据合并）。
清理数据快照和忽略文件等功能详述请看官方的内置帮助文档（界面右下角，每次更新都可以重新打开次，会随着更新）。
文件历史
文件历史是什么？
文件历史是思源里用来进行回滚操作的数据。
我们可以拿文件历史做什么？
文件历史是在误操作后拿来回滚数据的，文件历史具体的生成规则请搜索内置帮助文档“文件历史生成规则”。
它跟同步有什么关系？
云端同步时，遇到无冲突的文件，会在云端自动合并。
遇到冲突文件时，同步后本地被云端覆盖的数据会生成历史，这时候的覆盖目前（2022.7.22）是没有提示的，所以就需要我们去数据历史（ALT+H）里手动解决冲突，大部分老铁用了新版同步后发现自己的笔记少了点内容，多是因为这个原因。
遇到冲突文件时，同步后本地被云端覆盖的数据会生成历史，生成历史的同时也会在同级目录下生成该文档的副本（以 (Conflicted 2006-01-02 15:04:05) 作为文档名后缀），以方便后续手动编辑合并冲突。
可以按 ALT+H 打开数据历史界面恢复，也可以手动编辑生成的副本文档块合并冲突。
遇到同步错误的解决方法
近期（指 2022.7.21 前后）使用官方同步遇到以下同步失败：
- 云端数据已经损坏（cloud object not found）
- 数据仓库因为外部变更损坏
都可以通过重新设置云端同步来解决（桌面端卸载重装不会删配置文件的，没什么用）。具体操作如下（一定要每步操作都执行）：
-
所有设备暂停同步（在设置——云端里禁用）
-
所有设备更新到最新版思源，并备份工作空间目录下 data 文件夹数据（设置——导出里导出 data 压缩包）
-
复制备份主力设备（指数据最完整的设备）的密钥字符串，如果是用自己密码生成的密匙，则略过这步
-
重置所有设备的数据仓库（设置——关于——重置数据仓库）
-
在所有设备重新导入密匙（或者输入你自己设定的密码生成密匙）
-
在设置——云端里添加新的云端同步目录，并切换到新目录同步（重点，需要新建个之前未用过的名称，因为旧的云端目录出错后不能同步，点删除云端目录时云端删数据会较慢，有概率没删干净，所以最好用新名建个新目录）
-
在主力设备启用云端同步，点击同步上传
-
其它设备也要在云端里选择新目录进行同步
欢迎来到这里！
我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。
注册 关于