> 内容来源：Onevium 官方文档
> 文章: 浏览器自动化：网页检查、表单与截图
> 原文: https://onevium.com/zh/docs/browser-automation
> 语言：简体中文
> 更新于: 2026-09-20
> 适用版本: 1.2.1+

---

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

用 Onevium 内置浏览器或 Chrome 检查网页、操作表单和截图，配置登录状态，并核对操作权限与结果。

## 浏览器能帮你做什么

让助手在工作区打开页面、检查表单、操作控件，并结合截图、控制台和网络信息说明结果。

`@Browser` 标签的当前引导面向 Control Chrome。要操作内置浏览器，直接在消息中写明「使用 Onevium 内置浏览器」及网址、任务，并核对实际打开的目标。管理浏览器选项则打开「设置 → 浏览器」。

## 开始前确认页面与账号

使用预览站点和测试账号。本地服务应已监听正确端口；终端进程存在不代表页面已准备好。可以先用[托管服务](https://onevium.com/zh/docs/managed-services)检查状态。

核对当前网址、标签页和账号。不要假定外部 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
检查测试站邀请表单的空邮箱和无效邮箱提示。
不要发送邀请或修改角色。
记录实际提示、截图，以及相关控制台和网络错误。
如果进入生产环境或真实账号，停止并报告。
```

4. 页面跳转或更新后重新检查元素；切换标签时再次确认目标。
5. 按[权限设置](https://onevium.com/zh/docs/permissions)处理需要确认的动作，最后核对报告。

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

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

## 怎样确认检查完成

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

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

## 检查窄屏与默认视口

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

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

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

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

## 常见问题

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

## 下一步

在[浏览器设置参考](https://onevium.com/zh/docs/settings/reference#browser)查每项作用，用[托管服务](https://onevium.com/zh/docs/managed-services)准备预览，并用[权限指南](https://onevium.com/zh/docs/permissions)控制任务范围。