BrowserTrace 是一个本地回放调试器，专门用于排查 Browser Use 等浏览器自动化智能体运行失败的问题。当智能体失败时，日志只能说明执行了什么代码，却无法说明智能体实际看到了什么、点击了什么、返回了什么，以及第一个出错步骤的原因，BrowserTrace 正是为解决这一缺口而设计。
主要能力： 它以本地时间线的形式记录每个 Browser Use 步骤，包括截图、URL、动作、模型输入、模型输出、状态和错误。用户打开本地 UI 即可直接跳转到失败的浏览器状态。当同一任务同时有失败运行和已知成功运行记录时，可用 browsertrace compare <failed_run_id> <success_run_id> 定位第一个出现分歧的动作、URL、状态或错误。它被定位为本地调试产物通道，而非提示历史记录：截图、URL 和模型 I/O 都保留在本地 trace 存储中，browsertrace export --public 会在导出时省略提示/模型 I/O、截图和 URL，便于公开提交缺陷报告。
支持的集成： Browser Use 是主路径。Stagehand、Skyvern、Playwright + LLM 脚本以及自定义 computer-use 智能体作为次要集成提供支持。已覆盖的具体 Browser Use 失败模式包括新标签页失同步、多步表单漂移、本地 HTML 上传导航错误、远程 CDP 挂起以及仅图标目标不匹配等；次要集成模式涵盖 Stagehand 语义验证边界、Skyvern VNC/CDP 调试集成以及 Skyvern 多会话 VNC 控制漂移。
使用方式： 项目发布在 PyPI（https://pypi.org/project/browsertrace/），可从 PyPI 安装，要求 Python 3.11+。最快的免安装体验方式是使用 uvx，持久安装则使用 pip install，并可为本地 Web UI 安装 [ui] 扩展；仅 SDK 安装即可满足 trace 捕获集成以及终端命令如 browsertrace list、browsertrace show、browsertrace export。常用本地命令包括：browsertrace doctor 用于安装与 trace 存储状态检查，browsertrace doctor --json 输出 JSON 状态；browsertrace demo 无需 API 密钥或外部服务即可运行，并生成确定性 trace；browsertrace list 显示最近运行 ID、时间戳和状态，支持 --json、--status、--limit 过滤；browsertrace show <run_id> 在终端查看某次运行的步骤时间线，支持 --json；browsertrace export <run_id> --public -o public.html 生成可公开的安全自包含 HTML 报告；browsertrace compare 支持 --json 便于自动化。默认本地 trace 存储在 ~/.browsertrace/，可通过 BROWSERTRACE_HOME 使用隔离存储；本地 UI 默认绑定 127.0.0.1，使用 BROWSERTRACE_PORT 可更改端口。在自有代码中使用时，支持装饰器 @trace（同步和异步函数均可）、Playwright 快捷方式 run.snapshot(page, action=...) 和 run.snapshot_sync(page, ...)（同步 Playwright）、上下文管理器（with 块抛错时运行标记为失败并将错误记录到最后一个步骤），以及 Browser Use、Stagehand、Skyvern 等适配器集成方式。
适用场景： 适合需要调试浏览器自动化智能体失败步骤的开发者，包括排查 Browser Use 运行失败、对比失败与成功运行、以及为公开缺陷报告生成不含敏感信息的 HTML 导出。也适合在 pytest、CI（如 GitHub Actions、GitLab CI）中作为构建产物生成 public.html，BrowserTrace 本身不会上传 trace。
限制： BrowserTrace 是一个本地调试工具，不提供云端服务，也不自动上传任何 trace；公开导出会省略模型 I/O、截图和 URL，--redact 仅省略模型 I/O，--public 还会省略截图和 URL。Python 版本要求为 3.11+。部分功能（如 UI）需要额外安装 [ui] 依赖。本资料未提供收费、价格或更多平台支持信息，暂未提供相关内容。
