镜像自 HugoXK/LaunchPad@5cfa983 · upstream · 在 GitHub 上编辑 docs/browser.md ↗

任务浏览器与执行证据

任务可以在项目电脑上的独立真实浏览器里打开事先允许的站点,并把每一步和截图留下来事后查看。控制面只负责派发动作、收回并展示证据,不会在控制面进程里启动 Chromium,也不会在项目电脑不可用时悄悄改回控制面执行。这是 harness 的通用能力,供巡检等预置工作流复用,不是把外部产品的界面搬进控制台。

启用

在任务 input.browser 里声明允许访问的源:

{
  "browser": {
    "origins": ["http://127.0.0.1:8080"],
    "allow_destructive": false,
    "timeout_ms": 60000
  }
}

只有列出了至少一个合法 http/https 源时,任务才会得到 browser 工具。地址里不能带账号口令,也不能是 0.0.0.0 或未指定地址。浏览器发出的每个 HTTP 请求都要落在这些源上,包括跳转、iframe 和图片、脚本、XHR 等子资源;未允许的请求会被拦截,不会到达目标主机。默认只允许观察、打开、点击和输入。

角色权限目录里有单独的「使用任务浏览器」项,默认拒绝;未保存或空角色没有这项授权。具有「使用虚拟电脑」默认权限的工作角色会一并获得浏览器授权;显式拒绝会保留。未配置角色策略的入口在任务列出允许源时可以提供该工具。

删除、支付、结算等字面匹配到的动作需要 allow_destructive 为 true,或给出允许的路径前缀。这是启发式规则,不能完整识别所有破坏性操作:通用的「确认」、自定义控件或未出现在规则里的文案仍可能改动数据。不要把这项检查当成完善的支付或删除防护。

运行时边界

查看证据

步骤元数据(路径、校验和、尺寸、结果)记在任务的 execution_evidence 里,像素本身只保存在数据库旁的 browser-evidence/ 目录(位于 bot-data 卷,与 control.sqlite、trajectories/ 一起)。控制台任务详情在有证据时显示「浏览器证据」;截图按需加载,列表最多展示最近 80 步。接口:

已结束任务的截图目录沿用存储设置里的「轨迹正文」保留天数;没有对应任务的目录会在日常清理中删除。删除项目并且要求同时删除证据时,也会去掉该项目任务的截图目录。未设置保留天数则一直保留。

测试

默认 npm test 只覆盖策略、权限与接口,不启动浏览器。真实浏览器验收在 npm run test:e2e 中的 test/browser-runtime.mjs:经 LocalManager / 项目电脑执行路径,对本地受控夹具打开页面、截图,拦截跳转、跨源子资源以及子资源 302,关闭 WebSocket,并在接收端计数为 0 时证明未允许的主机没有被联系;同时检查工作区操作记录中不出现口令和截图 base64。超时会关闭会话。生产镜像里的只读根文件系统启动由独立 PR 覆盖,本文件的 e2e 不在那种镜像里跑。本机或 CI 未安装 Chromium 时该测试失败,不会跳过算通过。测试不访问线上站点,也不会向外部门户或仓库写 Issue。