Skip to content

浏览器验收:检查报名页并交付问题报告 ​

本课练习把“页面看起来正常”变成有步骤、有截图的问题报告。需要 Codex 已接入可用的浏览器工具;本篇不包含工具安装。没有工具时可以手动检查页面,但那不等于完成了 Agent 操作练习。

1. 要检查的报名页 ​

当 AI 告诉你“页面完成了”,还需要实际打开并检查操作是否符合需求。本练习提供一个本站原创的虚构报名页面,故意包含缺陷,不收集真实信息。

输入是练习页面与页面上写明的需求。输出是问题报告和实际截图,不是修复后的页面。

操作前:页面看起来完整,状态显示“尚未提交”。这张图只能证明界面存在,不能证明表单正确。

先按需求完成检查,再展开第 5 节的参考结果,避免把答案当成实际观察。

2. 打开页面,准备测试数据 ​

开始前,确认你的 Codex 能实际打开网页并操作元素,而不只是回答网址内容。只使用本页的虚构素材,不提交真实姓名、邮箱或客户数据。

直接打开上面的本站练习页即可,无需准备本地服务器。要研究源码,可以下载末尾的两个 HTML 文件;本次自动检查仍以给出的线上页面为目标。

使用假姓名与 example.com 邮箱,页面没有后端。完整需求见 TASK.md。

3. 确认浏览器工具可用 ​

本练习页面不需要密钥、数据库或服务端配置。先让 Codex 用已有浏览器工具打开练习页,并读出页面标题;没有工具时先完成接入,再继续下面的自动操作。

4. 让 Codex 执行三条检查路径 ​

在 Codex 对话中发送以下任务:

text
请使用当前可用的浏览器工具打开 https://codexguide.codes/samples/browser-check/index.html。
先读取页面上的需求,分别检查空提交、有效姓名和邮箱提交、帮助入口。
使用假姓名及 reader@example.com,记录每步预期与实际结果。
发现异常后重置页面复现,保存真实截图和 report.md。
不要修改页面,不要把客户端成功提示当成服务端写入证明。
如果没有可用浏览器工具,直接说明缺失条件,不编造执行过程。

检查时按“需求 → 操作 → 实际结果”记录,不要先照抄报告。发现异常后重新打开页面,再走一次相同步骤,区分稳定可复现的问题与一次性状态。

三条路径分别怎么走 ​

路径操作按需求应看到什么
空提交重新打开页面,不填任何字段,点提交阻止提交并提示补全
有效输入重新打开页面,填写“练习读者”和 reader@example.com,点提交显示页面约定的成功提示
帮助入口重新打开页面,点击帮助链接打开帮助内容,记录实际地址

每条路径从新打开的页面开始,避免上一条提示干扰结果。如果没有浏览器工具,可以先手动完成表格,练习写报告;不要把人工操作写成 Codex 自动执行。

5. 检查问题报告 ​

可以按下面格式保存 report.md,填入你实际看到的内容:

markdown
## 问题:用一句话描述
- 页面与环境:
- 前置状态:
- 复现步骤:
- 预期结果:
- 实际结果:
- 截图文件:
- 重新打开页面后能否再次复现:

对照实际操作截图,写清楚问题 ​

先自己做一遍,再看下面的记录。这组图片来自本次在本地打开同一份公开样例的真实浏览器操作;帮助页的错误外观会随服务器改变。

第一步:两个输入框都留空,直接点“提交报名”。

空提交后,输入框仍为空,结果却变成“报名成功”。需求说必填,所以这是可复现的缺陷。

报告不要只写“表单有 Bug”。写:“重新打开页面,不输入姓名和邮箱,点击提交;预期阻止提交,实际显示报名成功。”别人拿到这句话,才能按同样动作重现。

第二步:填写假姓名和邮箱,再提交。

填入“练习读者”和 reader@example.com 后也显示成功。页面没有后端,这不是数据已保存的证据。

空输入和有效输入都给出同一个结果,正是要对照不同路径的原因。只测试正常输入,会漏掉第一条问题。

第三步:点击帮助链接,看实际地址和页面。

帮助链接实际指向 missing-help.html。本地服务器返回 404;正确目标应是同目录 help.html。

报告里同时写下错误地址与需求中的正确目标。截图中出现 404,并不代表整个网站都坏了;这个例子里先检查单个链接的路径。

参考报告与此前的截图

空姓名和邮箱仍显示报名成功的实际截图

报告至少包含两个预设问题:空提交未被阻止、帮助入口指向错误路径。每个问题都必须写预期、实际、复现步骤;同时记录正常填写路径和未覆盖范围。

  • 找不到浏览器工具:停止本练习,先解决接入,不让模型猜页面内容。
  • 页面提示成功:检查输入和实际系统状态;此样例没有服务端,因此不能写“记录已入库”。
  • 工具定位失败:先重新观察页面再选择元素,不能盲目重试同一个定位器。
  • 只完成截图:仍需实际操作和报告。截图不能证明所有按钮都可用。

6. 页面源码与参考报告 ​

Codex 中文教程与实战 · 非 OpenAI 官方网站