> ## 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`：內部結構描述或專案格式版本。
* `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.