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。

