用途：用于 Next.js 项目的网页聊天集成，包括持久化会话、工具审批、工具结果 UI 和嵌入式挂件。脚手架可参考 ai-app，SDK 版本用 ai-sdk 确认，组件契约参考 ai-elements；多平台消息可查 Chat SDK。
主要能力与用法：保留项目现有技术栈，按质量、延迟和隐私需求选择模型、推理设置、存储与客户端状态。新项目未定默认值时，默认 Bun、shadcn/ui 上的 ai-elements、Drizzle + PostgreSQL 存服务端历史，以及低推理或无推理的快速模型。集成前需对齐 ai、@ai-sdk/react 与 provider 版本，v7 用 ai-sdk-7，v6 用 ai-sdk-6。会话访问要鉴权，请求数据要校验，工具要在服务端授权；客户端历史、上下文、模型 ID 和同意标记均不可信。需存储带稳定 ID 的已校验 UI 消息，并通过已安装 SDK 的辅助函数转换模型历史，保持工具调用/结果与推理关系。要明确取消、断连、重载和重试行为，记录带关联 ID 的脱敏诊断，返回安全的公开错误。自建 NDJSON/SSE 流需设置 X-Accel-Buffering: no 与 Cache-Control: no-store, no-transform。聊天界面默认用户消息右对齐 bg-muted 气泡、助手消息全宽无背景，流式输出跟随底部滚动，Markdown 用应用渲染器（默认栈为 ai-elements MessageResponse）与 shadcn Typeset 样式。
适用场景：需要生产级网页聊天、工具审批、历史恢复、检索与建议功能的 Next.js 应用。
限制：资料未提供具体价格、平台支持范围与效果数据；流式行为依赖托管环境，durable execution 需受支持的持久运行时；错误在响应头发出后无法改变 HTTP 状态。