用途:为把外部 API 与大模型接入现代应用提供生产级集成指导,强调认证、安全、错误处理、限流与重试,以及自主智能体编排。
主要能力:
- 认证与安全:Auth.js v5 的 AUTH_ 前缀环境变量规范、以 JWT 会话兼顾边缘运行、授权回调控制路由访问;Webhook 签名校验使用 Web Crypto。
- 模型编排:GPT-5 推理与 o3 深度研究的调用模式,规划—研究—综合的多模型分工。
- 支付集成:Stripe SDK v13+ 的原生自动分页与 expand 类型安全。
- 架构与弹性:Bun/pnpm 单仓、Repomix 上下文打包与大库索引、指数退避、熔断、舱壁与降载。
- 检索与反模式:git grep 与模式文件检索,以及密钥、类型校验、异步与限流等注意事项。
使用方式:资料给出 NextAuth 配置、AI SDK、Stripe、熔断与签名校验示例片段,以及 repomix、pnpm、git grep 等命令,可按项目需要选取并适配;环境变量示例含 AUTH_SECRET、AUTH_URL 及各提供方 ID/Secret。
适用场景:Next.js/边缘应用接入 OAuth 与第三方 API、支付订阅处理、带推理的智能体任务、大型代码库上下文准备与弹性容错。
限制:资料为集成实践指南,非可直接安装的软件包,未提供安装命令、依赖版本与运行环境细节;示例中的模型名、SDK 版本与 API 版本属资料所述内容,实际可用性需自行验证。