用途:为重复出现的视觉决策建立共享来源,创建或扩展现有设计令牌系统。在定义新调色板或替换系统前,先检查现有令牌及其消费方。
主要能力:确立受众、平台、品牌约束与阅读/任务密度;先选角色再定值。只定义需要的表面/文本、操作/前景、边框、焦点和状态配对,并在重复出现时补充类型、间距、圆角与动效尺度。复用当前格式与命名。OKLCH 便于感知调整,但不保证对比度;字面值适合源头,一次性测量尺寸不必自动成为令牌。
使用方式:支持产品实际需要的主题,对每个主题验证真实前景/背景配对与交互状态,不要机械反转颜色。展示一个真实基础组件和一个组合屏幕如何消费这些角色,用示例发现缺失角色。对已有工作,说明新增与迁移,包括可能发生可见变化的消费方。交付物包括源路径、紧凑的角色/值表或实现、用法示例以及对比度/视觉检查。获得授权的实现任务中,更新源文件及其消费方。
检查项:对比度、焦点、放大、主题切换。示例:将操作背景与操作文本配对,将警告表面与警告文本配对;名为 primary 并不证明配对可读。检查文本放大、焦点可见性和上下文中的主题切换。避免强制深色模式、固定类型比例或为每个像素建令牌。持续漂移与迁移审查用 $system,更广泛的可见设计工作用 $craft。
限制:不用于审计现有令牌系统的漂移或迁移其消费方,那应使用 $system;向现有系统添加缺失角色仍属本技能。问题涉及布局外壳时使用 $layout。