先认识完整表面
每个当前 V2 Theme 都必须给 13 个名称完整提供 light 与 dark 值。未知名称、缺失模式、CSS var 引用、URL、import、声明语句或结构性 CSS 语法都会被发布契约拒绝。
| Token | 作用 | 检查项 |
|---|---|---|
| --dsw-alias-bg-base | 主画布 | primary 与 secondary 文字均可读 |
| --dsw-alias-bg-layer-1 | 第一层抬升表面 | 能与 base 分开，又不过度突出 |
| --dsw-alias-bg-layer-2 | 第二层抬升表面 | 嵌套层级仍然清楚 |
| --dsw-alias-bg-overlay | 覆盖层表面 | 文字在实际叠加背景上仍可读 |
| --dsw-alias-border-l1 | 主要分隔线 | 能被看见但不抢夺内容注意力 |
| --dsw-alias-border-l2 | 次级分隔线 | 保留更弱的层级关系 |
| --dsw-alias-brand-primary | 品牌与主要强调 | 与邻近文字和表面颜色协调 |
| --dsw-alias-label-primary | 主要文字 | 满足必需的前景对比度 |
| --dsw-alias-label-secondary | 次要文字 | 保持可读，又不与主要文字同权重 |
| --dsw-alias-state-error-primary | 错误状态 | 与 warning 和背景角色可区分 |
| --dsw-alias-state-success-primary | 成功状态 | 与 brand 和背景角色可区分 |
| --dsw-alias-state-warn-primary | 警告状态 | 与 error、success 角色可区分 |
| --dsw-specific-sidebar-fill | 侧栏填充 | 在两种模式中都与主画布协调 |
执行可重复的检查
- 01
选择已验证 Theme
工作台只接收包信息与兼容信息能匹配仓库内已验证 sidecar 的样本。
- 02
明确选择 light 或 dark
检查色块、预览与声明值时，始终让当前模式保持明确。
- 03
走完 13 个角色
先结合上下文理解当前值，再与另一模式中的配对值比较。
- 04
只复制可以追溯的值
复制结果只是参考资料；评审记录应同时保留 token 名、模式、来源版本与 sidecar hash。
继续使用这些值
继续学习
查看验证证据并继续操作
对比已发布制品，或返回安装文档。