用途：指导在 TypeScript/JavaScript 应用中用 Better Auth 添加认证。按决策树区分三种情况：新项目从零搭建、既有项目新增认证、已有认证的迁移或增强。
主要能力：识别框架与数据库；安装 better-auth；创建 auth.ts 与 auth-client.ts；配置路由处理器；执行 CLI 迁移或生成；通过插件扩展功能。可选包包括 @better-auth/passkey（WebAuthn）、@better-auth/sso（SAML/OIDC）、@better-auth/stripe、@better-auth/scim、@better-auth/expo。
必要用法：核心安装 npm install better-auth。环境变量需 BETTER_AUTH_SECRET（32 位以上，可用 openssl rand -base64 32 生成）、BETTER_AUTH_URL、DATABASE_URL，以及按需的 OAuth 密钥。服务端配置放 lib/auth.ts 或 src/lib/auth.ts，最小配置含 database 与 emailAndPassword: { enabled: true }。客户端按框架从 better-auth/react、/vue、/svelte、/solid 或 /client 导入，常用导出 signIn、signUp、signOut、useSession、getSession。路由处理器按框架选择：Next.js App Router 用 app/api/auth/[...all]/route.ts 配 toNextJsHandler(auth)，Express 用 app.all("/api/auth/*", toNodeHandler(auth))，SvelteKit 用 svelteKitHandler(auth)，SolidStart 用 solidStartHandler(auth)，Hono 用 auth.handler(c.req.raw)。Next.js 服务端组件需加 nextCookies() 插件。迁移命令：内置 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，添加插件后需重跑。
适用场景：需要邮箱密码、OAuth、2FA、组织、管理、API 令牌、企业 SSO 等认证能力的 JS/TS 项目。
限制：资料未提供具体版本要求、性能数据与收费信息；代码示例与语法需查阅 better-auth.com/docs。