@ai-sdk/react
Vercel AI SDK 的 React 适配层,提供 useChat、useCompletion 等 Hook,帮助开发者在 React/Next.js 应用中快速构建流式对话、AI 补全等交互体验
核心事实
@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 等所有适配层
Vercel AI SDK 采用 Monorepo 单一代码仓库管理模式,核心包 ai 与各框架适配包(如 @ai-sdk/vue、@ai-sdk/react、@ai-sdk/svelte)协同发布
时间轴 (近 90 天)
服务端为选定模型签发短期令牌,浏览器自行打开WebSocket会话,可让API Key不暴露在客户端;浏览器侧可使用@ai-sdk/react中的useRealtime hook处理连接、麦克风采集和音频播放。
AI SDK 官方同时维护 React、Svelte、Vue 等多个框架绑定,这些包通常会在同一时间窗口内发布同版本号的补丁。
React 适配包使用 useState 与 hook 规则实现与 Vue 适配层相同的响应式语义。
AI SDK 的框架适配包与核心包保持补丁号版本号对齐(例如 ai@7.0.140 对应 @ai-sdk/svelte@5.0.140)。
@ai-sdk/react 发布了 4.0.139 版本,属于补丁级别(Patch Changes)更新
对于生产环境,推荐结合 changelog 审慎评估每次升级的实际收益,建立合理的依赖管理策略
ai 核心包已进入 7.x 阶段,而 React 适配层仍保持在 4.x
React 开发者使用 @ai-sdk/react,Vue 开发者依赖 @ai-sdk/vue
useChat 和 useCompletion 都支持通过 api 参数指定自定义后端路由,由后端调用模型供应商 API,从而避免在前端暴露密钥
React 适配包采用 2.0.x 版本,核心包 ai 采用 5.0.x 版本,两者各自独立进行语义化版本管理,通过依赖关系保持联动
还有 21 条时间轴事件
全部知识事实 (20)
@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 采用 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 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%待验证服务端为选定模型签发短期令牌,浏览器自行打开WebSocket会话,可让API Key不暴露在客户端;浏览器侧可使用@ai-sdk/react中的useRealtime hook处理连接、麦克风采集和音频播放。
50%待验证React 适配包使用 useState 与 hook 规则实现与 Vue 适配层相同的响应式语义。
50%待验证对于生产环境,推荐结合 changelog 审慎评估每次升级的实际收益,建立合理的依赖管理策略
50%待验证ai 核心包已进入 7.x 阶段,而 React 适配层仍保持在 4.x
50%待验证React 开发者使用 @ai-sdk/react,Vue 开发者依赖 @ai-sdk/vue
50%待验证useChat 和 useCompletion 都支持通过 api 参数指定自定义后端路由,由后端调用模型供应商 API,从而避免在前端暴露密钥
50%待验证React 适配包采用 2.0.x 版本,核心包 ai 采用 5.0.x 版本,两者各自独立进行语义化版本管理,通过依赖关系保持联动
50%待验证升级到 3.0.300 一般无需修改现有代码,主要收益在于获得底层核心包带来的稳定性改进与潜在的 Bug 修复
50%待验证3.0.300 属于补丁(Patch)版本,主要内容为一系列依赖项的同步更新,而非引入新特性或破坏性变更
50%待验证@ai-sdk/react 作为上层 React 绑定层,其行为变化由底层 ai 核心包驱动
50%