Dokki Docs logo

版本歷史

版本歷史是 Dokki 對文件、表格和工件的快照層。它能協助您檢視先前的狀態、比較變更,並在資源偏離先前版本過遠時恢復上下文。

文件快照

文件儲存快照,包含版本號、時間戳、快照類型、描述、字元數、字數和預覽。文件快照 API 可以列出最近的快照,並從最新保存的文件狀態建立手動快照。

快照保留多久

當人們編輯時,文件最多每 30 分鐘儲存一次自動快照,並在最後一位編輯者斷開時再儲存一次。自動快照會隨時間修剪:一份文件最多保留 50 個,且超過 30 天的自動快照會被移除。手動快照會保留直到您刪除,因此在進行有風險的改寫前,請先建立一個。

當前狀態注意事項

手動文件快照讀取最新保存的 documents.data 狀態。如果文件已開啟且 Hocuspocus 仍有未儲存的記憶體編輯,請等待編輯器的閒置儲存後再建立手動快照。

與當前比較

與當前比較的流程會下載儲存的 Yjs 快照,盡可能提取快照內容,與當前文件內容進行比較,並傳回新增、刪除、修改和未變更的區段,以及摘要統計。

表格和工件

表格和工件也有快照 API。請將快照清單視為您正在處理的資源類型的歷史檢視,而不是單一的全球工作區時間軸。

快照不是什麼

  • 它們不能取代工作區的垃圾桶。被刪除的資源會先進入垃圾桶。

  • 它們不是即時的協作游標歷史。

  • 它們可能落後於最新的鍵入,直到持久化趕上為止。

  • 它們不會自動發佈變更。發佈有其自己的凍結公開快照。