用途：在升级或回滚 Vast.ai 客户端（CLI 与 Python SDK）及工作负载模板时，避免臆测 API 版本变更，将 provider 客户端与模板视为独立兼容边界。
主要能力：固定并测试受管 CLI 或 PyPI 包；迁移期间保留 vastai_sdk 兼容层；先金丝雀验证模板，再执行滚动更新。
必要用法（按资料整理）：先从当前版本、安装渠道、导入方式、命令、模板与依赖自动化信息冻结现有约定；CLI 用其版本感知更新机制并保留旧版，Python 在一次性环境中固定目标 vastai 包；运行认证、offer 搜索、实例读取、响应规范化与预期拒绝测试；在兼容层存在时从 vastai_sdk 迁移到 vastai，并测试实际使用的高层与同步/异步边界；为模板变更创建独立端点或一次性实例，验证输出与恢复后，如为 Serverless 再触发受控滚动更新；对比约定与 SLO 证据后接受或回滚，失败时恢复旧客户端固定版本或旧模板哈希并验证回滚路径。认证方面需确认升级后客户端仍读取预期的 XDG 或环境凭据并保持最小权限，默认不使用无范围限制的生产密钥测试。
适用场景：服务从 vastai_sdk 过渡到 vastai、模板金丝雀与 Serverless 滚动更新等可逆迁移。
限制与错误处理：结构化输出变化应在适配器约定处失败并保留旧固定版本；凭据来源变化应停止并恢复原密钥优先级；金丝雀输出或恢复回退则拒绝模板并让生产保留旧哈希；回滚产物不可用时发出 NO-GO。未经明确批准不得创建、更新、销毁或充值 Vast.ai 资源。