val

Val QA 扫描 — GitHub Action

在每个 PR 上运行 Val，这是一款面向氛围编程应用的 QA Agent。Val 会通过真实浏览器访问预览 URL，发现失效链接、无响应按钮、损坏的布局、无障碍违规问题，并以 PR 评论的形式发布报告。

需要订阅 Val

Val 是一款付费产品。请在 val.nyx-intelligence.com 获取许可证密钥，将其保存为仓库机密（例如 VAL_LICENSE_KEY），并传递给此 Action。

快速开始

name: Val QA
on: pull_request

jobs:
  qa:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy preview
        id: deploy
        # ... your preview deployment step (Vercel, Netlify, etc.) ...
        # outputs.url should be the preview URL

      - name: Val scan
        uses: nyx-intelligence/val-action@v1
        with:
          url: ${{ steps.deploy.outputs.url }}
          license-key: ${{ secrets.VAL_LICENSE_KEY }}
          devices: 'desktop,iPhone 14'
          fail-on: 'high'

输入

名称	默认值	说明
url	（必填）	Val 应扫描的 URL。请传入预览部署 URL。
license-key	（必填）	你的 Val 许可证密钥（vk_...）。请在 val.nyx-intelligence.com 获取。
max-pages	12	要爬取的同源页面数上限。
devices	desktop	以逗号分隔的设备配置，例如 desktop,iPhone 14,Pixel 7。
fail-on	high	导致 Action 失败的问题严重级别：high、medium、low 或 never。
comment	true	是否以 PR 评论的形式发布报告（true / false）。
github-token	${{ github.token }}	用于发布 PR 评论的令牌。

输出

名称	说明
high	高严重级别发现的数量。
medium	中严重级别发现的数量。
low	低严重级别发现的数量。
report-path	原始报告文件的路径。

Val 检查的内容

• 失效链接和 4xx/5xx 响应
• 未捕获的 JS 错误和控制台错误
• 损坏或缺失的图片
• 移动设备上的水平布局溢出
• 固定容器中的文本被截断
• 累积布局偏移（加载卡顿）
• 无障碍基础项：缺少 alt、按钮无名称、输入框无标签、缺少 <html lang>
• 多设备检查：发现仅在移动设备或仅在桌面设备上出现的问题

权限

此 Action 需要 pull-requests: write 权限才能发布评论：

permissions:
  contents: read
  pull-requests: write