同步

在多台设备之间同步文献库和工作区。数据默认先在本机加密再上传，并配有恢复码；同步到哪里由您选：CiteDesk 同步服务，或您自己的 S3 兼容存储、WebDAV。同步设置在 设置 > 同步 页（账户 页最下面一行显示当前的同步状态，点 同步设置… 也能进来）。

页面最上面是状态卡：空间名、存在哪里、加密方式、当前状态和 立即同步、暂停，有冲突时还有 解决冲突…；恢复码没确认保存、文件有问题、转移还没结束这类需要您处理的事项，以横幅出现在状态卡下面。再往下是三组：这台设备（工作区、文件同步、自动同步、同步范围）、安全（恢复码、设备；只有端到端加密的空间有）、存储与历史（用量与诊断、版本历史与清理）。最底下的 高级（转移、断开同步、重置本机同步凭据）可以折叠，默认收起；转移还没结束或本机的钥匙读不出来时会自动展开。下文说到的按钮都在这些组里。

同步什么#

会同步的：

• 文献库：文献、笔记、附件（包括存进文献库的附件文件）、批注、分类、已保存搜索、标签颜色，以及附件的最后阅读时间。
• 工作区：已加入同步的工作区里的 Markdown 文件和资源文件。本机仍是普通的 Markdown 文件，可以照常用别的程序打开。

不会同步的：应用设置、窗口布局、本机路径、登录和存储凭据、Cookie、代理设置、撤稿名单、全文索引、阅读位置，以及您导入的 CSL 样式。链接到本机其他位置的附件文件也不上传，其他设备上只能看到它的链接信息。

几点需要先知道：

• 一个同步空间对应一个文献库，外加若干个工作区。工作区要逐个加入，见工作区。
• 两边同时改了同一处、无法自动合并时，从不按时间先后决定谁胜出，而是保留两份，等您来选，见冲突。
• 这套同步是 CiteDesk 自己的，不与 Zotero 的同步服务互通。与 Zotero 交换数据请用导入和导出，见导入与导出。
• 没有网络时照常使用。改动保存在本机，连上之后自动同步。

选择存储位置#

在「同步空间」里先选同步方式，再点 连接并检查（自带存储是 验证服务器）。

• CiteDesk 同步服务：使用 设置 > 账户 页登录的账户，不需要填写存储信息。未登录时不能连接。
• S3 兼容存储：填写服务端点、区域、存储桶、访问密钥 ID 和秘密访问密钥。会话令牌只有临时凭据才需要。前缀可以不填，填了就必须是专用的空位置。部分自建服务（例如 MinIO）需要打开 路径式访问。
• WebDAV：填写网址、用户名和密码。

自带存储的要求：

• 网址只支持 https，且不能带用户名、密码、查询串或片段。
• 位置必须专用且为空。同步空间在里面保存自己格式的数据，不是能被别的程序直接编辑的普通文件夹。
• 存储必须支持条件写入（仅在不存在时创建、仅在版本未变时替换），并且有强版本标识（ETag）、写入后立即可读。检查时会列出每一项是否支持，并临时写入几个测试对象，之后清理掉；清理不掉时会提示您手工删除以 .probe- 开头的目录。检查不通过的存储不能使用：CiteDesk 不会退而求其次改成直接覆盖，那样两台设备会互相覆盖对方的改动。

凭据只保存在本机，存在应用配置目录里只有您本人可读写的文件中，按账户页 本机凭据的保存方式 的选择存成明文或用系统钥匙串加密。写不进这份文件时，退出应用后需要重新输入。存储拒绝了保存的凭据，或本机没有凭据时，同步停下并显示 重新输入凭据…。位置必须和已绑定的相同，要换位置请用转移。窗口里不是秘密的各栏（服务端点、区域、存储桶、前缀、网址等）已预填为原来绑定的值，只需重新输入秘密部分。保存的凭据或密钥读不出来（例如那份文件损坏，或系统钥匙串里没有对应的钥匙）时，可以 重置本机同步凭据…，再重新输入凭据或用恢复码取回密钥。这不影响远端，也不影响本机文献库。

新建空间和加入空间#

检查通过后，选择新建一个空间，或加入已有的空间。

新建空间。起一个名字，用来在多台设备上辨认它。保护方式有三种：

