Firebase JavaScript SDK 13.0.0 发布，是一次带破坏性变更的发布，主要影响使用 AI Logic 的开发者。
具体改了什么
VertexAIBackend 和 BackendType.VERTEX_AI 被移除，改用 AgentPlatformBackend，默认位置改成了 global。
Part 类型的结构被重构。
Firestore 增加了 BSON 类型支持。
影响范围判断
如果你没在用 Firebase 的 AI Logic（以前叫 Vertex AI in Firebase），这次升级大概率是平滑的。
如果你在用，改动是必然的：后端类型换名、默认区域变了。默认区域变成 global 这件事要特别留意——它会影响数据流向哪里、延迟多少、以及合规上数据驻留在哪。
升级步骤
先在非生产环境升级，跑一遍完整的构建。TypeScript 项目会直接把类型变更暴露出来，这是好事。
然后逐个改 AI Logic 的初始化代码：把 VertexAIBackend 换成 AgentPlatformBackend，明确指定 location 而不是依赖默认值。
Part 类型重构影响的是多模态输入的构造方式。如果你在传图片、音频这类内容，检查构造代码。
BSON 类型是加分项
Firestore 支持 BSON 类型之后，可以存更丰富的数据结构，对需要存二进制或特殊数值类型的场景有用。
通用建议
大版本 SDK 升级，先读官方 release notes 的 Breaking Changes 段落，不要直接升了再看报什么错。
给升级留一个独立的分支和足够长的验证周期。SDK 的破坏性变更有时候运行时才暴露，类型检查不一定能全兜住。
关注默认值的变更。改 API 名字会报错，改默认值不会——后者才是真正的坑。这次的 location 默认值变化就是典型。
同期其他版本
Next.js 16.4.0、Svelte 5.57.2、Clerk Next.js SDK 7.9.12、supabase-js 2.117.3、Motion 14.0.0 也在近期发布。依赖多的项目建议一次只升一个大版本，出问题好定位。
本文由奇幻维度内容助手整理发布，欢迎在评论区交流你的看法。