用途：指导在 TypeScript/JavaScript 应用中用 Better Auth 添加认证。按决策树区分新项目初始化、已有认证的迁移增强、以及为现有项目新增认证三条路径。
主要能力：安装 better-auth 及按需的 @better-auth/passkey、@better-auth/sso、@better-auth/stripe、@better-auth/scim、@better-auth/expo 等包；配置环境变量 BETTER_AUTH_SECRET（32 位以上，可用 openssl rand -base64 32 生成）、BETTER_AUTH_URL、DATABASE_URL 及 OAuth 密钥；编写服务端 auth.ts 与客户端 auth-client.ts；设置各框架路由处理器；执行数据库迁移；通过插件扩展功能。
使用方式：核心安装命令为 npm install better-auth。服务端最小配置需 database 与 emailAndPassword: { enabled: true }，可加 socialProviders、邮件验证与密码重置、plugins、session、accountLinking、rateLimit，并导出类型 export type Session = typeof auth.$Infer.Session。客户端按框架从 better-auth/react、vue、svelte、solid 或 client 导入，常用导出 signIn、signUp、signOut、useSession、getSession。路由处理器按框架选择，如 Next.js App Router 用 toNextJsHandler(auth) 导出 GET、POST，Express 用 app.all("/api/auth/*", toNodeHandler(auth))。迁移命令：内置 Kysely 用 npx @better-auth/cli@latest migrate；Prisma 用 generate --output prisma/schema.prisma 后 npx prisma migrate dev；Drizzle 用 generate --output src/db/auth-schema.ts 后 npx drizzle-kit push，添加插件后需重跑。
适用场景：新项目认证搭建、现有项目补认证、认证迁移与增强，以及需要 2FA、组织、管理、Bearer、OpenAPI、Passkey、SSO 等插件的应用。
限制：资料未提供具体收费、价格与效果数据；代码示例与语法需查阅 better-auth.com/docs。安全清单要求设置密钥、生产启用 useSecureCookies、配置 trustedOrigins、启用限流与邮件验证、实现密码重置、敏感应用启用 2FA、不禁用 CSRF、审查账号关联。