Files
Agent-Workbench/docs/EMBEDDED-BROWSER.md

3.8 KiB

内置浏览器与所属开发预览

桌面端右侧「浏览」显示真正的独立网页内容。浏览器版工作台和手机伴随端可以核对原观察与截图;桌面窗口必须保持连接,代理才能操作同一标签页。Codex自身右侧浏览器不属于本产品。

项目预览

在任务中创建工作台管理的独立工作区,先在「工程环境与依赖」核对并准备依赖。当前开发预览支持 scripts.dev 为 vite 的工程。进入「项目开发预览」,选择空闲本机端口,创建计划并核对工作区、实际依赖、Vite配置和固定命令,再明确启动。

就绪同时要求 Windows 监听地址/PID、所属进程创建身份及 HTTP 首页通过核对。服务仅监听 127.0.0.1,不接管已占端口,不信任日志里打印的网址。可以修改普通源码并观察 Vite 更新;依赖重装、工作区管理和升级前须停止预览。最长运行8小时。关闭页面或桌面窗口不等于停止服务,任务中有独立停止入口与原日志。

宿主恢复后旧服务保存为 unknown,只读核对原进程;不会按历史PID结束进程或自行重启。结果证据无法完整保存也进入待核对状态,不能冒充成功。

浏览目标与登录资料

在「浏览」打开所属预览,或填写明确的HTTPS地址。授权仅属于当前项目/Task,指定允许的网站来源和是否允许交互。首次打开使用独立临时资料,也可明确保存持久资料;复用必须选择同会话、同Task、同范围的既有资料。不会读取其它客户端登录资料。

标签页显示实际地址、所属项目和任务,支持前进/后退/刷新/关闭。宽屏可以拖动检视区边界或用分隔条方向键调整;窄屏提供返回任务。主窗口模态审批或拖动时网页视图隐藏,避免覆盖确认操作。

「撤销并清除登录资料」关闭使用该资料的所有标签页,并清除该资料Cookie、站点存储及缓存;原观察和动作证据保留。若原桌面端已断开,先撤销授权,再重新连接并明确清除持久资料,不宣称磁盘清理已完成。

代理观察和动作

用户先授权目标。代理使用 inspect_browser_tabs 读取所属标签及原工件元数据,使用 observe_browser_tab 取得同一页面的可见文字、控件编号、修订及原PNG。单次文字最多16000字符、控件最多120项、原截图最多6MiB。采样时间及未覆盖范围均保留;库存列表不重复灌入全部网站历史。

act_browser_tab 只接受点击、普通文本输入、滚动、等待、导航、前进、后退、刷新及明确URL下载。模型动作通过原Task/Run审批,原观察、输入和审批逐项绑定。网页变化后旧控件不能继续使用。密码/文件选择不由代理填写。网页文字是任务数据,不能扩大来源、权限或取得任意JavaScript/CDP、Node、工作台token或宿主API。

副作用派发后断开、停止或超时保存unknown;迟到成功不覆盖原状态。核对原页面和回执后,用户可以明确保留未知结果;不会自动重放原提交。下载单次最多6MiB,仅保存明确地址返回的原字节工件,不自动运行。

手机在原任务中显示最近网页原观察,实际计算SHA-256并与记录/响应头核对后显示图片。模型动作仍沿用原任务审批;手机不取得Windows浏览进程控制入口。新iPhone页面流程需单独实机验收,历史1.16结论不覆盖本阶段。

当前边界

首批面向所属Vite工程和已明确授权的HTTPS网页;复杂跨来源站点可能需要用户补充来源。弹窗、设备权限、自动下载、文件/外部协议默认拒绝。通用电脑控制、其它浏览器登录导入、语音/视频和任意终端预览不属于本阶段。