设计原则 / One-way inheritance

One-way inheritance

Token 只能从更具体层指向更通用层,继承链默认遵循 L4 → L3 → L2 → L1,不形成循环。

关键字段

What · 是什么

定义
Token 只能从更具体层指向更通用层,继承链默认遵循 L4 → L3 → L2 → L1,不形成循环。

Why · 为什么

核心问题
如何让改动可预测,并能解释一个组件值最终来自哪里?
作用机制
Token Link 明确当前 Token、来源 Token、关系类型和例外理由。

How · 怎么做

主要用途
把 Token 图谱保持为有向无环图,便于审计、迁移和主题替换。
设计指导
默认只允许向下游引用;跨层直连必须标记 exception 并填写理由。

Evidence · 证据

局限与边界
Notion 不会自动阻止循环,需要通过命名规范和验收视图人工检查。
最后验证时间
2026-08-21
常见错误
把 Relation 做成无方向的“相关 Token”,失去继承语义。

Lifecycle · 生命周期

状态
在用