用途:为基于 Better Auth 的 TypeScript 项目添加高级认证功能,通过插件机制扩展服务端与客户端能力。
主要能力:支持按需引入服务端插件(如两步验证 twoFactor)与对应的客户端插件(twoFactorClient),覆盖 2FA、magic link、passkey、username、JWT、organizations 等特性类别。
使用方式:从 better-auth/plugins 导入服务端插件并加入 betterAuth 的 plugins 数组;从 better-auth/client/plugins 导入对应客户端插件并加入 createAuthClient 的 plugins 数组。当插件新增数据表时,运行 CLI 生成或执行迁移:
npx @better-auth/cli generate npx @better-auth/cli migrate
约束与限制:服务端与客户端插件应成对添加,保持 API 一致;若使用了 nextCookies,应将其放在服务端插件列表最后;需查阅各插件文档以确认所需 schema 与环境变量。具体插件清单、完整用例与官方说明暂未提供。