用途:为在 Next.js 15 应用(含 React Server Components)中使用 Vercel AI SDK 提供最佳实践规范,重点围绕流式响应、错误处理与安全边界。
主要能力:建议用 streamText 做文本流式输出,用 streamObject 做结构化 JSON 流式输出;用 onFinish 回调做错误处理,用 onChunk 做实时 UI 更新;使用 smoothStream 获得更平滑的流式体验;客户端可用 useChat 做聊天界面、useCompletion 做文本补全界面;为 AI 接口实现鉴权授权、限流与配额管理、日志记录与缓存。
铁律与用法:AI 输出必须走 streamText 或 streamObject 流式响应,避免阻塞调用;API 密钥与模型提供方机密不得出现在客户端代码,须使用仅服务端的路由处理器;流式 AI 响应在 React 组件中必须实现错误边界与加载状态;不得从客户端组件直接调用 AI SDK 函数,应使用 Server Actions 或 API 路由;必须设置 maxTokens 与超时限制以防调用失控耗尽预算。
反模式:在 UI 路由中阻塞式调用 generateText 会挂起请求;客户端暴露 API 密钥造成泄密;流式无错误边界会破坏整棵组件树;客户端组件调用 AI SDK 会暴露密钥并影响 SSR;无 Token 或超时限制会使额度耗尽。
记忆协议:开始前可执行 cat .claude/context/memory/learnings.md,完成后记录新发现的模式或例外,并假定上下文可能被重置。
限制:资料未提供安装命令、具体依赖版本、定价或性能数据。