跳转到主要内容
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日