用途：在已确定构建路径后，从零脚手架并配置面向 Meta Quest（Quest 2、Quest 3、Quest 3S、Quest Pro）与 Meta VR Glasses 的新项目，提供针对 Meta VR 硬件优化的分步设置说明。
主要能力：按构建路径给出项目创建步骤、所需工具与 SDK 版本、推荐项目设置、构建部署流程、测试迭代流程及常见坑。路径选择：Standard Android 适合以 Jetpack Compose、Android Views、React Native 或 Expo 实现的 2D 面板应用；Meta Spatial SDK 适合沉浸式场景、3D 实体、环境控制或 2D/3D 混合内容；Unity 适合 C# 沉浸式游戏或体验；Unreal Engine 适合 C++ 或蓝图项目；IWSDK/WebXR 适合基于浏览器运行的 Web 体验。
必要用法：前置步骤包括注册 Meta 开发者账号并创建组织、在手机 Meta Horizon 应用中开启头显开发者模式、通过 USB-C 启用 USB 调试、安装 metavr CLI（或使用 npx 免安装调用）。验证设备连接：metavr device list。Unity 项目必须使用 metavr_unity_setup MCP 工具创建，不要直接运行 Unity CLI 或手动走 Package Manager/XR Plug-in Management 步骤；仅在 MCP 工具不可用时参考手动回退文档。首次构建后安装与启动：metavr app install path/to/build.apk、metavr app launch com.yourcompany.yourapp、metavr adb logcat --follow --tag yourapp。
适用场景：新建 Meta VR 项目、配置渲染设置与 SDK 版本、搭建推荐架构与目录结构、按已选路径执行设置工作流。
限制与注意：需先用 hz-quest-verify-first 确定构建路径，不要按功能清单选 SDK。常见坑包括 Android API 级别不匹配（沉浸式项目建议最低 API 32、目标 API 34，具体以 hz-store-submit 与 hz-api-upgrade 为准）、仅支持 ARM64、Gradle 版本兼容性、Unity 版本与 Meta XR SDK 兼容性、Vulkan 与 OpenGL ES 选择、缺少 Android manifest 权限、首次构建前未设置包名、Unreal 中 OpenXR 与 OVRPlugin 混用。首次运行需验证性能基线：最低 72 Hz，Quest 3 建议 90 Hz 或 120 Hz，帧时间稳定且无热节流警告。其他平台细节、收费与价格信息暂未提供。