跳转到主要内容
docs 保存项目中可编辑文本文件的内容(Overleaf 称之为 docs),例如 main.tex 或 sample.bib。每个 doc 一个文档:它的行、评论和修订追踪、两个计数器以及删除状态。文件名和它在文件树中的位置不在这里,而在 projects.rootFolder 中(参见 Projects 集合)。二进制文件也不在这里。 除了迁移和维护脚本之外,只有 docstore 写入该集合,位置在 services/docstore/app/js/MongoManager.js。没有 Mongoose 模型;web 和 document-updater 通过 docstore 的 HTTP API 访问它(services/docstore/app.js:31-70)。在“来源”列中,不带路径的文件名位于 services/docstore/app/js/ 下。

字段

Ranges

ranges 有两个数组。document-updater 使用 libraries/ranges-tracker/index.cjs 构建它们;docstore 在保存前把 id 转为 ObjectId,把 ts 转为 Date(RangeManager.js:41-63)。没有评论或修订追踪的 doc 具有 ranges: {},或者没有 ranges。 评论及其回复的文本不在 docs 中:它们在 messages 集合里,位于 thread_id 等于评论 id 的 room 中。评论是否已解决保存在该 room 上,而不是这里;如果收到 resolved 标志,docstore 会将其丢弃(RangeManager.js:59-61)。参见 Rooms 集合 和 Messages 集合。

写入方

读取方

索引

全部来自 tools/migrations/ 中标记为 server-ce 的迁移。

说明

  • doc 打开期间,其最新文本在 document-updater(Redis)中,而不在这里。只有 document-updater 刷写时才会更新 Mongo(services/document-updater/app/js/PersistenceManager.js:128-160)。读取整个项目所有 doc 的代码应先调用 flushProjectToMongo,就像 ProjectDuplicator 那样。
  • 已删除的 doc 以 deleted: true 留在该集合中,直到项目被销毁。docstore 最多返回 MAX_DELETED_DOCS(默认 2000)个,最新的在前(MongoManager.js:29-44, services/docstore/config/settings.defaults.cjs:40)。历史面板不使用它们,而是读取 history-v1。
  • rev 和 version 计数器与 history-v1 中的项目历史版本无关。
以下是 Overleaf docs 的真实示例。
最后修改于 2026年11月21日