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

24 lines
3.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 实际页面验收
1.10.0将当前Web工程的实际页面检查内置自有Harness。项目先完成构建,在任务记录「页面验收」封存构建目录、页面路径、视口与步骤,再审查并执行。
每份计划绑定Project/Session/Task/Run、源码指纹、构建文件清单与SHA256、固定Playwright1.64.1运行库和本机Microsoft Edge关键身份。宿主复制清单内的原构建字节到独立快照,启动仅属于该任务的静态预览及无登录状态的Edge进程。
支持填写、选择、点击,以及文字、数量和可见性断言。步骤使用CSS元素;单份计划最多20步,单步3秒,总执行45秒。构建限512文件/32MiB,单文件8MiB、最多12层;常规HTML、JS、CSS、图片、字体和WASM可预览。视口宽320–1440、高400–1200,界面提供1280×900桌面和390×844手机布局。
空步骤计划读取实际页面、元素和截图,结果是observed;它提供下一份计划的依据,不计为断言通过。页面脚本、控制台或请求失败、范围阻止及事件记录超过保存上限都会保留为失败,即使部分断言已通过。文字快照最多20000字、元素最多80个,截取范围与原数量明确记录;它不是完整HTML导出。页面只能读取所属静态预览;后端请求、其他本地或远程来源、WebSocket、弹窗和下载会记录范围错误。动态后端联调按后续切片开发。
模型在有构建或当前Task已有页面计划时获得plan_browser、run_browser和read_browser_result。准备计划不打开浏览器;执行显示原计划、构建身份、视口和步骤,经确认后才运行。原结果字段和截图属于工程数据,不作为新增用户指令。
原结果保存实际DOM/控件/视口、控制台、请求、逐步返回值、断言统计、所属PID及结束记录。PNG保留原字节、尺寸、SHA256和归属,浏览器结果与各张图片重新核验后才允许读取或复用。界面支持原JSON分页、完整下载和原始PNG查看/下载。
1.11页面观察的controls提供selector、selectorMatches和selectorEvidence。定位先使用唯一id或标签,再逐层加入父节点位置,每个候选均在实际DOM计数并核对目标;只有唯一命中才登记。受长度/深度限制无法取得定位时明确返回unavailable,不任取第一个匹配。定位属于该次页面观察,页面变化后仍按新DOM核对;多元素实际操作继续严格拒绝。
read_browser_result按原source_artifact_id、原SHA256、section、返回视图和所属Run保存已读区间;不同字段和新Run分别判断进展。当前Run连续重复同一范围会明确暂停,不重新打开浏览器;模型可依据原失败与唯一定位准备新的实际检查计划。
同一完成计划在当前输入未变化时核验后复用原job,失败/停止的计划需要明确准备新计划。源码、构建或运行库变化时拒绝旧计划;运行后输入变化标记stale。停止结束本次实际进程并保留已完成步骤。重启将未确认结束的执行记录为unknown,需要在所属任务核对原记录并确认,宿主不按历史PID停止进程或重放操作。
Task配置页面验收后,Git预览与实际提交都要求最新计划有当前源码/构建的passed原结果;observed、failed、stale、unknown和工件损坏不能通过。预览后页面结果或构建变化会让提交计划失效。交付JSON/Markdown同时保留此前失败、通过、实际断言及原工件SHA256。
源码和便携包都保留原Playwright许可证、完整锁定包和BROWSER-RUNTIME.json清单。页面验收使用本机Edge;安装缺失会显示实际环境状态。相关源码/API、协议夹具、界面、随包运行和真实模型结果分别登记于[1.10验收](QA-1.10.md)。