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。

