用途：帮助 AI 代理在 React + Vite 项目中按 Tailwind CSS v4 与 shadcn/ui 的正确方式完成初始化与主题配置，规避已知报错（如 tw-animate-css 导入错误、重复 @layer base、模板选错、插件语法错误）。
主要能力：给出五步快速开始流程与四步架构；用 CSS 变量在 :root 与 .dark 中定义颜色并加 hsl() 包裹，通过 @theme inline 映射生成 bg-background、text-primary 等工具类；@layer base 直接引用未包裹的变量；配置 components.json 时设 "tailwind.config": ""，并删除 tailwind.config.ts；暗色模式需 ThemeProvider 包裹应用并配合 ModeToggle；插件使用 @plugin 指令。
使用方式：bun add tailwindcss @tailwindcss/vite，bun add -d @types/node，然后 pnpm dlx shadcn@latest init（因 Bun 兼容问题改用 pnpm）。Vite 配置引入 tailwindcss() 插件并设置 @ 别名。
适用场景：React 19 + Vite 项目接入 Tailwind v4 与 shadcn/ui、暗色模式、从 v3 迁移、官方插件配置。
限制：颜色勿双重包裹 hsl()，勿用 @apply 与 tailwindcss-animate/tw-animate-css，勿用 .dark { @theme {} } 嵌套。部分实现细节（如主题切换组件完整代码）在参考文件中，本资料未展开。