用途：hzdb（Horizon Debug Bridge）是 Meta Quest 与 Horizon OS 开发的 CLI，将 ADB 与 Meta 开发者 API 封装为更高层命令，覆盖设备管理、应用生命周期、文档查询、截图、音频控制、测试设备准备、MCP 集成与 Perfetto 性能分析。多数 Quest 开发任务无需直接使用 adb；需要原始 shell 时可用 hzdb shell 或 hzdb adb shell。
安装与版本：需要 Node.js 20 或更高版本。推荐用 npx 调用，始终拉取最新发布版本：npx -y @meta-quest/hzdb --help、npx -y @meta-quest/hzdb --version。也可全局安装：npm install -g @meta-quest/hzdb，并定期用 npm update -g @meta-quest/hzdb 更新。
设备连接：在 Quest 上开启开发者模式（Settings > System > Developer），按提示启用 USB 调试，用 USB-C 连接电脑，然后运行 hzdb device list 验证。若无设备，可换支持数据传输的 USB 线、在头显上接受调试提示，或用 hzdb device connect <ip> 无线连接。
命令发现：先看命令组与常见工作流，再按领域查阅聚焦参考文件；精确参数与不常见子命令用 docs/hzdb.md 或 hzdb --markdown-help。顶层命令组包括 adb/shell、app、asset、audio、capture、config、device、docs、files、log、mcp、perf。
MCP 服务器：内置 MCP 服务器，约 40 个工具，供 AI 智能体以编程方式操作 Quest 设备。启动：hzdb mcp server。安装到其他 AI 工具：hzdb mcp install cursor、hzdb mcp install claude-desktop、hzdb mcp install vscode；项目本地安装：cd your-project 后 hzdb mcp install project。
常见工作流示例：hzdb docs search "spatial sdk panel"、hzdb docs fetch <url>；./gradlew assembleDebug、hzdb app install app/build/outputs/apk/debug/app-debug.apk、hzdb app launch com.example.app；hzdb log --tag MyApp、hzdb capture screenshot -o latest.png；hzdb device health-check、hzdb device configure-testing setup、hzdb device configure-testing restore。
限制：资料未提供收费、价格、平台支持范围与效果数据；完整命令细节需查阅生成的 docs/hzdb.md，可用 npx -y @meta-quest/hzdb --markdown-help > docs/hzdb.md 重新生成。