• 端到端加密（默认）：内容在本机加密之后才上传，存储服务提供方和任何能访问那个位置的人都读不到。创建后会显示恢复码，见恢复码。使用 CiteDesk 同步服务时，服务器为了自己执行保留期，看得到版本的数量、写入时间和对象大小，看不到内容，见保留历史。
• 由 CiteDesk 保管钥匙（只有 CiteDesk 同步服务提供）：内容同样在本机加密，但同步服务器另存一份钥匙，所以服务器的运营方在技术上能解开其中的全部资料。好处是丢了恢复码也能找回，见由 CiteDesk 保管钥匙。
• 不加密：文献、笔记、批注、分类、标签和库内附件会以明文保存在所选位置。

保护方式在创建时定下，之后不能就地更改，要改只能转移到新的空间。

加入空间。在新设备上选择同一个存储位置，选中已有的空间，然后任选一种方式拿到钥匙（不加密的空间不需要，但加入后本机的改动会以明文上传）：

• 输入恢复码，见恢复码；
• 由已经加入这个空间的另一台设备批准，见批准新设备；
• 由 CiteDesk 保管钥匙的空间，还可以在浏览器里批准后从服务器取回，见由 CiteDesk 保管钥匙。

加入已有空间要求本机文献库是空的：没有文献、笔记、附件、批注、分类、搜索和彩色标签。两份各有内容的库不会自动合并，也不会互相覆盖，而是直接拒绝。本机已有资料时，请先导出，再用全新的数据目录加入，见数据目录与备份。

恢复码#

恢复码用来在新设备上加入加密的空间，也用来在这台设备的密钥丢失后取回数据。

• 创建空间后，恢复码显示在一个窗口里，只显示这一次。请抄在纸上，或存进密码管理器，不要存放在这个同步空间里。复制恢复码 可以把它放进剪贴板。
• 勾选 我已把恢复码保存在安全的地方，再点 确认已保存，创建才算完成。点窗口外面或按 Esc 不会关闭这个窗口，因为关掉就看不到这份码了。如果用关闭键离开而没有确认，设置页会提示恢复码尚未确认保存，您可以重新生成一份，或取消创建。
• CiteDesk 和同步服务器都不保存恢复码。恢复码丢了，又没有任何一台已授权的设备时，远端的数据无法恢复，后果由您自己承担。
• 输入恢复码时，空格和连字符会被忽略。连续输错会被暂时限制尝试。
• 这台设备的密钥读不出来时（新设备，或本机保存的密钥损坏、被重置），同步显示 需要恢复码，在同步设置里输入恢复码并点 解锁，同步就继续，本机数据不会丢失。也可以改由另一台设备批准，见批准新设备。
• 导出恢复资料…：在恢复码窗口里，以及核对成功之后，可以把空间名、恢复码和用法说明存成一份文本文件。这份文件是明文的，它与存储位置的访问权限加在一起，就能读取全部同步资料，请像保管恢复码一样保管它，不要放进同步空间或网盘。

丢了恢复码，但还有一台已授权的设备时，在那台设备上用 重新生成恢复码… 得到新的一份。重新生成只换以后使用的恢复码：新设备加入要用新的恢复码，旧恢复码不能再用来加入；但这不是撤销，拿着旧恢复码和旧资料副本的人仍可能解开同一把密钥。要让泄露的旧恢复码彻底失效，只能在转移时选择 更换主密钥，见转移。

核对恢复码#

隔了一阵子，您可能不确定手里那份恢复码还对不对。在设置窗「同步」页的 安全 组里选 核对恢复码…，输入恢复码：对上了就记下核对的时刻；对不上，说明它不是当前有效的恢复码，请找回正确的，或在还有已授权设备时 重新生成恢复码…。核对不启用任何东西，也不改变同步的状态。同一组里常驻一行 上次核对恢复码，写着距今几天。

文献库页顶上会按下面的节奏出现一条提醒：确认保存之后第 14 天、第 90 天，之后每 180 天一次；每核对成功一次，就从那一刻重新计时。提醒上点 稍后提醒 或关闭键，7 天后再提醒。提醒只记在这台设备上，每台设备各提醒各的；写作窗口不打扰。由 CiteDesk 保管钥匙的空间和不加密的空间不提醒。

批准新设备#

