用途:该技能面向两类迁移任务——从其他 SDK(如 Vercel AI SDK 或原始供应商 SDK)迁移到 TanStack AI,以及升级应用内已弃用的 TanStack AI API。
主要能力:提供 API 名称级映射思路,例如 streamText 与 generateText 合并为带 streaming 选项的 chat() 调用;createOpenAI(...) 改为可 tree-shake 的适配器(如 @tanstack/ai-openai 的 openaiText());onFinish 等回调改为 middleware hooks;手写 SSE 改为内置 response helpers;generateObject 改为 chat() 上的结构化输出。升级方面给出查看当前版本与最新版本的命令,并指向迁移、AG-UI 合规、采样选项转模型选项、create-ui 等指南。部分重命名提供 jscodeshift 转换脚本。
使用方式:先阅读对应迁移指南,再加载目标 API 技能:npx @tanstack/intent@latest load @tanstack/ai#ai-core。查看版本:node -p "require('@tanstack/ai/package.json').version" 与 npm view @tanstack/ai version。运行代码修改脚本前先预览:npx jscodeshift -t https://raw.githubusercontent.com/TanStack/ai/main/codemods/ag-ui-compliance/transform.ts --dry --print src/。迁移后运行项目类型检查,报错名称可对照 node_modules/@tanstack/ai/src/ 核实。
适用场景:需要更换 AI SDK、统一调用方式,或分步升级 TanStack AI 版本的项目。
限制:不要凭记忆移植 API,映射细节以官方文档为准;弃用 API 仍可用,建议分步升级;代码修改脚本覆盖范围有限,服务端重写通常需手动完成。具体收费、平台与效果资料暂未提供。