跳转到主要内容
projectHistoryBlobs 中每个项目历史一个文档:history-v1 为该项目存储的每个 blob 的元数据(哈希和大小)。blob 是某个文件或 doc 在其历史中某一时刻的内容。字节本身是项目 blob bucket 中的对象。没有 Mongoose schema:history-v1 在 services/history-v1/storage/lib/blob_store/mongo.js 中写入该集合,它用于 24 个十六进制字符的历史 id,CE 中正是如此(services/history-v1/storage/lib/blob_store/index.js:108-116)。

字段

写入方

新 blob 的来源:
  • 文件上传:web 把文件发送到 history-v1 的 PUT /projects/:project_id/blobs/:hash(services/web/app/src/Features/History/HistoryManager.mjs:164-169, services/history-v1/api/controllers/projects.js:376-402)。
  • 项目复制:web 让 history-v1 通过 POST /projects/:project_id/blobs/:hash?copyFrom= 复制每个文件的 blob(services/web/app/src/Features/Project/ProjectDuplicator.mjs:333-338, HistoryManager.mjs:177-187, projects.js:521-555)。
  • Doc 文本:history-v1 写入 chunk 时,会把每个 doc 的文本及其评论和修订追踪(JSON)存为 blob(chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173)。

读取方

索引

只有默认的 _id 索引。tools/migrations/ 中没有迁移添加其他索引。

说明

  • blob 的字节位于 bucket OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET(services/history-v1/config/custom-environment-variables.json:49-52)中的键 <project key>/<hash[0:2]>/<hash[2:]>(blob_store/index.js:51-53)。项目键是用零填充的历史 id,反转后按 3/3/其余字符切分(libraries/object-persistor/src/ProjectKey.js:8-15)。
  • 每个项目只存储一次某个 blob:插入项目已有的哈希会被跳过(blob_store/index.js:227-230, 249-252)。
  • 空内容不需要记录;getBlob 无需查找就能返回它(blob_store/index.js:378-380)。
  • projectHistoryGlobalBlobs 会在启动时读取(blob_store/index.js:138-148),但没有 CE 代码写入它,因此在 CE 中每个 blob 都是项目 blob。
最后修改于 2026年11月21日