用途:这是 AIBlueprint 技术栈的参考文档,列出开发时推荐使用的工具与库,供做架构决策时查阅。
主要能力:按类别整理工具。框架与前端包括 Next.js(主框架,App Router)、TanStack Query(数据获取与缓存)、Zustand(客户端状态)、nuqs(URL 状态)、shadcn/ui(可定制 React 组件)。后端与 API 包括 Next Safe Action(安全 Server Actions)、next-zod-route(安全 API 路由)、Better Auth(认证)、AI SDK(LLM 集成)、up-fetch(HTTP 客户端)。数据库与 ORM 包括 Neon(无服务器 PostgreSQL,推荐)、Supabase、Prisma(类型安全 ORM,团队推荐)、Drizzle ORM(轻量,性能推荐)。实时与协作包括 Convex(实时数据库与后端)、Liveblocks(多人协作:光标、在线状态、评论)。验证与表单包括 Zod v4、React Hook Form(推荐)、TanStack Form。测试包括 Vitest(单元)、Playwright(E2E)。监控与分析包括 Sentry、PostHog(推荐)、Plausible。支付包括 Stripe、Lemon Squeezy。邮件包括 Resend(推荐)、React Email、AWS SES。图片与上传包括 Uploadthing(推荐)、Cloudflare R2、AWS S3。服务与基础设施包括 Inngest(异步任务与工作流)、Cloudflare Browser Rendering(无服务器抓取)。
推荐栈:前端 Next.js + TanStack Query + Zustand + shadcn/ui,React Hook Form + Zod;后端 Neon + Prisma 或 Drizzle,Next Safe Action + Better Auth,Resend + React Email;服务 Stripe、Uploadthing、Cloudflare R2、PostHog、Sentry;测试 Vitest + Playwright。
选型建议:数据库起步用 Neon + Prisma,追求性能用 Drizzle;全实时应用用 Convex,仅部分功能协作则 Neon + Liveblocks;邮件起步用 Resend,月发送超 10 万用 AWS SES;支付要灵活用 Stripe,要简化税务用 Lemon Squeezy;产品分析用 PostHog,简单网站分析用 Plausible;表单标准用 React Hook Form,需更多控制用 TanStack Form;ORM 中 Prisma 开发体验更好,Drizzle 性能更好(快 2-3 倍);上传简单用 Uploadthing,需更多控制用 R2/S3;测试单元用 Vitest,E2E 用 Playwright。
限制与注意:Zod 已到 v4,需向 AI 指定版本;Supabase Auth 建议改用 Better Auth 以获得灵活性;AWS S3 需注意出网费用,提供资源优先用 R2;Stripe Tax 可开启自动税务处理;Sentry 需配置 source maps 才能获得真实堆栈。文档未提供各工具的价格、安装命令与具体使用步骤。