跳轉到主要內容
users 為每個帳號保存一份文件,儲存登入資料、個人資料、編輯器設定、功能與活動。結構描述為 services/web/app/src/models/User.mjs;大多數寫入都經由 services/web/app/src/Features/User/UserUpdater.mjs。在「來源」欄中,User.mjs:N 代表該結構描述的某一行,其他沒有路徑的檔名位於 services/web/app/src/Features/ 底下,modules/... 則位於 services/web/ 底下。行號取自撰寫當時的 server-pro。

核心身分與驗證

帳號狀態與生命週期

登入與活動追蹤

編輯器偏好設定(ace)

帳號設定頁面透過 UserController.updateUserSettings(UserController.mjs:460-530)儲存這些值。

功能旗標與限制(features)

features 是計算的結果,不應手動編輯。FeaturesUpdater 從 Settings.defaultFeatures 開始,合併每一筆未過期的 featuresOverrides 項目,並將結果連同 featuresUpdatedAt 一起寫入(FeaturesUpdater.mjs:220-300、UserFeaturesUpdater.mjs:10-24)。正式環境映像檔將 collaborators、dropbox、versioning、compileTimeout、compileGroup、trackChanges 與 references 設為預設值(server-ce/config/settings.js:301-309);其他鍵則維持未設定。 在 Ayakaleaf Pro 中,管理面板會依使用者關閉功能。admin-tools 模組將其儲存為帶有 note: 'admin-panel' 的 featuresOverrides 項目(modules/admin-tools/app/src/AdminFeatures.mjs:13-30),而 instance-features 模組會將未設定的鍵視為開啟(modules/instance-features/app/src/UserFeatures.mjs:12-14)。 AI 助理與錯誤助理不是 features 中的鍵。它們依循執行個體的 AI 設定與 aiFeatures.enabled,請參閱下方。

整合

計畫與實驗

推薦與教學

索引

全部來自 tools/migrations/ 中帶有 server-ce 標籤的遷移。

附註

  • Mongoose 的 autoIndex 已關閉(services/web/app/src/infrastructure/Mongoose.mjs:7),因此只有上述遷移會建立索引。
  • 刪除使用者會將整份文件移至 deletedUsers(請參閱 Deleted Users Collection)。

以下是一個真實的 Overleaf 使用者範例。
此帳號是在舊版本中建立的。它仍保有已不在結構描述中、也沒有任何地方讀取的欄位:staffAccess、ace.enableNewEditor、features.aiErrorAssistant、aiErrorAssistant 與 writefull.enabled(現為 writefull.initialized)。ace.breadcrumbs 現在預設為 false。
最後修改於 2026年11月20日