SuperAPI AI 工具集

migrate-ai-sdk-v6-to-v7

编程与开发

查看项目

更新于 10-16 11:23

技能介绍

该技能用于把使用 Vercel AI SDK 6.x 的应用迁移到 7.0。以 AI SDK 仓库中 content/docs/08-migration-guides/23-migration-guide-7-0.mdx 为权威来源,本技能作为工作检查清单,行为不明确时查阅该指南。

用途:升级 AI SDK 相关包、修复 v7 迁移错误,或用户提到 AI SDK v6 时使用。

迁移流程:先确保有干净备份或已提交基线;检查 package.json 与锁文件,识别已安装的 ai、@ai-sdk/*、provider、UI、MCP、telemetry 包;将 AI SDK 包升级到最新版本,仅在项目使用 OpenTelemetry span 时添加 @ai-sdk/otel;更新运行时与模块假设,Node.js 需 >=22,AI SDK 包仅支持 ESM,将 require() 改为 ESM 导入并按需添加 "type": "module" 或使用 .mjs;搜索 v6 模式,只迁移实际存在的代码,然后运行类型检查与针对性测试。尽量采用保持行为的改动;当 v7 改变语义时,需决定应用要用新的全步骤行为还是原先仅最终步骤的行为。

主要能力:覆盖核心 API 重命名(如 experimental_customProvider 到 customProvider、experimental_generateImage 到 generateImage、stepCountIs 到 isStepCount、CallSettings 到 LanguageModelCallOptions 等);提示词与步骤(system 改为 instructions、experimental_prepareStep 到 prepareStep、prepareStep 中返回的 system 改为 instructions);生命周期回调(onStart、onStepStart、onEnd、onStepEnd 等);用量与遥测(usage.cachedInputTokens 到 usage.inputTokenDetails.cacheReadTokens、experimental_telemetry 到 telemetry、OpenTelemetry 移出 ai 包);流式、消息与工具(StreamTextResult.fullStream 到 stream、needsApproval 移入工具审批、experimental_activeTools 到 activeTools);内容部分与推理(媒体结果类型改为 file-data、用户图像消息改为 file 类型);多步结果形状(result.usage 含所有步骤、result.totalUsage 弃用、使用 finalStep);流式响应辅助方法改为顶层无状态辅助函数;包特定检查(MCP redirect 默认改为 error、Vue Chat 类弃用、Anthropic 缓存计数字段变更、Google 类型重命名)。

使用方式:按上述工作流逐步执行,仅迁移存在的代码,完成编辑后运行类型检查与最小相关测试,并对流式、聊天 UI、工具执行、遥测和多步流程进行冒烟测试;若仍有类型错误,先在迁移指南中搜索被移除或重命名的符号,而不是自行发明变通方案。

限制:本技能不提供指南之外的额外行为说明;若项目未使用涉及的功能则无需改动;具体价格、平台支持与效果等资料暂未提供。