升级 Hermes 之后,你的浏览器工具悄悄换成了这个


你像往常一样升级了 Hermes,第二天让 agent 去网页上查个东西,结果发现它的“画风”变了:以前是 browser_navigatebrowser_click 一步步截图、点击、再看,现在它直接甩给你一行 browser_exec(code),一个工具就把整件事办完了。别慌,不是你配置坏了,也不是出了 bug——从 2026 年 8 月 10 日合并的 PR #83402 开始,Browser Use 模式成了 Hermes 的默认浏览器后端。这篇文章讲清楚这次“默认切换”到底改了什么、你的环境会怎么表现,以及想回到以前那套 12 个小工具该怎么做。

从“可选模式”到“默认后端”

上个月我们介绍过 Browser Use CLI 3.0 模式(PR #81958):在 config.yaml 里把 browser.backend 设为 browser-use,模型就不再看到 browser_navigatebrowser_clickbrowser_type 这一堆小工具,而是只有一个 browser_exec——用一段 Python 代码在真实浏览器里完成任意操作。官方基准测试中,多步网页任务的 token 总量下降了 48% 到 66%,准确率持平。当时这是要手动开启的“新玩法”;8 月 10 日的 PR #83402 把它变成了默认。

新默认规则:能用就用,不能用就回退

现在不配置 browser.backend(保持默认的空值)时,Hermes 会这样决定(逻辑在 tools/browser_use_cli.pyis_browser_use_cli_mode()):

  1. 本机能跑 browser-use CLI(装好的 browser-use 命令,或系统里有 uvx 可以临时拉取)→ 进入 Browser Use 模式,模型只看到 browser_exec 一个工具;
  2. 跑不起来(没装、装坏了)→ 自动回退到内置的 12 个 browser_* 工具,浏览功能不会悄悄失效;
  3. 显式配置永远优先backend: browser-use 强制开启,backend: off 强制回到内置工具;
  4. Camofox 用户不受影响——它基于 Firefox 的自定义 HTTP API,没有 CDP 接口,永远走内置工具;
  5. 老配置兼容:以前用 BROWSER_USE_API_KEY 配的旧版 Browser Use 云模式会自动迁移,行为不变。

这里还有一个 YAML 小坑值得知道:backend: off 在 YAML 1.1 里会被解析成布尔 false。源码专门做了归一化,把 false 当成“显式关闭”而不是“没配置”,所以手改配置文件也不会踩坑。

先看看你当前处于哪个模式

运行 hermes tools,Browser Use 那一行会高亮显示当前生效的模式——是默认开启、显式关闭,还是被 Camofox 排除。会话里也可以直接输入 /browser 查看,/browser use 切换到 Browser Use 模式,/browser use off 切回内置工具。

想回到原来那套 12 个小工具?

很简单,在 config.yaml 里加一行:

browser:
  backend: off   # 强制使用内置的 browser_navigate / browser_click / ...

或者不想动配置文件,直接在会话里输入 /browser use off。反过来,如果升级后发现自己还在用旧工具、想试试默认模式,把 backend 删掉留空("")即可,前提是装好 browser-use CLI 或 uvx

browser_exec 到底多了什么

默认模式下的 browser_exec 是一个“代码即操作”的工具:你描述目标,模型生成一段 Python,在真实浏览器(通过 CDP 连接)里执行。内置 helper 包括 new_tabjsfill_inputclick_at_xycdp 等;后端可以是本地 Chrome,也可以是 Browserbase、Nous Portal、Firecrawl 等云浏览器。步骤越多,省下的 token 越多——这也是官方把它扶正为默认的原因。详细的用法、helper 列表和基准数字,可以看我们上一篇的完整介绍

小结

这次默认切换对多数人是透明升级:能跑 CLI 就自动用上省 token 的新模式,跑不了就安静回退,不会坏。需要留意的只有一点——如果你在工作流里明确依赖 browser_navigate 那 12 个工具的名字(比如在观察 agent 的行为日志),升级后请主动确认当前模式,或直接用 backend: off 锁回旧行为。想了解浏览器后端的安装与配置细节,可以看安装指南命令参考