新设备不必输入恢复码，也可以由一台已经加入这个空间、并且已解开密钥的设备批准。

1. 在新设备上选中这个空间，点 由另一台设备批准…。窗口里显示一个配对码（形如 XXXX-XXXX-XXXXX）和倒计时。
2. 在旧设备上打开设置窗「同步」页，点 批准新设备…，输入新设备屏幕上的配对码。
3. 应用会弹出确认窗，列出新设备的名字、系统、CiteDesk 版本和请求时刻。这些信息是那台设备自己报告的，只供辨认，真正把两台设备连起来的是您亲手抄过去的配对码。确认是您正在操作的那一台，再点 批准。

要点：

• 配对码 10 分钟有效，只能用一次。过期了或想换一个，在新设备上重新开始即可。配对码只在新设备的屏幕上，不会经过网络。
• 在旧设备上连续输错多次会被暂停一段时间（10 分钟内输错 5 次，暂停 10 分钟）。
• 批准之后，那台设备拿到这个空间的钥匙，能读取和修改其中的全部资料。批准出去的钥匙收不回来，已经下载到那台设备上的资料也收不回来。要让它以后读不到、写不进，需要在存储方或用户中心里撤掉它的访问权限（有一段延迟），并通过转移带新主密钥更换密钥。
• 这台设备批准过哪些设备，在同步设置里列着（设备自报的名字和时间）。CiteDesk 不在远端保存设备名单，也没有远端的「撤销」按钮：名单只能是各设备自报的，删掉一行并不能撤回它手里的钥匙。
• 本机已绑定、但密钥不可用的设备，同样可以用这个办法解锁。

由 CiteDesk 保管钥匙#

这是建空间时可以选的一种保护方式，只有 CiteDesk 同步服务提供。

• 内容仍在本机加密后才上传，但同步服务器另存一份钥匙。所以服务器的运营方在技术上能解开这个空间里的全部资料，这一点必须知情；服务器只在您批准取回时才把钥匙交出去，自己不会拿它去解任何内容。
• 好处：丢了恢复码、又没有别的已授权设备时，仍能找回。端到端加密的空间在这种情形下无法找回。
• 创建之前，账户必须已经在用户中心里绑定了认证器。创建时仍会生成恢复码，可以不勾选「已保存」直接完成，它是服务不可用时的后备。
• 取回钥匙：在新设备（或密钥不可用的设备）上选 从 CiteDesk 取回钥匙…。应用会用系统浏览器打开用户中心的批准页，窗口里显示一个核对码（形如 XXXX-XXXX）。在浏览器里登录，用密码和认证器验证，输入窗口里的核对码，再点批准；回到应用，钥匙就自动取回。批准时的验证只在 15 分钟内有效；每个账户每天最多取回 10 次。
• 用户中心的同步空间页列出每个空间的保护方式和钥匙取回记录（时间、设备名、结果）。
• 保护方式在创建时定下，之后不能就地更改。端到端加密的空间可以转移成托管；托管改成端到端加密必须同时更换主密钥，因为服务器已经知道旧钥匙。

工作区#

同步工作区里的 Markdown 文件和资源文件。

• 同步当前工作区…：给这个工作区起个名字，用来在其他设备上辨认它，然后把它加入同步。
• 拉取…：在另一台设备上，从远端已有的工作区里挑一个，下载到本机的一个文件夹里。
• 停止同步：把这个工作区移出同步。本机的文件不动。

一次只同步当前打开的那个工作区。已加入同步、但没有打开的工作区，远端的改动会先留着，等它打开时再应用。文献库则始终同步。工作区的绑定记在本机：如果本机的文件夹被改名、挪走，或不是原来的那一个，同步会停下，请重新选定文件夹并确认它就是这个工作区。

设置页的 同步范围 表按范围（文献库和每个工作区）列出：待上传、待应用、文件、冲突各有几项，以及上次同步的时间。同步时因路径不合法等原因被跳过的文件，列在表的下面。

文献 ID 被改名时#

Markdown 里的引用标记写的是文献 ID。别的设备改了某条文献的 ID，同步到这台设备之后，当前工作区的文档里可能仍有写着旧 ID 的引用标记。同步不会擅自改您的文档，而是给出改写建议，由您确认。

