@ai-sdk/react
Vercel AI SDK 的 React 适配层,提供 useChat、useCompletion 等 Hook,帮助开发者在 React/Next.js 应用中快速构建流式对话、AI 补全等交互体验
核心事实
@ai-sdk/provider-utils 承担 AI SDK 中与模型提供商交互的通用工具函数职责,包括流式响应解析、工具调用格式化、错误处理等底层逻辑
@ai-sdk/rsc 是 Vercel AI SDK 生态中的子包,rsc 指 React Server Components,为在服务端组件环境中集成生成式 AI 能力提供工具
Vercel AI SDK 使用 changesets 工具管理版本变更,核心 ai 包的每次补丁会自动传播到 @ai-sdk/svelte、@ai-sdk/react、@ai-sdk/vue 等所有适配层
时间轴 (近 90 天)
在 npm 生态中,绑定包随核心包补丁更新而更新、保持自身 API 稳定的做法是常见模式。
排查 ai 版本冲突的手段包括:运行 npm ls ai 查看依赖树、检查 @ai-sdk/react 的 peerDependencies 版本范围、必要时用 overrides/resolutions 强制统一版本。
升级后应在流式对话和工具调用两个场景做回归验证,因为这两个场景对底层解析逻辑的变化最敏感。
如果一个项目对线上稳定性要求高,可以等一两个补丁版本观察后再跟进升级。
升级补丁版本后,应重点回归流式响应、错误处理和中断逻辑。
该版本发布时间标注为 11 月 11 日。
monorepo 把核心包 ai 与各框架适配包(@ai-sdk/svelte、@ai-sdk/react 等)放在同一个 Git 仓库中管理,共享构建配置与发布流水线。
发布 1.0.40 的提交由 github-actions 机器人自动完成,提交号为 165a954,并附带了 GitHub 的验证签名。
服务端为选定模型签发短期令牌,浏览器自行打开WebSocket会话,可让API Key不暴露在客户端;浏览器侧可使用@ai-sdk/react中的useRealtime hook处理连接、麦克风采集和音频播放。
@ai-sdk/vue 将 ai 声明为 peer dependency,两者版本不一致时 npm 或 pnpm 可能安装多份 ai 包,导致类型不匹配、响应式状态失效甚至运行时错误
还有 35 条时间轴事件
全部知识事实 (20)
@ai-sdk/provider-utils 承担 AI SDK 中与模型提供商交互的通用工具函数职责,包括流式响应解析、工具调用格式化、错误处理等底层逻辑
90%已验证@ai-sdk/rsc 是 Vercel AI SDK 生态中的子包,rsc 指 React Server Components,为在服务端组件环境中集成生成式 AI 能力提供工具
90%已验证Vercel AI SDK 使用 changesets 工具管理版本变更,核心 ai 包的每次补丁会自动传播到 @ai-sdk/svelte、@ai-sdk/react、@ai-sdk/vue 等所有适配层
90%已验证Vercel AI SDK 是由 Vercel 主导开发的开源工具包,为 JavaScript/TypeScript 开发者提供标准化的大语言模型集成方案
90%已验证Vercel AI SDK 采用 Monorepo 单一代码仓库管理模式,核心包 ai 与各框架适配包(如 @ai-sdk/vue、@ai-sdk/react、@ai-sdk/svelte)协同发布
90%已验证AI SDK 的框架适配包与核心包保持补丁号版本号对齐(例如 ai@7.0.140 对应 @ai-sdk/svelte@5.0.140)。
80%已验证AI SDK 生态中存在与 @ai-sdk/valibot 类似的适配包 @ai-sdk/zod,两者提供相同的对外接口
80%已验证@ai-sdk/vue 是 AI SDK 面向 Vue 框架的绑定层,负责将核心 ai 包的能力(如流式响应、消息状态管理、useChat 等组合式 API)暴露给 Vue 组件
80%已验证如果项目当前版本与核心 ai 包存在版本不一致,升级到 @ai-sdk/vue@3.0.310 有助于对齐依赖树。
75%已验证AI SDK 官方同时维护 React、Svelte、Vue 等多个框架绑定,这些包通常会在同一时间窗口内发布同版本号的补丁。
75%已验证@ai-sdk/vue 的核心能力以 Vue Composable 形式暴露,例如 useChat、useCompletion 等 Hook,与 @ai-sdk/react 在功能上对称
75%已验证@ai-sdk/vue、@ai-sdk/react 等框架适配层将核心能力封装为对应框架的组合式 API
75%待验证@ai-sdk/react 是面向 React 生态的官方适配包,封装了 useChat、useCompletion 等 Hooks
70%待验证当核心包 ai 发布补丁时,CI/CD 会自动触发所有依赖它的框架适配包(@ai-sdk/react、@ai-sdk/svelte、@ai-sdk/vue 等)同步发布相同补丁级别版本,即使适配包自身无代码改动
70%待验证排查 ai 版本冲突的手段包括:运行 npm ls ai 查看依赖树、检查 @ai-sdk/react 的 peerDependencies 版本范围、必要时用 overrides/resolutions 强制统一版本。
50%待验证在 npm 生态中,绑定包随核心包补丁更新而更新、保持自身 API 稳定的做法是常见模式。
50%待验证升级后应在流式对话和工具调用两个场景做回归验证,因为这两个场景对底层解析逻辑的变化最敏感。
50%待验证如果一个项目对线上稳定性要求高,可以等一两个补丁版本观察后再跟进升级。
50%待验证该版本发布时间标注为 11 月 11 日。
50%待验证升级补丁版本后,应重点回归流式响应、错误处理和中断逻辑。
50%