agent-browser
为 AI 智能体提供浏览器自动化命令行，控制网页任务执行。
agent-browser 是为 AI 智能体和开发者提供的浏览器自动化命令行，可打开页面、读取结构、点击和输入，并通过文本或截图检查执行结果。
可以用来完成：核对网页字段、检查测试表单、记录页面异常。
agent-browser 能做什么
它提供浏览器操作命令，任务规划通常由调用它的智能体或脚本完成。使用者需要了解终端、浏览器环境和基本错误处理。
官方入门采用先读取页面快照、再按元素引用操作的方式。页面发生变化后重新观察，避免把旧引用继续用于新的页面状态。
读取页面结构
快照提供页面元素及可引用标识，让调用方知道当前有哪些可操作对象。
执行明确动作
通过命令点击、填写或读取元素，也支持按角色或选择器定位。
保存可核查结果
可获取页面文字并截取画面，供脚本整理报告或由人工检查。
控制会话生命周期
会话命令用于组织浏览器活动，任务结束后应关闭不再使用的会话。
- 核心用途
- 页面快照、元素操作、文本提取、截图与会话管理。
- 可完成的工作
- 核对网页字段、检查测试表单、记录页面异常。
- 如何开始
- 安装命令行与所需浏览器，打开一个公开测试页并读取快照。
- 使用条件
- 需终端和浏览器运行环境；搭配智能体时还需其模型与工具配置。
可以完成哪些工作
按你的目标查看准备资料、操作方法和交付结果。
核对产品页规格可回溯页面的规格记录。
适合：维护资料脚本的开发者
- 准备什么
- 指定页面、目标型号及要读取的字段。
- 怎么完成
- 打开页面并读快照，定位规格区后提取文本，由自己的脚本保存字段和页面地址，缺失项单独记录。
- 完成后得到什么
- 可回溯页面的规格记录。
- 交付前检查
- 核对型号、单位和页面更新时间，文本存在不表示字段含义已经正确解析。
检查测试登录表单可重复执行的测试步骤及异常证据。
适合：网站质量保障人员
- 准备什么
- 测试地址、虚构或专用账号、预期错误提示。
- 怎么完成
- 先观察表单，依次验证空值和无效输入，再按测试范围运行有效路径，保存失败时的快照与截图。
- 完成后得到什么
- 可重复执行的测试步骤及异常证据。
- 交付前检查
- 核对最终登录状态，不把按钮点击成功当作认证成功。
记录页面导航问题含复现路径的导航问题清单。
适合：前端开发者
- 准备什么
- 待检页面、预期链接去向和测试视口。
- 怎么完成
- 读取主要导航，逐项检查最终地址与关键页面内容，对跳错或遮挡的入口保存截图后返回列表。
- 完成后得到什么
- 含复现路径的导航问题清单。
- 交付前检查
- 页面更新或弹窗出现后重取快照，避免沿用失效元素引用。
如何使用 agent-browser
- 准备命令行环境
按官方方式安装，确认浏览器可启动并能打开测试页。
- 先读取再操作
获取最新快照，确定目标元素与允许执行的动作。
- 逐步核对状态
每次关键操作后检查文字、地址或截图，遇到异常先停止定位。
- 保存结果并关闭
把所需证据交给脚本或报告，结束本次浏览器会话。
开始前需要了解
工具不会自行理解业务验收
需要调用方定义成功条件、停止条件和异常处理。
网页状态会持续变化
弹窗、重绘和加载延迟可能使旧定位失效，不能盲目重放动作。
命令拥有实际操作效果
填写、提交和下载会影响页面或文件，登录会话应限定授权范围。
账号权限、费用与可用功能请以官方入口的当前说明为准。重要结果应先检查，再用于实际工作。
常见问题
这是聊天网页吗？
不是。它主要通过终端命令或智能体工具调用运行。
每次都要使用大模型吗？
确定的操作可由脚本调用；让智能体规划任务时才涉及相应模型条件。
出现遮挡错误该怎么办？
先检查弹窗或覆盖层，处理后重新读取快照，再确认目标元素。
保存截图能证明后台写入吗？
截图只记录页面表现，涉及写入时还要检查目标系统的实际记录。
工具动态
agent-browser v0.41.2 版本发布信息
agent-browser · 原文更新
agent-browser 官方发布 v0.41.2 版本。本条为版本发布简讯，具体改动和适用条件请参阅官方发布说明。
agent-browser v0.41.1 版本发布信息
agent-browser · 原文更新
agent-browser 官方发布 v0.41.1 版本。本条为版本发布简讯，具体改动和适用条件请参阅官方发布说明。
agent-browser v0.41.0 版本发布信息
agent-browser · 原文更新
agent-browser 官方发布 v0.41.0 版本。本条为版本发布简讯，具体改动和适用条件请参阅官方发布说明。
agent-browser v0.40.0 版本发布信息
agent-browser · 原文更新
agent-browser 官方发布 v0.40.0 版本。本条为版本发布简讯，具体改动和适用条件请参阅官方发布说明。
agent-browser v0.39.4 版本发布信息
agent-browser · 原文更新
agent-browser 官方发布 v0.39.4 版本。本条为版本发布简讯，具体改动和适用条件请参阅官方发布说明。
从自动化与AI助手角度评估agent-browser
把自动化与AI助手需要的条件列清楚，再比较工具。阅读本页的产品用途、步骤与限制，再逐项确认下面的问题；这些是选型方法，不表示每款工具都具备同样能力。
触发是否明确
写清事件来源、必要字段和重复事件的识别方式。
权限是否够用
只连接完成任务所需的账户与范围；真实操作由有权人员确认。
失败是否可见
保留结果状态和接手人，不能把重试次数当成完成次数。
选择一个小样任务，先检查结果与交付格式，再决定是否用于更多资料。
