用途：metavr 是 Meta VR 与 Horizon OS 开发的 CLI，把 ADB 和 Meta 开发者 API 封装为更高层命令，覆盖设备管理、应用生命周期、文档查询、截图、音频控制、测试设备准备、MCP 集成和 Perfetto 性能分析。多数 Meta VR 开发任务无需直接使用 adb；需要原始 shell 时可用 metavr shell 或 metavr adb shell。
安装：独立二进制安装后位于 PATH，无前置依赖。macOS/Linux 执行 curl -fsSL https://developers.meta.com/horizon/install-cli/ | sh；Windows PowerShell 执行 iwr -useb https://developers.meta.com/horizon/install-cli/windows/ | iex。安装后可用 metavr update 更新。npm 分发需 Node.js 16 或更高，可用 npx -y metavr --version，或 npm install -g metavr 全局安装，之后用 npm update -g metavr 更新；npm 方式需在命令前加 npx -y。
设备连接：在头显设置中开启开发者模式（Settings > System > Developer），按提示启用 USB 调试，用 USB-C 连接电脑，然后运行 metavr device list 验证。若无设备，可换支持数据传输的 USB 线、在头显接受调试提示，或用 metavr device connect <ip> 无线连接。
主要命令组：adb/shell 提供底层 ADB 兼容命令与设备 shell；app 安装、列出、启动、停止、清除、检查及检测前台应用；asset 搜索 Meta 3D 资产库；audio 读取/设置音量、静音与取消静音；capture 截图；config 读写、重置、列出配置；device 列出/连接设备、等待 ADB 状态、检查控制器、配置测试设备、健康检查与邻近度管理；docs 搜索/获取 Meta VR 文档与 API 参考；files 列出、拉取、推送、删除、创建目录；log 查看近期日志（高级过滤与流式用 adb logcat）；mcp 启动或安装 MCP 服务器；perf 捕获、打开、分析、查询、比较和管理 Perfetto trace。
MCP 服务器模式：内置 MCP 服务器，约 40 个工具，供 AI 智能体以编程方式操作 Meta VR 设备，覆盖设备管理、应用生命周期、性能 trace 分析、文档搜索、文件操作和 3D 资产搜索。启动命令为 metavr mcp server；可安装到其他 AI 工具：metavr mcp install cursor、metavr mcp install claude-desktop、metavr mcp install vscode；项目本地安装用 cd your-project 后执行 metavr mcp install project，适合已有仓库访问权限的编码智能体。
典型工作流：先用 metavr docs search 与 metavr docs fetch 核对文档，再构建部署（如 ./gradlew assembleDebug、metavr app install、metavr app launch），随后用 metavr log --tag MyApp 与 metavr capture screenshot -o latest.png 观察设备行为，重复测试前用 metavr device health-check 与 metavr device configure-testing setup，测试后 restore。
限制：完整命令标志与语法需查看生成的 docs/metavr-cli.md 或运行 metavr --markdown-help，可用 metavr --markdown-help > docs/metavr-cli.md 重新生成。资料未提供收费、价格、平台支持范围及效果保证等信息。