用途:把生成的 OSDK 变更和官方 Platform SDK 发布视为契约迁移,冻结新旧产物,阅读迁移指南或发布说明,只更新一个边界,并在非生产环境验证兼容性。
主要能力:建立新旧契约清单(导入、生成实体、操作、作用域、运行时、测试);审查官方迁移与发布证据并分类变更;在分支上更新固定版本的 SDK/客户端或产品;运行单元与契约测试,以及代表性读取、分页、仅验证模式的 Action、鉴权拒绝、限流和错误映射;在非生产环境安装、对比行为与遥测、取得批准后提升精确版本,并保留经过测试的降级方案。
使用方式:先确认当前与目标版本、生成的应用、语言/运行时、调用点、负责人和目标环境,捕获锁文件、生成元数据、OAuth 限制、测试和代表性查询/Action。阅读 references/official-docs.md 及语言相关迁移指南。准备分支和带文档化降级的非生产安装。工具使用上,用 Glob 定位仓库与清单,用 Grep 查找标识符与权限,用 Read 查看最小必要文件,Write 仅用于新批准的本地草稿或证据,Edit 仅用于回滚已知的有界变更。
限制与边界:不得在 SDK 升级中顺带更改授权类型、作用域、资源限制、服务用户权限或密钥;如需鉴权变更,应作为独立安全迁移审查测试。应用与产品负责人批准版本,本体负责人批准重新生成的资源,安全负责人批准单独提出的鉴权变更,生产负责人批准提升与降级窗口。若生成符号消失,先确认 Developer Console 选择与已发布本体变更;若测试通过但访问范围扩大,阻止提升并比较作用域与权限;若降级无法恢复兼容,保持生产在旧版本并重新设计迁移顺序。资料未提供具体命令、价格或平台支持细节。