TheOrcDev/shadscan

解决的问题

Shadscan 是一个为使用 shadcn/ui 构建的 React 应用程序设计的确定性 UI 审计工具。它能识别开发过程中常被忽略的缺失产品细节和 UI 基础要素——如命令菜单、无障碍控制和移动端行为——并提供 0 到 100 的评分来量化 UI 质量。

如何工作

该工具对项目代码进行静态源码审计，评估其是否符合内置的 62 项确定性检查规则集。它还可以使用隔离的 Chromium 浏览器执行渲染后的 UI 检查，以检测移动端和桌面端视口中的水平溢出等问题。结果被分类为修复项、决策项和建议项，可导出为 JSON 或作为编码代理的提示使用。

适用人群

使用 shadcn/ui 和 React（包括 Next.js、React Router、TanStack Start、Astro 等）的前端开发者和团队，希望确保其应用达到高水准的无障碍性、交互性和生产级打磨标准。

主要亮点

• 确定性分析：无需 AI 模型、应用密钥或启动应用即可执行只读扫描（适用于源码审计）。
• 代理交接：生成专为编码代理设计的、可直接粘贴的修复计划。
• MCP 服务器：提供 Model Context Protocol 服务器，使 AI 代理可将审计结果作为类型化工具调用进行查询。
• 多框架支持：适用于各种 React 环境，包括 monorepos 和混合型 Next.js 项目。
• CI/CD 集成：包含 GitHub Action，可强制执行最低评分并通过 GitHub Issues 追踪发现结果。