Dokki Docs logo

版本历史

版本历史是Dokki对文档、表格和工件的快照层。它帮助你查看早期状态、比较更改,并在资源与先前版本偏离过大时恢复上下文。

文档快照

文档以版本号、时间戳、快照类型、描述、字符数、字数和预览形式存储快照。文档快照API可以列出最近的快照,并从最新的持久化文档状态创建手动快照。

快照保留时长

在编辑期间,文档最多每30分钟保存一次自动快照,并在最后一位编辑者断开连接时再保存一次。自动快照会随着时间被清理:文档最多保留50个自动快照,超过30天的自动快照将被移除。手动快照会一直保留到你删除它们,所以在进行有风险的改写之前请创建一个。

当前状态注意事项

手动文档快照读取最新的持久化documents.data状态。如果文档处于打开状态且Hocuspocus仍有未保存的内存编辑,请在创建手动快照前等待编辑器空闲保存。

与当前版本比较

与当前版本比较的流程会下载存储的Yjs快照,尽可能提取快照内容,将其与当前文档内容进行比较,并返回新增、删除、修改和未更改的段落以及摘要统计。

表格和工件

表格和工件也有快照API。将快照列表视为你正在处理的资源类型的历史视图,而不是一个单一的全局工作区时间线。

快照不是什么

  • 它们不能替代工作区回收站。被删除的资源首先会进入回收站。

  • 它们不是实时协同光标历史。

  • 它们可能会滞后于最新的按键输入,直到持久化赶上。

  • 它们不会自动发布更改。发布有自己的冻结的公共快照。