> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects 集合

`Project` 表示 Overleaf 中的单个 LaTeX 项目。它存储项目元数据、所有权与访问控制、文件结构、编译设置以及协作状态。

#### 核心标识与元数据

* `_id`：标识该项目的唯一 MongoDB ObjectId。
* `name`：项目显示名称。
* `description`：可选的项目文字描述。
* `active`：表示项目当前是否处于活跃状态。
* `version`：内部 schema 或项目格式版本。
* `trashed`：已移入回收站（软删除）的条目列表。
* `deletedDocs`：已永久删除的文档记录。

#### 所有权与访问控制

* `owner_ref`：指向项目所有者用户的引用。
* `collaberator_refs`：拥有编辑权限的用户。
* `reviewer_refs`：拥有审阅者级别访问权限的用户。
* `readOnly_refs`：拥有只读访问权限的用户。
* `pendingEditor_refs` / `pendingReviewer_refs`：待处理的邀请。

#### 基于令牌的访问

* `tokens`：用于共享链接的令牌注册表。
* `tokenAccessReadOnly_refs`：授予只读访问权限的令牌。
* `tokenAccessReadAndWrite_refs`：授予读写访问权限的令牌。

#### 活动跟踪

* `lastUpdated`：最近一次修改的时间戳。
* `lastUpdatedBy`：执行最近一次更新的用户。
* `lastOpened`：项目最近一次被打开的时间戳。
* `deletedByExternalDataSource`：删除操作是否由外部集成触发。

#### 项目结构

根文档与文件夹

* `rootDoc_id`：LaTeX 主入口文档（通常为 `main.tex`）的 ObjectId。
* `rootFolder`：项目文件树的内联表示。

每个文件夹条目包含：

* `name` / `_id`：文件夹名称和标识符。
* `docs`：LaTeX 源文档列表，包含名称和 `_id`。
* `fileRefs`：二进制文件引用（图片、数据文件），包括：
  * `name`：文件名
  * `created`：上传时间戳
  * `rev`：修订计数器
  * `hash`：用于去重的内容哈希
  * `linkedFileData`：外部存储关联（如有）
* `folders`：嵌套的子文件夹。

#### 编译与编辑器设置

* `compiler`：所选的 LaTeX 引擎（`pdflatex`、`xelatex`、`lualatex` 等）。
* `spellCheckLanguage`：该项目的拼写检查语言。

#### 公开与共享设置

* `publicAccesLevel`：项目可见性（`private`、`readOnly`、`public` 等）。
* `collabratecUsers`：来自外部协作平台的关联用户。

#### Overleaf 特有扩展

* `overleaf.history`：
  * `id`：历史服务使用的标识符。
  * `display`：历史记录是否启用并可见。

#### 内部版本控制

* `__v`：Mongoose 用于并发控制的内部版本键。

以下是一个 Overleaf 项目的真实示例。

<Accordion title="项目示例">
  ```json5 theme={null}
  {
      _id: ObjectId('69686c09bcb72ccea226ff33'),
      name: 'overleaf-example',
      lastUpdated: ISODate('2026-01-15T04:25:34.637Z'),
      lastUpdatedBy: ObjectId('696868f6bcb72ccea226fe5f'),
      lastOpened: ISODate('2026-01-15T04:25:22.286Z'),
      active: true,
      owner_ref: ObjectId('696868f6bcb72ccea226fe5f'),
      collaberator_refs: [],
      reviewer_refs: [],
      readOnly_refs: [],
      pendingEditor_refs: [],
      pendingReviewer_refs: [],
      rootDoc_id: ObjectId('69686c09bcb72ccea226ff38'),
      rootFolder: [
          {
              name: 'rootFolder',
              _id: ObjectId('69686c09bcb72ccea226ff32'),
              docs: [
                  {
                      name: 'main.tex',
                      _id: ObjectId('69686c09bcb72ccea226ff38')
                  },
                  {
                      name: 'sample.bib',
                      _id: ObjectId('69686c09bcb72ccea226ff3f')
                  }
              ],
              fileRefs: [
                  {
                      name: 'frog.jpg',
                      created: ISODate('2026-01-15T04:24:41.963Z'),
                      rev: 0,
                      linkedFileData: null,
                      hash: '5b889ef3cf71c83a4c027c4e4dc3d1a106b27809',
                      _id: ObjectId('69686c09bcb72ccea226ff45')
                  }
              ],
              folders: []
          }
      ],
      version: 3,
      publicAccesLevel: 'private',
      compiler: 'pdflatex',
      spellCheckLanguage: 'en',
      deletedByExternalDataSource: false,
      description: '',
      trashed: [],
      deletedDocs: [],
      tokens: {},
      tokenAccessReadOnly_refs: [],
      tokenAccessReadAndWrite_refs: [],
      overleaf: {
          history: {
              id: '69686c09bcb72ccea226ff33',
              display: true
          }
      },
      collabratecUsers: [],
      __v: 0
  }
  ```
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.