• 写作侧栏的「引用」页顶部会出现一条提示：同步发现一些文献的 ID 改了：当前工作区里有 N 处引用标记（涉及 M 个文件）仍在用旧 ID，可以改写。点 查看… 打开 引用标记的文献 ID 改写建议 窗口。同步设置里的同名一节列的是同一份建议。
• 窗口里逐条列出文件、旧 ID 和新 ID，勾选要改写的（全选、取消全选），点 应用所选。应用前系统还会再确认一次，只改写列出的位置。
• 找不到对应文献、旧 ID 已被别的文献使用，或历史不明确的，会标出原因，这几条不能应用。

附件文件#

「文件同步」里的 下载文件 决定附件文件什么时候下载到本机：

• 在同步时：附件文件随同步一起下载。
• 在需要时：同步只带元数据，打开附件时才下载文件。

附件文件传输遇到问题会自动重试，不用手动处理。超过同步允许大小的文件会被跳过，其余内容照常同步；存储空间已满时文件暂时上传不了，其余数据照常同步。「用量与诊断」里 查看用量 显示远端用了多少，导出诊断信息… 生成一份可以交给帮助您的人的诊断文件。

对象上的同步标记#

绑定了同步空间之后，文献表标题格的末尾会出现一枚小图标，说明这一行为什么还没有和远端一致；已经一致的行什么也不画。把鼠标停在图标上可以看到文字说明。

选中附件时，右栏的附件信息里有一行 同步，写着同样的说明。文件在远端、还没下载时，这一行有 下载文件 按钮；正在下载时显示进度，并有 取消下载 按钮。链接到本机其他位置的附件，这一行写明同步只带这条链接，不传文件的内容。

同步状态面板和同步按钮的提示里，文件传输期间会显示 正在同步文件，以及上传、下载各有几个文件、已传多少。

版本历史#

每次修改都会留在远端，所以可以回到旧的版本。版本历史需要联网读取远端；端到端加密的空间还要求本机已有密钥。

• 单个对象的版本历史：在文献表里选中一条文献、笔记或附件，右键选择 版本历史…；在左栏的文件列表里右键一个文件，同样选择 版本历史…。窗口左边按时间列出这个对象的每一个版本，写明是本机还是其他设备做的修改、是创建、修改、移入回收站、还原还是永久删除；右边预览所选的版本，并与当前版本对照。勾选 只显示与当前版本不同的内容 时只列有差别的字段（文献、笔记、附件）或有差别的行（文字文件）。复制 把预览的内容放进剪贴板。
• 恢复此版本：把所选的版本写成对象现在的内容。恢复结果会同步到其他设备，现有历史不会被改写或删除，所以恢复之后还能再恢复回去；其他设备同时改了同一处时，照常按冲突处理。选的是最新一版时，窗口会提示已是最新版本。
• 已被永久删除的对象也在版本列表里，最后一版是 永久删除。选更早的一版再点 恢复此版本，对象会以原来的条目键回来，它的关联和附件文件也随之接上；它原来所在的分类也会加回。
• 读不到内容的版本：版本太旧、已按保留期清理，或已被清除时，列表里仍有这一版，但写着 内容不可得；选中它，右边说明是哪一种情形，它不能预览，也不能恢复。一共四种说法：更早的历史已清理（已经超过保留期）；已按清除操作清理（服务器记录这一版是被 清除已删除项的旧内容 清掉的，这是服务器的说法）；历史不可得，并写出这台设备几天前还见到这一版是当前版本（现在读不到；应用不会认定是谁删的，可以导出诊断信息）；历史不可得，无法确认原因和时间（本机没有足够的记录，无法确认内容为什么不可用、是什么时候开始的，例如在新设备上）。
• 已删除的条目：设置窗「同步」页 存储与历史 组里的 查看已删除的条目… 列出被永久删除的对象，可以多选后点 恢复所选。放在回收站里的对象不在这里，请在文献库的回收站中还原。删除之前的内容读不到时，这一行写着原因（同上面四种说法），不能勾选。
• 附件文件：恢复的版本带着另一份文件内容时，会先把那份内容从远端完整取回、验证无误之后才写入；远端缺少其中任何一块时，整次还原什么都不写，并说明哪里缺了。被换下的现有文件保留在数据目录的 sync-recovery 文件夹里。
• 文献 ID：恢复一条文献可能让它的文献 ID 变回旧的，或者因为旧 ID 已被别的文献使用而改用另一个。完成后会列出这些变化；正文里写着旧 ID 的引用会显示缺少文献，可以按文献 ID 被改名时处理。
• 本机或这个对象还有没发出的改动、涉及的对象有未处理的冲突，或者读不到远端时，不能还原；先同步一次再试，窗口会说明原因。
• 版本列表标明每个版本来自 本机 还是 其他设备。转移过后端的空间，转移时带过来的历史照常列出；更早或转移时已读不到的历史留在原来的存放位置，这里读不到，版本列表底下会提示。

