用途：指导升级 Gamma SDK 版本并在不同 API 版本之间安全迁移，适用于升级 SDK 包、处理弃用、迁移到新 API 版本等场景。
主要能力：检查当前版本（npm list @gamma/sdk、pip show gamma-sdk、npm outdated @gamma/sdk）；审阅变更日志（npm info @gamma/sdk changelog，或访问 https://gamma.app/docs/changelog）；升级 SDK（npm install @gamma/sdk@latest、pip install --upgrade gamma-sdk，或指定版本如 npm install @gamma/sdk@2.0.0）；处理 v1.x 到 v2.x 的常见迁移模式，包括客户端初始化（new Gamma(apiKey) 改为 new GammaClient({ apiKey })）、响应格式（result.id 改为 result.data.id）、错误处理（e.code === 'RATE_LIMIT' 改为 e instanceof RateLimitError）；更新类型定义并运行 npx tsc --noEmit；执行单元测试、集成测试与手动冒烟测试；通过 showDeprecationWarnings 处理弃用方法（如 getPresentations() 改为 presentations.list()）。
使用方式：需已有 Gamma 集成、版本控制（git）和可用测试环境。流程为创建升级分支（git checkout -b feat/gamma-sdk-upgrade）、升级、修复类型错误、处理弃用警告、测试、验证预发布部署、规划生产部署。回滚可执行 git checkout main 后 npm install，或显式降级 npm install @gamma/sdk@1.x.x。
限制与错误处理：遇到 schema、发布、共享、访问或目标不匹配时应停止推进，恢复先前配置并隔离不透明故障以供审查。升级回执应记录已审阅版本、受影响集成、兼容性/金丝雀结果、负责人批准与回滚状态，且不包含内容、查看者数据和凭据。具体收费、价格与平台信息暂未提供。