决策报告：Pico 头显桥接 vs 桌面 WebXR 仿真¶

裁决日期: 2026-06-02 项目: truth-lab 最速降线 WebXR 模拟器 目标设备: Pico Ultra 4 VR 头显 核心痛点: 开发迭代慢 (30-60秒/次)

1. 双方方案对比表¶

2. 冲突还是互补？—— 互补¶

结论：这两个方案彻底互补，不是冲突关系。

它们解决的是同一个痛点的**两个不同环节**：

1
2
3
4
5

开发流程分解：
  改代码 → 验证效果 → 发现 bug → 改代码...
           ↑                  ↑
     桌面仿真解决        真机桥接解决
     "不用戴头显"        "戴上后更快"

各自解决的问题¶

重叠分析¶

有少量重叠 —— 两者都能做**UI/逻辑调试**。但： - 桌面仿真覆盖的是**开发早期**（写新功能时快速验证逻辑） - Pico 桥接覆盖的是**集成阶段**（在真实 XR 环境中验证交互、性能）

能否同时实施？¶

能，而且应该同时推进 —— 但它们有明确的先后依赖关系（见下节）。

3. 先做哪个？为什么？—— 先做 Pico 桥接¶

最终裁决：立即实施 Pico 头显桥接（Phase 1），2周内完成桌面仿真（Phase 2）¶

核心理由¶

理由 1：ROI 碾压¶

Pico 桥接的 ROI 比桌面仿真高约 200 倍（按实施时间加权）。

理由 2：紧迫性 —— 当前痛点就是"慢"¶

用户明确说："每次改代码要 30-60 秒才能看到结果"。

• Pico 桥接直接消灭这个问题（<1s 迭代）
• 桌面仿真虽然好，但**6小时开发周期内你仍然要忍受 30-60s 的迭代**
• 先做桥接，当天就能享受即时反馈

理由 3：风险分析¶

理由 4：依赖关系¶

桌面仿真**不依赖** Pico 桥接，但： - Pico 桥接完成后，桌面仿真的验证也有了快速回环（仿真→真机验证只需 1 秒） - 两个方案组合使用效果 > 各自单独使用之和（1+1 > 2）

4. 分阶段实施路线图¶

Phase 1: Pico 桥接（立即实施，当天完成）¶

目标：把迭代速度从 30-60s 降到 <1s

Phase 1 总计耗时：约 15 分钟

Phase 1 产出： - npm run dev:pico → 启动 HTTPS Vite 开发服务器 - ./pico-helper.sh dev → 一键启动全部调试环境 - ./pico-helper.sh forward → 转发 ADB DevTools - Pico 浏览器打开 https://192.168.x.x:5173 → 即时 HMR 反馈 - Chrome chrome://inspect → 实时 JS 远程调试

Phase 1 效果量化： - 迭代速度：30-60s → <1秒（UI/逻辑变更）/ ~1-2秒（WebXR 变更需手动刷新） - 每天按 50 次迭代计算：节约 25-50 分钟/天

Phase 2: 桌面 VR 调试模式（Phase 1 后 1-2 周内）¶

目标：非 XR 交互逻辑可在桌面完成 80% 调试

Phase 2 总计耗时：约 6 小时（分散在 1-2 周内）

Phase 2 产出： - https://localhost:5173/?vr-debug → 桌面端可模拟 VR 交互 - 鼠标拖拽控制点、键盘触发手柄操作

Phase 2 效果量化： - 预计减少 ~70-80% 的真机测试次数 - 仅在 XR 特定行为（坐标系、性能、WebXR session）需要戴头显 - 配合 Phase 1，每次真机测试也是 <1s 的快速回环

Phase 3: 持续优化（长期）¶

5. 不要做的建议（陷阱/弯路）¶

❌ 不值得做的事¶

⚠️ 需要警惕的中等陷阱¶

1. 过度追求桌面仿真 fidelity — 仿真永远是仿真，手柄的扳机手感、射线精度、6DoF 抖动在桌面上永远无法完全模拟。桌面仿真用来**验证逻辑**而非**验证交互**。
2. 在 Phase 1 还没有做的情况下先做 Phase 2 — 这是最大的弯路。没有 Pico 桥接，桌面仿真验证后最终还是要走 30-60s 的慢迭代上真机。
3. 一次做太多自动化 — 保持简单：pico-helper.sh + 几个 npm scripts 就够用了。不要一开始就搞 CI/CD。

6. 最终总结¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

┌──────────────────────────────────────────────────────────────┐
│                    最终裁决                                   │
├──────────────────────────────────────────────────────────────┤
│                                                              │
│   ✅ 先做：Pico 头显桥接（Phase 1）—— 立即实施，当天见效      │
│   ✅ 后做：桌面 VR 仿真  （Phase 2）—— 1-2周内实施            │
│   ✅ 关系：互补，Pico 桥接是桌面仿真的加速器                   │
│   ❌ 别碰：ngrok、Puppeteer、Eruda（现阶段不需要）            │
│                                                              │
│   预计效果：                                                 │
│   - 迭代速度：30-60s → <1s (Phase 1)                         │
│   - 真机测试减少：~80% (Phase 2)                              │
│   - 日节省时间：25-50分钟/开发者                              │
│                                                              │
└──────────────────────────────────────────────────────────────┘