Browser Use 1.0.2排查顺序:固定依赖、查询版本与区分CDP等待和页面阻塞

作者:像素猫时间:2026-11-16 11:27:48浏览:481

在现有uv项目中固定与读取BrowserUse1.0.2版本,区分正式/rc1、CLI MCP自带Chromium、CDP20秒及Windows编码修复。

Browser Use 1.0.2排查需要区分依赖和浏览器状态:版本查询能确认项目装了哪个包,不能证明MCP任务已经完成。正式版修复了Chrome远程调试关闭时的Chromium回退,同时调整相关CDP调用等待及对话框错误。1.0.2rc1是同日早些时候的候选,复现稳定修复无需再专门选择候选包。

Browser Use产品封面

明确测试项目的精确依赖号

以下适用于已经安装uv、具有pyproject.toml的测试项目目录。若需要复现这次历史版本,可使用官方发布条目给出的固定版本依赖命令;它会修改项目依赖及相应环境,不是在所有项目中强制降级的建议:

uv add 'browser-use==1.0.2'

命令成功后,预期项目依赖解析到1.0.2。已经使用后续维护版的项目,应评估自身版本说明,不要只为对应旧补丁号而覆盖现有依赖;解析冲突或安装失败也不能写成更新完成。

Browser Use 1.0.2正式版官方修复记录及固定版本依赖示例

读取项目环境实际安装的包版本

在同一项目目录执行下面的版本查询,无需账号、API密钥或浏览器路径。它读取当前uv项目环境中的包元数据:

uv run python -c "from importlib.metadata import version; print(version('browser-use'))"

对应依赖安装成功时,预期输出1.0.2。若输出别的版本,说明实际环境还需要核对;若提示PackageNotFoundError,表示该环境没有对应分发包。版本查询成功只确认安装状态,不证明浏览器连接、MCP会话或网页任务已经通过。

CLI MCP改用自带Chromium意味着什么

官方说明,Chrome远程调试关闭时,browser-use --cli-mcp不再只停在配置提示,而可驱动自己的Chromium。这减少了一种启动阻碍,但不等于已经连接用户日常使用的Chrome,也不等于自动继承其登录状态。

切换到用户Chrome仍涉及Chrome远程调试配置和MCP服务器重启,这与使用独立Chromium是不同会话条件。不要因为任务能打开一个浏览器窗口,就认定它操作的是原来带业务登录状态的浏览器。

CDP等待上限与对话框阻塞分别判断

1.0.2将CLI和MCP的CDP调用等待调整为20秒;页面被JavaScript对话框阻塞时,会较快返回明确错误,提示处理对话框。20秒对应的是相关CDP调用等待,不能当成整个Agent任务的总时长限制,也不保证所有慢网页都能完成。

因此,慢响应与对话框阻塞应按错误信息区分。单纯重复等待不能推导出阻塞已解除;明确的对话框错误也不代表全部网页脚本都发生异常。

UTF-8修复和反馈入口有什么边界

Windows下,MCP的browser_exec代码中open()文件读写使用UTF-8。这是对应MCP执行路径的编码调整,不能概括成系统所有文件或第三方程序都自动转换为UTF-8。

该版还提供CLI、Agent及MCP反馈入口,官方说明反馈文本发送前会清理。反馈能力用于报告问题,不是本地任务已经执行成功的证明,也不应据此推定任意敏感内容都适合提交。

1.0.2正式版于北京时间11月11日12:00发布,1.0.2rc1为同日06:56的较早候选。复现这次正式修复不必再专门选择rc1;完整后缀仍应保留,避免把候选安装和稳定安装混为一谈。安装状态、浏览器会话与实际MCP任务应分别验收,命令示例本身不代表任务已经运行成功。

作者最新文章