用途：将 Tailwind CSS v3.x 项目升级到 v4.x，并处理升级后出现的构建错误（如 @tailwind 指令未知、缺少 @tailwindcss/postcss、无法应用未知工具类、tailwind.config 不再被读取），以及把 tailwind.config.{js,ts} 转为 CSS 优先的 @theme。若项目已在 v4、需要降级或新建设计系统，则不适用。注意 v4 面向 Safari 16.4+、Chrome 111+、Firefox 128+，需支持更旧浏览器时应留在 v3.4。
主要能力：核心思路是迁移应为视觉无变化。重命名的工具类多为纯别名（shadow-sm→shadow-xs、rounded→rounded-sm、ring→ring-3、outline-none→outline-hidden），真正改变像素的主要是 v4 的默认值变更。流程包括：预检与基线（Node 20+、干净工作树、建分支、清点所有入口、记录 darkMode/theme.extend/plugins/prefix/theme.container、截图基线）；运行 npx @tailwindcss/upgrade@latest（脏树需 --force）；核对依赖与构建管线（移除 tailwindcss@3、autoprefixer、postcss-import，改用 @tailwindcss/postcss 或 @tailwindcss/vite，CSS 入口改为 @import "tailwindcss";，内置插件删除，typography 用 @plugin 加载且需 ≥0.5.16，container 用 @utility 重建）；默认值审计与兼容垫片（border/divide 颜色、ring 宽度与颜色、placeholder、按钮 cursor、dialog 边距、hover 仅限悬停设备、dark mode 变体）；残留扫描（grep 后按表修复，注意裸重命名顺序与 space-x/y、divide-x/y 选择器变化、渐变 via-none）；验证（构建、lint、类型检查、单测通过，重跑基线确认零意外差异，并手动检查截图不可见的行为变化）。
使用方式：按步骤顺序执行，不跳过预检与默认值审计。配置可移植到 CSS @theme 或保留 JS 文件用 @config 引用；@import "tailwindcss"; 必须最先，@config 与 @theme 在其后；自定义 @layer utilities/components 转为 @utility；动画库 tailwindcss-animate 换为 tw-animate-css；Vue/Svelte/Astro 作用域样式需加 @reference 或使用原始 CSS 变量；不支持 Sass/Less/Stylus。
限制：无代码修改工具时需手动回退流程；corePlugins、safelist、separator 在 v4 的 JS 配置中不受支持；部分行为变化无法通过像素对比确认，需人工判断。具体收费、价格与平台信息暂未提供。