24 lines
3.8 KiB
Markdown
24 lines
3.8 KiB
Markdown
# 实际页面验收
|
||
|
||
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)。
|