TabQA logoTabQA

文档

连接手机，复现问题，交付完整证据

TabQA 直接通过 Chrome WebUSB 访问用户明确选择的 Android 设备。下面是从零开始的完整工作流。

1. 准备 Android 手机

  1. 进入系统设置中的“关于手机”，连续点击版本号开启开发者选项。
  2. 在开发者选项中开启 USB 调试。
  3. 使用支持数据传输的 USB 线连接电脑，并将 USB 用途设为“文件传输”。

2. 在 Chrome 中授权

  1. 打开 TabQA 侧边栏并点击“选择 Android 设备”。
  2. 在 Chrome 设备选择器中选中手机，然后在手机上允许当前电脑进行 USB 调试。
  3. 如果设备显示忙碌，请退出 Android Studio，并停止已运行的桌面 ADB server。

3. 选择目标 App

  1. TabQA 会识别当前前台 App，也可以搜索或手动输入包名。
  2. 日志会围绕目标 App、崩溃和 ANR 过滤；只有开启高级设置时才保留原始全设备日志。

4. 开始采集

  1. 选择日志、截图和录像中的任意组合，然后点击“开始采集”。投屏启动后，页面调试会自动记录网络请求和 console.* 输出。
  2. 投屏运行时，可将一个或多个测试文件拖到手机画面，TabQA 会把它们传入手机共享存储根目录 /sdcard/。
  3. 复现问题过程中可以保存多张关键截图。普通录屏最长 180 秒；回捞模式会持续保留最近片段。

5. 定位与导出

  1. 在页面调试中切换网络与 Console：搜索接口、查看请求响应并导出脱敏 HAR，或按文本、正则及 Verbose、Info、Warning、Error 级别过滤 Console 输出。
  2. 完成采集后，TabQA 自动保存终态截图并整理日志上下文。填写复现信息，需要时为截图添加框、箭头或打码。
  3. 点击“导出 Markdown + 附件”获得 report.md、截图、日志和 MP4。

常见问题

Chrome 列表里没有手机

确认数据线支持传输，将 USB 用途改为文件传输，重新开启 USB 调试并插拔手机。

设备正忙

WebUSB 与桌面 ADB 无法同时占用设备接口。关闭 Android Studio，运行 adb kill-server 后重试。

关闭侧边栏后采集中断

WebUSB 连接属于侧边栏页面。采集期间保持侧边栏打开；已经保存的附件不会丢失。

录像没有声音

TabQA 的录屏当前不采集设备音频，这是设计限制。

为什么有些请求没有显示

网络抓取适用于浏览器页面和开启调试的应用页面。原生网络库发出的请求当前不会显示。

为什么没有看到页面 Console

Console 抓取仅适用于 Android Chrome 页面和已开启 WebView 调试的页面，并且只显示页面调用 console.* 产生的输出；它不是可执行 JavaScript 的完整 DevTools Console。

TabQA 与 Scrcpy 或 Vysor 等工具有什么区别？

Scrcpy 是一款令人赞叹的原生桌面端高性能投屏利器。TabQA 的定位则完全不同：它是一个运行在 Chrome 浏览器内的免配置测试工作台。基于 WebUSB 技术，无需安装本地 ADB 或驱动，将免代理网络抓包、崩溃前滑动回捞录屏与一键导出缺陷证据链整合在一个工作区中，免去在多个桌面窗口间频繁切换。