Back to Details

update

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

assistant-ui Update

assistant-ui 更新

Always verifies against npm ground truth and GitHub commits.
始终对照npm基准版本和GitHub提交记录进行验证。

References

参考资料

  • ./references/ai-sdk-v6.md -- AI SDK v4/v5 → v6 migration (complete guide)
  • ./references/assistant-ui.md -- assistant-ui version migrations
  • ./references/breaking-changes.md -- Quick reference table
  • ./references/ai-sdk-v6.md -- AI SDK v4/v5 → v6 迁移（完整指南）
  • ./references/assistant-ui.md -- assistant-ui 版本迁移指南
  • ./references/breaking-changes.md -- 快速参考表格

Phase 1: Detect Versions

第一阶段：检测版本

Get Ground Truth

获取基准版本

bash
undefined
bash
undefined

Installed versions

已安装版本

npm ls @assistant-ui/react @assistant-ui/react-ai-sdk ai @ai-sdk/react 2>/dev/null
npm ls @assistant-ui/react @assistant-ui/react-ai-sdk ai @ai-sdk/react 2>/dev/null

Latest from npm

npm上的最新版本

npm view @assistant-ui/react version npm view @assistant-ui/react-ai-sdk version npm view ai version
undefined
npm view @assistant-ui/react version npm view @assistant-ui/react-ai-sdk version npm view ai version
undefined

Version Analysis

版本分析

PackageCheck For
ai
< 6.0.0 → needs AI SDK v6 migration
@assistant-ui/react
< 0.11.0 → needs runtime migration
@assistant-ui/react
< 0.10.0 → needs ESM migration
@assistant-ui/react
< 0.8.0 → needs UI split migration
@assistant-ui/react-ai-sdk
< 1.0.0 → needs AI SDK v6 first
包检查项
ai
< 6.0.0 → 需要进行AI SDK v6迁移
@assistant-ui/react
< 0.11.0 → 需要进行运行时迁移
@assistant-ui/react
< 0.10.0 → 需要进行ESM迁移
@assistant-ui/react
< 0.8.0 → 需要进行UI拆分迁移
@assistant-ui/react-ai-sdk
< 1.0.0 → 需先完成AI SDK v6迁移

Phase 2: Route to Migration

第二阶段：选择迁移路径

AI SDK < 6.0.0?
├─ Yes → See ./references/ai-sdk-v6.md
└─ No
   └─ assistant-ui outdated?
      ├─ Yes → See ./references/assistant-ui.md
      └─ No → Already up to date
AI SDK 版本 < 6.0.0？
├─ 是 → 查看 ./references/ai-sdk-v6.md
└─ 否
   └─ assistant-ui 版本过时？
      ├─ 是 → 查看 ./references/assistant-ui.md
      └─ 否 → 已为最新版本

Migration Order

迁移顺序

  1. AI SDK first (if < 6.0.0) - Required for @assistant-ui/react-ai-sdk >= 1.0
  2. assistant-ui second - Apply breaking changes for version jump
  3. Verify - Type check, build, test
  1. 优先升级AI SDK（若版本 < 6.0.0）- 是@assistant-ui/react-ai-sdk >=1.0版本的前置要求
  2. 其次升级assistant-ui - 针对版本跨度应用相应的破坏性变更
  3. 验证 - 类型检查、构建、测试

Phase 3: Execute

第三阶段：执行操作

Update Packages

更新包

bash
undefined
bash
undefined

pnpm

pnpm

pnpm add @assistant-ui/react@latest @assistant-ui/react-ai-sdk@latest ai@latest @ai-sdk/react@latest
pnpm add @assistant-ui/react@latest @assistant-ui/react-ai-sdk@latest ai@latest @ai-sdk/react@latest

npm

npm

npm install @assistant-ui/react@latest @assistant-ui/react-ai-sdk@latest ai@latest @ai-sdk/react@latest
undefined
npm install @assistant-ui/react@latest @assistant-ui/react-ai-sdk@latest ai@latest @ai-sdk/react@latest
undefined

Apply Migrations

执行迁移

Based on version jump, apply relevant migrations from references.
根据版本跨度，参考相关文档执行对应迁移操作。

Verify

验证

bash
npx tsc --noEmit  # Type check
pnpm build        # Build check
bash
npx tsc --noEmit  # 类型检查
pnpm build        # 构建检查

Troubleshooting

问题排查

"Peer dependency conflict"
  • Update all packages together
  • Check version compatibility in ./references/breaking-changes.md
Type errors after upgrade
  • Consult breaking changes reference
  • Check specific migration guide
Runtime errors
  • Verify API patterns match new version
  • Check for renamed/moved APIs
「对等依赖冲突」
  • 同时更新所有相关包
  • 查看 ./references/breaking-changes.md 检查版本兼容性
升级后出现类型错误
  • 查阅破坏性变更参考文档
  • 查看具体迁移指南
运行时错误
  • 验证API模式是否匹配新版本
  • 检查是否有API被重命名或迁移位置