用途:在设计系统运维中检查消费代码的令牌合规性,识别硬编码原始值、错误层级令牌引用和令牌使用不一致,产出带文件引用与修复指导的违规报告。
主要能力:检查硬编码颜色、间距、字体值;检查组件代码直接引用基础令牌而非语义令牌的错误层级引用;检查同一语义角色跨组件使用不同令牌的不一致;可结合 Style Dictionary 令牌树与 Figma 变量交叉比对,对匹配已知令牌的值给出正确令牌名;对杂乱代码库提供遗留值映射、违规年代估计与热点文件识别。
使用方式:需有代码可访问(本地检出或粘贴文件),确认评估范围、令牌体系与样式方案。可用配置 .ds-ops-config.yml 读取严重度覆盖、主题、样式、GitHub 与 Style Dictionary 集成及发布门禁。启用 GitHub 集成时应在本地检出中搜索而非依赖代码搜索 API;可用 ripgrep 命令搜索颜色值,并用令牌源文件做阳性对照。
适用场景:设计系统团队审计消费端代码的令牌使用,或作为组件发布流程的合规门禁。
限制:无代码可访问时应停止并索取;令牌源文件、生成 CSS、SVG 资产、故事与测试夹具不纳入检查;透明、currentColor、inherit、none 及 CSS 全局关键字不算违规;部分固定尺寸是否违规需人工判断;缺失的集成配置与具体收费、平台信息暂未提供。