agent-browser

智能体与MCP 45.4k 3.1k Rust 上架 2026-11-08 访问官网 ↗ 在 GitHub 打开

专为 AI agent 设计的浏览器自动化命令行界面 (CLI)。简洁的文本输出最大限度地减少了上下文信息的使用。100% 原生 Rust 编写。特性 Agent 优先：紧凑的文本输出比 JSON ...

#Web应用开发 #Agent

项目信息

所有者: vercel-labs
Star: 45.4k
Fork: 3.1k
开源协议: —
主要语言: Rust
发布时间: 2026-01-11
最近更新: 2026-11-03

项目更新

v0.41.12026-11-01
本次修复集中在命令行为的准确性上：cookies set 现在正确遵循 --http-only 与 --same-site，保留原有别名写法，未知参数会被直接拒绝；errors --clear 终于能真正清掉已捕获的页面错误。MCP 侧，纯整数选择器不再被误当作超时等待，而是返回错误；插件报错也做了脱敏，不再回传不支持的协议值。数值配置更稳妥：空闲超时溢出或输出上限非法时改为给出警告，既不溢出也不再被静默吞掉。此外，安装的 agent skill 已移除对 npx 的免固定版本执行权限，收紧了一处供应链风险。文档新增了 Vercel Sandbox 中复用同一服务进程的 stdin MCP 连接说明，并配置了桌面版文档路由与站点地图。
v0.41.02026-10-29
agent-browser 0.41 带来一次破坏性调整：@agent-browser/eve 的工具不再手写维护，改为直接取用 CLI 的 MCP 工具目录，工具名与入参随之全变——navigate 变 open、evaluate 变 eval、presskey 变 press、selectoption 变 select、setchecked 拆成 check 与 uncheck，get、tabs、waitfor 也分别拆为 get、tab、wait_* 系列。使用 @agent-browser/eve/tools 覆盖的调用方需要同步改名；沙箱所需的 0.41 版本由扩展默认安装。新命令 agent-browser mcp call <tool> '<json>' 可单次执行一个 MCP 工具并以 JSON 输出结果，适合无法在两次工具调用间保持进程常驻的运行时；另新增 @agent-browser/sandbox/mcp-tools.json，收录全部工具的标题、说明与入参 schema，并由测试校验。安全方面堵了一个洞：MCP 工具入参此前能顺带写入全局 flag，例如在选择器或 extraArgs 里塞入 --allowed-domains，从而覆盖服务端或调用方的域名白名单，现在这类调用会被直接拒绝。性能上，@agent-browser/eve 把每次工具调用拆成独立短命进程，工具调用结束后不会再留下残留的 agent-browser 进程；模型上下文只列出 28 个 core 工具，其余 14 个按需通过 eve__search 查找，保持提示词体积不涨。
v0.40.02026-10-27
@agent-browser/eve 升为硬性依赖 eve 0.84.0 及以上——新版 eve 会拒绝旧版构建的扩展，因此一并跟着重编译了；仍在旧 eve 上跑的应用请留在 @agent-browser/eve@0.39。功能方面，@agent-browser/sandbox/vercel 新增每个 Vercel Sandbox 独立的 MCP server：startAgentBrowserMcp 通过 Sandbox stdin 维持单个 agent-browser mcp，connectAgentBrowserMcp 则供任何暴露 stdin/stdout 流的运行时接入。batch 命令与 MCP batch 工具新增 --omit-command / omitCommand，JSON 输出里重复的原始命令数组改用从 0 开始的索引指代，体积明显变小。修复值得一提：state load 与启动时的存储恢复曾把保存的令牌暴露给页面脚本，重定向后还会把 A 站点的 storage 写进 B 站点，现改为仅在页面位于原站点时经 DevTools 写入并报告跳过的来源，属安全类问题。另有三项：daemon 退出后 <session>.config 残留在 socket 目录；network route --body 模拟的跨域响应过不了 CORS，新增 --allow-origin <origin>（MCP network_route 同步支持）回应预检，并在未设 content type 时按 application/json 发送；Windows 下僵死 daemon 仍占着固定标签页，以及不同 socket 目录里同名会话误连到彼此 daemon 的问题。
v0.39.42026-10-26
本次更新集中修复了几处影响日常使用的缺陷。wait --download 在下载先于等待启动时不再超时，会把文件正确移动到指定路径；启用 --allowed-domains 打开含跨域 iframe 的页面时，也不再报「Cannot find default execution context」。截图问题一并修掉：高 DPI 屏上整页截图尺寸翻倍、内容只挤在左上角四分之一的毛病已解决，选择器截图在首屏之外、滚动之后或 iframe 内同样能正常成像。会话稳定性也有改善，卡死的标签页不再拖垮整个会话，会以 page_wedged 报错，在启动的浏览器中再次超时便自动替换；--pin-tab 固定的标签页也不会再被其他会话用 tab <targetId> 抢走。
v0.39.32026-10-26
这版修了一批安全与稳定性问题。认证加密密钥在配置项无效或密钥文件损坏时不再被覆盖，已保存的凭据得以保留；项目配置的信任机制收紧，自动发现的文件不能再改写可执行路径、浏览器参数或插件，plugin add 默认写入用户配置。MCP 工具参数无法再越权覆盖服务器的网络、文件与主机访问限制，inspect 的 WebSocket 连接也限定为本地 Chrome DevTools 来源。另外修了守护进程重启与 close --all 时的进程误杀，按身份校验后再发信号；复制的 Chrome 配置不再反复弹出崩溃恢复提示，Windows 下脱离的进程也不会占用 CLI 输出管道。仪表盘的会话管理同步修正，命令与后台轮次会留在各自的会话中。启动 connect 或 --cdp 时会多等两秒调试端口。
v0.39.22026-10-22
本次修复集中在浏览器自动化与 CDP 通信的稳定性上：暂停的网络请求不再因事件接收滞后而丢失；域名过滤的重定向会正确报错；CDP 附加状态能在后续命令中保持；同批到达的 target/session 失效事件也能正确处理。交互方面，隐藏、禁用或视口外的元素点击会返回错误而非假装成功，模糊的过期元素引用改为直接失败，不再误选其他元素。另修复了启动参数中逗号与负坐标被截断、MCP 未声明参数静默走默认逻辑等问题。安全策略加载失败时改为拒绝操作，不再裸奔。测试侧的端到端用例已脱离真实网站依赖。
v0.39.12026-10-13
守护进程响应丢失后，命令被重复执行的问题已修复。现在只要请求字节已经发出，涉及变更和启动的命令一律不再自动重试，避免重复执行造成副作用；CLI 的 JSON 输出与 MCP 响应会标记 outcome_unknown，调用方可以先核对实际结果再决定是否重发。纯读命令不受影响，发送前就失败的请求也仍会照常重试（#2085）。
v0.39.02026-10-09
这版加入实验性 Obscura 引擎（--engine obscura），本地启动与清理方式类似 Chrome，启动超时受控，CLI 与 MCP 均可调用；不过它在无障碍和渲染上还有欠缺，切换前建议先过一遍引擎页。CLI 的 HTTPS 请求新增私有 CA 信任，read、install、upgrade、doctor 在 TLS 拦截环境下照常工作：--ca-cert 现在全平台生效，--use-system-ca 改用系统证书库，SSLCERTFILE 作为兜底，证书校验始终开启。修复三处问题：snapshot -s 不再重复打印被忽略包裹层下的元素，选中自定义元素时 shadow root 内容也不会丢失；--auto-connect 面对 Chrome 144+ 的远程调试弹窗最多等待 30 秒，不再反复弹窗或报「No running Chrome instance found」；命令长时间占用状态锁期间，守护进程仍会接受连接，close 不被阻塞，此时发出的 SIGTERM 也不再丢失。文档站已迁移至 Geistdocs。
v0.38.22026-10-01
本轮修复集中在登录、浏览器与沙箱环境上：认证保险库登录现在会从隐藏的重复元素中挑出可用控件，并把凭据输入绑定到所选字段，字段被替换或焦点被重定向时会直接拒绝提交；聊天模式放行了 webmcp、skills 等顶层浏览器命令，模型改用页面自带的 WebMCP 工具，不再退回 eval 执行。Kernel profiles 的 KERNELPROFILENAME 会话改为以对象形式传递配置，不再报 400，同时新增 KERNELPROFILESAVE_CHANGES 用于选择是否把改动写回。另修了 Chrome 启动后卡死的问题——持续排空 stderr，日志管道写满不再阻塞浏览器；Browser Use 升级到 Cloud V4，创建、附加与停止浏览器统一走带超时的路径；Vercel Sandbox 会检测 /dev/shm 容量，低于 256 MiB 时自动加 --disable-dev-shm-usage，避免 Chrome 杀掉渲染进程。eve 集成从 0.47.3 升到 0.57.0，基于 eve 0.50 以上版本的应用重新可以构建。
v0.38.12026-09-16
本次更新修复了录屏时光标与鼠标移动的时间同步问题——此前拖拽和定时鼠标动作中，光标渲染可能与页面内容不同步，现已对齐（#1869）。另外 README 增加了 Vercel Labs 的产品与项目状态徽章（#1868），方便快速查看项目进展。