使用浏览器 Agent 验收应用

检查真实用户流程,保留有效证据,把失败场景转成可复现的问题报告。

资料核验 / 更新于 · 8 分钟阅读

开始之前

准备一个已启动的本地应用,并记下准确网址。可以使用上一篇的阅读清单应用。练习只使用测试数据,便于重复操作。

Antigravity 能操作本地 Chrome,并生成截图或操作录像等产物;相关浏览器工具需要在设置中启用。具体行为与配置入口见官方浏览器说明

1. 先确认应用本身可访问

自行打开本地地址,确认页面能加载。如果有登录功能,提前确认测试账号和浏览器会话。连接不到浏览器与应用出错是两类问题,需要分别判断。

Agent 工具栏依次显示变更、终端、产物与浏览器入口

官方 IDE 截图中,Browser 在 Artifacts 旁边。可从这些入口检查运行会话和任务证据。

官方示例截图(原图未修改) · 来源:Google Codelabs · CC BY 4.0 · 点击图片放大

先准备一张测试记录表

写明应用网址、待测版本和初始数据。阅读清单练习应始终使用同一个浏览器配置,并从空的测试列表开始。如果保留已有样例数据,新条目就用容易区分的标题,避免无法判断预期条数。

保持开发服务器运行。如果原端口被占用,服务可能换到另一个端口,此时同步修改提示词。示例中的 localhost:3000 只是占位地址,不代表所有项目都使用它。

检查项初始条件预期观察
添加空的练习列表出现一行,标题与提交内容一致。
筛选一个已读、一个未读条目仅显示未读条目。
持久化已保存两个条目相同站点地址刷新后仍能看到它们。
窄屏长标题和条目操作按钮无需整页横向滚动也能使用按钮。

2. 发出可观察的测试任务

把以下本站练习提示词的网址替换成开发服务器实际输出的地址:

测试 http://localhost:3000 上的阅读清单应用。
使用虚构标题和 https://example.com 作为样例网址。
添加两个条目,将一个标记已读,筛选未读,刷新,再删除一个条目。
另外测试空标题和无效网址。
每个场景记录:操作、预期结果、实际结果、通过或失败。
如果支持调整视口,再检查 390px 宽度。
为失败场景保存证据;第一轮只测试,不修改代码。
如果无法使用浏览器,请明确说明,不能假定测试已经通过。

第一轮先观察,可以明确哪些故障来自当前版本,避免测试和修复混在一起后无法复现。

3. 阅读测试证据

截图可以说明布局和错误提示,但单张截图不能证明刷新后数据还在。检查持久化时,应看到刷新前后的条目及操作顺序。

窄屏验收重点是:输入框和提交按钮能否正常使用、长标题是否换行、每个条目的操作按钮能否触达。仅有“页面看起来正常”的结论不够。

Antigravity 官方 Walkthrough 示例,包含功能清单与 Verification Details

这是官方会议网站练习在 Antigravity 应用中的产物。阅读时将功能列表与验证记录分开;它不代表本文阅读清单已经通过测试。

官方示例截图(原图未修改) · 来源:Google Codelabs · CC BY 4.0 · 点击图片放大

证据要与结论对应

想证明的结论有用的证据单凭它还不能证明什么
移动端表单没有溢出标明视口宽度的截图提交后是否正确保存。
刷新不会丢数据相同网址下刷新前后的操作记录更换浏览器配置后能否同步。
无效网址被拒绝实际输入、提示信息、未变的条目数所有有效网址都能正常通过。
应用可以构建命令、退出状态和相关输出用户交互一定正确。

Walkthrough 应分清已执行操作、预期结果与未验证的判断。打开它引用的证据,对照文字结论是否准确。

4. 修复后重复同一操作

挑选一个失败场景,要求最小修复,并使用同一组输入再次验收。如果修改影响表单验证,还应重新测试一次正常提交。

页面打不开时,先检查服务进程和端口,再检查浏览器工具设置。遇到登录或视口控制不可用,应记录为阻塞项,而不是通过项。

给 Agent 一份可复现的缺陷报告

以下是报告写法示例,并非对你的应用实际测得的结果:

场景:筛选后删除
版本:[提交号或检查点]
网址:[实际本地网址]
初始状态:Alpha 已读,Beta 未读。
步骤:切到未读,删除 Beta,再切回全部。
预期:Alpha 保留,Beta 消失。
实际:Alpha 消失,Beta 仍在。
证据:[本次运行实际保存的录像或截图]
请修复这一场景,再复测它,以及正常添加和刷新流程。

浏览器连不上时先查网址和服务;能连接却找不到元素时,核对路由与初始数据;同一操作时好时坏时,先记录发生时机和加载状态,再决定修复方向。

完成标准

保留一份简短记录,包括网址、版本或提交号、已测试流程、剩余问题和证据位置。读者应该能够按记录复现结果。

下一篇:用 Rules 和 Skills 复用审阅过程