用途：为 React + Vite 项目搭建 Tailwind v4 与 shadcn/ui 的主题化界面，并支持深色模式，产出配置好的 CSS、主题 Provider 与可用的组件库。
主要能力：按“四步模式”组织主题架构——在 :root/.dark 定义 CSS 变量（用 hsl() 包裹），用 @theme inline 将变量映射为 Tailwind 工具类（如 --color-background → bg-background），再在 @layer base 应用基础样式；通过 ThemeProvider 在 <html> 上切换 .dark 类实现明暗主题，无需为语义色写 dark: 变体。
使用方式：安装依赖 pnpm add tailwindcss @tailwindcss/vite，pnpm add -D @types/node tw-animate-css，pnpm dlx shadcn@latest init，并删除 tailwind.config.ts；在 Vite 配置中引入 @tailwindcss/vite 插件；按顺序编写 index.css；复制 theme-provider.tsx 包裹应用；用 pnpm dlx shadcn@latest add dropdown-menu 添加切换组件；components.json 中设置 "config": ""。
适用场景：需要语义化配色、明暗主题切换与 shadcn/ui 组件的 Tailwind v4 前端项目。
限制与注意：必须使用 @tailwindcss/vite 而非 PostCSS；:root/.dark 不能放在 @layer base 内；不支持嵌套 @theme；避免 hsl(var(--x)) 双重包裹；颜色需满足 WCAG 对比度（正文 4.5:1，大文本与 UI 3:1）；tailwindcss-animate 已弃用，改用 tw-animate-css；shadcn init 后需合并重复的 @layer base。具体版本与依赖以资料所列为准，其他环境细节暂未提供。