用途：在 Meta XR SDK 版本之间迁移 Unity 项目，覆盖 Meta VR 与 Horizon OS；适用于从 Oculus Integration 或较旧 com.meta.xr 包升级。Unreal、原生 Android、Spatial SDK、WebXR/IWSDK 及通用跨平台升级应改用 hz-api-upgrade。
主要能力与流程：先阅读 Unity 升级 runbook，对 Unity 版本、渲染管线、XR provider、Meta 包、vendored Assets/Oculus 内容、程序集定义及受影响场景/预制体做有界浅层盘点，建立受影响生产者、消费者、序列化资产、设置与测试的清单。从包或 SDK 家族标记确定源与目标版本，将 Meta XR 包版本、托管 OVRPlugin API 报告的捆绑原生 OVRPlugin 版本、Unity 编辑器版本与 XR provider 视为独立维度，不互相推断；版本不明确时报告证据并标注为推断。用 metavr 查询当前文档后再选替代方案，缺失结果记为文档覆盖缺口，不得凭记忆填补。先更新包拓扑再改应用代码：移除重复 vendored SDK 内容，保持相关 Meta 包与所需 bridge/adaptor 包兼容目标版本，更新 XR provider，解决程序集引用；同时验证包声明与序列化 loader/provider 设置。生产者与消费者一起迁移，搜索场景、预制体、序列化字段、自定义 loader、编辑器工具与测试，而非仅 .cs 调用点。使用 OVRSceneManager、OVRSceneRoom、OVRSceneAnchor 或自定义 Scene API loader 时，先读 MRUK 迁移最佳实践并执行其完成清单。
验证与限制：分层验证包解析、脚本编译、编辑/播放模式测试、Android 构建、头显行为。编译是阻塞反馈循环，每次连贯迁移切片后都要编译，失败时先看首个可操作错误并做最小修复。时间受限时预留约最后三分之一用于编译/修复。完成前核对包集合、XR provider 启用状态、重复 vendored 代码、遗留生产者与消费者、序列化预制体映射与 MRUK/provider 设置。不得仅凭编译通过报告成功；不得删除资产或整体改场景而未先识别消费者；不得将 deprecated 等同于 removed。若 metavr 不可用，改用官方开发者中心页面与已安装目标包的 changelog、公共 API 和示例，并报告未运行实时 CLI 检索。文档命令示例：metavr docs search --category UNITY --format json "Meta XR Unity SDK release notes <source> <target>"；metavr docs fetch --format json "<URL returned by search>"。