用途:在 Next.js 13+(App Router)项目中使用 shadcn/ui 与 Tailwind v4 时,强制统一、可访问且美观的 UI 规范。适用于新建组件或页面、生成 UI 元素、样式化 React 组件、初始化项目设计系统,以及在生成任何 UI 代码前进行约束。
主要能力:核心约束包括——排版仅允许 4 个字号与 2 个字重(Semibold 与 Regular,禁止 bold、light 等);所有间距必须可被 8 或 4 整除(如 8、16、24、32px,禁止 15、25px);颜色遵循 60/30/10 规则(60% bg-background、30% text-foreground、10% bg-primary);使用 OKLCH 颜色变量;仅使用 @/components/ui/ 下的 shadcn/ui 组件;需满足无障碍要求(ARIA 标签、键盘导航)。提供 setup-design-system.sh 交互式配置、validate-design-system.sh 校验、update-colors.sh 批量颜色更新、check-typography.sh 排版审计等脚本,以及模板与示例文档。
使用方式:项目初始化时运行 ./scripts/setup-design-system.sh,配置项目名与品牌色、4 级字号、OKLCH 颜色、深色模式色板及 Figma 链接,生成 design-system.md。生成 UI 前必须先阅读 design-system.md 理解约束,按规范生成代码,再用 ./scripts/validate-design-system.sh path/to/component.tsx 自校验;校验会检查字号数量、字重、间距整除、颜色分布、自定义 CSS 与无障碍合规。
适用场景与限制:适合需要严格设计一致性的 Next.js + shadcn/ui + Tailwind v4 项目,如任务管理、仪表板与电商等示例场景。限制为强制规范,违反会被拒绝(超过 4 字号、额外字重、间距不符、强调色超 10%、自定义 CSS 代替 Tailwind、使用非 shadcn/ui 组件)。具体价格、平台支持及安装细节暂未提供。