principle / No duplicated semantic meaning
No duplicated semantic meaning
同一设计意图只保留一个主 Semantic Role，组件和状态通过引用复用，不以不同名字复制相同含义。
Key fields
What
- Definition
- 同一设计意图只保留一个主 Semantic Role，组件和状态通过引用复用，不以不同名字复制相同含义。
Why
- Core Question
- 如何避免 Token 数量增长但系统意义越来越模糊？
- Mechanism
- 通过意图说明、Token Link 和原则 Relation 识别同义 Token；组件专属差异只放在 L3/L4。
How
- Primary Use
- 保持命名、继承和主题映射的一致性，降低维护成本。
- Design Guidance
- 建立 text.primary、surface.raised、action.primary 等受控角色，并为重复角色合并或废弃。
Evidence
- Limitations
- 同义判断需要设计评审，不能完全依赖自动化。
- Last Verified At
- 2026-08-21
- Common Mistakes
- 把 Token 数量当作系统成熟度。
Lifecycle
- Status
- 在用
Related content
Relationships come from the local knowledge graph and include reverse links.