Tracie 安装和使用教程
面向 iOS 和 Android App 调试的日志和网络请求查看工具。遇到接口、会话、业务 code 或链路问题时，先在这里把证据看清楚。
Tracie 是什么
Tracie 用来查看 iOS 和 Android App 调试日志、网络请求详情和业务链路信息。
排查接口问题时，优先看请求路径、参数、状态码、耗时和响应体。按顺序完成安装、启动和扫码配对，优先记录 sessionId、接口路径和关键响应。
安装
Tracie 是本机或局域网临时调试工具。使用前先确认电脑已安装 Node.js 20.9.0 或更高版本。
node -v
以下版本与原教程保持一致，默认安装 0.1.8；如需和其他客户端保持一致，可以安装 0.1.7。
0.1.8（默认安装版本）
npm install -g "https://prism-stone-file.byering.com/prod/platform/files/tracie-0.1.8.tgz"
安装包 SHA-256：
af013946d0b871470f8b35fd89f9a7207339eb7c0a4b4822b79591a7eb4ab62d
0.1.7
npm install -g "https://prism-stone-file.byering.com/prod/platform/files/tracie-0.1.7.tgz"
安装包 SHA-256：
153ad9a286a8c957a4920be7e728281c3713d99eea099396b2f5cf3321bbb3e4
安装后可以查看帮助，确认命令已经可用。
tracie --help
启动日志台
在电脑终端启动 Tracie。默认会监听 3000 端口，并自动打开日志会话页面。
tracie start
启动成功后会看到类似输出。手机扫码时优先使用 Network 地址。
Tracie running at:
Local: http://localhost:3000/debug/logs/new
Network: http://192.168.1.10:3000/debug/logs/new
如果 3000 端口被占用，可以换一个端口。
tracie start --port 4000
扫码和查看日志
- 打开
tracie start输出里的/debug/logs/new页面。 - 页面会自动创建调试会话，并展示二维码、sessionId、pairingToken 和过期时间。
- 在 iOS 或 Android App 里进入调试或日志入口，点击扫码配对，扫描网页上的二维码。
- App 加入成功后，网页会进入日志台；如果没有自动跳转，点击页面上的“进入日志台”。
- 在 App 里复现问题，在日志台检查 path、params、status、duration、request body 和 response body。
- 把 sessionId、接口路径、traceId、recordId 和关键响应字段贴到问题单里。
更新版本
需要重新安装默认版本时，执行以下命令；如需其他版本，可使用上方对应的安装命令。
npm install -g "https://prism-stone-file.byering.com/prod/platform/files/tracie-0.1.8.tgz"
排查清单
- Node.js 版本：需要 Node.js 20.9.0 或更高版本。
- request failed：网络错误或非 2xx 响应。
- request business failed：HTTP 200，但业务 code 失败。
- request finished：HTTP 200 且业务成功。