跳转到正文
Onevium文档
本页内容

浏览器自动化:网页检查、表单与截图

用 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

  1. 打开内置标签的工具栏菜单,选择 Cookies & browser settings(Cookie 与浏览器设置)
  2. 点击“导入 Cookie”,检查检测到的来源浏览器/配置,再导入需要的登录资料。此弹窗针对当前标签使用的浏览器配置。
  3. 导入完成后使用弹窗中的刷新入口,回到目标网站检查账号名称,再继续任务。

导入数量成功不代表网站已经接受登录。共用该配置的标签可能共享更新后的登录态。检测或导入失败时保留错误,改在目标浏览器登录,不要尝试导入无关配置。

找回当前会话访问过的页面

会话使用过浏览器后,可以通过权限旁的地球图标找回页面:

  1. 打开浏览历史列表,用页面标题或网址搜索。
  2. 第一批记录中没有目标时,向下滚动加载更多。
  3. 选择记录重新打开页面,继续操作前核对当前网址和账号。

会话信息面板底部也有带记录数量的可折叠浏览历史。记录按会话独立保存,方便找回这个任务访问过的页面,不会混成所有会话共用的一份列表。它不等于独立登录配置,也不是网页快照;重新打开网址不会恢复当时的页面内容。

第一次操作:检查一个表单#

  1. 打开设置 → 浏览器,开启 AI 浏览器控制,再选择内置后端。如果设置 → 工具另列 Browser 工具组,也确认其已开启。
  2. 回到演示项目,用普通消息写「使用 Onevium 内置浏览器」,附上准确预览地址,要求先描述页面;不要用指向外部 Chrome 的标签代替这个目标说明。
  3. 核对页面与账号后,发送一个有明确结果的任务:
text
检查测试站邀请表单的空邮箱和无效邮箱提示。
不要发送邀请或修改角色。
记录实际提示、截图,以及相关控制台和网络错误。
如果进入生产环境或真实账号,停止并报告。
  1. 页面跳转或更新后重新检查元素;切换标签时再次确认目标。
  2. 权限设置处理需要确认的动作,最后核对报告。

读取页面文字、标题或表格等只读脚本,通常不会再逐次要求确认。提交、发送、删除等点击,以及按 Enter 等可能提交表单的操作,仍可能显示确认卡;Full Access 不会取消这类浏览器确认。

确认卡会说明目标网站与动作。需要查看具体脚本时展开「查看脚本」,核对后再批准;不要仅为读取页面就扩大权限。

怎样确认检查完成#

报告至少列出网址、测试场景、预期与实际结果,以及对应证据。截图只证明当时的可见状态,HTTP 成功也不能单独证明表单或权限正确。

打不开页面、缺账号或未执行的场景,应标“未测试”,不能标“通过”。分享结果前移除令牌、个人信息和敏感请求数据。

检查窄屏与默认视口#

在「设置 → 浏览器 → 默认视口」选择常用预设,它用于新打开的标签;已有标签可在工具栏菜单里单独调整。

例如打开测试邀请表单,从工具栏菜单的视口选项选择手机预设,检查邮箱输入框、错误提示和提交按钮是否都能到达。视口大于当前面板时,可以横向和纵向滚动查看边缘。

同一菜单中的页面缩放是独立控制:用减号/加号调整,点击百分比可恢复 100%。比较视口预设时先保持 100% 缩放,便于确认布局变化来自哪项调整。修改当前标签的视口不会改写新标签的默认设置。

窄屏检查应实际观察按钮、校验信息和导航是否可用。尺寸预设不等于真机验收,也不证明触摸、浏览器身份或设备行为完全相同。无法复现的场景另用目标浏览器或真机补测。

常见问题#

  • 没有浏览器入口: 核对顶部适用版本与浏览器总开关;如果「设置 → 工具」列出了 Browser 工具组,再确认它已开启。
  • 空白页: 检查 URL、端口、控制台和网络,不要只反复刷新。
  • 账号不对: 检查实际浏览器与配置;不要依赖会话名称判断登录隔离。
  • 元素失效: 重新读取当前页面,再选择控件。
  • 外部连接失败: 检查扩展和连接状态,使用重试入口后发一个小任务验证。

下一步#

浏览器设置参考查每项作用,用托管服务准备预览,并用权限指南控制任务范围。