新手引導

你第一次登入 app.engram.page 時，Engram 會先帶你 走過一個簡短的新手引導精靈，才會開啟你的知識庫。之所以有這個精靈，是因為 Engram 要求在知識庫端點可被存取之前，先完成條款接受與有效的訂閱狀態。

精靈涵蓋的內容

精靈共有兩個步驟：

1. 同意。 接受服務條款與隱私權政策。會依目前生效的條款版本，記錄在伺服器端 的 user_agreements 資料表中。目前生效的版本是從 terms_versions 資料表動態 解析出來的（由 Engram.Legal.VersionCache 快取），而不是編譯期常數。
2. 計費。 選擇方案並透過 Paddle 完成結帳（或選擇 Free，完全略過 Paddle）。 各方案的內容請見 帳單 → 方案。

兩個步驟都完成後，你會被帶到知識庫瀏覽器。

為什麼它會限制知識庫的存取

後端把 /api/notes、/api/search 與 /api/folders 包在 RequireOnboarding plug 之後，它會驗證：

• 該使用者已接受最新的條款
• 訂閱狀態良好（或是自行架設，這會完全略過此檢查）

只要其中一項檢查失敗，API 就會回傳 403，網頁版會把你導回精靈。這表示你不會意外 進入一個只完成一半的壞掉狀態；這道關卡要嘛放你通過，要嘛顯示能解決缺漏步驟的 畫面。

略過精靈（自行架設）

在自行架設時，計費預設為關閉（沒有 PADDLE_API_KEY → config :engram, :billing_enabled 為 false）。精靈會直接跳過選擇方案的步驟。 你仍然需要接受一次條款。

重新執行精靈

你無法手動重新執行；一旦接受就已通過。如果條款有變更，Engram 會在伺服器端提升 版本，下一次 API 呼叫會回傳 403；應用程式只會重新顯示接受條款的步驟。方案變更 在 帳單 頁面進行，而不是在精靈中。