浏览器自动化:网页检查、表单与截图
用 Onevium 内置浏览器或 Chrome 检查网页、操作表单和截图,配置登录状态,并核对操作权限与结果。
核心能力浏览器能帮你做什么#
让助手在工作区打开页面、检查表单、操作控件,并结合截图、控制台和网络信息说明结果。
@Browser 标签的当前引导面向 Control Chrome。要操作内置浏览器,直接在消息中写明「使用 Onevium 内置浏览器」及网址、任务,并核对实际打开的目标。管理浏览器选项则打开「设置 → 浏览器」。
开始前确认页面与账号#
使用预览站点和测试账号。本地服务应已监听正确端口;终端进程存在不代表页面已准备好。可以先用托管服务检查状态。
核对当前网址、标签页和账号。不要假定外部 Chrome 的登录态已自动带入 Onevium;需要登录时在目标浏览器环境完成。网页内容用于 AI 任务时可能发送给所配置模型。
选择内置、外部或自动#
打开 设置 → 浏览器,先开启 AI 浏览器控制,再选择 要控制的浏览器(Browser to control)。全新安装的 AI 浏览器控制默认关闭;升级时保留已有的开启状态,请核对界面开关,不要假定所有安装的默认值相同:
| 选择 | 适合情况 | 需要什么 |
|---|---|---|
| 内置 | 开启控制后的默认后端;让页面与对话一起工作 | 不要求 Chrome 扩展或 claude --chrome |
| 外部 | 明确需要使用外部 Chrome 控制环境 | 可用的外部连接;按同页 Control Chrome 的说明配置 |
| 自动 | 希望由可用性决定 | 优先内置,不可用时回退外部;仍要核对实际目标 |
后端选择对下一次浏览器调用生效。总开关关闭会隐藏 AI 浏览器控制入口,不会清除 Cookie。
使用外部 Chrome 时,在同页检查扩展安装、Control Chrome 开关和连接状态。等待就绪,再在新会话发一个明确请求,验证实际控制的是哪一个浏览器。
Profile:能管理什么,不能假定什么#
在「设置 → 浏览器 → 配置文件」可以新建配置、导入检测到的浏览器 Cookie,以及删除非默认配置。每个配置用于单独保存站点数据。
当前常规会话没有可见的 Profile 选择器,默认浏览器调用仍使用默认配置。 新建一个 Profile 不会自动把当前或下一段会话切换过去,也不能据此承诺两个任务已经隔离账号。
同一浏览器配置的预览可能共享 Cookie 和登录态。会话分别跟踪标签页不等于账号隔离。导入 Cookie 后仍需打开目标网站核对账号;“清除浏览数据”可能让共用该分区的多个标签退出登录,不要作为首个排错动作。
不离开当前页面导入 Cookie
- 打开内置标签的工具栏菜单,选择 Cookies & browser settings(Cookie 与浏览器设置)。
- 点击“导入 Cookie”,检查检测到的来源浏览器/配置,再导入需要的登录资料。此弹窗针对当前标签使用的浏览器配置。
- 导入完成后使用弹窗中的刷新入口,回到目标网站检查账号名称,再继续任务。
导入数量成功不代表网站已经接受登录。共用该配置的标签可能共享更新后的登录态。检测或导入失败时保留错误,改在目标浏览器登录,不要尝试导入无关配置。
找回当前会话访问过的页面
会话使用过浏览器后,可以通过权限旁的地球图标找回页面:
- 打开浏览历史列表,用页面标题或网址搜索。
- 第一批记录中没有目标时,向下滚动加载更多。
- 选择记录重新打开页面,继续操作前核对当前网址和账号。
会话信息面板底部也有带记录数量的可折叠浏览历史。记录按会话独立保存,方便找回这个任务访问过的页面,不会混成所有会话共用的一份列表。它不等于独立登录配置,也不是网页快照;重新打开网址不会恢复当时的页面内容。
第一次操作:检查一个表单#
- 打开设置 → 浏览器,开启 AI 浏览器控制,再选择内置后端。如果设置 → 工具另列 Browser 工具组,也确认其已开启。
- 回到演示项目,用普通消息写「使用 Onevium 内置浏览器」,附上准确预览地址,要求先描述页面;不要用指向外部 Chrome 的标签代替这个目标说明。
- 核对页面与账号后,发送一个有明确结果的任务:
检查测试站邀请表单的空邮箱和无效邮箱提示。
不要发送邀请或修改角色。
记录实际提示、截图,以及相关控制台和网络错误。
如果进入生产环境或真实账号,停止并报告。
- 页面跳转或更新后重新检查元素;切换标签时再次确认目标。
- 按权限设置处理需要确认的动作,最后核对报告。
读取页面文字、标题或表格等只读脚本,通常不会再逐次要求确认。提交、发送、删除等点击,以及按 Enter 等可能提交表单的操作,仍可能显示确认卡;Full Access 不会取消这类浏览器确认。
确认卡会说明目标网站与动作。需要查看具体脚本时展开「查看脚本」,核对后再批准;不要仅为读取页面就扩大权限。
怎样确认检查完成#
报告至少列出网址、测试场景、预期与实际结果,以及对应证据。截图只证明当时的可见状态,HTTP 成功也不能单独证明表单或权限正确。
打不开页面、缺账号或未执行的场景,应标“未测试”,不能标“通过”。分享结果前移除令牌、个人信息和敏感请求数据。
检查窄屏与默认视口#
在「设置 → 浏览器 → 默认视口」选择常用预设,它用于新打开的标签;已有标签可在工具栏菜单里单独调整。
例如打开测试邀请表单,从工具栏菜单的视口选项选择手机预设,检查邮箱输入框、错误提示和提交按钮是否都能到达。视口大于当前面板时,可以横向和纵向滚动查看边缘。
同一菜单中的页面缩放是独立控制:用减号/加号调整,点击百分比可恢复 100%。比较视口预设时先保持 100% 缩放,便于确认布局变化来自哪项调整。修改当前标签的视口不会改写新标签的默认设置。
窄屏检查应实际观察按钮、校验信息和导航是否可用。尺寸预设不等于真机验收,也不证明触摸、浏览器身份或设备行为完全相同。无法复现的场景另用目标浏览器或真机补测。
常见问题#
- 没有浏览器入口: 核对顶部适用版本与浏览器总开关;如果「设置 → 工具」列出了 Browser 工具组,再确认它已开启。
- 空白页: 检查 URL、端口、控制台和网络,不要只反复刷新。
- 账号不对: 检查实际浏览器与配置;不要依赖会话名称判断登录隔离。
- 元素失效: 重新读取当前页面,再选择控件。
- 外部连接失败: 检查扩展和连接状态,使用重试入口后发一个小任务验证。