browser use 1.0.2已经是正式版,同日早些时候的1.0.2rc1属于候选阶段。此次修复让cli mcp在chrome未开启远程调试时可使用自己的chromium,同时调整cdp等待、对话框错误和windows文件编码。排查时应先确认实际依赖版本,再区分浏览器来源、页面阻塞和mcp状态,不能把所有等待都当作版本未更新。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在现有uv项目中明确依赖版本
以下适用于已经安装uv、具有pyproject.toml的测试项目目录。若需要复现这次历史版本,可使用官方发布条目给出的固定版本依赖命令;它会修改项目依赖及相应环境,不是在所有项目中强制降级的建议:
uv add 'browser-use==1.0.2'
命令成功后,预期项目依赖解析到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是不同会话条件。不要因为任务能打开一个浏览器窗口,就认定它操作的是原来带业务登录状态的浏览器。
20秒等待与JavaScript对话框错误怎样区分
1.0.2将CLI和MCP的CDP调用等待调整为20秒;页面被JavaScript对话框阻塞时,会较快返回明确错误,提示处理对话框。这个20秒针对相关CDP调用,不是整个Agent任务的统一最长时长,也不能用来承诺所有慢网页都会成功。
因此,慢响应与对话框阻塞应按错误信息区分。单纯重复等待不能推导出阻塞已解除;明确的对话框错误也不代表全部网页脚本都发生异常。
Windows编码和反馈能力的适用范围
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任务应分别验收,命令示例本身不代表任务已经运行成功。











