用途:审查 UI4 CSS 迁移,确保组件使用语义令牌而非硬编码值或原始调色板,并自动修复违规。
主要能力:区分 --ramp-* 原始调色板与 --color-* 语义令牌,组件应始终使用 --color-。检测六类违规:SCSS 嵌套(&__、&--)、硬编码间距(px/rem)、硬编码颜色(hex、rgb、rgba)、遗留主题变量(--theme-、--style-、--base)、旧令牌名(--bg-default 等)、原始调色板(--ramp-,colors.css 除外)。
使用方式:先用 git status --porcelain | grep '.css$' 获取变更的 CSS 文件,再并行运行六条 grep 检测,然后按优先级自动修复:SCSS 嵌套、遗留变量、旧令牌名、原始调色板、硬编码值。修复使用 replace_string_in_file 或 multi_replace_string_in_file,最后报告已修复与需人工复核项。
适用场景:Payload UI4 迁移中的 CSS 审查与批量修复。
限制:无明确令牌匹配的值(如 3px、18px)只标记不猜测;1px 边框、0 等有意值不修改;迁移后为空的 CSS 文件应删除并移除导入。