跳轉到主要內容
projectHistoryChunks 中每個歷史 chunk 一個文件,chunk 是一個專案歷史中的一段連續版本。Mongo 只保存 chunk 的中繼資料;chunk 本身(一個快照加上其後的變更)是 chunks bucket 中經 gzip 壓縮的 JSON 物件。沒有 Mongoose schema:history-v1 在 services/history-v1/storage/lib/chunk_store/mongo.js 中寫入此集合,它用於所有 24 個十六進位字元的歷史 id,CE 中正是如此(services/history-v1/storage/lib/chunk_store/index.js:644-652)。

欄位

寫入方

新 chunk 來自 project-history,它把排隊中的編輯傳送到 history-v1 的 POST /projects/:project_id/legacy_changes(services/history-v1/api/routes/project_import.js:29-31);history-v1 接著呼叫 chunkStore.update 或 chunkStore.create(services/history-v1/storage/lib/persist_changes.js:215, 229)。新專案的第一個 chunk 來自 chunkStore.initializeProject(chunk_store/index.js:54-80)。

讀取方

索引

備註

  • 狀態流程:pending(記錄已寫入,正在上傳)→ active(最新的 chunk,仍可延伸)→ closed(後面有較新的 chunk)或 deleted(被取代,或專案已刪除)。讀取只看 active 與 closed。
  • chunk 物件是經 gzip 壓縮的 JSON(services/history-v1/storage/lib/history_store.js:151-170),位於鍵 <project key>/<chunk id>(history_store.js:65-67)。專案鍵是以零填補的歷史 id,反轉後依 3/3/其餘字元切分(libraries/object-persistor/src/ProjectKey.js:8-15)。bucket 是 OVERLEAF_EDITOR_CHUNKS_BUCKET(services/history-v1/config/custom-environment-variables.json:53-56):開發環境中為 /buckets/chunks(develop/docker-compose.yml:90),使用 S3_ENABLED=true 時為 overleaf-chunks(develop/s3/docker-compose.yml:51)。
  • 處於 deleted 或 pending 狀態的記錄及其 bucket 物件只會被 delete_old_chunks.js 移除(yarn delete_old_chunks,services/history-v1/package.json:79)。CE 映像檔沒有為此設定 cron 工作(server-ce/config/crontab-history, server-ce/config/crontab-deletion),因此在 CE 中它們會一直保留。
  • 當 web 讓已刪除的專案過期時,會呼叫 history-v1 的 DELETE /projects/:history_id(services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162),從而把該專案的所有 chunk 標記為 deleted。
  • 設定了 backupStore 時,確認 chunk 也會把 overleaf.history.currentEndVersion、currentEndTimestamp、updatedAt 與 overleaf.backup.pendingChangeAt 寫入專案(mongo.js:232-262)。CE 沒有設定 backupStore,所以 mongo.js:238-240 會提前返回。
最後修改於 2026年11月21日