framer-upgrade-migration

用途：指导升级 Framer 插件 SDK、Server API，并在 Framer 平台版本之间迁移。升级前应先查看 Framer 开发者更新日志中的破坏性变更。

主要能力：检查当前版本、审阅更新日志、升级插件 SDK、处理常见迁移模式、回滚。

使用方式：

1. 检查当前版本：npm list framer-plugin framer-api framer；npm view framer-plugin version；npm view framer-api version。
2. 审阅更新日志：访问 https://www.framer.com/developers/changelog。关键迁移包括 Plugin API 3.x 引入 Managed Collections 与 Code File APIs；Server API beta 提供基于 WebSocket 的编程访问；Code Components v2 更新属性控件类型。
3. 升级插件 SDK：git checkout -b upgrade/framer-plugin；npm install framer-plugin@latest；npm run build 检查类型错误；npm test 运行测试。
4. 常见迁移模式：集合 API 由 framer.createCollection(...) 改为 framer.createManagedCollection(...)；代码组件控件类型由 ControlType.FusedNumber 改为 ControlType.Number（带 min/max/step）；Override 导入路径不变但需检查类型形状。
5. 回滚：npm install framer-plugin@3.x.x --save-exact 固定到先前版本。

前提条件：当前发布信息、站点组件/域名/集成/重定向清单、暂存站点与回滚负责人。

输出：记录审查的版本与组件、暂存与金丝雀结果、重定向与集成检查、审批人和回滚状态，不复制访客或凭据数据。

错误处理：路由、发布、访问、集成或隐私不匹配时停止推广，恢复先前版本并审查不透明失败后再重试。

适用场景：升级 Framer SDK 版本、检测弃用、平台版本迁移。限制：资料未提供具体收费、价格、平台支持范围等信息。