回到历史版本#

把整个文献库或整个工作区回到过去某个时刻的状态。设置窗「同步」页 存储与历史 组里选 回到历史版本…，先选范围（有多个时）和时刻，再选还原方式：

• 找回与覆盖（默认）：那时有的内容找回来，改过的恢复成那时的样子；那之后新建的内容一律不动。
• 完全回到那一刻：在上面的基础上，那之后新建的内容也处理掉。文献库里的移入回收站，之后还能还原；工作区里的文件移进系统废纸篓。不直接删除。

选好之后窗口会列出将要覆盖、找回、移入回收站各有几个。点 还原 后应用还会再确认一次，确认后才开始：先取回需要的文件内容，再一次写入并发布。还原结果会同步到其他设备，现有历史不会被改写。要撤回，再打开这个窗口，选还原之前的那个时刻。

时间线上有的时刻标着 不可还原，选中后右边写明原因：含已清除的已删除项旧内容，或依赖的内容已按保留期清理。这样的时刻不会被悄悄跳过，换一个更晚的时刻即可。

这些情形会被提示或跳过，不会擅自处理：工作区里文件的路径现在被别的文件占用时，跳过那个文件，不改名；分类在那时的成员如果已不存在，不会加回；换回旧文件的附件上，那之后新建的批注留着不动，位置可能对不上。最后阅读时间 不还原。还原开始前应用会自动备份文献库。

清理远端未使用的数据#

CiteDesk 同步服务上的空间没有 清理远端未使用的数据 这一项：没有任何版本用到的数据、过期的历史，都由服务器按自己的记录和时钟清理，不需要任何设备在线，见保留历史。这里换成 清除已删除项的旧内容 一行里的 清除…，由您主动腾出空间：

• 它把已经被永久删除的对象的旧版本内容清掉。点下去之后应用先确认一次，写明三件事：这些旧内容不能再在 CiteDesk 里自己还原；内容 14 天后才从服务器彻底删除，这期间只能请运营方放回；与其他内容打包在一起或共享的部分，实际释放空间可能更晚。
• 这是您主动缩短自己的历史，被清除的内容不再受历史保留期的保证。当前数据和已删除对象的记录不受影响：已清除的对象仍列在 已删除的条目 里，但写明内容已按清除操作清理，不能恢复。
• 每个空间每小时只能清除一次。

下面是自带存储（S3 兼容存储、WebDAV）上的 清理远端未使用的数据…。

同步中断、被别的设备取代的发布，会在远端留下没有任何版本用到的数据。设置窗「同步」页 存储与历史 组里选 清理远端未使用的数据…，应用先算出能清理多少，确认之后删除。

• 手动清理孤儿数据时，所有版本历史和已删除对象的记录都保留（这里的清理不同于下面「保留历史」按保留期做的清理），清理只删没有任何版本用到的数据，不影响版本历史和还原。
• 刚产生的数据有 7 天宽限期 不会删；存储方没给出时间的数据也不会删。
• 清理不是自动的，只在您手动选择时进行。「用量与诊断」里的 查看用量 分别列出当前版本占用、仅历史版本占用、可清理的和宽限期内的数据。
• 删除需要存储凭据有删除权限。自带的 S3 兼容存储或 WebDAV 上删掉的数据没有回收站，只能靠存储方自己的版本控制找回，建议先开启。
• 别的设备正在清理，或本机有未完成的发布或转移时，清理会暂缓，稍后再试。

保留历史#

默认每次修改都一直留在远端。设置保留期之后，只保留最近一段时间的版本，更早的会被删除，空间占用不再一直增长。

