Web 界面设计审计专家：常见问题

在这里，我们汇总了大家在开始使用时最常关心的几个问题。

既然可以全自动审计，是不是代表我不需要研发人员做 UI Code Review 了？

不是的。这个 Skill 主要是帮你拦截“低级错误”和“规范缺失”。比如是否漏了标签、是否用错了按钮组件。但对于审美（颜色配不配）、业务逻辑是否合理，仍然需要研发负责人的专业判断。它更像是一个超级助手，帮大家腾出精力处理更有创造力的事情。

如果我的项目很大，扫描一次会很久吗？

不会。由于它只进行规则匹配和比对，而非深度编译，扫描过程通常在几秒到几十秒内完成。你可以指定特定的 src 目录来加快速度。

它能帮我自动把代码改好吗？

目前的版本专注于“诊断”而非“手术”。它会告诉你哪里错了、为什么错，并给出修正建议。我们认为让研发人员理解规范并手动修改，比 AI 自动改代码更有利于项目的长期稳定。

这个规范是强制的吗？如果不符合会怎么样？

这些规范来自 Vercel 内部的最佳实践。虽非法律强制，但在用户体验、性能、多设备适配和 SEO 方面都有显著收益。如果不符合，通常意味着你的产品在某些极端或精细场景下（如弱网、低视力、移动端手势）表现不佳。你可以根据项目优先级进行权衡，优先修复无障碍访问和性能卡顿等关键问题。

发现报错后，我该怎么处理？

最简单的做法就是把具体的报错项直接转发给负责该模块的研发同学。因为报告里包含了具体的文件和行号，研发小伙伴修正起来非常快。

只能扫描 React 项目吗？

主要针对 Web 界面相关的代码（包括 HTML、React 组件、Vue 组件等）。只要是基于 Web 技术的 UI 展现，大部分规则都能精准生效。

我能自定义增减规则吗？

目前的规则集是由源 URL 锁定的，这保证了审计的专业权威性。如果你有特定的团队规则需要额外检查，建议在审计报告的基础上，再口头或通过文档补充说明。