引导向导

你首次登录 app.engram.page 时，Engram 会先带你完成一个简短的引导向导，然后才会打开你的知识库。之所以有这个向导，是因为在知识库端点可访问之前，Engram 要求你已接受条款并具备有效的订阅状态。

向导包含什么

向导共两步：

1. **协议。**接受服务条款和隐私政策。系统会针对当前生效的条款版本，把记录写入服务端的 user_agreements 表。生效版本是从 terms_versions 表动态解析的（由 Engram.Legal.VersionCache 缓存），而不是编译期常量。
2. **计费。**选择套餐并通过 Paddle 完成结账（或选择免费版，这会完全跳过 Paddle）。各套餐包含的内容请见计费 → 套餐。

两步都完成后，你会被转交到知识库浏览器。

为什么它会限制知识库访问

后端通过 RequireOnboarding plug 包裹了 /api/notes、/api/search 和 /api/folders，该 plug 会验证：

• 该用户已接受最新版本的条款
• 订阅状态良好（自托管则完全绕过此检查）

如果任一检查未通过，API 会返回 403，网页应用会重定向回向导。这意味着你不会不小心陷入一个未完成引导的半成品状态；这道关卡要么放你通过，要么给你一个能解决缺失步骤的界面。

跳过向导（自托管）

在自托管环境中，计费默认关闭（没有 PADDLE_API_KEY → config :engram, :billing_enabled 为 false）。向导会跳过选择套餐的步骤。你仍然需要接受一次条款。

重新运行向导

你无法手动重新运行它；一旦接受就不会再出现。如果条款有变更，Engram 会在服务端提升版本号，下一次 API 调用会返回 403；应用只会重新显示条款接受这一步。套餐变更在计费页面进行，而不是在向导中。