• 同步服务：保留多久由服务按您的账户等级决定，设置里只显示天数，不能修改。
• 服务器自己执行，不需要任何设备在线：过期和删除完全由服务器按它自己的记录和时钟做，用桌面应用还是用网页都一样，您的设备改不了它，也不必替它做什么。被新版本取代满保留期的旧版本到期；永久删除满保留期的对象，它的旧内容到期。到期后不立即删除，而是先进入 14 天的放回期，这期间只有运营方能放回，期满才彻底删除。当前版本、删除记录和转移留下的存档不会被自动删除。
• 自带存储（S3 兼容存储、WebDAV）：设置窗「同步」页 存储与历史 组里，保留历史 可选 全部保留（默认）或 自定义…，自定义时填天数，不少于 30 天。这一项由整个空间共用，所有设备都按它执行。
• 缩短保留期前会先确认：被删除的旧版本无法还原。延长保留期，或改回全部保留，不需要确认。
• 旧历史被清理后，版本历史里最早的一版写 更早的历史已清理，再往前的版本不能还原。更早之前永久删除的对象仍列在 已删除的条目 里，写明内容已被清理、不能恢复。当前的数据不受影响。
• 回收站和保留期：回收站里的东西默认 30 天后自动永久删除（设置里的回收站自动清空天数，照 Zotero）；永久删除满保留期之后，它的内容才从历史里裁掉。移进回收站只算一次修改，不会因为保留期被删除。保留期只删被新版本取代了的旧版本，此刻存在的数据不删。
• 「用量与诊断」里的 查看用量 写出历史保留的天数，以及 最早可还原到 的日期。
• 官方空间的用量：它是您在官方存储里的全部同步数据，加上还没释放的部分：当前数据、保留期内的历史、存档、放回期里还没删掉的内容、上传中的预留，都算。查看用量 写出 已用 / 上限，其中一小块留给删除操作，普通上传用不到；再按互不重叠的七类列出占用：上传中、等待释放、存档、当前数据、同步记录、历史版本、待清理。分项由服务器隔一段时间计算，可能与总数略有时差，界面会写出计算时刻。与仍在使用的内容打包在一起的旧内容不能单独释放，只计一次，另用一行说明。等待释放的一类另写服务器计划清理的日期（本机时区，只是计划值，服务器暂停清理或清理受阻时不会准时）。
• 空间满了怎么办：超过上限时只拦新的上传，本机照常保存，改动排队等待，已存的数据一个也不删。「存储与历史」里按顺序列出腾出空间的办法，各写明要等什么：等超过保留期的历史由服务器清理；清除已删除项的旧内容（14 天放回期满后释放）；在用户中心删除存档（发起 14 天后释放）；请运营方调整上限；把空间转移到自带存储，再删除官方服务上封存的旧副本（14 天后释放）；注销账户（删除官方服务上的全部同步数据）。
• 服务器因此多知道什么：为了自己执行保留期，CiteDesk 同步服务看得到每一项有几个版本、哪一版取代了哪一版、一项是否已被删除、哪些项在同一次写入里一起改，以及对象的大小、写入和访问的时间。它看不出一项是文献、笔记还是附件，也看不出它们之间的挂靠关系。端到端加密的空间里，文献、笔记、批注的文字，附件文件的内容和文件名，工作区文件的正文和路径，分类名和空间名，服务器都看不到；明文空间和由 CiteDesk 保管钥匙的空间，运营方读得到内容。
• 自带存储的清理在同步空闲时检查，最多每天一次，所以缩短保留期后不会立刻删除。
• 自带存储需要凭据有删除权限；没有时不清理旧历史，并在「用量与诊断」里提示。

同步状态#

文献库的视图头上有一个同步按钮（两个箭头的图标），应用底部的状态栏也有一项「同步: …」。

• 点同步按钮：一切正常时立即同步；有问题、离线或已暂停时打开 同步状态 面板；还没设置时打开同步设置。点状态栏那一项也打开面板。
• 面板里有上次同步的时间、各范围待处理的项数、问题的说明，以及 解决冲突…、立即同步、暂停同步 或 继续同步、打开同步选项。暂停期间的改动保存在本机，继续后上传。

同步设置里有一个 自动同步 勾选框，默认开启。关闭后，本机的改动、定时检查、应用启动和网络恢复都不再自动同步，只在点 立即同步 时才同步；本机的改动照常保存。它与 暂停同步 不同：暂停时连 立即同步 也不运行，正在进行的自动下载也会取消。

