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

你像往常一样升级了 Hermes,第二天让 agent 去网页上查个东西,结果发现它的“画风”变了:以前是 browser_navigate、browser_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_navigate、browser_click、browser_type 这一堆小工具,而是只有一个 browser_exec——用一段 Python 代码在真实浏览器里完成任意操作。官方基准测试中,多步网页任务的 token 总量下降了 48% 到 66%,准确率持平。当时这是要手动开启的“新玩法”;8 月 10 日的 PR #83402 把它变成了默认。
新默认规则:能用就用,不能用就回退
现在不配置 browser.backend(保持默认的空值)时,Hermes 会这样决定(逻辑在 tools/browser_use_cli.py 的 is_browser_use_cli_mode()):
- 本机能跑 browser-use CLI(装好的
browser-use命令,或系统里有uvx可以临时拉取)→ 进入 Browser Use 模式,模型只看到browser_exec一个工具; - 跑不起来(没装、装坏了)→ 自动回退到内置的 12 个
browser_*工具,浏览功能不会悄悄失效; - 显式配置永远优先:
backend: browser-use强制开启,backend: off强制回到内置工具; - Camofox 用户不受影响——它基于 Firefox 的自定义 HTTP API,没有 CDP 接口,永远走内置工具;
- 老配置兼容:以前用
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_tab、js、fill_input、click_at_xy、cdp 等;后端可以是本地 Chrome,也可以是 Browserbase、Nous Portal、Firecrawl 等云浏览器。步骤越多,省下的 token 越多——这也是官方把它扶正为默认的原因。详细的用法、helper 列表和基准数字,可以看我们上一篇的完整介绍。
小结
这次默认切换对多数人是透明升级:能跑 CLI 就自动用上省 token 的新模式,跑不了就安静回退,不会坏。需要留意的只有一点——如果你在工作流里明确依赖 browser_navigate 那 12 个工具的名字(比如在观察 agent 的行为日志),升级后请主动确认当前模式,或直接用 backend: off 锁回旧行为。想了解浏览器后端的安装与配置细节,可以看安装指南和命令参考。