[控场AI]
产品ai-sdk/react / Vercel AI SDK React

@ai-sdk/react

Vercel AI SDK 的 React 适配层,提供 useChat、useCompletion 等 Hook,帮助开发者在 React/Next.js 应用中快速构建流式对话、AI 补全等交互体验

核心事实

时间轴 (近 90 天)

11月11日

在 npm 生态中,绑定包随核心包补丁更新而更新、保持自身 API 稳定的做法是常见模式。

待验证50%
11月11日

排查 ai 版本冲突的手段包括:运行 npm ls ai 查看依赖树、检查 @ai-sdk/react 的 peerDependencies 版本范围、必要时用 overrides/resolutions 强制统一版本。

待验证50%
11月11日

升级后应在流式对话和工具调用两个场景做回归验证,因为这两个场景对底层解析逻辑的变化最敏感。

待验证50%
11月11日

如果一个项目对线上稳定性要求高,可以等一两个补丁版本观察后再跟进升级。

待验证50%
11月11日

升级补丁版本后,应重点回归流式响应、错误处理和中断逻辑。

待验证50%
11月11日

该版本发布时间标注为 11 月 11 日。

待验证50%
11月2日

monorepo 把核心包 ai 与各框架适配包(@ai-sdk/svelte、@ai-sdk/react 等)放在同一个 Git 仓库中管理,共享构建配置与发布流水线。

待验证50%
10月29日

发布 1.0.40 的提交由 github-actions 机器人自动完成,提交号为 165a954,并附带了 GitHub 的验证签名。

已过期90%
10月27日

服务端为选定模型签发短期令牌,浏览器自行打开WebSocket会话,可让API Key不暴露在客户端;浏览器侧可使用@ai-sdk/react中的useRealtime hook处理连接、麦克风采集和音频播放。

待验证50%
10月26日

@ai-sdk/vue 将 ai 声明为 peer dependency,两者版本不一致时 npm 或 pnpm 可能安装多份 ai 包,导致类型不匹配、响应式状态失效甚至运行时错误

待验证50%

还有 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%

来源文章