用途：帮助在项目中采用 Tailwind CSS v4 的 CSS-first 配置方式，适用于安装 v4、从 v3 迁移，以及配置 Vite、PostCSS、CLI 或框架集成。目标是尽量用 CSS 完成配置，仅在项目工具链要求时保留 JavaScript 配置。
主要能力与规则：使用 @import "tailwindcss"; 导入 Tailwind；用 @theme 定义主题令牌；默认依赖自动内容检测；仅在检测遗漏文件或外部包时使用 @source；主题值使用 CSS 自定义属性；在旧环境使用 v4 前先检查浏览器支持；不要照搬 v3 的 content 配置；v4 中不要使用旧的 @tailwind base/components/utilities。
配置模式示例：@import "tailwindcss"; 后接 @theme { --color-brand-primary: oklch(0.65 0.24 354.31); --font-display: "Satoshi", "sans-serif"; --breakpoint-3xl: 1920px; }。
关键变化：CSS-first 配置、单一导入、自动内容检测、原生级联层、主题值作为 CSS 变量、现代浏览器基线。工具类变化包括 shadow-sm 改为 shadow-xs、rounded-sm 改为 rounded-xs、bg-gradient-to-r 改为 bg-linear-to-r。
使用流程：识别项目框架与构建工具；检查现有 Tailwind 版本；添加 v4 包与集成；创建或更新主 CSS 入口；将令牌移入 @theme；仅在检测遗漏时添加 @source；运行构建并做视觉检查。
浏览器兼容：Chrome/Edge 111+、Firefox 128+、Safari 16.4+。
限制：资料未提供具体安装命令、各框架的完整配置代码与验证命令细节，需参考其 context 目录下的 setup-examples.md、migration-guide.md、framework-examples.md、advanced-config.md 及官方 v4 文档与升级指南。