常见状态：

同步已停止常见的原因：远端的版本比这台设备见过的更旧（可能被回滚或恢复过备份）；远端出现了两条互不相容的历史；远端的数据格式与本应用不一致；找不到这个同步空间的入口；这个空间已被转移到别处；现在登录的账户和绑定这个空间的账户不同。出现这些情况时请先不要继续写入，按提示核对，需要时导出诊断信息。系统时间与服务器相差太大也会让安全连接失败，请校准系统时间。

冲突#

本机和远端对同一个对象做了无法自动合并的改动时，同步会暂停这一项，等您选择。选定之前，两份内容都保留着，什么都不会丢。在同步状态面板或同步设置里点 解决冲突…，打开冲突窗口。

窗口左边是冲突列表，右边是当前这一项：先说明是哪一类冲突，再把 本机版本、远端版本 和 共同基线（两边各自改动之前共有的版本）并排显示。库里的对象按字段并排：字段冲突可以逐项选择保留哪一边（见下方的逐字段拼合），删除等其他冲突按下面列出的处理方式选择。

可选的处理方式随冲突类型而定：保留本机版本、保留远端版本、逐字段拼合（见下）、保留两份（其中一份改名存放）、采用合并文字（在下面的编辑框里手工合并，可以以本机或远端版本为起点）、恢复对象（撤销删除）、删除对象（接受删除）、重命名本机对象（给本机的对象起新名，两个版本并存）。选好之后点 应用此选择；用 上一项、下一项 切换。

• 会删除对象的选择，会列出受影响的对象，要先勾选确认，再点应用；之后系统还会再确认一次。
• 窗口下方的 对于剩下的所有冲突，都采用本机的版本（或远端的版本）把当前这一项和后面的每一项都按所选的一边处理，只确认一次（项数很多时分批，每批确认一次）。批量删除和无效的远端对象不在其内。做完后窗口会写出 已解决 N 项；确认之后又发生了变化的项没有被动，会标上 已变化，没有动，请重新查看；没有解决的项标上 没有解决，并列出原因。
• 有的冲突牵涉好几条记录，要全部选定之后才会一起应用，窗口会提示还差几条。
• 采用远端的附件版本之前，会把本机这份附件的完整目录原样保留在本机数据目录的恢复文件夹里，不会直接清除。这一项的提示旁有 在访达中显示，可以直接打开那个文件夹。

逐字段拼合。两边改了同一个对象的不同字段、其中有些字段发生冲突时，可以不整边取舍，而是逐字段拼合。选中后窗口下面出现一张表，列出有冲突的字段，以及它们的基线、本机、远端和合并结果。每个字段选 本机 或 远端，默认选本机；文献的顶层字段（题名、日期等）还可以选 改写，直接写一个新值。值不是文字的字段（数字、列表等）要按 JSON 写，例如 3 或 [1,2]，写得不对时不能应用。两边没有冲突的改动在解决时自动照套。拼出的结果不符合文献库的要求时（例如日期或数字的写法不对）不会保存，窗口里写明原因，您填的内容还在，改正有问题的字段或改选一边即可。

待处理的附件文件操作#

改名、重新链接、转存附件文件，把文件挂到附件上，以及同步往工作区写文件，都要同时动文件和文献库。这些操作中途被打断（例如应用崩溃，或别的程序占着文件），没能自动了结时，文献库页顶会出现一条横幅：有 N 项附件文件操作没有完成，点 查看并处理…。

文件没有被删除。从原位置拿开的内容都放在各条给出的恢复目录里。在处理完之前，相关的附件和路径不能再改名、重新链接和转存，其他附件不受影响。

每一条会告诉您文献库里的记录已经改好、还是还没改，列出涉及的路径和恢复目录。每个附件旁有 在访达中显示 显示它的文件；恢复目录旁有 在访达中显示（打开那个文件夹）和 复制路径。可选的办法：

• 重试：再做一次。如果是别的程序占着这些文件，请先让它退出。
• 保留现在的文件：以此刻磁盘上的文件为准，让文献库的记录与它们一致。不一致的旧内容不会被删除，会被挪进恢复目录。
• 恢复到操作之前：把文件和文献库的记录都恢复到这项操作开始之前的样子。做了一半的新内容不会被删除，会被挪进恢复目录。

