用途:为尚无设计系统的项目一次性搭建最小设计令牌体系,或对已有体系的令牌漂移进行可量化的检测。它负责创建令牌系统、词汇表与漂移检测;令牌如何应用到界面属于 ui-polish,动效令牌属于 motion,状态覆盖属于 ux-check。
主要能力:仅设两级令牌——原始值(色阶)与语义别名(界面所用)。组件只引用语义令牌,如 var(--border),而非 var(--gray-300);由比例推导的几何值(如 calc(var(--radius-lg) - var(--space-2)))属于同心圆角规则,不算原始值泄漏。默认含暗色模式:别名翻转,原始值不变。颜色使用 OKLCH,一个强调色加 10 级中性色阶(同一色相),至少一个状态色。词汇遵循 shadcn/ui 语义命名(--background、--foreground、--card、--primary、--border、--ring、--destructive 等)。间距采用 base-4 或 Tailwind 默认刻度;圆角一个基准派生 sm/md/lg;字体最多两族、5-7 个字号;阴影 2-3 级;z-index 使用命名层级。输出为 :root 上的 CSS 自定义属性加暗色块,检测到 Tailwind 时附 v4 @theme 块,仅在明确要求时输出 DTCG JSON。
使用方式:先检测技术栈并扩展现有体系,Tailwind 项目中令牌是其主题的精选子集;存在 shadcn/ui 时沿用其变量名。创建或扩展后,将语义变量名(只写名称不写值)写入项目旁 icons8.json 的 tokens 字段。随后运行漂移 grep:原始颜色值、中性色去重数、偏离刻度的间距、Tailwind 任意值、基础圆角不同值数、原始 z-index、并行调色板等,报告数量与 file:line 定位。可运行模式下还需截图明暗模式并实时切换主题检查。
限制:项目已有成熟令牌管线(Style Dictionary、zeroheight、Supernova 或已发布设计系统)时只做审计、不得替换。无法渲染页面时可仅读源码审查,并标注未验证项。漂移数量是测量结果而非发布门禁,仅在本轮新建系统且仍残留原始颜色时才判定为 Block。建议服务端 Icons8 MCP 检查仍在路线图中,目前以 grep 为检查手段。价格与具体平台支持暂未提供。