用途：帮助把现有 Meta VR 应用升级到更新的 Horizon OS SDK 版本，处理废弃 API 警告或编译错误，在主要 API 版本间迁移（如 VrApi 到 OpenXR），了解各 SDK 版本间的变化，并为落后多个版本的项目规划升级路径。Unity 项目请改用专门的 hz-unity-sdk-upgrade 技能。
主要能力：提供通用升级流程——识别当前 SDK 版本、查阅 API 变更日志、更新 SDK 依赖、修复废弃 API 调用、在设备上测试、运行性能检查；并给出各平台升级路径（Unreal 的 Meta XR Plugin、Android/Spatial SDK 的 Gradle 依赖、Web/IWSDK 的 npm 包）。还汇总常见升级问题：命名空间从 Oculus./OVR 迁移到 Meta.*、API 被移除、新增权限（如 com.oculus.permission.HAND_TRACKING、horizonos.permission.HEADSET_CAMERA）、AndroidManifest.xml 的 meta-data 变更，以及新二进制上传需将 targetSdkVersion 设为 32-34（沉浸式应用）或 32-36（2D 面板应用），minSdkVersion 可保持 32。
使用方式：可用 metavr 工具检索文档，如 metavr docs search "migration guide"、metavr docs search "deprecated API"；若 metavr 不在 PATH，可用 npx -y metavr <args>。设备测试与性能检查命令包括 metavr app install ./build/output.apk、metavr app launch com.yourcompany.yourapp、metavr perf capture。查找废弃 API 可用 grep 命令，例如 grep -rn "vrapi_" --include=".c" --include=".cpp" --include=".h" src/ 与 grep -rn "OVRManager" --include=".cs" Assets/。
适用场景：Unreal、原生 Android、Spatial SDK、Web/IWSDK 项目的 SDK 升级与跨平台升级规划。
限制：资料未提供具体版本号、价格、平台支持范围或效果保证；升级前应查阅对应参考文档并逐步增量升级，避免跳过中间版本导致符号缺失。