后两项会先请您确认。窗口里另有一块「同步装附件文件时没有了结的内容」：同步在装附件文件时，发现本机的材料对不上记录（例如外部程序改写了挪开的旧目录），已经把它们原样挪到所给的文件夹，没有删除任何内容。文献库照常使用，需要时点 在访达中显示 打开那个文件夹找回文件。

转移到另一个存储位置#

用 转移到另一个位置… 可以把整个同步空间搬到另一个存储位置，也可以借此在加密和明文之间切换（因为加密方式不能就地更改）。

1. 填写目标位置。目标必须是全新的、专用的空位置，不是空的不能转移。
2. 选择目标的加密方式：保持现状、改为端到端加密，或改为不加密。可以勾选 更换主密钥。目标是 CiteDesk 同步服务、并且是端到端加密时，还可以选 钥匙保管：自己保管，或由 CiteDesk 保管钥匙。
3. 点 检查并计划，看到数据量后，点 开始转移。
4. 过程分阶段进行：已计划、正在封存源位置、正在复制、正在验证、正在发布到目标、正在切换、已完成。可以中断，之后用 继续转移 接着做，也可以 中止转移…。

需要知道的：

• 计划做完后，窗口列出这次转移的提示：其他设备需要重新连上；源位置作为存档保留；旧凭据在存储服务商那边仍然有效；需要新的恢复码；目标没有加密；目标由 CiteDesk 保管钥匙（服务器的运营方能解开）；从托管改成自己保管必须换主密钥；耗时取决于网络和存储服务。目标是 CiteDesk 同步服务时，计划阶段不做条件写入的探测，开始转移时才检查它能否使用、是否为空。
• 勾选 更换主密钥 会生成新的恢复码，开始转移后会弹出恢复码窗口，要先保存并确认，转移才会继续，旧恢复码对新位置不再有效。这是让泄露的旧恢复码失效的唯一办法。
• 转移时源位置会被封存，并作为存档保留，不会被删除。当前数据连同保留期内、从当前版本往前能完整读到的历史一起带到新位置；更早或已读不到的历史留在存档里，不带过去。
• 目标也可以是现在所在的同一个同步服务（用来改变加密方式、钥匙保管方式，或更换主密钥）。这时必须至少改变其中一样，否则窗口不允许计划。旧的那一份留作存档：只读，仍计入用量，在用户中心的同步空间页里标明。存档不会自动删除，只能由您在用户中心里发起 删除存档（需要核验密码，14 天内可以撤销）；还没有重新连接的设备在删除之后就接不回来，请先在那些设备上重新连接。
• 转移到自带存储之后，官方服务上封存的那份旧副本也可以在用户中心里删除，条件同存档：核验密码、14 天内可以撤销、期满才释放空间；还没有在新位置重新连接的设备，删除之后就接不回来。
• 封存只对遵守协议的设备有效。要彻底防止旧位置被继续写入，请到存储服务商那里撤销旧凭据或改成只读，生效可能有延迟。
• 其他设备需要重新连上并确认新位置：它们的同步设置里会出现 重新绑定到新位置，填写新位置的信息即可，本机尚未上传的改动都会保留。永远不再上线的设备上尚未上传的改动无法找回。
• 转到不加密的目标后，目标位置里的研究内容是可读的明文。
• 改变钥匙保管方式一律更换主密钥，由 CiteDesk 强制，不能取消。自己保管改成托管：目标是 CiteDesk 同步服务上的新空间，开始转移时（封存源之前）先把新钥匙存入服务器，存不进去转移就停在计划阶段，源不会被封存；选它之前账户必须已经绑定认证器，没绑会提示并给出认证器页面的入口。托管改成自己保管：目标可以是自带的存储（S3 或 WebDAV），也可以是同一个同步服务；转移完成后服务器删除这个空间托管的那份旧钥匙，在删除之前服务器仍能解开源存档里的资料，删除也改变不了服务器曾经知道过这把钥匙，所以才必须换新钥匙。

断开同步#

断开… 之后，这台设备不再同步。本机的文献库和工作区文件一个字都不会动，远端的资料也不动；本机尚未上传的改动仍留在本机。可以同时勾选删除本机为这个空间保存的凭据。

以后要重新加入已有空间，本机文献库必须是空的，见新建空间和加入空间。