SuperAPI AI 工具集

web-quality-audit

测试与质量

查看项目

更新于 10-15 15:39

技能介绍

用途

Web Quality Audit 用于对网页或项目进行综合质量审查,审查标准基于 Google Lighthouse 审计。它覆盖性能、无障碍(Accessibility)、SEO 和最佳实践四大类别,包含 150 多项检查。当被要求“审计我的站点”“审查网页质量”等任务时使用。

工作方式

  1. 分析提供的代码或项目,查找质量问题。
  2. 按严重程度对发现的问题分类:Critical、High、Medium、Low。
  3. 提供具体、可执行的建议。
  4. 附带修复用的代码示例。

审计类别

性能(通常占问题的 40%)

Core Web Vitals(良好页面体验必须通过):

  • LCP(Largest Contentful Paint)< 2.5s:最大可见元素必须快速渲染,需优化图片、字体和服务器响应时间。
  • INP(Interaction to Next Paint)< 200ms:用户交互必须感觉即时,需减少 JavaScript 执行时间并拆分长任务。
  • CLS(Cumulative Layout Shift)< 0.1:内容不得跳动,需为图片、嵌入内容和广告设置明确尺寸。

资源优化:

  • 压缩图片,使用 WebP/AVIF 并提供回退,通过 srcset 提供正确尺寸的图片。
  • 最小化 JavaScript,移除未使用代码,使用代码分割,延迟非关键脚本。
  • 优化 CSS,提取关键 CSS,移除未使用样式,避免 @import。
  • 高效字体,使用 font-display: swap,预加载关键字体,按需子集化字符。

加载策略:

  • 预连接来源,为第三方域名添加 <link rel="preconnect">。
  • 预加载关键资源:LCP 图片、字体和首屏 CSS。
  • 懒加载首屏以下内容:图片、iframe 和重型组件。
  • 有效缓存:静态资源使用长缓存 TTL,带哈希文件使用不可变缓存。

无障碍(通常占问题的 30%)

可感知:

  • 文本替代:每个 <img> 都有有意义的 alt 文本,装饰性图片使用 alt=""。
  • 颜色对比度:普通文本至少 4.5:1,大文本至少 3:1(WCAG AA)。
  • 不单独依赖颜色:颜色指示旁配合图标、图案或文字。
  • 字幕与转录:视频有字幕,音频有转录。

可操作:

  • 键盘可访问:所有功能可通过键盘使用,无键盘陷阱。
  • 焦点可见:所有交互元素有清晰的焦点指示。
  • 跳转链接:为键盘用户提供“跳到主要内容”。
  • 充足时间:用户可延长时限,无控制的自动推进内容不应存在。

可理解:

  • 页面语言:在 <html> 上设置 lang 属性。
  • 一致的导航:各页面导航结构相同。
  • 错误识别:表单错误清晰描述并与字段关联。
  • 标签与说明:所有表单输入都有对应标签。

健壮性:

  • 有效 HTML:无重复 ID,元素正确嵌套。
  • 正确使用 ARIA:优先使用原生元素,ARIA 角色与行为匹配。
  • 名称、角色、值:交互元素有可访问名称和正确角色。

SEO(通常占问题的 15%)

可抓取性:

  • 有效的 robots.txt,不屏蔽重要资源。
  • XML 站点地图,列出所有重要页面并提交到 Search Console。
  • 规范 URL,防止重复内容问题。
  • 重要页面无 noindex,检查 meta robots 和响应头。

页面内 SEO:

  • 唯一标题标签,50-60 字符,包含主要关键词。
  • Meta 描述,150-160 字符,有吸引力且唯一。
  • 标题层级:单个 <h1>,逻辑清晰的标题结构。
  • 描述性链接文本,不用“点击这里”或“阅读更多”。

技术 SEO:

  • 移动友好:响应式设计,点击目标 ≥ 48px。
  • HTTPS:需要安全连接。
  • 快速加载:性能直接影响排名。
  • 结构化数据:使用 JSON-LD 实现富摘要(Article、Product、FAQ 等)。

最佳实践(通常占问题的 15%)

安全:

  • 全站 HTTPS,无混合内容,启用 HSTS。
  • 无漏洞库,保持依赖更新。
  • CSP 响应头,内容安全策略防止 XSS。
  • 生产构建中不暴露 source map。

现代标准:

  • 无废弃 API,替换 document.write、同步 XHR 等。
  • 有效 doctype,使用 <!DOCTYPE html>。
  • 声明字符集,<meta charset="UTF-8"> 作为 <head> 首个元素。
  • 无浏览器错误,控制台干净,无 CORS 问题。

UX 模式:

  • 无侵入式插页,尤其在移动端。
  • 清晰的权限请求,仅在需要时带上下文询问。
  • 无误导性按钮,按钮行为与文字一致。

严重程度

  • Critical:安全漏洞、完全失败,立即修复。
  • High:Core Web Vitals 失败、重大无障碍障碍,发布前修复。
  • Medium:性能机会、SEO 改进,本迭代内修复。
  • Low:次要优化、代码质量,方便时修复。

审计输出格式

执行审计时,按以下结构组织发现:

Audit results

Critical issues (X found)

  • [Category] Issue description. File: path/to/file.js:123
    • Impact: Why this matters
    • Fix: Specific code change or recommendation

High priority (X found)

...

Summary

  • Performance: X issues (Y critical)
  • Accessibility: X issues (Y critical)
  • SEO: X issues
  • Best Practices: X issues

Recommended priority

  1. First fix this because...
  2. Then address...
  3. Finally optimize...

快速检查清单

每次部署前:

  • Core Web Vitals 通过
  • 无无障碍错误(axe/Lighthouse)
  • 无控制台错误
  • HTTPS 正常
  • Meta 标签齐全

每周审查:

  • 检查 Search Console 问题
  • 查看 Core Web Vitals 趋势
  • 更新依赖
  • 用屏幕阅读器测试

每月深入:

  • 完整 Lighthouse 审计
  • 性能分析
  • 与真实用户进行无障碍审计
  • SEO 关键词审查

参考

针对特定领域的详细指南:Performance Optimization、Core Web Vitals、Accessibility、SEO、Best Practices。