跳转至

truth-lab Pico 调试 · 快速入门

你只需要 Pico 开 USB 调试 + 本机装 adb，其他都在本机操作

完整文档： truth-lab-workflow.md

1. Pico（只需做一次）

设置 → 通用 → 开发者选项 → 开启 USB 调试

没看到开发者选项？去"关于本机"连点版本号 7 次

2. 本机装 adb

Mac: 

1
brew install android-platform-tools

Windows: 下载 https://developer.android.com/studio/releases/platform-tools → 解压 → 把 adb.exe 所在目录加到 PATH

验证： 

1
adb --version   # 应 >= 1.0.41

3. 日常开发流程

1
2
3
4
5
6
7
改代码 → git push → SSH 到服务器：
    git pull
    npm run build:fast    ← 5秒，跳过类型检查
    # 或 npm run build    ← 完整构建含类型检查
    npm run deploy        ← rsync 部署

戴 Pico → 刷新 ilmhub.top/truth-lab/

4. 需要调试 JS 时（本机操作）

1
2
3
4
5
连 USB → 本机终端：
    adb devices               # 确认连接
    adb forward tcp:9222 localabstract:chrome_devtools_remote
    # 打开 Chrome → chrome://inspect
    # 点 inspect → 弹出完整 DevTools

DevTools 能做什么： | 面板 | 用途 | |------|------| | Console | 看报错、console.log、手动执行 JS | | Sources | 断点调试 | | Network | 看请求 | | Performance | 性能分析 |

5. 一键脚本（本机用）

在你的本机上创建一个文件 pico-debug.sh：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
#!/bin/bash
# Pico 调试助手
case "${1:-help}" in
  check)
    echo "=== 环境 ==="
    which adb && adb --version | head -1 || echo "❌ adb 未安装"
    echo "---"
    adb devices
    ;;
  fwd)
    adb forward tcp:9222 localabstract:chrome_devtools_remote
    echo "✅ 转发成功 → 打开 Chrome 访问 chrome://inspect"
    ;;
  log)
    adb logcat -s chromium:*:V
    ;;
  ss)
    adb exec-out screencap -p > "pico-ss-$(date +%Y%m%d-%H%M%S).png"
    echo "✅ 截图已保存"
    ;;
  *)
    echo "用法: ./pico-debug.sh [check|fwd|log|ss]"
    ;;
esac

常见问题

问题 原因 解决
adb devices 看不到设备 USB 线/授权 检查线，Pico 上点允许
chrome://inspect 空白 端口没转发 先跑 adb forward
Pico 上页面不更新 缓存 Pico 浏览器下拉刷新
WebXR 进不去 证书/HTTPS ilmhub.top 已有合法证书