网页回归测试
将"用自然语言描述测试需求"转化为一次完整的网页回归测试：自动规划步骤、驱动浏览器执行交互、按多种断言校验结果，并产出可读的专业测试报告。面向测试工程师、开发者，以及需要验收网页交付的非技术人员。
语言处理 / Language
本技能面向中、英文用户，交付语言跟随用户输入语言：
- 用户用中文描述需求 → 全程中文回复（测试计划、步骤、状态、报告）。
- 用户用英文描述需求 → 全程英文回复，不要给英文需求强行回中文。
- 断言状态标签：中文
通过 ✅ / 部分通过 ⚠️ / 失败 ❌；英文PASS ✅ / PARTIAL ⚠️ / FAIL ❌。 - 报告模板按用户语言选用：中文见
references/report-template.md默认模板，英文见其 English Template 段。
这与"自然语言驱动"的定位一致——用户用什么语言下指令，就用什么语言交付。
何时使用
- 用户给出网址 + 想测的功能（如"测一下 https://x.com 的登录和下单流程"；英文："Test the login and checkout flow at https://x.com"）
- 用户要求网页 UI 测试、回归测试、冒烟测试、功能验证（英文：UI / regression / smoke / functional testing）
- 用户拿到网页交付物，需要验收是否达标（英文：acceptance of a web deliverable）
- 用户希望"说一句话"就完成原本要写自动化脚本的测试
核心差异（相对录制类工具）
本技能不要求录制操作或写代码。输入是自然语言测试需求，输出是"步骤 + 断言结果 + 报告"。把"写自动化脚本"降级为"描述测试意图"——这正是与市场上录制导出脚本类工具的差异点，也是上架卖点。
工作流程
1. 解析测试需求
从用户输入中提取：
- 目标网址（必填）
- 测试范围：登录 / 下单 / 注册 / 表单提交 / 导航 / 搜索 等
- 关键校验点：用户点名的断言（如"提交后显示订单号"）
- 环境约束：是否需要登录态、测试账号、前置数据
若缺少目标网址或测试范围，向用户澄清，不要臆测。
2. 规划测试步骤
将自然语言需求拆为有序、可执行的步骤序列。每步标注：
- 动作（打开 / 点击 / 输入 / 选择 / 等待 / 导航）
- 目标元素（用可读描述，如"登录按钮""邮箱输入框"）
- 该步预期（用于后续断言）
步骤粒度以"一个用户可感知的操作"为单位，避免过细。
3. 执行与断言
按步骤驱动浏览器（使用平台浏览器自动化能力）逐步执行。在每一步的预期点插入断言。断言类型详见 references/assertion-catalog.md，常用包括：
> 浏览器驱动准备（尤其 Windows 环境 Chromium 下载失败时如何用 Edge 兜底）见 references/windows-edge-fallback.md。
> 测后台管理类站点（登录 + 侧边栏菜单 + 列表 + 搜索）时，通用路径与断言范式见 references/admin-console-flow.md。
- 元素存在 / 可见
- 文本内容匹配（包含 / 等于 / 正则）
- URL 变化
- 表单字段值
- 控制台无错误
- 网络请求成功（状态码）
执行中的关键约定（来自真实站点验证）：
- 导航后必重新 snapshot：元素引用（@eN）随页面刷新失效，每次点击/跳转后先取最新可交互元素再操作，不要沿用旧引用。
- SPA / 客户端路由：后台多为前端路由（如 /console、/orders），wait --load 不会因路由切换再次触发，应等待"目标元素可见"而非文档 load。
- 登录落地页与断言目标不符：若登录后落在首页/仪表盘而非断言指定的功能页，先经菜单导航到达目标页再断言，并在报告中标注"落地页差异"（属实现差异，非缺陷）。
执行中若某步失败，记录失败原因与现场（截图 / URL / 控制台），继续完成其余独立步骤，不整体中断。
4. 生成测试报告
测试结束后，按 references/report-template.md 生成 Markdown 报告，包含：
- 概览：网址、测试范围、通过率、耗时
- 步骤明细：每步动作、预期、实际、通过 / 失败、截图链接
- 缺陷清单：失败项汇总 + 复现线索
- 结论与建议
报告使用客观语言，标注"自动化测试结论，建议人工复核关键路径"。
输入格式建议
指导用户按此格式提供，可显著提升准确率：
网址：https://...
测试点：登录、下单流程
断言：登录成功跳转首页；下单后显示订单号
环境：已有测试账号 test@x.com / 123456
英文示例 / English:
URL: https://...
Test points: login, checkout
Assertions: login redirects to dashboard; order number shown after checkout
Env: test account test@x.com / 123456
完整运行指南（含自行命令行跑法）见 references/run-guide.md。
示例
完整样例见 references/example-run.md。
环境准备（浏览器驱动）
执行测试前需有可用的浏览器驱动。若使用平台内置浏览器自动化能力，按其默认配置即可；若使用 agent-browser CLI 且在 Windows 上遇到官方 Chromium 下载失败，参见 references/windows-edge-fallback.md 用本机 Edge 兜底，无需翻墙即可跑通整条流水线。
边界与注意
- 仅测试用户明确授权的网址；不绕过登录鉴权、不测未授权系统。
- 动态 / 随机内容（如验证码、实时价格）用"形态断言"（如"包含数字"）而非精确匹配。
- 断言失败不等于 bug，需区分"实现差异"与"真实缺陷"，报告中注明。
- 不将用户测试账号密码存储到技能外部；仅在本次会话使用。
