设计原则 / No direct component-to-global reference

No direct component-to-global reference

组件只能通过 L3/L4 契约消费 Token,不直接绑定 L1 Global Token。

关键字段

What · 是什么

定义
组件只能通过 L3/L4 契约消费 Token,不直接绑定 L1 Global Token。

Why · 为什么

核心问题
如何防止组件绕过语义层,逐渐变成不可迁移的局部实现?
作用机制
Component Slot 的绑定 Token 视图成为唯一消费入口;直接 L1 绑定记录为违规。

How · 怎么做

主要用途
保护 Global 与 Semantic 层的职责边界,使组件可以更换主题和品牌。
设计指导
Button、Input、Card 等组件的所有公共视觉属性都经过 Component Slot。

Evidence · 证据

局限与边界
极小型系统可能暂时没有 L3;此时必须明确记录迁移计划。
最后验证时间
2026-08-21
常见错误
因为某个 L1 值“看起来合适”就直接复用。

Lifecycle · 生命周期

状态
在用