文档
连接手机,复现问题,交付完整证据
TabQA 直接通过 Chrome WebUSB 访问用户明确选择的 Android 设备。下面是 Free 基础采集工作流;Pro 增加 AI 辅助日志分诊、性能 HUD、UI 检查与环境模拟。
1. 准备 Android 手机
- 进入系统设置中的“关于手机”,连续点击版本号开启开发者选项。
- 在开发者选项中开启 USB 调试。
- 使用支持数据传输的 USB 线连接电脑,并将 USB 用途设为“文件传输”。
2. 在 Chrome 中授权
- 打开 TabQA 侧边栏并点击“选择 Android 设备”。
- 在 Chrome 设备选择器中选中手机,然后在手机上允许当前电脑进行 USB 调试。
- 如果设备显示忙碌,请退出 Android Studio,并停止已运行的桌面 ADB server。
3. 选择目标 App
- TabQA 会识别当前前台 App,也可以搜索或手动输入包名。
- 日志会围绕目标 App、崩溃和 ANR 过滤;只有开启高级设置时才保留原始全设备日志。
4. 开始采集
- 选择日志、截图和录像中的任意组合,然后点击“开始采集”。投屏启动后,页面调试会自动记录网络请求和 console.* 输出。
- 投屏运行时,可将一个或多个测试文件拖到手机画面,TabQA 会把它们传入手机共享存储根目录 /sdcard/。
- 复现问题过程中可以保存多张关键截图。Free 与 Pro 的普通录屏均最长 180 秒,且均支持回捞模式持续保留最近片段。
5. 定位与导出
- 在页面调试中切换网络与 Console:搜索接口、查看请求响应并导出脱敏 HAR,或按文本、正则及 Verbose、Info、Warning、Error 级别过滤 Console 输出。
- 完成采集后,TabQA 自动保存终态截图并整理日志上下文。填写复现信息,需要时为截图添加框、箭头或打码。
- 点击“导出 Markdown + 附件”获得 report.md、截图、日志和 MP4。
常见问题
AI 分析会发送哪些数据?
采集附件与 OCR 在本地处理;AI 分析会向配置的服务发送日志文本、请求信息、UI 属性或性能指标。网络凭证分析也可能在免费版的页面调试期间发起请求,详见隐私政策。
离线时还能使用 Pro 吗?
AI 请求失败或超时后,日志分诊、凭证检测、UI 断言和卡顿分析会使用本地规则降级。规则覆盖与云端结果可能不同;首次激活需要联网,离线使用仍需有效授权。
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,将免代理网络抓包、崩溃前滑动回捞录屏与一键导出缺陷证据链整合在一个工作区中,免去在多个桌面窗口间频繁切换。
如何开启 TabQA Pro 高阶 AI 诊断与卡顿分析?
在 TabQA 侧边栏点击顶部 Pro 按钮,输入购买获取的 32 位订单号或 License Key 即可立即解锁 AI 辅助日志分诊、性能 HUD、UI 元素检查与环境模拟。详细使用说明可查阅官网指南。