Design Token Audit Kit：设计一致性巡检工具

这个项目的出发点很直接：
设计系统文档写得再清楚，只要缺少自动巡检，风格漂移就会在日常迭代里慢慢积累。

项目目标

• 自动发现 token 使用偏差（颜色、间距、字体）；
• 识别组件层“自定义样式逃逸”；
• 生成可读的审计报告，方便设计和前端协同。

核心机制

1) Token 映射解析

工具会读取设计 token 清单，并建立“允许值索引”。
当页面样式出现未登记值时，直接标记为风险项。

2) 样式扫描

扫描 CSS、组件内联样式和主题变量，重点关注：

• 非标准颜色值
• 非约定字号/字重
• 非约定间距步进

3) 规则分级

审计结果分为：

• error：强约束违规，必须处理；
• warn：建议收敛；
• info：可观测项，便于趋势分析。

实际收益

• 新页面接入时的风格回归速度明显提升；
• 设计评审不再依赖纯人工截图对比；
• 团队对“为什么这个样式不一致”有了统一证据。

后续计划

• 增加 Figma token 导入适配；
• 对接 CI，阻止高风险样式进入主分支；
• 提供页面级 diff 视图辅助快速修复。