speccore 8.3.158 → 8.3.160

package/templates/verify-spec-example.yaml

@@ -1,982 +0,0 @@
-# VERIFY_SPEC.yaml — UI 冒烟测试规格（真实值示例版）
-# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-# 格式类型: VERIFY_SPEC 格式（scenarios + actions + assertions 结构）
-# 对应命令:
-#   • speccore verify --ui --spec ./tests/smoke.yaml     ← 推荐
-#   • speccore verify --ui --config ./tests/smoke.yaml   ← 兼容
-# 按模块过滤: speccore verify --ui --spec ./tests/smoke.yaml --module=login
-#
-# 本文件所有 value / selector 均为真实示例值，使用时替换为你的实际值即可。
-# 选择器建议优先使用 data-testid（最稳定），其次 name / id，避免随机 class。
-#
-#
-# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-# 【重要】前端需要配合加 data-testid 吗？选择器怎么写最稳定？
-# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-#
-# 问题: 像「点击保存按钮」这种操作，selector 写什么才不会因为前端改一下就失效？
-#
-# 稳定性排序（从高到低）:
-#
-#   1. data-testid="xxx"  ← 最稳定，专门给测试用的属性，前端不会随意改
-#      前端写法: <button data-testid="save-profile-btn">保存</button>
-#      测试写法: selector: '[data-testid="save-profile-btn"]'
-#
-#   2. id="xxx" / name="xxx"  ← HTML 原生属性，较稳定，但可能有重复（name）
-#      前端写法: <input id="username" name="username" />
-#      测试写法: selector: '#username' 或 'input[name="username"]'
-#
-#   3. 稳定的 class  ← 确保 class 名不会随构建变化
-#      前端写法: <button class="save-btn primary">保存</button>
-#      测试写法: selector: '.save-btn'
-#      ⚠️ 注意: 避免使用带随机后缀的 class（如 Vue scoped: .button__xx3a / React CSS Modules: .Button_module_abc123）
-#
-#   4. 文本内容定位  ← 当前端没给任何标识时的兜底方案
-#      测试写法: selector: 'button:has-text("保存")' 或 'button >> text=保存'
-#      ⚠️ 注意: 多语言项目会失效，仅作兜底
-#
-#   5. 绝对不要用的  ← 这些选择器页面一改就失效
-#      ❌ div:nth-child(3)              ← 布局变化就失效
-#      ❌ /html/body/div[1]/div[2]      ← XPath 绝对路径
-#      ❌ .sc-xxx-123                   ← styled-components 随机 class
-#      ❌ .v-xxx-456                    ← Vue scoped CSS hash
-#      ❌ .Button_module_abc123         ← CSS Modules 随机 class
-#
-# 前端配合建议（最佳实践）:
-#   在关键交互元素上添加 data-testid，不影响业务逻辑，只用于测试:
-#     <input  data-testid="login-username" name="username" />
-#     <input  data-testid="login-password" type="password" />
-#     <button data-testid="login-submit">登录</button>
-#     <button data-testid="save-profile-btn">保存</button>
-#     <div    data-testid="dashboard-container">...</div>
-#
-# 如果前端暂时不配合，测试脚本怎么写？
-#   先用浏览器开发者工具（F12）→ Elements 面板 → 右键元素 → Copy → Copy selector
-#   但复制出来的通常是绝对路径，不稳定。建议:
-#     1. 优先找 name / id / 稳定的 class
-#     2. 其次用属性选择器: [type="submit"] / [placeholder="请输入用户名"]
-#     3. 最后才用层级组合: .form-group > button.primary
-#
-#
-# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-# 【重要】关于"需要登录的场景"怎么处理？
-# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-#
-# 本文件场景1-9 是测试"登录功能本身"的，必须走完整的登录流程。
-# 场景10-42 是测试"登录后的业务功能"（如个人资料、订单、购物车），这些场景默认已登录。
-#
-# 你有两种方式让"业务场景"拿到登录态：
-#
-# 方式A: Cookie/Token 注入（推荐，最简洁）
-#   把「场景13: Token注入免登录」或「场景33: Cookie注入免登录」复制到业务场景前面，
-#   作为第一个场景执行。注入后同一浏览器会话内后续场景共享登录态。
-#   示例顺序:
-#     1. Token注入免登录（注入 accessToken + refreshToken）
-#     2. 个人资料修改
-#     3. 商品列表浏览
-#     4. 创建订单...
-#
-# 方式B: 每个业务场景自己注入（最独立，适合并行执行）
-#   在每个需要登录的场景的 actions 开头加 cookie 或 localStorage 注入：
-#     actions:
-#       - type: localStorage
-#         selector: accessToken
-#         value: 'Bearer eyJhbGci...'
-#       - type: navigate
-#         value: /profile
-#
-# 方式C: 先执行登录场景，再执行业务场景（顺序依赖）
-#   把「场景1: 账号密码登录」放第一个，登录成功后同一浏览器会话内后续场景共享登录态。
-#   注意: 如果登录有验证码/短信，这种方式不稳定，建议用方式A。
-#
-# ⚠️ 每个 scenario 独立执行，但 cookie/localStorage 在同一浏览器会话内共享。
-
-name: 示例项目冒烟测试
-platform: h5-mobile
-url: /
-
-scenarios:
-
-  # ═══════════════════════════════════════════════════════════════════════════
-  # 一、登录认证 (auth)
-  # ═══════════════════════════════════════════════════════════════════════════
-
-  # ── 场景1: 账号密码登录 ──
-  # 说明: 最基础的登录方式，填写用户名密码后点击登录
-  # 如何替换: 把 selector 换成你页面上的真实选择器，value 换成你的测试账号
-  - name: 登录-账号密码登录
-    description: 模块:auth 页面:/login
-    actions:
-      - type: navigate
-        value: /login                                    # 登录页路由
-      - type: fill
-        selector: 'input[name="username"]'               # 用户名输入框（换成你实际的，如 '#username' / '[data-testid="user-input"]'）
-        value: test_user                                  # 测试账号用户名
-      - type: fill
-        selector: 'input[name="password"]'               # 密码输入框
-        value: Test@123456                                # 测试账号密码
-      - type: click
-        selector: 'button[type="submit"]'                # 登录按钮
-        waitFor: '.dashboard-container'                   # 登录成功后出现的元素（用于等待跳转完成）
-    assertions:
-      - type: url
-        contains: /dashboard                              # 断言 URL 跳转到控制台
-      - type: visible
-        selector: '.dashboard-container'                  # 断言控制台容器可见
-      - type: text
-        selector: '.user-name'                            # 断言页面显示用户名
-        contains: test_user                               # 预期显示的用户名
-
-  # ── 场景2: 手机号+验证码登录 ──
-  # 说明: 输入手机号 → 点击获取验证码 → 输入验证码 → 登录
-  # 如何替换: 测试环境通常有固定验证码（如123456），或需要 mock 验证码接口
-  - name: 登录-手机号验证码
-    description: 模块:auth 页面:/login/phone
-    actions:
-      - type: navigate
-        value: /login/phone                               # 手机号登录页路由
-      - type: fill
-        selector: 'input[name="phone"]'                  # 手机号输入框
-        value: '13800138000'                              # 测试手机号
-      - type: click
-        selector: '.send-code-btn'                        # 获取验证码按钮
-      - type: wait
-        delay: 2000                                       # 等待短信发送（测试环境可缩短）
-      - type: fill
-        selector: 'input[name="verifyCode"]'             # 验证码输入框
-        value: '123456'                                   # 测试环境固定验证码
-      - type: click
-        selector: 'button[type="submit"]'                # 登录按钮
-        waitFor: '.dashboard-container'
-    assertions:
-      - type: url
-        contains: /dashboard
-      - type: visible
-        selector: '.dashboard-container'
-
-  # ── 场景3: 微信 OAuth 登录 ──
-  # 说明: 点击微信登录按钮 → 跳转微信授权页 → 授权后回调
-  # 如何替换: 需配置微信开放平台测试账号，回调域名需与测试环境一致
-  - name: 登录-微信OAuth
-    description: 模块:auth 页面:/login 第三方登录
-    actions:
-      - type: navigate
-        value: /login                                     # 登录页
-      - type: click
-        selector: '.wechat-login-btn'                     # 微信登录按钮（如 [data-testid="wechat-login"]）
-      - type: waitForRequest
-        selector: 'https://open.weixin.qq.com/connect/oauth2/authorize'  # 等待跳转微信授权页
-        timeout: 5000
-      - type: wait
-        delay: 3000                                       # 等待授权回调
-    assertions:
-      - type: url
-        contains: wechat                                  # 断言 URL 包含微信域名
-
-  # ── 场景4: 企业微信 SSO 登录 ──
-  # 说明: 页面内嵌 iframe 展示企业微信登录 → 填写企业 ID → 授权
-  # 如何替换: 企业 ID 从企业微信管理后台获取（格式: wwxxxxxxxxxxxxxxxx）
-  - name: 登录-企业微信SSO
-    description: 模块:auth 页面:/login/sso
-    actions:
-      - type: navigate
-        value: /login/sso                                 # SSO 登录页
-      - type: iframe
-        selector: '#sso-frame'                            # iframe 选择器（切换上下文到 iframe 内部）
-      - type: fill
-        selector: 'input[name="corpId"]'                 # 企业 ID 输入框（在 iframe 内）
-        value: 'ww1234567890abcdef'                       # 企业微信企业 ID
-      - type: click
-        selector: '.sso-submit-btn'                       # 确认按钮（在 iframe 内）
-        waitFor: '.dashboard-container'
-    assertions:
-      - type: url
-        contains: /dashboard
-      - type: visible
-        selector: '.dashboard-container'
-
-  # ── 场景5: 扫码登录 ──
-  # 说明: 进入扫码页 → 二维码渲染 → 等待扫码 → 登录成功
-  # 如何替换: 测试环境可用 mock 接口模拟扫码成功，避免人工操作
-  - name: 登录-扫码登录
-    description: 模块:auth 页面:/login/qrcode
-    actions:
-      - type: navigate
-        value: /login/qrcode                              # 扫码登录页
-      - type: visible
-        selector: '.qrcode-img'                           # 断言二维码图片已渲染
-      - type: wait
-        delay: 5000                                       # 等待扫码（测试环境可 mock 缩短）
-    assertions:
-      - type: visible
-        selector: '.qrcode-img'
-      - type: attribute
-        selector: '.qrcode-img'                           # 断言二维码图片
-        attribute: src                                    # 检查 src 属性
-        contains: data:image                              # 包含 base64 图片数据
-
-  # ── 场景6: 登录失败-密码错误 ──
-  # 说明: 故意输错密码，验证错误提示是否正确
-  # 如何替换: value 填存在的账号 + 错误的密码
-  - name: 登录-密码错误提示
-    description: 模块:auth 页面:/login 异常场景
-    actions:
-      - type: navigate
-        value: /login
-      - type: fill
-        selector: 'input[name="username"]'
-        value: test_user                                  # 存在的用户名
-      - type: fill
-        selector: 'input[name="password"]'
-        value: wrong_password                             # 故意填错密码
-      - type: click
-        selector: 'button[type="submit"]'
-      - type: wait
-        delay: 1000                                       # 等待错误提示出现
-    assertions:
-      - type: visible
-        selector: '.error-message'                        # 错误提示元素
-      - type: text
-        selector: '.error-message'
-        contains: 密码错误                                 # 根据实际文案调整（如"用户名或密码错误"）
-
-  # ── 场景7: 登录失败-账号锁定 ──
-  # 说明: 使用被锁定的账号登录，验证锁定提示
-  - name: 登录-账号锁定提示
-    description: 模块:auth 页面:/login 异常场景
-    actions:
-      - type: navigate
-        value: /login
-      - type: fill
-        selector: 'input[name="username"]'
-        value: locked_user                                # 被锁定的测试账号
-      - type: fill
-        selector: 'input[name="password"]'
-        value: any_password                               # 任意密码
-      - type: click
-        selector: 'button[type="submit"]'
-      - type: wait
-        delay: 1000
-    assertions:
-      - type: visible
-        selector: '.error-message'
-      - type: text
-        selector: '.error-message'
-        contains: 账号已被锁定                             # 根据实际文案调整
-
-  # ── 场景8: 记住密码 ──
-  # 说明: 勾选记住密码 → 登录 → 验证 Cookie 中写入记住密码标记
-  - name: 登录-记住密码
-    description: 模块:auth 页面:/login 记住密码勾选
-    actions:
-      - type: navigate
-        value: /login
-      - type: check
-        selector: 'input[name="rememberMe"]'             # 记住密码复选框
-      - type: fill
-        selector: 'input[name="username"]'
-        value: test_user
-      - type: fill
-        selector: 'input[name="password"]'
-        value: Test@123456
-      - type: click
-        selector: 'button[type="submit"]'
-        waitFor: '.dashboard-container'
-    assertions:
-      - type: cookie
-        selector: remember_me                             # Cookie 名称
-        contains: 'true'                                  # Cookie 值包含 true
-
-  # ── 场景9: 退出登录 ──
-  # 说明: 点击用户头像展开菜单 → 点击退出 → 验证跳回登录页
-  - name: 登录-退出登录
-    description: 模块:auth 页面:/dashboard
-    actions:
-      - type: navigate
-        value: /dashboard                                 # 已登录后的首页
-      - type: click
-        selector: '.user-avatar'                          # 用户头像/菜单触发器
-      - type: click
-        selector: '.logout-btn'                           # 退出按钮
-      - type: wait
-        delay: 1000                                       # 等待跳转
-    assertions:
-      - type: url
-        contains: /login                                  # 断言回到登录页
-      - type: visible
-        selector: '.login-form'                           # 断言登录表单可见
-
-  # ═══════════════════════════════════════════════════════════════════════════
-  # 二、用户中心 (user)
-  # ═══════════════════════════════════════════════════════════════════════════
-
-  # ── 场景10: 修改个人资料 ──
-  # 说明: 修改昵称、性别、邮箱，点击保存
-  # ⚠️ 前置条件: 用户已登录。如需登录态，参考文件开头「方式A」把「场景13: Token注入」放第一个
-  # select 说明: value 填 option 的 value 属性（不是显示文本）
-  # 保存按钮 selector 写法示例（按稳定性排序）:
-  #   1. '[data-testid="save-profile-btn"]'     ← 最稳定，需前端配合添加 data-testid
-  #   2. '#save-profile-btn'                     ← 有 id 时用 id
-  #   3. '.save-profile-btn'                     ← 稳定的 class
-  #   4. 'button[type="submit"]'                 ← 页面只有一个提交按钮时可用
-  #   5. '.profile-form button:last-child'       ← 兜底：表单内最后一个按钮
-  - name: 用户-修改个人资料
-    description: 模块:user 页面:/profile/edit
-    actions:
-      - type: navigate
-        value: /profile/edit                              # 个人资料编辑页
-      - type: fill
-        selector: 'input[name="nickname"]'               # 昵称输入框
-        value: 新昵称测试                                  # 新昵称
-      - type: select
-        selector: 'select[name="gender"]'                # 性别下拉框
-        value: female                                     # option 的 value 值（如 female/male/unknown）
-      - type: fill
-        selector: 'input[name="email"]'                  # 邮箱输入框
-        value: 'newemail@example.com'                     # 新邮箱
-      - type: click
-        selector: '.save-profile-btn'                     # 保存按钮
-      - type: wait
-        delay: 1500                                       # 等待保存接口返回
-    assertions:
-      - type: visible
-        selector: '.toast-success'                        # 成功提示元素
-      - type: text
-        selector: '.toast-success'
-        contains: 保存成功                                 # 预期提示文案
-
-  # ── 场景11: 上传头像 ──
-  # 说明: 选择本地图片文件上传，验证预览图更新
-  # upload 说明: value 为本地文件路径（相对项目根目录或绝对路径）
-  - name: 用户-上传头像
-    description: 模块:user 页面:/profile/edit 头像上传
-    actions:
-      - type: navigate
-        value: /profile/edit
-      - type: upload
-        selector: 'input[type="file"].avatar-upload'     # 文件输入框
-        value: ./fixtures/test-avatar.png                 # 本地图片路径（确保文件存在）
-      - type: wait
-        delay: 2000                                       # 等待上传完成
-    assertions:
-      - type: visible
-        selector: '.avatar-preview img'                   # 头像预览图
-      - type: attribute
-        selector: '.avatar-preview img'
-        attribute: src                                    # 断言 src 属性已更新
-        contains: avatar                                  # 包含 avatar 路径
-
-  # ── 场景12: 修改密码 ──
-  # 说明: 填写旧密码 + 新密码 + 确认密码，点击修改
-  - name: 用户-修改密码
-    description: 模块:user 页面:/profile/security
-    actions:
-      - type: navigate
-        value: /profile/security                          # 安全设置页
-      - type: fill
-        selector: 'input[name="oldPassword"]'            # 旧密码
-        value: OldPass123                                 # 当前密码
-      - type: fill
-        selector: 'input[name="newPassword"]'            # 新密码
-        value: NewPass456                                 # 新密码
-      - type: fill
-        selector: 'input[name="confirmPassword"]'        # 确认密码
-        value: NewPass456                                 # 与新密码保持一致
-      - type: click
-        selector: '.change-password-btn'                  # 确认修改按钮
-      - type: wait
-        delay: 1500
-    assertions:
-      - type: visible
-        selector: '.toast-success'
-      - type: text
-        selector: '.toast-success'
-        contains: 密码修改成功
-
-  # ── 场景13: Token 注入免登录 ──
-  # 说明: 直接通过 localStorage 注入 JWT，跳过登录流程
-  # ⚠️ 核心用途: 作为「前置场景」放在业务场景（场景10-42）之前，为后续场景提供登录态
-  # 适用场景: 测试环境已有固定账号，不需重复测试登录。把这个场景放第一个，后面所有场景共享登录态
-  - name: 用户-Token注入免登录
-    description: 模块:user 页面:/profile Token注入方式
-    actions:
-      - type: localStorage
-        selector: accessToken                             # localStorage key 名
-        value: 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOjEwMDg2fQ.test'  # JWT Token
-      - type: localStorage
-        selector: refreshToken                            # 同时注入 refreshToken
-        value: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0eXBlIjoicmVmcmVzaCJ9.test'
-      - type: navigate
-        value: /profile                                   # 直接访问需要登录的页面
-      - type: wait
-        delay: 800
-    assertions:
-      - type: visible
-        selector: '.profile-header'                       # 断言个人中心头部可见
-      - type: text
-        selector: '.username'                             # 断言显示用户名
-        contains: test_user
-
-  # ═══════════════════════════════════════════════════════════════════════════
-  # 三、商品模块 (product)
-  # ═══════════════════════════════════════════════════════════════════════════
-
-  # ── 场景14: 商品列表浏览 ──
-  # 说明: 进入商品列表 → 滚动到底部 → 验证商品数量
-  - name: 商品-列表浏览
-    description: 模块:product 页面:/products
-    actions:
-      - type: navigate
-        value: /products                                  # 商品列表页
-      - type: scroll
-        selector: bottom                                  # 滚动到页面底部（触发懒加载）
-      - type: wait
-        delay: 1000
-    assertions:
-      - type: visible
-        selector: '.product-list'                         # 商品列表容器
-      - type: count
-        selector: '.product-item'                         # 商品卡片
-        count: 10                                         # 预期至少 10 个商品
-
-  # ── 场景15: 商品搜索 ──
-  # 说明: 输入关键词 → 按回车 → 验证搜索结果
-  - name: 商品-搜索
-    description: 模块:product 页面:/products 搜索功能
-    actions:
-      - type: navigate
-        value: /products
-      - type: fill
-        selector: 'input[name="keyword"]'                # 搜索框
-        value: iPhone                                     # 搜索关键词
-      - type: press
-        key: Enter                                        # 按回车触发搜索
-      - type: wait
-        delay: 1500                                       # 等待搜索结果返回
-    assertions:
-      - type: visible
-        selector: '.search-result-list'                   # 搜索结果列表
-      - type: count
-        selector: '.product-item'
-        count: 3                                          # 预期至少 3 个结果
-
-  # ── 场景16: 商品详情 ──
-  # 说明: 点击商品标题进入详情页，验证详情信息展示
-  - name: 商品-详情页
-    description: 模块:product 页面:/products/:id
-    actions:
-      - type: navigate
-        value: /products
-      - type: click
-        selector: '.product-item:first-child .product-title'  # 点击第一个商品的标题
-      - type: wait
-        delay: 1000
-    assertions:
-      - type: visible
-        selector: '.product-detail'                       # 详情页容器
-      - type: text
-        selector: '.product-name'                         # 商品名称
-        contains: iPhone                                  # 包含搜索关键词
-      - type: visible
-        selector: '.product-price'                        # 价格元素
-
-  # ── 场景17: 商品多条件筛选 ──
-  # 说明: 同时选择分类 + 库存状态，验证筛选结果
-  - name: 商品-多条件筛选
-    description: 模块:product 页面:/products 筛选功能
-    actions:
-      - type: navigate
-        value: /products
-      - type: select
-        selector: 'select[name="category"]'              # 分类下拉框
-        value: electronics                                # option value（如 electronics/clothing/food）
-      - type: check
-        selector: 'input[value="inStock"]'               # 仅看有库存（复选框）
-      - type: click
-        selector: '.filter-submit-btn'                    # 确认筛选按钮
-      - type: wait
-        delay: 1200
-    assertions:
-      - type: visible
-        selector: '.product-list'
-      - type: count
-        selector: '.product-item'
-        count: 5                                          # 筛选后预期 5 个商品
-
-  # ── 场景18: 商品收藏 ──
-  # 说明: 点击收藏按钮，验证按钮颜色变为红色（已收藏状态）
-  - name: 商品-收藏/取消收藏
-    description: 模块:product 页面:/products/:id 收藏功能
-    actions:
-      - type: navigate
-        value: /products/123                              # 某个商品详情页（123 为商品 ID）
-      - type: click
-        selector: '.favorite-btn'                         # 收藏按钮（空心）
-      - type: wait
-        delay: 500
-    assertions:
-      - type: style
-        selector: '.favorite-btn'                         # 断言按钮样式变化
-        style: color                                      # CSS 属性: 颜色
-        value: rgb(255, 77, 79)                           # 预期变为红色（根据实际样式调整）
-
-  # ═══════════════════════════════════════════════════════════════════════════
-  # 四、购物车 (cart)
-  # ═══════════════════════════════════════════════════════════════════════════
-
-  # ── 场景19: 添加商品到购物车 ──
-  # 说明: 商品详情页点击加购，验证购物车角标数字更新
-  - name: 购物车-添加商品
-    description: 模块:cart 页面:/products/:id
-    actions:
-      - type: navigate
-        value: /products/123                              # 商品详情页
-      - type: click
-        selector: '.add-to-cart-btn'                      # 加入购物车按钮
-      - type: wait
-        delay: 800                                        # 等待加购动画/接口
-    assertions:
-      - type: visible
-        selector: '.cart-badge'                           # 购物车角标
-      - type: text
-        selector: '.cart-badge'
-        contains: '1'                                     # 角标显示 1
-
-  # ── 场景20: 修改购物车商品数量 ──
-  # 说明: 修改数量输入框 → 失去焦点触发计算 → 验证小计金额更新
-  - name: 购物车-修改数量
-    description: 模块:cart 页面:/cart
-    actions:
-      - type: navigate
-        value: /cart                                      # 购物车页面
-      - type: fill
-        selector: '.cart-item:first-child .quantity-input'  # 第一个商品的数量输入框
-        value: '3'                                        # 修改为 3 件
-      - type: blur
-        selector: '.cart-item:first-child .quantity-input'  # 触发 blur 事件（触发价格重算）
-      - type: wait
-        delay: 800
-    assertions:
-      - type: text
-        selector: '.cart-item:first-child .subtotal'      # 小计金额
-        contains: '¥'                                    # 包含人民币符号（断言金额已更新）
-
-  # ── 场景21: 购物车去结算 ──
-  # 说明: 勾选商品 → 点击结算 → 验证跳转到结算页
-  - name: 购物车-去结算
-    description: 模块:cart 页面:/cart
-    actions:
-      - type: navigate
-        value: /cart
-      - type: check
-        selector: '.cart-item:first-child .item-checkbox'  # 勾选第一个商品
-      - type: click
-        selector: '.checkout-btn'                         # 去结算按钮
-      - type: wait
-        delay: 1500
-    assertions:
-      - type: url
-        contains: /checkout                               # 断言跳转到结算页
-      - type: visible
-        selector: '.checkout-form'                        # 结算表单
-
-  # ── 场景22: 删除购物车商品 ──
-  # 说明: 点击删除按钮，验证商品被移除
-  - name: 购物车-删除商品
-    description: 模块:cart 页面:/cart
-    actions:
-      - type: navigate
-        value: /cart
-      - type: click
-        selector: '.cart-item:first-child .delete-btn'     # 删除按钮
-      - type: wait
-        delay: 800
-    assertions:
-      - type: count
-        selector: '.cart-item'                            # 断言购物车商品数量
-        count: 0                                          # 预期为 0（空购物车）
-
-  # ═══════════════════════════════════════════════════════════════════════════
-  # 五、订单模块 (order)
-  # ═══════════════════════════════════════════════════════════════════════════
-
-  # ── 场景23: 创建订单 ──
-  # 说明: 填写收货信息 → 提交订单 → 验证订单创建成功
-  - name: 订单-创建订单
-    description: 模块:order 页面:/checkout
-    actions:
-      - type: navigate
-        value: /checkout                                  # 结算页
-      - type: fill
-        selector: 'input[name="receiverName"]'           # 收货人姓名
-        value: 张三                                       # 真实姓名或测试姓名
-      - type: fill
-        selector: 'input[name="phone"]'                  # 手机号
-        value: '13800138000'
-      - type: fill
-        selector: 'input[name="address"]'                # 详细地址
-        value: 北京市朝阳区测试街道123号                   # 测试地址
-      - type: click
-        selector: '.submit-order-btn'                     # 提交订单按钮
-      - type: wait
-        delay: 2000                                       # 等待订单创建接口
-    assertions:
-      - type: url
-        contains: /order/success                          # 断言跳转到成功页
-      - type: visible
-        selector: '.order-success'                        # 成功提示
-      - type: text
-        selector: '.order-success'
-        contains: 订单提交成功
-
-  # ── 场景24: 订单支付 ──
-  # 说明: 选择支付方式 → 确认支付 → 等待支付接口返回 → 验证成功
-  - name: 订单-支付订单
-    description: 模块:order 页面:/pay/:orderId
-    actions:
-      - type: navigate
-        value: /pay/ORD202409110001                       # 支付页（ORD202409110001 为订单号）
-      - type: click
-        selector: '.pay-method-wechat'                    # 选择微信支付
-      - type: click
-        selector: '.confirm-pay-btn'                      # 确认支付按钮
-      - type: waitForResponse
-        selector: '/api/pay/create'                       # 等待支付创建接口返回
-        timeout: 10000                                    # 支付接口较慢，超时设 10 秒
-      - type: wait
-        delay: 2000
-    assertions:
-      - type: url
-        contains: /pay/success                            # 断言跳转到支付成功页
-      - type: visible
-        selector: '.pay-success'
-
-  # ── 场景25: 订单列表查询 ──
-  - name: 订单-列表查询
-    description: 模块:order 页面:/orders
-    actions:
-      - type: navigate
-        value: /orders                                    # 订单列表页
-      - type: wait
-        delay: 1000
-    assertions:
-      - type: visible
-        selector: '.order-list'
-      - type: count
-        selector: '.order-item'
-        count: 5                                          # 预期至少 5 个订单
-
-  # ── 场景26: 订单详情查看 ──
-  - name: 订单-详情查看
-    description: 模块:order 页面:/orders/:id
-    actions:
-      - type: navigate
-        value: /orders
-      - type: click
-        selector: '.order-item:first-child .view-detail-btn'  # 查看第一个订单详情
-      - type: wait
-        delay: 800
-    assertions:
-      - type: visible
-        selector: '.order-detail'
-      - type: text
-        selector: '.order-status'                         # 订单状态
-        contains: 待付款                                  # 预期状态文案
-
-  # ── 场景27: 取消订单 ──
-  # 说明: 点击取消 → 确认取消 → 验证状态变为已取消
-  - name: 订单-取消订单
-    description: 模块:order 页面:/orders/:id
-    actions:
-      - type: navigate
-        value: /orders/ORD202409110001                    # 某个待付款订单
-      - type: click
-        selector: '.cancel-order-btn'                     # 取消订单按钮
-      - type: wait
-        delay: 500                                        # 等待确认弹窗
-      - type: click
-        selector: '.confirm-cancel-btn'                   # 确认取消按钮
-      - type: wait
-        delay: 1500                                       # 等待取消接口返回
-    assertions:
-      - type: text
-        selector: '.order-status'
-        contains: 已取消                                  # 状态变为已取消
-
-  # ═══════════════════════════════════════════════════════════════════════════
-  # 六、消息通知 (notification)
-  # ═══════════════════════════════════════════════════════════════════════════
-
-  # ── 场景28: 消息列表查看 ──
-  - name: 消息-列表查看
-    description: 模块:notification 页面:/notifications
-    actions:
-      - type: navigate
-        value: /notifications                             # 消息中心
-      - type: wait
-        delay: 1000
-    assertions:
-      - type: visible
-        selector: '.notification-list'
-      - type: count
-        selector: '.notification-item'
-        count: 3                                          # 预期 3 条未读消息
-
-  # ── 场景29: 消息标记已读 ──
-  # 说明: 点击消息 → 验证字体从粗体变为正常（已读状态）
-  - name: 消息-标记已读
-    description: 模块:notification 页面:/notifications
-    actions:
-      - type: navigate
-        value: /notifications
-      - type: click
-        selector: '.notification-item:first-child'        # 点击第一条消息
-      - type: wait
-        delay: 500
-    assertions:
-      - type: style
-        selector: '.notification-item:first-child'
-        style: font-weight                                 # CSS 属性: 字重
-        value: '400'                                       # 400 = normal（已读），700 = bold（未读）
-
-  # ═══════════════════════════════════════════════════════════════════════════
-  # 七、后台管理 (admin)
-  # ═══════════════════════════════════════════════════════════════════════════
-
-  # ── 场景30: 用户管理列表 ──
-  - name: 后台-用户管理
-    description: 模块:admin 页面:/admin/users
-    actions:
-      - type: navigate
-        value: /admin/users                               # 后台用户管理页
-      - type: wait
-        delay: 1500                                       # 等待表格数据加载
-    assertions:
-      - type: visible
-        selector: '.user-table'                           # 用户表格
-      - type: count
-        selector: '.user-table tbody tr'                  # 表格行数
-        count: 10                                         # 预期 10 条用户数据
-
-  # ── 场景31: 数据报表（iframe 嵌入） ──
-  # 说明: 后台报表通常用 iframe 嵌入第三方 BI 工具（如帆软、Tableau）
-  - name: 后台-数据报表iframe
-    description: 模块:admin 页面:/admin/reports iframe嵌入
-    actions:
-      - type: navigate
-        value: /admin/reports                             # 报表页面
-      - type: iframe
-        selector: '#report-frame'                         # 报表 iframe
-      - type: wait
-        delay: 2000                                       # 等待 iframe 内报表加载
-    assertions:
-      - type: visible
-        selector: '.chart-container'                      # 图表容器（在 iframe 内）
-      - type: count
-        selector: '.chart-item'                           # 图表数量
-        count: 4                                          # 预期 4 个图表
-
-  # ── 场景32: 拖拽排序 ──
-  # 说明: 拖拽分类/菜单项调整顺序
-  - name: 后台-拖拽排序
-    description: 模块:admin 页面:/admin/categories 拖拽排序
-    actions:
-      - type: navigate
-        value: /admin/categories                          # 分类管理页
-      - type: drag
-        selector: '.category-item:first-child'            # 拖拽第一个分类
-        toSelector: '.category-item:last-child'           # 放到最后一个位置
-      - type: wait
-        delay: 1000                                       # 等待保存接口
-    assertions:
-      - type: text
-        selector: '.category-item:last-child .category-name'  # 断言最后一个分类的名称
-        contains: 原第一个分类                            # 确认拖拽成功
-
-  # ═══════════════════════════════════════════════════════════════════════════
-  # 八、通用能力
-  # ═══════════════════════════════════════════════════════════════════════════
-
-  # ── 场景33: Cookie 注入免登录 ──
-  # 说明: 直接注入 session Cookie，跳过登录页，适合批量测试业务模块
-  # ⚠️ 核心用途: 作为「前置场景」放在业务场景（场景10-42）之前，为后续场景提供登录态
-  # 如何获取 Cookie: 在浏览器开发者工具 → Application → Cookies 中复制
-  - name: 通用-Cookie注入免登录
-    description: 模块:common Cookie注入跳过登录
-    actions:
-      - type: cookie
-        selector: session_token                           # Cookie 名称
-        value: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOjEwMDg2fQ.test'  # Cookie 值
-        domain: example.com                               # Cookie 域名（必须与测试站点一致）
-        path: /                                           # Cookie 路径
-        secure: true                                      # 仅 HTTPS 传输
-        httpOnly: true                                    # 禁止 JS 读取
-      - type: cookie
-        selector: user_id                                 # 同时注入 user_id
-        value: '10086'
-        domain: example.com
-        path: /
-      - type: navigate
-        value: /dashboard                                 # 直接访问需登录页面
-      - type: wait
-        delay: 1000
-    assertions:
-      - type: visible
-        selector: '.dashboard-container'
-      - type: text
-        selector: '.user-name'
-        contains: test_user
-
-  # ── 场景34: 首页滚动加载 ──
-  - name: 通用-首页滚动加载
-    description: 模块:home 页面:/
-    actions:
-      - type: navigate
-        value: /
-      - type: scroll
-        selector: bottom                                  # 滚动到底部
-      - type: wait
-        delay: 1500
-      - type: scroll
-        selector: bottom                                  # 再次滚动（触发第二轮加载）
-      - type: wait
-        delay: 1500
-    assertions:
-      - type: visible
-        selector: '.load-more-btn'                        # 加载更多按钮
-      - type: count
-        selector: '.product-card'                         # 商品卡片总数
-        count: 20                                         # 预期加载了 20 个商品
-
-  # ── 场景35: 样式断言 ──
-  # 说明: 验证按钮颜色、圆角等样式是否符合设计稿
-  - name: 通用-按钮样式检查
-    description: 模块:ui 页面:/
-    actions:
-      - type: navigate
-        value: /
-    assertions:
-      - type: style
-        selector: '.primary-btn'                          # 主按钮
-        style: background-color                           # CSS 属性: 背景色
-        value: rgb(24, 144, 255)                          # 预期颜色（根据设计稿调整）
-      - type: style
-        selector: '.primary-btn'
-        style: border-radius                               # CSS 属性: 圆角
-        value: 4px                                         # 预期 4px 圆角
-
-  # ── 场景36: 视觉对比测试 ──
-  # 说明: 截图后与基线图片对比，检测 UI 回归
-  # 前置条件: 先执行一次生成基线图片，后续对比以此为准
-  - name: 通用-视觉对比测试
-    description: 模块:ui 页面:/ 视觉回归
-    actions:
-      - type: navigate
-        value: /
-      - type: screenshot                                   # 页面截图
-    assertions:
-      - type: visual
-        selector: 'body'                                  # 对比整个页面
-        threshold: normal                                 # 阈值: strict/normal/loose
-
-  # ── 场景37: 键盘操作 ──
-  # 说明: 聚焦搜索框 → 输入关键词 → 按回车触发搜索
-  - name: 通用-键盘操作
-    description: 模块:common 页面:/products 键盘导航
-    actions:
-      - type: navigate
-        value: /products
-      - type: focus
-        selector: 'input[name="keyword"]'                # 聚焦搜索框
-      - type: fill
-        selector: 'input[name="keyword"]'
-        value: MacBook
-      - type: press
-        key: Enter                                        # 按回车
-      - type: wait
-        delay: 1500
-    assertions:
-      - type: visible
-        selector: '.search-result-list'
-      - type: count
-        selector: '.product-item'
-        count: 2                                          # 预期 2 个结果
-
-  # ── 场景38: hover 效果 ──
-  # 说明: 鼠标悬停在商品卡片上，验证阴影/边框等 hover 样式
-  - name: 通用-hover效果
-    description: 模块:ui 页面:/products hover交互
-    actions:
-      - type: navigate
-        value: /products
-      - type: hover
-        selector: '.product-item:first-child'             # 悬停在第一个商品
-      - type: wait
-        delay: 500                                        # 等待 hover 动画
-    assertions:
-      - type: style
-        selector: '.product-item:first-child'
-        style: box-shadow                                  # CSS 属性: 阴影
-        contains: rgba                                     # 包含 rgba（有阴影）
-
-  # ── 场景39: 元素隐藏检查 ──
-  # 说明: 验证未登录状态下，用户菜单和退出按钮不显示
-  - name: 通用-元素隐藏
-    description: 模块:ui 页面:/login 未登录状态
-    actions:
-      - type: navigate
-        value: /login                                     # 未登录页面
-    assertions:
-      - type: hidden
-        selector: '.user-menu'                            # 用户菜单应隐藏
-      - type: hidden
-        selector: '.logout-btn'                           # 退出按钮应隐藏
-
-  # ── 场景40: 表单值断言 ──
-  # 说明: 验证表单字段的默认值是否正确
-  - name: 通用-表单值检查
-    description: 模块:user 页面:/profile/edit 表单默认值
-    actions:
-      - type: navigate
-        value: /profile/edit
-    assertions:
-      - type: value
-        selector: 'input[name="username"]'               # 断言表单值
-        equals: test_user                                 # 精确匹配
-      - type: value
-        selector: 'input[name="email"]'
-        contains: '@'                                     # 包含 @ 符号
-
-  # ── 场景41: JavaScript 注入执行 ──
-  # 说明: 执行自定义 JS，如修改全局变量、调用前端方法
-  - name: 通用-JS脚本注入
-    description: 模块:common 页面:/ JS注入测试
-    actions:
-      - type: navigate
-        value: /
-      - type: script
-        value: 'window.testFlag = "injected";'             # 设置全局变量
-      - type: wait
-        delay: 500
-      - type: script
-        value: 'return window.testFlag;'                   # 读取全局变量（返回给引擎）
-    assertions:
-      - type: text
-        selector: 'body'
-        contains: injected                                # 断言页面包含 injected 文本
-
-  # ── 场景42: 响应式布局测试 ──
-  # 说明: 验证移动端下显示移动端导航，隐藏桌面端侧边栏
-  # 注意: Playwright 可通过 viewport 配置模拟不同设备尺寸
-  - name: 通用-响应式布局
-    description: 模块:ui 页面:/ 移动端适配
-    actions:
-      - type: navigate
-        value: /
-      - type: wait
-        delay: 800
-    assertions:
-      - type: visible
-        selector: '.mobile-nav'                           # 移动端导航应可见
-      - type: hidden
-        selector: '.desktop-sidebar'                      # 桌面端侧边栏应隐藏