modelgo-design-tokens 0.16.0 → 0.18.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -0
- package/TOKEN-GOVERNANCE.md +24 -0
- package/UNIFIED-UI-TOKEN.md +153 -0
- package/base.css +130 -79
- package/console.css +38 -226
- package/package.json +10 -3
- package/scripts/check-token-usage.mjs +3 -1
- package/token-layers.json +79 -0
- package/tokens.css +144 -248
- package/website.css +8 -0
package/README.md
CHANGED
|
@@ -122,6 +122,27 @@ pnpm preview:deploy # → Cloudflare Pages 项目 modelgo-design-tokens
|
|
|
122
122
|
|
|
123
123
|
值统一 ≠ 用法统一。怎么用见 [USAGE.md](./USAGE.md)(颜色/字阶/wordmark/按钮/层级的 do & don't)。
|
|
124
124
|
|
|
125
|
+
## 值冲突仲裁:两条规则别混
|
|
126
|
+
|
|
127
|
+
改 token 时有两类动作,判据不同、commit message 也不同:
|
|
128
|
+
|
|
129
|
+
| 情形 | 谁说了算 | 依据 | commit message |
|
|
130
|
+
|---|---|---|---|
|
|
131
|
+
| **主动改值**(换颜色、调尺寸) | **设计意图** | 规范图 / 走查结论 / 设计稿 | 写清设计依据 |
|
|
132
|
+
| **对账冲突**(token 说 A,页面渲染 B) | **页面的值** | 页面是用户实际看到的 | 写「对齐页面实际渲染(<页面/组件>)」 |
|
|
133
|
+
|
|
134
|
+
**为什么冲突时页面优先**:token 是声明,页面是现实。声明和现实不一致时,**改声明去对齐现实**——
|
|
135
|
+
因为「现在长这样」已经过用户、QA、市场验证;而 token 的声明可能来自过期设计稿、
|
|
136
|
+
被别的档位覆盖、或压根没生效过。
|
|
137
|
+
|
|
138
|
+
**对账动作**:① 用真实浏览器读 computed value(不是读 token 声明值,声明值可能被档位覆盖)
|
|
139
|
+
→ ② 与声明值比对 → ③ 不一致就把 token 改成 computed 值。
|
|
140
|
+
|
|
141
|
+
**别混**:把 `--mg-error` 从 `#c98b85` 改成 `#eb7067` 却写「对齐页面」是错的——
|
|
142
|
+
页面渲染的是 `#c98b85`,这是**主动改值**(设计走查),不是对账。
|
|
143
|
+
|
|
144
|
+
详见 [`TOKEN-GOVERNANCE.md`](./TOKEN-GOVERNANCE.md)「值冲突仲裁」。
|
|
145
|
+
|
|
125
146
|
## Token 分类
|
|
126
147
|
|
|
127
148
|
| 组 | 前缀 | 说明 |
|
package/TOKEN-GOVERNANCE.md
CHANGED
|
@@ -152,3 +152,27 @@ pnpm check:coverage --verbose # 列出全部未覆盖家族
|
|
|
152
152
|
> 结果是**国内官网从未被扫过**,而库里成体系的 `ease` / `duration` / `radius` / `shadow`
|
|
153
153
|
> 一条都没查 —— 补齐后存量从 22 处涨到 402 处,即原先只看得见 5.5%。
|
|
154
154
|
> 新增规则时记住:**没被规则覆盖的维度,等于默许硬编码**。
|
|
155
|
+
|
|
156
|
+
## 值冲突仲裁(2026-11-19 owner 定)
|
|
157
|
+
|
|
158
|
+
**当 token 声明的值和页面实际渲染的值冲突时,以页面的值为准。**
|
|
159
|
+
|
|
160
|
+
两种情形分开,不要混:
|
|
161
|
+
|
|
162
|
+
| 情形 | 谁说了算 | 依据 |
|
|
163
|
+
|---|---|---|
|
|
164
|
+
| **主动改值**(换颜色、调尺寸) | **设计意图** | 规范图 / 走查结论 / 设计稿。没有设计结论不许改(见上文) |
|
|
165
|
+
| **对账冲突**(token 说 A,页面渲染 B) | **页面的值** | 页面是用户实际看到的。token 可能是陈的、错的、或被别的规则覆盖 |
|
|
166
|
+
|
|
167
|
+
**为什么页面优先**:token 是声明,页面是现实。声明和现实不一致时,改声明去对齐现实 ——
|
|
168
|
+
因为「现在长这样」已经是被用户、被 QA、被市场验证过的;而 token 的声明可能来自
|
|
169
|
+
过期的设计稿、或被别的层覆盖、或压根没生效过。
|
|
170
|
+
|
|
171
|
+
**对账动作**(发现冲突时按此走):
|
|
172
|
+
1. 用真实浏览器读 computed value(不是读 token 声明值 —— 声明值可能被档位覆盖)
|
|
173
|
+
2. 与 token 声明值比对
|
|
174
|
+
3. 不一致 → **把 token 值改成 computed 出来的值**,commit message 写「对齐页面实际渲染(<页面/组件>)」
|
|
175
|
+
4. 若认为页面的值才是错的(即该按设计意图改)→ 那是**主动改值**,走设计依据流程,不要混在对账里
|
|
176
|
+
|
|
177
|
+
**反例**(别这么干):把 `--mg-error` 的值改成 `#eb7067` 却说「对齐页面」——
|
|
178
|
+
页面渲染的是 `#c98b85`,这是主动改值(设计走查),不是对账。两者 commit message 不一样。
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
# 对外 UI Token 统一规则
|
|
2
|
+
|
|
3
|
+
**一句话**:对外三条业务线(控制台 + 国内官网 + 国际官网)共用**一套 token 名**,视觉差异全部由三个正交维度承载。遇到问题照 §3 的表做,不用问人。
|
|
4
|
+
|
|
5
|
+
- 本文件管**跨端怎么统一消费**;`tokens.css` 内部怎么写(命名、主题、层级、门禁)见 [`TOKEN-GOVERNANCE.md`](./TOKEN-GOVERNANCE.md)。两个口径各有各的家,别复制内容过去。
|
|
6
|
+
- 本文件是唯一决策表。口径要改就改这里,不在别处留第二份。
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## 1. 范围
|
|
11
|
+
|
|
12
|
+
**覆盖 4 个面**(两个业务线 × 两类站点),落在 3 个仓:
|
|
13
|
+
|
|
14
|
+
| 业务线 | 控制台 | 官网 |
|
|
15
|
+
|---|---|---|
|
|
16
|
+
| **国内** | `modelgo-console-web`(`data-market='cn'`) | `modelgo-web` |
|
|
17
|
+
| **国际** | `modelgo-console-web`(`data-market='global'`) | `modelgo-global-web` |
|
|
18
|
+
|
|
19
|
+
> 控制台是**一个仓服务两个市场**(靠 `[data-market]` 切),官网是两个独立仓。
|
|
20
|
+
> 所以「改一个 UI」的影响面是 4 个,不是 2 个——**控制台的改动同样影响国内和国际**。
|
|
21
|
+
|
|
22
|
+
| 仓 | 角色 | 在范围内 |
|
|
23
|
+
|---|---|---|
|
|
24
|
+
| `modelgo-design-tokens` | 值真源(SSOT) | ✅ 本文件所在 |
|
|
25
|
+
| `modelgo-console-web` | **UI 发生地**(新视觉先在这里落地) | ✅ |
|
|
26
|
+
| `modelgo-web`(国内官网) | 消费方 | ✅ |
|
|
27
|
+
| `modelgo-global-web`(国际官网) | 消费方 | ✅ |
|
|
28
|
+
| `modelgo-doc-web` | 文档内容源,**UI 冻结不维护** | ❌ 不纳入、不管理 |
|
|
29
|
+
| `modelgo-controller-web` | 内部后台,不在对外业务线 | ❌ 不纳入 |
|
|
30
|
+
| `modelgo-icons` / `modelgo-track` | 各自领域真源 | ❌ 不归本规则 |
|
|
31
|
+
|
|
32
|
+
**两个业务线 = 国内 / 国际**,由 `[data-market='cn' | 'global']` 承载,**不拆两套 token**。
|
|
33
|
+
**三个正交维度**(一套名,三个轴):
|
|
34
|
+
|
|
35
|
+
| 轴 | 取值 | 载体 | 例子 |
|
|
36
|
+
|---|---|---|---|
|
|
37
|
+
| 主题 | `light` / `dark` | `[data-theme]` | 同一个 `--mg-bg` 在深浅下取值不同 |
|
|
38
|
+
| 市场 | `cn` / `global` | `[data-market]` | `--mg-brand-base` 国内 indigo / 海外 emerald |
|
|
39
|
+
| 层 | `base` / `console` / `website` | 分文件(`base.css` / `console.css` / `website.css`) | `--mg-hero-*` 只有官网消费 |
|
|
40
|
+
|
|
41
|
+
**不许出现的**:按市场拆成 `--mg-cn-*` / `--mg-global-*` 两套名(品牌色的历史别名除外,见 §3);
|
|
42
|
+
为某个端单独立名表达同一个概念;用消费方样式反推库值。
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## 2. 版本对齐(三端必须同版本)
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
modelgo-design-tokens 发版
|
|
50
|
+
↓
|
|
51
|
+
console-web / modelgo-web / modelgo-global-web 同步升到同版本
|
|
52
|
+
↓
|
|
53
|
+
三端 package.json 里的 version 一致 = 链路通
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
- **版本漂移就是 bug**,不是"暂时没排上"。三端跑的是同一套视觉定义,谁掉队谁就在长歪。
|
|
57
|
+
- 升依赖必须**同时删本地同名声明**(§3 第 2 行)——只升不删 = 白升,本地声明会盖住库值。
|
|
58
|
+
- 消费方装的是 **npm 版本号**,不是 git 分支。只推 `test` 分支对任何页面无效。
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## 3. 遇到问题 → 怎么改(核心决策表)
|
|
63
|
+
|
|
64
|
+
照表做,别问。拿不准的走最后一行。
|
|
65
|
+
|
|
66
|
+
| # | 遇到的情况 | 怎么改 | 验收判据 |
|
|
67
|
+
|---|---|---|---|
|
|
68
|
+
| 1 | 消费方版本落后库 | 升到库的 latest,走 §2 | 三端版本一致 |
|
|
69
|
+
| 2 | 消费方有**与库同名**的本地声明 | 删本地声明,让库接管 | 删前删后 `computed value` diff = 空 |
|
|
70
|
+
| 3 | 消费方有**库没有**的语义 token | 按 `token-layers.json` 归层下沉进库 → 发版 → 消费方升 | `check:layers` 通过,分层不反向引用 |
|
|
71
|
+
| 4 | 库与消费方**同一个名取值不同** | **以库为准**,删消费方的值。要改值得有设计依据,改库不改消费方 | 同 2 |
|
|
72
|
+
| 5 | 同一概念有**两套命名** | 只留规范名;旧名改成 `var(规范名)` 别名,注释写"兼容旧名,勿新增引用" | `check:contract` 通过 |
|
|
73
|
+
| 6 | **国内/国际**视觉不一样 | 改 `[data-market]` 下的**值**,不加新名 | 四象限(主题×市场)都看 |
|
|
74
|
+
| 7 | 深色下不对 | 值写进 `[data-theme='dark']`;主题属性挂 `<html>`,不挂子树 | `check:closure` 的级联顺序通过 |
|
|
75
|
+
| 8 | 想"顺手改个值" | **不动**。改值必须附设计依据 | — |
|
|
76
|
+
| 9 | QA 说像素对不上 | 用 **computed diff** 判。UI 改版里像素变化是预期,逐像素零变化不是验收标准 | §4 |
|
|
77
|
+
| 10 | 验 token 装没装上 | 查 `tokens.css` 里的**真名**,不信 CHANGELOG 的概括描述 | §4 |
|
|
78
|
+
| 11 | 半透明值看着不对 | 看它**垫在哪一层**合成后的像素,不看自己的 hex | `TOKEN-GOVERNANCE.md` §5 |
|
|
79
|
+
| 12 | 拿不准该不该做 | **先别做**,开单写清现象和候选方案,等设计/owner 定 | — |
|
|
80
|
+
|
|
81
|
+
### 为什么 4、8 是硬的
|
|
82
|
+
库是值真源,消费方只向库同步。允许"控制台改个值、官网再改个"就等于三套真源,正是本规则要消灭的分叉。
|
|
83
|
+
历史上 `--mg-select-bg-to` 的深色档被后面的 `:root` 压死、从未生效,就是"谁都能改值"留下的坑。
|
|
84
|
+
|
|
85
|
+
### 为什么 3 要先归层
|
|
86
|
+
`base` 不得引用 `console`/`website`,`console` 不得引用 `website`。乱放会造成反向引用,`check:layers` 会拦。
|
|
87
|
+
判层看**名字**(`token-layers.json` 的 `basePrefixes`/`websitePrefixes`/`overrides`),不看它在 `tokens.css` 里的物理位置。
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## 4. 验收:computed diff,不是逐像素
|
|
92
|
+
|
|
93
|
+
**判据只有一个**:删/改前后,四个上下文(浅/深 × 国内/国际)下 `getComputedStyle(el).getPropertyValue(name)` 的 diff。
|
|
94
|
+
|
|
95
|
+
```js
|
|
96
|
+
// 覆盖全部 token 名 × 4 上下文;diff 必须为空(或仅剩语义等价的格式差异)
|
|
97
|
+
document.documentElement.style.setProperty('--probe', `var(${name})`)
|
|
98
|
+
getComputedStyle(document.documentElement).getPropertyValue('--probe')
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
- **别拿逐像素截图当验收标准**。UI 改版本身带像素变化,逐像素比对会把改版差异判成回归。
|
|
102
|
+
- **要看像素的场景**:半透明值合成、对比度。这时用 `check:contrast` 或渲染出来看合成像素,别用截图对截图。
|
|
103
|
+
- **验包装上没有**:查部署产物 CSS 里的 token **真名**(`--mg-font-size-micro` 这类),
|
|
104
|
+
不要按 CHANGELOG 里的概括名("UI 字阶 `--mg-ui-font-size/…`")去 grep——那是描述,不是真名,查了全是 0。
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## 5. 下沉链路与时机
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
新 UI 在 console-web 落地(control 起作用)
|
|
112
|
+
↓ 视觉定稿后
|
|
113
|
+
下沉进 modelgo-design-tokens(对应层)
|
|
114
|
+
↓ check:* 全绿
|
|
115
|
+
发版(npm publish) ← 不可逆对外动作,要 owner 明确确认
|
|
116
|
+
↓
|
|
117
|
+
三端升依赖 + 删本地同名声明(§3 第 2 行)
|
|
118
|
+
↓
|
|
119
|
+
computed diff 验证 + 部署 test 交 QA
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
- **顺序不能换**:先发版再升依赖。库没发版就删本地声明 = 页面上那个值没了。
|
|
123
|
+
- **一步到位**:升依赖和删声明不留间隔。只升不删,控制台还在用自己的旧值。
|
|
124
|
+
- 白名单里的值(真冲突)**不进这条链**:控制台和库都保持原样,等设计给目标值后单独收敛。
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## 6. 门禁接入(已知缺口,要补)
|
|
129
|
+
|
|
130
|
+
库侧门禁在 `modelgo-design-tokens` 的 pre-commit 里(`check:closure` / `check:contract` / `check:contrast` / `check:usage`)。
|
|
131
|
+
|
|
132
|
+
**但 `check:usage` 扫的是消费方源码,它在消费方提交期没有自动触发点**——
|
|
133
|
+
库侧门禁全绿 ≠ 下游没有新增硬编码。要真拦住,得在三端各自的 pre-commit 里跑:
|
|
134
|
+
|
|
135
|
+
```bash
|
|
136
|
+
# 三端(console-web / modelgo-web / modelgo-global-web)提交期各跑一次
|
|
137
|
+
pnpm --dir ../modelgo-design-tokens check:usage
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
- 找不到目标时它会以退出码 2 失败(不会静默通过)。worktree 里跑要配 `MODELGO_WORKSPACE`。
|
|
141
|
+
- baseline 减少时也要收口(`-- --update-baseline`),虚高的 baseline 等于凭空发放免罚额度。
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
## 7. 相关文件
|
|
146
|
+
|
|
147
|
+
| 文件 | 管什么 |
|
|
148
|
+
|---|---|
|
|
149
|
+
| 本文件 | 跨端统一:范围、版本、问题→动作、验收、下沉链 |
|
|
150
|
+
| `TOKEN-GOVERNANCE.md` | 库内部:命名、主题、层级、半透明、门禁 |
|
|
151
|
+
| `token-layers.json` | 分层归属(base/console/website),**唯一人工输入** |
|
|
152
|
+
| `token-contract.json` / `contrast-contract.json` | 命名契约 / 对比度契约 |
|
|
153
|
+
| `CONSUMER-SINK-CONSOLE-1.0.11.md` | 本次控制台下沉的实例记录(判据与回滚) |
|
package/base.css
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/* ══════════════════════════════════════════════════════════════
|
|
2
|
-
modelgo-design-tokens · base.css (
|
|
2
|
+
modelgo-design-tokens · base.css (310 个 token)
|
|
3
3
|
原子与跨端语义:品牌色阶/灰阶/字阶/间距/圆角/阴影/动效/层级/断点/面与文字/玻璃/状态语义色。必须自闭合——不得引用 console 或 website 的 token。
|
|
4
4
|
|
|
5
5
|
⚠️ 本文件由 scripts/split-tokens.mjs 从 tokens.css 生成,**不要手改**。
|
|
@@ -28,6 +28,96 @@
|
|
|
28
28
|
|
|
29
29
|
/* ═══════════════════════ 1) PRIMITIVE 原子 ═══════════════════════ */
|
|
30
30
|
:root {
|
|
31
|
+
/* ── 玻璃染色档(rgba(255,255,255,X),跨端共用)── */
|
|
32
|
+
--mg-glass-tint-0: rgba(255, 255, 255, 0); /* 玻璃染色 0% · 自 console-web 下沉(#1970)*/
|
|
33
|
+
--mg-glass-tint-1: rgba(255, 255, 255, 0.01); /* 玻璃染色 1% · 自 console-web 下沉(#1970)*/
|
|
34
|
+
--mg-glass-tint-2: rgba(255, 255, 255, 0.02); /* 玻璃染色 2% · 自 console-web 下沉(#1970)*/
|
|
35
|
+
--mg-glass-tint-3: rgba(255, 255, 255, 0.03); /* 玻璃染色 3% · 自 console-web 下沉(#1970)*/
|
|
36
|
+
--mg-glass-tint-4: rgba(255, 255, 255, 0.04); /* 玻璃染色 4% · 自 console-web 下沉(#1970)*/
|
|
37
|
+
--mg-glass-tint-5: rgba(255, 255, 255, 0.05); /* 玻璃染色 5% · 自 console-web 下沉(#1970)*/
|
|
38
|
+
--mg-glass-tint-6: rgba(255, 255, 255, 0.06); /* 玻璃染色 6% · 自 console-web 下沉(#1970)*/
|
|
39
|
+
--mg-glass-tint-7: rgba(255, 255, 255, 0.07); /* 玻璃染色 7% · 自 console-web 下沉(#1970)*/
|
|
40
|
+
--mg-glass-tint-8: rgba(255, 255, 255, 0.08); /* 玻璃染色 8% · 自 console-web 下沉(#1970)*/
|
|
41
|
+
--mg-glass-tint-9: rgba(255, 255, 255, 0.09); /* 玻璃染色 9% · 自 console-web 下沉(#1970)*/
|
|
42
|
+
--mg-glass-tint-10: rgba(255, 255, 255, 0.1); /* 玻璃染色 10% · 自 console-web 下沉(#1970)*/
|
|
43
|
+
--mg-glass-tint-12: rgba(255, 255, 255, 0.12); /* 玻璃染色 12% · 自 console-web 下沉(#1970)*/
|
|
44
|
+
--mg-glass-tint-14: rgba(255, 255, 255, 0.14); /* 玻璃染色 14% · 自 console-web 下沉(#1970)*/
|
|
45
|
+
--mg-glass-tint-16: rgba(255, 255, 255, 0.16); /* 玻璃染色 16% · 自 console-web 下沉(#1970)*/
|
|
46
|
+
--mg-glass-tint-18: rgba(255, 255, 255, 0.18); /* 玻璃染色 18% · 自 console-web 下沉(#1970)*/
|
|
47
|
+
--mg-glass-tint-20: rgba(255, 255, 255, 0.2); /* 玻璃染色 20% · 自 console-web 下沉(#1970)*/
|
|
48
|
+
--mg-glass-tint-22: rgba(255, 255, 255, 0.22); /* 玻璃染色 22% · 自 console-web 下沉(#1970)*/
|
|
49
|
+
--mg-glass-tint-24: rgba(255, 255, 255, 0.24); /* 玻璃染色 24% · 自 console-web 下沉(#1970)*/
|
|
50
|
+
--mg-glass-tint-26: rgba(255, 255, 255, 0.26); /* 玻璃染色 26% · 自 console-web 下沉(#1970)*/
|
|
51
|
+
--mg-glass-tint-28: rgba(255, 255, 255, 0.28); /* 玻璃染色 28% · 自 console-web 下沉(#1970)*/
|
|
52
|
+
--mg-glass-tint-30: rgba(255, 255, 255, 0.3); /* 玻璃染色 30% · 自 console-web 下沉(#1970)*/
|
|
53
|
+
--mg-glass-tint-34: rgba(255, 255, 255, 0.34); /* 玻璃染色 34% · 自 console-web 下沉(#1970)*/
|
|
54
|
+
--mg-glass-tint-35: rgba(255, 255, 255, 0.35); /* 玻璃染色 35% · 自 console-web 下沉(#1970)*/
|
|
55
|
+
--mg-glass-tint-38: rgba(255, 255, 255, 0.38); /* 玻璃染色 38% · 自 console-web 下沉(#1970)*/
|
|
56
|
+
--mg-glass-tint-40: rgba(255, 255, 255, 0.4); /* 玻璃染色 40% · 自 console-web 下沉(#1970)*/
|
|
57
|
+
--mg-glass-tint-42: rgba(255, 255, 255, 0.42); /* 玻璃染色 42% · 自 console-web 下沉(#1970)*/
|
|
58
|
+
--mg-glass-tint-45: rgba(255, 255, 255, 0.45); /* 玻璃染色 45% · 自 console-web 下沉(#1970)*/
|
|
59
|
+
--mg-glass-tint-46: rgba(255, 255, 255, 0.46); /* 玻璃染色 46% · 自 console-web 下沉(#1970)*/
|
|
60
|
+
--mg-glass-tint-48: rgba(255, 255, 255, 0.48); /* 玻璃染色 48% · 自 console-web 下沉(#1970)*/
|
|
61
|
+
--mg-glass-tint-50: rgba(255, 255, 255, 0.5); /* 玻璃染色 50% · 自 console-web 下沉(#1970)*/
|
|
62
|
+
--mg-glass-tint-55: rgba(255, 255, 255, 0.55); /* 玻璃染色 55% · 自 console-web 下沉(#1970)*/
|
|
63
|
+
--mg-glass-tint-57: rgba(255, 255, 255, 0.57); /* 玻璃染色 57% · 自 console-web 下沉(#1970)*/
|
|
64
|
+
--mg-glass-tint-58: rgba(255, 255, 255, 0.58); /* 玻璃染色 58% · 自 console-web 下沉(#1970)*/
|
|
65
|
+
--mg-glass-tint-60: rgba(255, 255, 255, 0.6); /* 玻璃染色 60% · 自 console-web 下沉(#1970)*/
|
|
66
|
+
--mg-glass-tint-62: rgba(255, 255, 255, 0.62); /* 玻璃染色 62% · 自 console-web 下沉(#1970)*/
|
|
67
|
+
--mg-glass-tint-65: rgba(255, 255, 255, 0.65); /* 玻璃染色 65% · 自 console-web 下沉(#1970)*/
|
|
68
|
+
--mg-glass-tint-70: rgba(255, 255, 255, 0.7); /* 玻璃染色 70% · 自 console-web 下沉(#1970)*/
|
|
69
|
+
--mg-glass-tint-72: rgba(255, 255, 255, 0.72); /* 玻璃染色 72% · 自 console-web 下沉(#1970)*/
|
|
70
|
+
--mg-glass-tint-75: rgba(255, 255, 255, 0.75); /* 玻璃染色 75% · 自 console-web 下沉(#1970)*/
|
|
71
|
+
--mg-glass-tint-78: rgba(255, 255, 255, 0.78); /* 玻璃染色 78% · 自 console-web 下沉(#1970)*/
|
|
72
|
+
--mg-glass-tint-80: rgba(255, 255, 255, 0.8); /* 玻璃染色 80% · 自 console-web 下沉(#1970)*/
|
|
73
|
+
--mg-glass-tint-82: rgba(255, 255, 255, 0.82); /* 玻璃染色 82% · 自 console-web 下沉(#1970)*/
|
|
74
|
+
--mg-glass-tint-85: rgba(255, 255, 255, 0.85); /* 玻璃染色 85% · 自 console-web 下沉(#1970)*/
|
|
75
|
+
--mg-glass-tint-86: rgba(255, 255, 255, 0.86); /* 玻璃染色 86% · 自 console-web 下沉(#1970)*/
|
|
76
|
+
--mg-glass-tint-88: rgba(255, 255, 255, 0.88); /* 玻璃染色 88% · 自 console-web 下沉(#1970)*/
|
|
77
|
+
--mg-glass-tint-90: rgba(255, 255, 255, 0.9); /* 玻璃染色 90% · 自 console-web 下沉(#1970)*/
|
|
78
|
+
--mg-glass-tint-92: rgba(255, 255, 255, 0.92); /* 玻璃染色 92% · 自 console-web 下沉(#1970)*/
|
|
79
|
+
--mg-glass-tint-95: rgba(255, 255, 255, 0.95); /* 玻璃染色 95% · 自 console-web 下沉(#1970)*/
|
|
80
|
+
--mg-glass-tint-100: rgba(255, 255, 255, 1); /* 玻璃染色 100% · 自 console-web 下沉(#1970)*/
|
|
81
|
+
|
|
82
|
+
/* ── 中性透明染色档 · 自 console-web 下沉(#1970 核心全局批次)── */
|
|
83
|
+
/* 纯中性原子(四档恒定,跨端共用) */
|
|
84
|
+
--mg-white: #ffffff;
|
|
85
|
+
--mg-black: #000000;
|
|
86
|
+
/* 白色玻璃染色补齐档(1:1 保值,不收敛) */
|
|
87
|
+
--mg-glass-tint-11: rgba(255, 255, 255, 0.11);
|
|
88
|
+
--mg-glass-tint-15: rgba(255, 255, 255, 0.15);
|
|
89
|
+
--mg-glass-tint-25: rgba(255, 255, 255, 0.25);
|
|
90
|
+
--mg-glass-tint-56: rgba(255, 255, 255, 0.56);
|
|
91
|
+
--mg-glass-tint-59: rgba(255, 255, 255, 0.59);
|
|
92
|
+
--mg-glass-tint-68: rgba(255, 255, 255, 0.68);
|
|
93
|
+
--mg-glass-tint-96: rgba(255, 255, 255, 0.96);
|
|
94
|
+
--mg-glass-tint-98: rgba(255, 255, 255, 0.98);
|
|
95
|
+
/* 黑色遮罩染色档(与 glass-tint 对称,1:1 保值) */
|
|
96
|
+
--mg-scrim-tint-0: rgba(0, 0, 0, 0);
|
|
97
|
+
--mg-scrim-tint-1: rgba(0, 0, 0, 0.01);
|
|
98
|
+
--mg-scrim-tint-6: rgba(0, 0, 0, 0.06);
|
|
99
|
+
--mg-scrim-tint-8: rgba(0, 0, 0, 0.08);
|
|
100
|
+
--mg-scrim-tint-11: rgba(0, 0, 0, 0.11);
|
|
101
|
+
--mg-scrim-tint-12: rgba(0, 0, 0, 0.12);
|
|
102
|
+
--mg-scrim-tint-14: rgba(0, 0, 0, 0.14);
|
|
103
|
+
--mg-scrim-tint-15: rgba(0, 0, 0, 0.15);
|
|
104
|
+
--mg-scrim-tint-25: rgba(0, 0, 0, 0.25);
|
|
105
|
+
--mg-scrim-tint-30: rgba(0, 0, 0, 0.3);
|
|
106
|
+
--mg-scrim-tint-35: rgba(0, 0, 0, 0.35);
|
|
107
|
+
--mg-scrim-tint-40: rgba(0, 0, 0, 0.4);
|
|
108
|
+
--mg-scrim-tint-45: rgba(0, 0, 0, 0.45);
|
|
109
|
+
--mg-scrim-tint-50: rgba(0, 0, 0, 0.5);
|
|
110
|
+
--mg-scrim-tint-55: rgba(0, 0, 0, 0.55);
|
|
111
|
+
--mg-scrim-tint-60: rgba(0, 0, 0, 0.6);
|
|
112
|
+
--mg-scrim-tint-70: rgba(0, 0, 0, 0.7);
|
|
113
|
+
--mg-scrim-tint-75: rgba(0, 0, 0, 0.75);
|
|
114
|
+
--mg-scrim-tint-80: rgba(0, 0, 0, 0.8);
|
|
115
|
+
--mg-scrim-tint-84: rgba(0, 0, 0, 0.84);
|
|
116
|
+
--mg-scrim-tint-85: rgba(0, 0, 0, 0.85);
|
|
117
|
+
--mg-scrim-tint-90: rgba(0, 0, 0, 0.9);
|
|
118
|
+
--mg-scrim-tint-92: rgba(0, 0, 0, 0.92);
|
|
119
|
+
--mg-scrim-tint-95: rgba(0, 0, 0, 0.95);
|
|
120
|
+
|
|
31
121
|
/* ── 双品牌色阶:两套都常驻,可按需分别引用某一市场 ──
|
|
32
122
|
国内 indigo(cn)/ 海外 emerald(global)。--mg-brand-* = 当前市场(随 [data-market] 切)。 */
|
|
33
123
|
--mg-brand-cn-deep: #0622c9;
|
|
@@ -109,15 +199,11 @@
|
|
|
109
199
|
--mg-font-sans: 'Inter', 'PingFang SC', 'MiSans', 'HarmonyOS Sans SC', 'Microsoft YaHei', system-ui, sans-serif;
|
|
110
200
|
--mg-font-heading: 'Inter', 'PingFang SC', 'MiSans', 'HarmonyOS Sans SC', 'Microsoft YaHei', system-ui, sans-serif;
|
|
111
201
|
--mg-font-mono: 'JetBrains Mono', 'Fira Code', 'Consolas', monospace;
|
|
112
|
-
--mg-font-brand-latin: 'ModelGo Latin A';
|
|
113
|
-
--mg-font-brand-cjk: 'ModelGo Chinese A';
|
|
114
202
|
|
|
115
203
|
/* ── 字重 ── */
|
|
116
|
-
--mg-weight-normal: 400;
|
|
117
204
|
--mg-weight-medium: 500;
|
|
118
205
|
--mg-weight-semibold: 600;
|
|
119
206
|
--mg-weight-bold: 700;
|
|
120
|
-
--mg-weight-black: 900; /* 基线 wordmark/标题用 900 */
|
|
121
207
|
|
|
122
208
|
/* ── 字阶(基线 --font-size-modelgo-* / line / tracking 原样) ── */
|
|
123
209
|
--mg-text-hero: clamp(48px, 7vw, 96px);
|
|
@@ -135,6 +221,7 @@
|
|
|
135
221
|
--mg-text-body: 16px;
|
|
136
222
|
--mg-text-body-line: 1.6;
|
|
137
223
|
--mg-text-sm: 14px;
|
|
224
|
+
--mg-text-caption-line: var(--mg-text-xs-line); /* support-kit 在用,勿删 */
|
|
138
225
|
--mg-text-sm-line: 1.6;
|
|
139
226
|
--mg-text-xs: 12px;
|
|
140
227
|
--mg-text-xs-line: 1.5;
|
|
@@ -174,26 +261,16 @@
|
|
|
174
261
|
|
|
175
262
|
/* 抗锯齿:macOS 上 antialiased 明显更细、auto(次像素)更实。
|
|
176
263
|
产品端一律 auto —— 消费方都没设,规范如实沿用,别在预览里偷偷加 antialiased。 */
|
|
177
|
-
--mg-font-smoothing: auto;
|
|
178
264
|
|
|
179
265
|
/* 数字:等宽数位。价格/用量/账单这类会跳动或需要竖排对齐的数字必须用,
|
|
180
266
|
否则 1 比其他数字窄,列表滚动时数字会左右抖。 */
|
|
181
|
-
--mg-numeric-tabular: tabular-nums;
|
|
182
|
-
--mg-numeric-proportional: proportional-nums;
|
|
183
267
|
|
|
184
268
|
/* 中英混排:CJK 与西文之间的自动间隙。CJK 正文开启可读性更好,
|
|
185
269
|
但会影响精确对齐的场景(表格数字列),故给出两档由消费方选。 */
|
|
186
|
-
--mg-text-autospace-on: normal;
|
|
187
|
-
--mg-text-autospace-off: no-autospace;
|
|
188
270
|
|
|
189
271
|
/* 字距补充档(原来只有 h1/h2/h3/xs 有,body/sm 缺,导致消费方各写各的) */
|
|
190
|
-
--mg-text-body-tracking: normal;
|
|
191
|
-
--mg-text-sm-tracking: normal;
|
|
192
272
|
|
|
193
273
|
/* 断行:中文不该按西文规则断词;长 API ID / 模型名需要能断 */
|
|
194
|
-
--mg-word-break-cjk: normal;
|
|
195
|
-
--mg-word-break-id: break-all;
|
|
196
|
-
--mg-line-break-cjk: strict;
|
|
197
274
|
|
|
198
275
|
/* ── 圆角(基线:card20 / code16 / tag8 / btn999 + 通用 8/14/18) ── */
|
|
199
276
|
--mg-radius-xs: 6px; /* 控制台 segmented/小控件内层圆角(sm 内缩一档) */
|
|
@@ -280,32 +357,10 @@
|
|
|
280
357
|
/* ── 焦点环 ── */
|
|
281
358
|
--mg-focus-ring: 0 0 0 3px color-mix(in oklab, var(--mg-brand-base) 35%, transparent);
|
|
282
359
|
|
|
283
|
-
/* ── 产品市场 UX:官网内容卡 + 高密度信息 tile + 工具栏 + 图片 Banner ──
|
|
284
|
-
设计依据:2026-08 国内官网改版与控制台模型广场。官网保留舒展的 card,
|
|
285
|
-
模型列表/筛选等高频信息区使用更紧凑的 tile;二者不混用。
|
|
286
|
-
|
|
287
|
-
⚠️ 2026-08-24 更正上面这条依据的一半:「国内官网改版」这个依据已经失效。
|
|
288
|
-
国内官网的模型广场已并入控制台(modelgo-web 的 /models 只做 301 到
|
|
289
|
-
console.modelgo.com/models),官网侧不再有模型列表/筛选这类高密度场景;
|
|
290
|
-
且官网锁 ^0.6.2,本段是 0.6.2 之后进包的,它技术上也拿不到。
|
|
291
|
-
实测四端对本段的消费:console-web 21 个,国内官网 / 海外官网 / 文档站 0 个
|
|
292
|
-
——两个官网消费的是基础层(品牌色/字阶/圆角/间距),这是分工而非缺口,
|
|
293
|
-
正是上面「二者不混用」那句话的结果。
|
|
294
|
-
所以本段的现实消费方只有控制台。按治理文档 §3,零引用不构成删除理由,
|
|
295
|
-
token 保留;但后续改本段的值,设计依据要以控制台为对象,别再写官网。 */
|
|
296
|
-
--mg-text-market-title: 34px;
|
|
297
|
-
--mg-text-market-title-line: 1.5;
|
|
298
|
-
/* -0.025em = Tailwind tracking-tight,控制台模型广场 h1 实际在用的值
|
|
299
|
-
(catalog/index.tsx:318)。原为 -0.01em,与消费方不符且本 token 除预览页
|
|
300
|
-
无其他消费方,故对齐到实际值。 */
|
|
301
|
-
--mg-text-market-title-tracking: -0.025em;
|
|
302
|
-
|
|
303
360
|
/* ── 图标(库已统一:UI=Lucide,品牌/厂商=@lobehub/icons;这里统一尺寸与线宽) ── */
|
|
304
361
|
--mg-icon-xs: 14px;
|
|
305
362
|
--mg-icon-sm: 16px;
|
|
306
363
|
--mg-icon-md: 20px;
|
|
307
|
-
--mg-icon-lg: 24px;
|
|
308
|
-
--mg-icon-stroke: 2; /* Lucide 默认描边宽 */
|
|
309
364
|
}
|
|
310
365
|
|
|
311
366
|
/* ═══════════════════════ 2) SEMANTIC 语义(引用原子,浅色默认) ═══════════════════════ */
|
|
@@ -398,19 +453,14 @@
|
|
|
398
453
|
|
|
399
454
|
--mg-info-text: #1e40af; /* blue-800 · 7.09(900 档 8.42 深过头;800 恰好够,用调色板整档) */
|
|
400
455
|
--mg-info-bg: color-mix(in oklab, var(--mg-info) 9%, transparent);
|
|
401
|
-
--mg-info-bg-hover: color-mix(in oklab, var(--mg-info) 15%, transparent);
|
|
402
456
|
--mg-info-border: color-mix(in oklab, var(--mg-info) 26%, transparent);
|
|
403
457
|
|
|
404
458
|
/* danger 是 error 的语义别名(破坏性操作),与 --mg-danger 同源 */
|
|
405
459
|
--mg-danger-text: var(--mg-error-text);
|
|
406
460
|
--mg-danger-bg: var(--mg-error-bg);
|
|
407
|
-
--mg-danger-bg-hover: var(--mg-error-bg-hover);
|
|
408
461
|
--mg-danger-border: var(--mg-error-border);
|
|
409
462
|
|
|
410
463
|
/* ── 悬浮阴影三档(卡片/面板 hover 抬起)── */
|
|
411
|
-
--mg-shadow-hover-sm: 0 4px 12px -6px rgba(16, 24, 40, 0.14);
|
|
412
|
-
--mg-shadow-hover-md: 0 10px 28px -12px rgba(16, 24, 40, 0.20), 0 0 0 1px color-mix(in oklab, var(--mg-brand-base) 10%, transparent);
|
|
413
|
-
--mg-shadow-hover-lg: 0 18px 48px -18px rgba(16, 24, 40, 0.24), 0 0 0 1px color-mix(in oklab, var(--mg-brand-base) 12%, transparent);
|
|
414
464
|
|
|
415
465
|
/* ══════════════════════════════════════════════════════════════
|
|
416
466
|
玻璃系统(GLASS)—— 四端通用,页面只引 token / 工具类,不写死色值。
|
|
@@ -569,40 +619,56 @@
|
|
|
569
619
|
--mg-shadow-card: var(--mg-shadow-sm);
|
|
570
620
|
--mg-shadow-card-hover: var(--mg-shadow-md);
|
|
571
621
|
--mg-shadow-elevated: var(--mg-shadow-md);
|
|
572
|
-
/* 悬浮阴影深色档(下沉自 console-web/src/styles/tokens.css:584-586) */
|
|
573
|
-
--mg-shadow-hover-sm: 0 6px 16px rgba(0, 0, 0, 0.32), 0 0 0 1px rgba(255, 255, 255, 0.04);
|
|
574
|
-
--mg-shadow-hover-md: 0 12px 30px rgba(0, 0, 0, 0.38), 0 0 0 1px rgba(255, 255, 255, 0.05);
|
|
575
|
-
--mg-shadow-hover-lg: 0 20px 52px rgba(0, 0, 0, 0.46), 0 0 0 1px rgba(255, 255, 255, 0.06);
|
|
576
|
-
}
|
|
577
|
-
|
|
578
|
-
/* ──────────────────────────────────────────────────────────────
|
|
579
|
-
* 断点(CSS 变量不能进 @media,作为契约清单 + JS/容器查询消费)
|
|
580
|
-
* sm 640 · md 768 · lg 1024 · xl 1280 · 2xl 1536
|
|
581
|
-
* ────────────────────────────────────────────────────────────── */
|
|
582
|
-
:root {
|
|
583
|
-
--mg-bp-sm: 640px;
|
|
584
|
-
--mg-bp-md: 768px;
|
|
585
|
-
--mg-bp-lg: 1024px;
|
|
586
|
-
--mg-bp-xl: 1280px;
|
|
587
|
-
--mg-bp-2xl: 1536px;
|
|
588
622
|
}
|
|
589
623
|
|
|
590
624
|
/* 深色 × 海外绿:前面三档已覆盖 浅蓝 / 浅绿 / 深蓝,这里补 深绿。
|
|
591
625
|
薄膜与颗粒沿用深色档,只换画布与描边色相。 */
|
|
626
|
+
/* ── 国际黑 · 2026-11-17 设计走查收编 ────────────────────────────────────
|
|
627
|
+
依据:docs/console-ui-spec/国际黑/Projects/基础/色彩/(色彩规范图,11 组 × 10 级)
|
|
628
|
+
与其「修改日志」2026-11-17 各条。控制台代码已按新值改(当时未提交),
|
|
629
|
+
本批把设计值正式下沉进库,让库重新成为唯一真源。
|
|
630
|
+
|
|
631
|
+
口径:**只覆盖国际黑**([data-theme='dark'][data-market='global']),
|
|
632
|
+
国内黑 / 国内白继续用本包的既有档(设计走查明确「国内未动」)。
|
|
633
|
+
改值依据是设计走查,不是实现对齐 —— 见 UNIFIED-UI-TOKEN.md §3 第 8 行。
|
|
634
|
+
|
|
635
|
+
状态色整行提高饱和度(明度、色相不变或微调):原色组偏灰,在暗底上辨识度不够。
|
|
636
|
+
中性色去掉一档(原中性3 #18181C 并入中性2),页面底随之提亮到 #131316。 */
|
|
592
637
|
[data-theme='dark'][data-market='global'],
|
|
593
638
|
[data-theme='dark'] [data-market='global'] {
|
|
639
|
+
/* 中性:页面底 / 卡片实色 / 浮层(原 #18181c / #3b3b44 并档) */
|
|
640
|
+
--mg-bg: #131316;
|
|
641
|
+
--mg-bg-0-solid: #232329;
|
|
642
|
+
--mg-bg-2: #2e2e36;
|
|
643
|
+
--mg-bg-3: #2e2e36;
|
|
644
|
+
|
|
645
|
+
/* 品牌绿家族:明度按 OKLCH 均匀递增 .25→.96,色相统一约 155°,浅端略偏薄荷。
|
|
646
|
+
正色 #0F9F59 不变;原深端发灰、浅端色相不一致。 */
|
|
647
|
+
--mg-brand-pale: #092917;
|
|
648
|
+
--mg-brand-deep: #0e5f36;
|
|
649
|
+
--mg-brand-mid: #7fe5aa;
|
|
650
|
+
--mg-brand-light: #d3fee5;
|
|
651
|
+
|
|
652
|
+
/* 蓝:整行重排(色相统一约 255°,原品牌蓝 #385AFF 偏紫 268° 且饱和度突跳) */
|
|
653
|
+
--mg-brand-blue: #2273d2;
|
|
654
|
+
--mg-error: #eb7067; /* 错误7 */
|
|
655
|
+
--mg-error-text: #f59b92; /* 错误8,对比 9.2(AAA) */
|
|
656
|
+
--mg-warning: #d7a658; /* 警示7 */
|
|
657
|
+
--mg-warning-text: #e8c082; /* 警示8 */
|
|
658
|
+
--mg-success: #67ba8c; /* 成功7 */
|
|
659
|
+
--mg-success-text: #90d1aa; /* 成功8 */
|
|
660
|
+
--mg-info: #6a9ef6; /* 信息7 */
|
|
661
|
+
--mg-info-text: #96bcfb; /* 信息8 */
|
|
662
|
+
|
|
594
663
|
--mg-glass-canvas: linear-gradient(180deg, #16241f 0%, #111614 100%);
|
|
595
664
|
--mg-glass-line: rgba(255, 255, 255, 0.10);
|
|
665
|
+
--mg-text-weak: #8e8e99; /* neutral.7 · 弱文字 / 说明 */}
|
|
596
666
|
}
|
|
597
667
|
|
|
598
668
|
/* ── 交互状态(State) ── */
|
|
599
669
|
:root {
|
|
600
670
|
--mg-state-hover-bg: var(--mg-fill-0);
|
|
601
|
-
--mg-state-hover-border: var(--mg-border-hover);
|
|
602
|
-
--mg-state-pressed-bg: var(--mg-fill-1);
|
|
603
671
|
--mg-state-pressed-scale: 0.98;
|
|
604
|
-
--mg-state-disabled-opacity: 0.5;
|
|
605
|
-
--mg-state-disabled-bg: var(--mg-fill-0);
|
|
606
672
|
--mg-state-selected-bg: var(--mg-brand-selected-bg);
|
|
607
673
|
--mg-state-selected-border: color-mix(in oklab, var(--mg-brand-base) 35%, var(--mg-border));
|
|
608
674
|
}
|
|
@@ -613,26 +679,13 @@
|
|
|
613
679
|
/* ── 动效(Motion) ── */
|
|
614
680
|
:root {
|
|
615
681
|
--mg-motion-press: var(--mg-duration-instant) var(--mg-ease-standard);
|
|
616
|
-
--mg-motion-enter-y: 8px;
|
|
617
|
-
--mg-motion-enter-scale: 0.98;
|
|
618
|
-
--mg-motion-exit-y: 4px;
|
|
619
|
-
--mg-motion-exit-scale: 0.99;
|
|
620
|
-
--mg-motion-stagger-gap: 45ms;
|
|
621
|
-
--mg-motion-skeleton-duration: 1.4s;
|
|
622
|
-
--mg-motion-attention-duration: 0.6s;
|
|
623
|
-
--mg-motion-reduced-duration: 0.01ms;
|
|
624
682
|
}
|
|
625
683
|
|
|
626
684
|
/* ── 排版补充(控制台特有字阶) ── */
|
|
627
685
|
:root {
|
|
628
686
|
--mg-text-2xs: 10px;
|
|
629
687
|
--mg-text-2xs-line: 1.4;
|
|
630
|
-
--mg-text-micro: 11px;
|
|
631
|
-
--mg-text-micro-line: 1.45;
|
|
632
688
|
--mg-text-caption: var(--mg-text-xs);
|
|
633
|
-
--mg-text-caption-line: var(--mg-text-xs-line);
|
|
634
|
-
--mg-text-ui: var(--mg-text-sm);
|
|
635
|
-
--mg-text-ui-line: 1.55;
|
|
636
689
|
--mg-letter-spacing-label: 0.04em;
|
|
637
690
|
}
|
|
638
691
|
|
|
@@ -670,13 +723,11 @@
|
|
|
670
723
|
/* ── 空态 / 骨架屏 / 悬浮位移 / 表格行态 / 收藏 ── */
|
|
671
724
|
:root {
|
|
672
725
|
|
|
726
|
+
/* 与已有的 --mg-skeleton-h-md: 2rem 同族,统一用 rem(24px / 48px 等价换算) */
|
|
727
|
+
|
|
673
728
|
/* 卡片/行 hover 抬起位移,配合 --mg-shadow-hover-* 使用 */
|
|
674
|
-
--mg-hover-y-sm: -1px;
|
|
675
|
-
--mg-hover-y-md: -2px;
|
|
676
|
-
--mg-hover-y-lg: -3px;
|
|
677
729
|
|
|
678
730
|
--mg-motion-hover: var(--mg-duration-fast) var(--mg-ease-standard);
|
|
679
|
-
--mg-motion-panel: var(--mg-duration-base) var(--mg-ease-emphasized);
|
|
680
731
|
|
|
681
732
|
--mg-favorite: var(--mg-error);
|
|
682
733
|
}
|