modelgo-design-tokens 0.13.0 → 0.15.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/CHANGELOG.md +8 -0
- package/README.md +15 -6
- package/TOKEN-GOVERNANCE.md +10 -2
- package/USAGE.md +4 -4
- package/base.css +71 -3
- package/console.css +120 -2
- package/package.json +1 -1
- package/scripts/check-token-usage.mjs +37 -3
- package/tokens.css +183 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
## Unreleased
|
|
4
4
|
|
|
5
|
+
### Added
|
|
6
|
+
|
|
7
|
+
- **新增 `--mg-decor-star-*` 星点装饰 token(7 个,base 层,qa#688)**:
|
|
8
|
+
`opacity/rotate/scale/x/y/x2/y2`。此前 console-web `public-shell.css` 与官网 hero
|
|
9
|
+
各自维护一份字面值(逐项相同),下沉为唯一定义点;值原样搬运,视觉零变化。
|
|
10
|
+
消费方把本地字面值改为 `var(--mg-decor-star-*)` 引用,逐星实例的
|
|
11
|
+
inline style 覆盖机制不受影响。
|
|
12
|
+
|
|
5
13
|
### Fixed
|
|
6
14
|
|
|
7
15
|
- **`check:usage` 的 baseline key 在 worktree 里会带上 worktree 名,导致 baseline 整体失配**
|
package/README.md
CHANGED
|
@@ -1,15 +1,23 @@
|
|
|
1
1
|
# modelgo-design-tokens
|
|
2
2
|
|
|
3
|
-
ModelGo
|
|
4
|
-
纯 CSS
|
|
3
|
+
ModelGo 前端(控制台 / 内部后台 / 国内官网 / 国外官网)统一设计 token 的**单一真源**。
|
|
4
|
+
纯 CSS 变量,框架无关;本仓主要维护 **React·Vite**(控制台 / 内部后台)与 **Astro**(国内 + 国外官网)两种技术栈。
|
|
5
|
+
文档站(VitePress,`modelgo-doc-web`)**已冻结**,停在本库 0.6.x,不跟进升级——文档 UI 以官网为准,改它不在本仓范围内。
|
|
5
6
|
|
|
6
7
|
> 🎨 **在线看全部 token**:<https://modelgo-design-tokens.pages.dev>
|
|
7
8
|
> 147 个变量分组可视化、国内/海外 × 浅色/深色舒适/深色酷炫实时预览、顶栏标注当前版本号。
|
|
8
9
|
> 本地要**改值并写回**真源用 `pnpm preview`,见 [可视化查看 / 改值](#可视化查看--改值)。
|
|
9
10
|
|
|
11
|
+
> 📌 **V1.0.11 = 预览UI(Preview UI)版本。**
|
|
12
|
+
> 产品原型(`modelgo_prd`)与控制台本轮视觉对齐的基准是 1.0.11 的预览UI,不是线上。
|
|
13
|
+
> 这一版与线上差在哪、按主题/页面逐块对照(含 Figma 节点),见
|
|
14
|
+
> **[PREVIEW-UI-1.0.11.md](./PREVIEW-UI-1.0.11.md)** ——写给 UI 走查用的。
|
|
15
|
+
> 不想看 markdown 的话,同一份内容已发成网页:**<https://modelgo-design-tokens.pages.dev/preview-ui-1.0.11>**
|
|
16
|
+
> (也可从线上站顶栏的「🆕 1.0.11 预览UI 差异」进去)。
|
|
17
|
+
|
|
10
18
|
## 为什么是 token 而不是组件
|
|
11
19
|
|
|
12
|
-
|
|
20
|
+
两端技术栈不同(React·Vite / Astro),跨框架共享「组件」几乎不可能;
|
|
13
21
|
能真正统一的是 **CSS 变量层**。各端组件自己实现,但都消费同一套 `--mg-*`,风格自然一致。
|
|
14
22
|
|
|
15
23
|
## 安装
|
|
@@ -98,7 +106,8 @@ pnpm preview # → http://127.0.0.1:5177
|
|
|
98
106
|
pnpm preview:deploy # → Cloudflare Pages 项目 modelgo-design-tokens,生产分支 main
|
|
99
107
|
```
|
|
100
108
|
|
|
101
|
-
发上去的是 `index.html` +
|
|
109
|
+
发上去的是 `index.html` + `preview-ui-1.0.11.html`(1.0.11 预览UI 差异页,顶栏有入口)
|
|
110
|
+
+ 当次的 `tokens.css` + 精简 `package.json`(只留 name/version/description)。
|
|
102
111
|
线上默认读同源那份 `tokens.css`,与发布时的仓库状态严格一致;顶栏也能切到「线上发布版」
|
|
103
112
|
从 unpkg 拉当前 npm 上的最新版对照 —— 用来确认「已发布的包」和「仓库里的真源」有没有脱节。
|
|
104
113
|
|
|
@@ -131,7 +140,7 @@ pnpm preview:deploy # → Cloudflare Pages 项目 modelgo-design-tokens
|
|
|
131
140
|
|
|
132
141
|
1. 发布本包到 npm(公共)。
|
|
133
142
|
2. 选一端先接(建议国内官网),把本地变量改成引用 `--mg-*`,跑通构建+部署。
|
|
134
|
-
3.
|
|
143
|
+
3. 验证无误后,其余各端逐个接入,删掉各自重复的 token 定义。
|
|
135
144
|
|
|
136
145
|
> `tokens.css` 里的具体数值是「对账两端现状后的起步建议」,可按设计意图调整;
|
|
137
|
-
> 价值在于**统一命名 +
|
|
146
|
+
> 价值在于**统一命名 + 单一来源**,改视觉只改这一个文件、各端同步。
|
package/TOKEN-GOVERNANCE.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Token 工程契约
|
|
2
2
|
|
|
3
|
-
`tokens.css`
|
|
3
|
+
`tokens.css` 是各端的值真源;本文件约束命名、主题选择器、派生指向与层级透明度,防止真源本身再次分叉。
|
|
4
4
|
本包**框架无关**:只出 CSS 自定义属性,不提供任何框架适配层(Tailwind `@theme` 入口已于 0.10.0 移除,理由见 CHANGELOG)。
|
|
5
5
|
|
|
6
6
|
## 1. 命名与兼容
|
|
@@ -12,10 +12,18 @@
|
|
|
12
12
|
|
|
13
13
|
## 2. 深色主题真源
|
|
14
14
|
|
|
15
|
-
- `data-theme="dark"`
|
|
15
|
+
- `data-theme="dark"` 是唯一正式深色主题,用于控制台、内部后台和两端官网。
|
|
16
16
|
- `data-theme="dark-showcase"` 已由 qa#611 定案废弃,0.10.0 从发版产物移除。新增深色档一律写进 `[data-theme='dark']`,不得再引入第二套深色选择器。
|
|
17
17
|
- 深色填色不是一刀切降饱和:语义色去饱和,品牌色与分类色提亮保饱和。新增深色值按这条分类,别把品牌色按莫兰迪规律算。
|
|
18
18
|
- 不得用消费方现有样式反推或覆盖本仓的设计值。改值必须附设计依据;消费方只向本仓同步。
|
|
19
|
+
- **主题属性必须挂在 `<html>` 上,不支持挂在某个子树(`<div data-theme>` 做「局部深色」)。**
|
|
20
|
+
原因不是偏好而是 CSS 语义:`var()` 在**声明所在元素**上完成替换,`--mg-bg-2: var(--mg-surface-2)`
|
|
21
|
+
这类别名只声明在 `:root`,于是它在根元素就替换成浅色值,再作为已算好的值继承进子树;
|
|
22
|
+
子树里的 `data-theme` 改了 `--mg-surface-2` 也**不会回流进别名**。实测现象是深色子树里
|
|
23
|
+
浮层底停在 `#f8fafc`(白)。要局部深色只能在子树里重写**值本身**,不能靠继承别名。
|
|
24
|
+
四端目前都在 `<html>` 上挂主题(console `applyTheme()` / global-web `brand-provider`
|
|
25
|
+
与 `BaseLayout`),所以不受影响;但四象限核对页必须**一文档一上下文**(iframe),
|
|
26
|
+
同页嵌四个 `<div data-theme>` 得出来的结论是假的。
|
|
19
27
|
|
|
20
28
|
## 3. 下沉但未消费的 token
|
|
21
29
|
|
package/USAGE.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# ModelGo Token 用法规范
|
|
2
2
|
|
|
3
|
-
token 解决"值统一",这页解决"用法统一"
|
|
3
|
+
token 解决"值统一",这页解决"用法统一"——各端照同一套规则用,才不会再飘。
|
|
4
4
|
|
|
5
5
|
## 引哪一份(0.11.0 起)
|
|
6
6
|
|
|
@@ -109,7 +109,7 @@ token 解决"值统一",这页解决"用法统一"——四端照同一套规则
|
|
|
109
109
|
```
|
|
110
110
|
- 字体族:正文 `--mg-font-sans`、标题 `--mg-font-heading`、等宽 `--mg-font-mono`、品牌字 `--mg-font-brand-latin / -cjk`。
|
|
111
111
|
|
|
112
|
-
## 品牌 wordmark
|
|
112
|
+
## 品牌 wordmark(强约束,各端一致)
|
|
113
113
|
|
|
114
114
|
- 结构永远是**主体实色 + 末段品牌渐变**:
|
|
115
115
|
- 海外:`Model`(实色) + `Go`(渐变)
|
|
@@ -174,10 +174,10 @@ token 解决"值统一",这页解决"用法统一"——四端照同一套规则
|
|
|
174
174
|
## 图标
|
|
175
175
|
|
|
176
176
|
- **UI 图标统一 Lucide**:官网用 `lucide-react`,控制台目前走 `react-icons/lu`(同一套 Lucide 字形)——新代码统一到 `lucide-react`,老代码可暂留。
|
|
177
|
-
- **品牌/厂商图标统一 `@lobehub/icons`**(OpenAI / Claude / DeepSeek…
|
|
177
|
+
- **品牌/厂商图标统一 `@lobehub/icons`**(OpenAI / Claude / DeepSeek… 各端已同版本,勿另找别的源)。
|
|
178
178
|
- **尺寸只取档**:`--mg-icon-xs(14) / -sm(16) / -md(20) / -lg(24)`,别随手写 `size={13}`、`size={15}`。
|
|
179
179
|
- **线宽** `--mg-icon-stroke`(Lucide 默认 2),保持一致,别一处 1.5 一处 2.5。
|
|
180
|
-
- 文档站(VitePress
|
|
180
|
+
- 文档站(VitePress)已冻结(停在本库 0.6.x),不接入本库图标规范;改它不在本仓范围内。
|
|
181
181
|
|
|
182
182
|
## 层级 / 焦点 / 动效
|
|
183
183
|
|
package/base.css
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/* ══════════════════════════════════════════════════════════════
|
|
2
|
-
modelgo-design-tokens · base.css (
|
|
2
|
+
modelgo-design-tokens · base.css (275 个 token)
|
|
3
3
|
原子与跨端语义:品牌色阶/灰阶/字阶/间距/圆角/阴影/动效/层级/断点/面与文字/玻璃/状态语义色。必须自闭合——不得引用 console 或 website 的 token。
|
|
4
4
|
|
|
5
5
|
⚠️ 本文件由 scripts/split-tokens.mjs 从 tokens.css 生成,**不要手改**。
|
|
@@ -66,6 +66,18 @@
|
|
|
66
66
|
/* 柔和径向光晕版(用于品牌氛围点缀,不刺眼) */
|
|
67
67
|
--mg-brand-gradient-soft: linear-gradient(135deg, color-mix(in oklab, var(--mg-brand-gradient-from) 88%, white), var(--mg-brand-gradient-mid), var(--mg-brand-gradient-to));
|
|
68
68
|
|
|
69
|
+
/* ── 星点装饰(品牌氛围组件默认档,qa#688 下沉)──
|
|
70
|
+
此前 console-web public-shell.css 与官网 hero 各存一份字面值(逐项相同);
|
|
71
|
+
这里是唯一定义点,消费方在 .mg-decor-star 等容器上引用,逐星实例仍可用
|
|
72
|
+
同名局部变量 / inline style 覆盖出错落动画。值原样搬运,视觉零变化。 */
|
|
73
|
+
--mg-decor-star-opacity: 0.34;
|
|
74
|
+
--mg-decor-star-rotate: 0deg;
|
|
75
|
+
--mg-decor-star-scale: 1;
|
|
76
|
+
--mg-decor-star-x: 14px;
|
|
77
|
+
--mg-decor-star-y: -16px;
|
|
78
|
+
--mg-decor-star-x2: -10px;
|
|
79
|
+
--mg-decor-star-y2: 12px;
|
|
80
|
+
|
|
69
81
|
/* ── 中性灰阶(含基线在用的精确值;其余补标准 slate) ── */
|
|
70
82
|
--mg-gray-50: #f8fafc; /* 基线 raised */
|
|
71
83
|
--mg-gray-100: #f1f5f9;
|
|
@@ -128,6 +140,35 @@
|
|
|
128
140
|
--mg-text-xs-line: 1.5;
|
|
129
141
|
--mg-text-xs-tracking: 0.01em;
|
|
130
142
|
|
|
143
|
+
/* ── UI 字阶 / 行高(2026-11 V1.0.11 预览UI 下沉,源自控制台 release/v1.0.11)──
|
|
144
|
+
与上面的 --mg-text-* 不是同一把尺子,刻意并存,别互相别名:
|
|
145
|
+
· --mg-text-* 是**官网营销**字阶,px 值 + 无单位行高倍数(正文 16px × 1.6 = 25.6px);
|
|
146
|
+
· 本组是**应用 UI** 字阶,行高按 2px 整数网格落地(10/14 · 11/16 · 12/16 · 14/22 ·
|
|
147
|
+
16/24 · 18/24 · 24/32 · 28/36),控制台/后台的列表、表单、工具栏靠这个网格才对齐。
|
|
148
|
+
两者混用会同时出现「行高带小数」与「营销标题被 UI 档位绑住」两个问题。
|
|
149
|
+
⚠️ 命名撞车提醒:--mg-text-body = 16px(营销正文),--mg-font-size-body = 14px(UI 正文),
|
|
150
|
+
各自按家族取,不要跨家族替换。
|
|
151
|
+
micro(10px) / meta(11px) 是控制台特有的紧凑档,共享包此前最小只到 12px:
|
|
152
|
+
模型发现页 2026-09-03 用 computed style 逐项量过 PRD 原型(厂商名/状态标签/轴刻度/图例
|
|
153
|
+
都是 10px),智能客服面板宽 380px、窄屏还会收缩,11px 是元信息排得开的前提。
|
|
154
|
+
⚠️ 只补共享包确实没有的档;12px 及以上一律用本组 caption/body/value,不再页面级自建。 */
|
|
155
|
+
--mg-font-size-micro: 0.625rem; /* 10px */
|
|
156
|
+
--mg-line-height-micro: 0.875rem; /* 14px */
|
|
157
|
+
--mg-font-size-meta: 0.6875rem; /* 11px */
|
|
158
|
+
--mg-line-height-meta: 1rem; /* 16px */
|
|
159
|
+
--mg-font-size-caption: 0.75rem; /* 12px */
|
|
160
|
+
--mg-line-height-caption: 1rem; /* 16px */
|
|
161
|
+
--mg-font-size-body: 0.875rem; /* 14px */
|
|
162
|
+
--mg-line-height-body: 1.375rem; /* 22px */
|
|
163
|
+
--mg-font-size-value: 1rem; /* 16px */
|
|
164
|
+
--mg-line-height-value: 1.5rem; /* 24px */
|
|
165
|
+
--mg-font-size-title-sm: 1.125rem; /* 18px */
|
|
166
|
+
--mg-line-height-title-sm: 1.5rem; /* 24px */
|
|
167
|
+
--mg-font-size-page-title: 1.5rem; /* 24px */
|
|
168
|
+
--mg-line-height-page-title: 2rem; /* 32px */
|
|
169
|
+
--mg-font-size-display-sm: 1.75rem; /* 28px */
|
|
170
|
+
--mg-line-height-display-sm: 2.25rem;/* 36px */
|
|
171
|
+
|
|
131
172
|
/* ── 渲染因素(2026-08-06 补:此前只定义了族/字阶/字重,但同一份字体在不同
|
|
132
173
|
渲染设置下观感差别很大,缺了这几项就会出现「字体明明一样却看着不对」)── */
|
|
133
174
|
|
|
@@ -198,6 +239,10 @@
|
|
|
198
239
|
--mg-duration-fast: 0.15s;
|
|
199
240
|
--mg-duration-base: 0.25s; /* 基线 motion-fast */
|
|
200
241
|
--mg-duration-slow: 0.4s;
|
|
242
|
+
/* 上面四档量的是**一次动作**有多快(按压 / 悬停 / 切换);下面两档量的不是同一件事
|
|
243
|
+
—— 一个量「画多久」,一个量「转一圈多久」——所以单独立档,不复用 fast/base/slow。 */
|
|
244
|
+
--mg-duration-chart: 0.9s; /* 一次性入场(图表生长、相对条):0.4s 一闪而过等于没有,要看得见生长又不用等 */
|
|
245
|
+
--mg-duration-pulse: 2.4s; /* 常驻循环一圈(呼吸、流光):1s 内像故障闪烁,4s 以上察觉不到变化 */
|
|
201
246
|
--mg-ease-standard: cubic-bezier(0.4, 0, 0.2, 1);
|
|
202
247
|
--mg-ease-emphasized: cubic-bezier(0.16, 1, 0.3, 1);
|
|
203
248
|
/* 第三档缓动(qa#686 补件,UI 侧定案):纯减速、无加速起手,比 emphasized 更柔和平滑。
|
|
@@ -291,6 +336,26 @@
|
|
|
291
336
|
--mg-surface-2: #f8fafc; /* 抬升面 / Dropdown(比卡片更亮,配阴影表达抬升) */
|
|
292
337
|
--mg-surface-3: #ffffff; /* 顶层面板 Modal/Tooltip(白 + 阴影) */
|
|
293
338
|
|
|
339
|
+
/* ── 表面编号别名(bg-0/1/2/3)—— 下沉自控制台 V1.0.11 ──
|
|
340
|
+
控制台按「层级编号」引用表面,官网/后台按「用途」引用,两套拼写指向同一批值。
|
|
341
|
+
库保留用途名(surface-*)为规范名,编号名在此收编,避免控制台各自再抄一份。
|
|
342
|
+
bg-0 = 卡片面(surface,已并入玻璃 → 半透明)
|
|
343
|
+
bg-1 = 页面底(--mg-bg)
|
|
344
|
+
bg-2 = 悬浮面(surface-2,Dropdown)
|
|
345
|
+
bg-3 = 顶层面板(surface-3,Modal/Tooltip)
|
|
346
|
+
-solid / -rgb 是 color-mix 与 rgba() 用的不透明替身:
|
|
347
|
+
★ 它们**不等于** --mg-bg-0 本身。--mg-surface 在深色下是白 7% 的半透明膜,
|
|
348
|
+
rgb 拿出来是 255,255,255,混进 color-mix 会得到一片发白的死灰。
|
|
349
|
+
所以 -solid 指向 --mg-surface-solid,-rgb 是"这层叠在常规页底上看起来是什么颜色"
|
|
350
|
+
的手工快照,换底色要连它一起改(控制台侧原本也是手工同步的)。 */
|
|
351
|
+
--mg-bg-0: var(--mg-surface);
|
|
352
|
+
--mg-bg-0-solid: var(--mg-surface-solid);
|
|
353
|
+
--mg-bg-0-rgb: 255, 255, 255;
|
|
354
|
+
--mg-bg-1: var(--mg-bg);
|
|
355
|
+
--mg-bg-1-rgb: 255, 255, 255;
|
|
356
|
+
--mg-bg-2: var(--mg-surface-2);
|
|
357
|
+
--mg-bg-3: var(--mg-surface-3);
|
|
358
|
+
|
|
294
359
|
/* 边框:柔和 hairline(浅色卡片"浮起"主要靠分层阴影,边框只做极淡勾勒,避免生硬) */
|
|
295
360
|
--mg-border: color-mix(in oklab, var(--mg-brand-base) 9%, transparent); /* 市场分色 hairline(国内官网现行;随 [data-market] 品牌色自动切) */
|
|
296
361
|
--mg-border-hover: color-mix(in oklab, var(--mg-brand-base) 50%, transparent);
|
|
@@ -465,6 +530,10 @@
|
|
|
465
530
|
--mg-surface-solid: #232329;
|
|
466
531
|
--mg-surface-2: #2e2e36; /* 悬浮 Dropdown */
|
|
467
532
|
--mg-surface-3: #3b3b44; /* 顶层 Modal/Tooltip */
|
|
533
|
+
/* 编号别名的 rgb 快照必须跟着深色档改(浅色是 255,255,255):
|
|
534
|
+
bg-0-rgb = --mg-surface-solid 的 rgb(#232329);bg-1-rgb = --mg-bg 的 rgb(#18181c)。 */
|
|
535
|
+
--mg-bg-0-rgb: 35, 35, 41;
|
|
536
|
+
--mg-bg-1-rgb: 24, 24, 28;
|
|
468
537
|
--mg-border: rgba(255, 255, 255, 0.08);
|
|
469
538
|
--mg-divider: rgba(255, 255, 255, 0.06);
|
|
470
539
|
--mg-fill-0: rgba(255, 255, 255, 0.025);
|
|
@@ -518,8 +587,6 @@
|
|
|
518
587
|
--mg-bp-2xl: 1536px;
|
|
519
588
|
}
|
|
520
589
|
|
|
521
|
-
/* ═══════════════════════ 玻璃系统 · 第四象限 + 通用工具类 ═══════════════════════ */
|
|
522
|
-
|
|
523
590
|
/* 深色 × 海外绿:前面三档已覆盖 浅蓝 / 浅绿 / 深蓝,这里补 深绿。
|
|
524
591
|
薄膜与颗粒沿用深色档,只换画布与描边色相。 */
|
|
525
592
|
[data-theme='dark'][data-market='global'],
|
|
@@ -574,6 +641,7 @@
|
|
|
574
641
|
--mg-on-primary: #ffffff;
|
|
575
642
|
--mg-favorite-bg-hover: var(--mg-error-bg-hover);
|
|
576
643
|
--mg-link-hover: var(--mg-brand-mid);
|
|
644
|
+
--mg-link: var(--mg-brand-base);
|
|
577
645
|
--mg-icon-empty-size: 2rem;
|
|
578
646
|
--mg-overlay-bg: var(--mg-overlay);
|
|
579
647
|
--mg-overlay-blur: 8px;
|
package/console.css
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/* ══════════════════════════════════════════════════════════════
|
|
2
|
-
modelgo-design-tokens · console.css (
|
|
2
|
+
modelgo-design-tokens · console.css (463 个 token)
|
|
3
3
|
控制台专用组件语义。可引用 base,不得引用 website。
|
|
4
4
|
|
|
5
5
|
⚠️ 本文件由 scripts/split-tokens.mjs 从 tokens.css 生成,**不要手改**。
|
|
@@ -153,11 +153,23 @@
|
|
|
153
153
|
--mg-chart-cat-4-border: color-mix(in oklab, var(--mg-chart-cat-4) 30%, transparent);
|
|
154
154
|
--mg-chart-cat-5-border: color-mix(in oklab, var(--mg-chart-cat-5) 30%, transparent);
|
|
155
155
|
--mg-chart-cat-6-border: color-mix(in oklab, var(--mg-chart-cat-6) 30%, transparent);
|
|
156
|
+
|
|
157
|
+
/* 画布实色兜底(prd#827 闪白):--mg-glass-canvas 是纯 linear-gradient、没有
|
|
158
|
+
background-color,快速滚动时未栅格化的瓦片会按文档根底色(默认白)填充 → 闪白。
|
|
159
|
+
值取本象限渐变两端的中值;**改渐变必须同步改这里**,否则兜底色和画布会差半个色阶。
|
|
160
|
+
四象限各一条,与各自的 --mg-glass-canvas 紧邻对应。 */
|
|
161
|
+
--mg-canvas-base: #f0f8ff;
|
|
156
162
|
--mg-app-bg: var(--mg-glass-canvas);
|
|
157
163
|
}
|
|
158
164
|
|
|
165
|
+
/* ═══════════════════════ 3) MARKET 市场覆盖:当前市场指向 global 色阶 ═══════════════════════ */
|
|
166
|
+
[data-market='global'] {
|
|
167
|
+
--mg-canvas-base: #f8fcf9; /* 浅色·海外:上面渐变两端的中值 */
|
|
168
|
+
}
|
|
169
|
+
|
|
159
170
|
/* —— 舒适型(控制台/app 默认):暖炭灰底 + 锌灰文字 + 莫兰迪降饱和语义 —— */
|
|
160
171
|
[data-theme='dark'] {
|
|
172
|
+
--mg-canvas-base: #181c27; /* 深色·国内:上面渐变两端的中值 */
|
|
161
173
|
|
|
162
174
|
/* 图表分类色深色档(下沉自 console-web/src/styles/tokens.css:622-627)。
|
|
163
175
|
cat-4 原两档同值——不是「深底上已足够亮」,是补深色档时漏改的那一个(qa#672):
|
|
@@ -174,6 +186,61 @@
|
|
|
174
186
|
--mg-chart-cat-6: #e66767;
|
|
175
187
|
}
|
|
176
188
|
|
|
189
|
+
/* ═══════════════════════ 玻璃系统 · 第四象限 + 通用工具类 ═══════════════════════ */
|
|
190
|
+
|
|
191
|
+
/* ── 浮层表面(Float)—— 下沉自控制台 V1.0.11 ──────────────────────────
|
|
192
|
+
所有浮层(Popover / Dropdown / Select / Dialog / Sheet / Tooltip)表面的唯一配方。
|
|
193
|
+
|
|
194
|
+
为什么不复用 --mg-glass-surface:那一档是给内容面调的(浅色白 70% / 深色白 7%),
|
|
195
|
+
背后的正文能透读出来 —— 需求方 #504(同源 #449)当初正是因此把下拉面板一刀改成实色。
|
|
196
|
+
|
|
197
|
+
⚠️ 这里是**实底**,是定论不是待调值。浮层走过一轮玻璃实验(92% 不透明 + 24px 模糊 +
|
|
198
|
+
5% 品牌色染入)后被 owner 于 2026-09-17 否掉:那 8% 透光把整片抽屉底衬成发紫的灰,
|
|
199
|
+
与里面的纯白输入框一撞就脏,抽屉越大越明显。遮挡改由 --mg-float-opacity 直接给满,
|
|
200
|
+
层次改由投影 / 亮边 / 光晕表达,不靠透明度。
|
|
201
|
+
控制台至今还声明着 --mg-float-blur / --mg-float-saturate,但 .mg-float 已不消费它们
|
|
202
|
+
(底不透明,模糊什么都看不见,只剩每帧合成开销)——本库**刻意不收这两个**:
|
|
203
|
+
收进来就等于给「半透明浮层」留了个随时能复活的口子,而它已经被否过一次了。
|
|
204
|
+
|
|
205
|
+
命名用 float 不用 overlay:--mg-overlay-bg 已经是「模态遮罩 scrim」的名字,
|
|
206
|
+
同名两义会让后来的人改错地方。
|
|
207
|
+
|
|
208
|
+
深浅两档都写在下面,深色档**必须**在浅色 :root 之后(同特异性,靠源序取胜);
|
|
209
|
+
键名是 [data-theme='dark']——控制台 applyTheme() 在切深色时会同时设 data-theme,
|
|
210
|
+
删掉它本地的 [theme-mode='dark'] 副本后这条照样生效。 */
|
|
211
|
+
:root {
|
|
212
|
+
--mg-float-brand-mix: 0%; /* 浮层不染主题色 —— 2026-09-17 owner 看 API Key 抽屉「太丑」,
|
|
213
|
+
偏色叠在 bg-2 上整片发紫灰,与里面的纯白输入框撞得很脏。 */
|
|
214
|
+
--mg-float-opacity: 100%; /* 实底。92% 那 8% 透光在大面积抽屉上就是脏,不是质感;
|
|
215
|
+
遮挡改由不透明度直接保证,不再依赖 backdrop-filter。 */
|
|
216
|
+
--mg-float-surface: color-mix(in oklab, var(--mg-brand-base) var(--mg-float-brand-mix), var(--mg-bg-2));
|
|
217
|
+
--mg-float-bg: color-mix(in srgb, var(--mg-float-surface) var(--mg-float-opacity), transparent);
|
|
218
|
+
--mg-float-line: color-mix(in oklab, var(--mg-brand-base) 16%, var(--mg-glass-line));
|
|
219
|
+
--mg-float-sheen: rgba(255, 255, 255, 0.9); /* 顶部 1px 亮边 = 表面厚度的高光(玻璃档留名) */
|
|
220
|
+
/* 微光是「晕」不是「环」:用大扩散负 spread 的品牌色投影,别写 0 0 0 1px(那会变成第二道描边) */
|
|
221
|
+
--mg-float-glow: 0 8px 32px -14px color-mix(in oklab, var(--mg-brand-base) 30%, transparent);
|
|
222
|
+
--mg-float-shadow:
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
/* 浮层表面深色档:暗底上靠「实底抬一档 + 品牌微光」立起来,不是靠更黑的面。
|
|
226
|
+
sheen 压到 12%(深色下白亮边一硬就假);glow 改用 --mg-brand-mid(深色档的提亮级),
|
|
227
|
+
--mg-brand-base 在暗底上晕不开。 */
|
|
228
|
+
[data-theme='dark'] {
|
|
229
|
+
--mg-float-brand-mix: 0%;
|
|
230
|
+
--mg-float-opacity: 100%;
|
|
231
|
+
--mg-float-line: color-mix(in oklab, var(--mg-brand-mid) 22%, rgba(255, 255, 255, 0.13));
|
|
232
|
+
--mg-float-sheen: rgba(255, 255, 255, 0.12);
|
|
233
|
+
--mg-float-glow: 0 8px 34px -14px color-mix(in oklab, var(--mg-brand-mid) 36%, transparent);
|
|
234
|
+
--mg-float-shadow:
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
/* 深色 × 海外绿:前面三档已覆盖 浅蓝 / 浅绿 / 深蓝,这里补 深绿。
|
|
238
|
+
薄膜与颗粒沿用深色档,只换画布与描边色相。 */
|
|
239
|
+
[data-theme='dark'][data-market='global'],
|
|
240
|
+
[data-theme='dark'] [data-market='global'] {
|
|
241
|
+
--mg-canvas-base: #141d1a; /* 深色·海外:上面渐变两端的中值 */
|
|
242
|
+
}
|
|
243
|
+
|
|
177
244
|
/* ── 层级工具类:挂类名即可,避免 Tailwind z-40/z-50 与 9999 魔数混用 ──
|
|
178
245
|
与 --mg-z-* 同源,只是省掉每处写 style={{ zIndex: 'var(--mg-z-modal)' }}。 */
|
|
179
246
|
.mg-layer-base { z-index: var(--mg-z-base); }
|
|
@@ -346,6 +413,13 @@
|
|
|
346
413
|
--mg-control-affix-gap: var(--mg-space-2);
|
|
347
414
|
--mg-control-helper-gap: var(--mg-space-1);
|
|
348
415
|
--mg-control-border-hover: var(--mg-border-hover);
|
|
416
|
+
|
|
417
|
+
/* 多行与下拉的高度约束 —— 下沉自控制台 V1.0.11(预览UI)
|
|
418
|
+
textarea 默认 3 行 ≈ 80px,太矮:正文一多就出内部滚动条,用户要先滚再写。
|
|
419
|
+
5rem 是 4 行的量,配 --mg-control-py-sm 后正好不溢出。
|
|
420
|
+
select 列表 202px ≈ 5.5 项:够看清可选项,又不至于把下方表单推出视口。 */
|
|
421
|
+
--mg-textarea-min-h: 5rem;
|
|
422
|
+
--mg-select-list-max-h: 202px;
|
|
349
423
|
}
|
|
350
424
|
|
|
351
425
|
/* ══════════════════════════════════════════════════════════════
|
|
@@ -403,7 +477,7 @@
|
|
|
403
477
|
--mg-toast-gap: var(--mg-space-2);
|
|
404
478
|
--mg-toast-pad-x: var(--mg-space-4);
|
|
405
479
|
--mg-toast-pad-y: var(--mg-space-3);
|
|
406
|
-
--mg-toast-radius: var(--mg-radius-
|
|
480
|
+
--mg-toast-radius: var(--mg-radius-pill);
|
|
407
481
|
--mg-toast-bg: var(--mg-surface-3);
|
|
408
482
|
--mg-toast-border: var(--mg-border);
|
|
409
483
|
--mg-toast-shadow: var(--mg-shadow-lg);
|
|
@@ -429,6 +503,9 @@
|
|
|
429
503
|
--mg-progress-track-bg: var(--mg-fill-0);
|
|
430
504
|
--mg-progress-track-border: color-mix(in oklab, var(--mg-border) 40%, transparent);
|
|
431
505
|
--mg-progress-thumb-bg: #ffffff;
|
|
506
|
+
/* 里程碑节点直径 —— 下沉自控制台 V1.0.11。刻度点要能被看见又不抢进度条本体,
|
|
507
|
+
2rem 与 --mg-control-height-sm 同高,配表单行内的进度不撑高。 */
|
|
508
|
+
--mg-progress-milestone-h: 2rem;
|
|
432
509
|
|
|
433
510
|
/* 品牌 */
|
|
434
511
|
--mg-progress-brand-bar: linear-gradient(90deg, var(--mg-brand-base), var(--mg-brand-mid));
|
|
@@ -528,12 +605,23 @@
|
|
|
528
605
|
--mg-panel-padding-md: var(--mg-space-4);
|
|
529
606
|
--mg-panel-padding-lg: var(--mg-space-5);
|
|
530
607
|
--mg-panel-padding-xl: var(--mg-space-6);
|
|
608
|
+
|
|
609
|
+
/* 默认档 —— 下沉自控制台 V1.0.11。历史上有 66 处直接写 var(--mg-panel-padding),
|
|
610
|
+
缺它等于整条 padding 声明失效(静默故障)。规范名仍按尺寸取,这条只是 md 的别名。 */
|
|
611
|
+
--mg-panel-padding: var(--mg-panel-padding-md);
|
|
531
612
|
}
|
|
532
613
|
|
|
533
614
|
/* ── 导航(Nav) ── */
|
|
534
615
|
:root {
|
|
535
616
|
--mg-nav-text-active: var(--mg-brand-deep);
|
|
536
617
|
--mg-nav-icon-active: var(--mg-brand-base);
|
|
618
|
+
|
|
619
|
+
/* 菜单列表(下拉菜单 / 导航分组 / 动作列表)—— 下沉自控制台 V1.0.11。
|
|
620
|
+
内层留 0.375rem 比 item 自身的 space-3/space-2 小一档:容器内边距小于项内边距,
|
|
621
|
+
鼠标划到边缘才不会觉得「菜单挤在框里」。 */
|
|
622
|
+
--mg-menu-padding: 0.375rem;
|
|
623
|
+
--mg-menu-item-px: var(--mg-space-3);
|
|
624
|
+
--mg-menu-item-py: var(--mg-space-2);
|
|
537
625
|
}
|
|
538
626
|
|
|
539
627
|
/* --mg-brand-deep 在浅色下是「比 base 更深的品牌色」,当强调文字正合适;
|
|
@@ -561,6 +649,14 @@
|
|
|
561
649
|
|
|
562
650
|
/* ── 其他通用 ── */
|
|
563
651
|
:root {
|
|
652
|
+
/* 品牌语义兼容别名(2026-11 V1.0.11 预览UI 下沉):控制台/后台按 --mg-primary* / --mg-link
|
|
653
|
+
书写,库里此前只有 --mg-brand*。按 §1「一个概念一个规范名」——本组是**单向兼容别名**,
|
|
654
|
+
只指向规范名、不持有值,禁止把它们当新值的定义点,新代码一律写 --mg-brand-*。 */
|
|
655
|
+
--mg-primary: var(--mg-brand-base);
|
|
656
|
+
--mg-primary-hover: var(--mg-brand-mid);
|
|
657
|
+
--mg-primary-active: var(--mg-brand-deep);
|
|
658
|
+
--mg-primary-disabled: var(--mg-brand-light);
|
|
659
|
+
--mg-primary-light: var(--mg-brand-pale);
|
|
564
660
|
--mg-calendar-cell-size: 1.75rem;
|
|
565
661
|
--mg-sparkline-h: 1.75rem;
|
|
566
662
|
--mg-skeleton-h-md: 2rem;
|
|
@@ -864,3 +960,25 @@
|
|
|
864
960
|
--mg-table-row-hover-bg: var(--mg-state-hover-bg);
|
|
865
961
|
--mg-table-row-selected-bg: var(--mg-state-selected-bg);
|
|
866
962
|
}
|
|
963
|
+
|
|
964
|
+
/* ══════════════════════════════════════════════════════════════
|
|
965
|
+
下沉自控制台的组件级 token —— 第五批:工作区页签(V1.0.11 预览UI 定案值)
|
|
966
|
+
来源:modelgo-console-web release/v1.0.11 src/styles/tokens.css:1545-1548
|
|
967
|
+
(原文注释:「特定UI已确认的翻面曲线及内层页签刻度,保持本轮设计原参数」)
|
|
968
|
+
日期:2026-11-16
|
|
969
|
+
|
|
970
|
+
这两个值不在 --mg-radius-* / --mg-ease-* 的通用档位里,是 UI 本轮(1.0.11)
|
|
971
|
+
对工作区页签这一处的定案:13px 是「外层 16px 圆角里再内缩一层」的刻度,
|
|
972
|
+
硬套 radius-md(12px)/lg(16px) 都会和设计稿差 1~3px。故按组件值下沉,
|
|
973
|
+
不改通用档位 —— 通用档位的依据只能是设计意图,不能拿单点值反推。
|
|
974
|
+
══════════════════════════════════════════════════════════════ */
|
|
975
|
+
:root {
|
|
976
|
+
--mg-workspace-tab-radius: 13px;
|
|
977
|
+
--mg-petal-flip-ease: cubic-bezier(.65, 0, .35, 1);
|
|
978
|
+
|
|
979
|
+
/* 历史短名仅供下游迁移兼容;规范名是 --mg-workspace-tab-radius / --mg-petal-flip-ease。
|
|
980
|
+
注意:这两个不是 --mg-ui-preview-<hash> 那类「未定案的字面色逃生舱」,
|
|
981
|
+
它们已有确定语义与单一真源,只是控制台侧还留着旧拼写。 */
|
|
982
|
+
--mg-ui-workspace-tab-radius: var(--mg-workspace-tab-radius);
|
|
983
|
+
--mg-ui-petal-flip-ease: var(--mg-petal-flip-ease);
|
|
984
|
+
}
|
package/package.json
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
// 最后只会被 --no-verify 绕过。
|
|
14
14
|
//
|
|
15
15
|
// 用法:
|
|
16
|
-
// node scripts/check-token-usage.mjs #
|
|
16
|
+
// node scripts/check-token-usage.mjs # 扫默认各端(含已冻结的文档站)
|
|
17
17
|
// node scripts/check-token-usage.mjs <dir> [dir...] # 扫指定目录(相对 cwd)
|
|
18
18
|
// node scripts/check-token-usage.mjs --all # 列出全部存量,不阻断
|
|
19
19
|
// node scripts/check-token-usage.mjs --update-baseline # 存量收口,写回 baseline
|
|
@@ -47,8 +47,10 @@ function resolveWorkspaceRoot() {
|
|
|
47
47
|
|
|
48
48
|
const WORKSPACE = resolveWorkspaceRoot()
|
|
49
49
|
|
|
50
|
-
//
|
|
51
|
-
//
|
|
50
|
+
// 默认扫全部消费方:React·Vite(控制台 / 内部后台)+ Astro(国内 / 国外官网)。
|
|
51
|
+
// 原来只有 console-web 和一个早已不存在的 wt-console-glass,于是国内官网的存量硬编码从来没被扫过。
|
|
52
|
+
// 文档站(VitePress)已冻结在 0.6.x、不再升级,仍留在列表里只作参照——
|
|
53
|
+
// 它的命中不代表要改它,改它不在本仓范围内。
|
|
52
54
|
const DEFAULT_TARGETS = [
|
|
53
55
|
'modelgo-console-web/src',
|
|
54
56
|
'modelgo-web/src',
|
|
@@ -113,6 +115,38 @@ const rules = [
|
|
|
113
115
|
message: 'Use --mg-shadow-sm/md/lg or the semantic --mg-*-shadow aliases instead of literal shadow values.',
|
|
114
116
|
accept: (text) => !usesVar(text) && /(?:rgba?\(|#[0-9a-fA-F]{3,8})/.test(text) && !/\bnone\b/.test(text),
|
|
115
117
|
},
|
|
118
|
+
// ── 2026-09-17 新增(prd46#1061)。起因:微信收银台整页写死一套自造紫(#5D3FD3 等
|
|
119
|
+
// 9 个值),模型广场把 brand token 的字面值抄成本地值、深色档已经漂移 —— 品牌色
|
|
120
|
+
// 此前没有任何规则管(同 font-size 那次:规则只在能被机器执行的地方才真正存在)。
|
|
121
|
+
// 判据:饱和彩色字面值(hex 或 rgb 三元组,RGB 通道差 ≥ 16)。灰阶/黑白中性色
|
|
122
|
+
// 通道差趋近 0,不判;CSS 自定义属性定义点沿用扫描器的统一豁免(定义本地 token
|
|
123
|
+
// 不是「该用 token 却没用」——catalog-palette 那类定义点漂移由 code review 兜,
|
|
124
|
+
// 机器只拦业务代码里的散落字面值)。第三方品牌色(微信绿 #07c160、支付宝蓝等)
|
|
125
|
+
// 集中到一个常量文件并加 token-check-ignore 写明理由,不散落业务代码。
|
|
126
|
+
// 阈值 16 的依据:brand pale 档最浅是 #e8ecfd(通道差 21),暖灰类中性色差 <10。
|
|
127
|
+
{
|
|
128
|
+
name: 'hardcoded-brand-color',
|
|
129
|
+
pattern: /#[0-9a-fA-F]{3,8}\b|rgba?\(\s*\d{1,3}\s*,\s*\d{1,3}\s*,\s*\d{1,3}/g,
|
|
130
|
+
message:
|
|
131
|
+
'Saturated color literal — brand/theme colors must reference tokens: var(--mg-brand-*), ' +
|
|
132
|
+
'rgba(var(--mg-brand-base-rgb), a) or color-mix over a token. Literals will not follow ' +
|
|
133
|
+
'market (cn/global) or theme changes. Third-party brand colors: centralize in one ' +
|
|
134
|
+
'constants file with a token-check-ignore note.',
|
|
135
|
+
accept: (text) => {
|
|
136
|
+
let r, g, b
|
|
137
|
+
if (text.startsWith('#')) {
|
|
138
|
+
const hex = text.slice(1)
|
|
139
|
+
if (hex.length === 3 || hex.length === 4) {
|
|
140
|
+
;[r, g, b] = [0, 1, 2].map((i) => parseInt(hex[i] + hex[i], 16))
|
|
141
|
+
} else if (hex.length === 6 || hex.length === 8) {
|
|
142
|
+
;[r, g, b] = [0, 2, 4].map((i) => parseInt(hex.slice(i, i + 2), 16))
|
|
143
|
+
} else return false // #abcde 这类非法长度不判
|
|
144
|
+
} else {
|
|
145
|
+
;[r, g, b] = text.match(/\d{1,3}/g).map(Number)
|
|
146
|
+
}
|
|
147
|
+
return Math.max(r, g, b) - Math.min(r, g, b) >= 16
|
|
148
|
+
},
|
|
149
|
+
},
|
|
116
150
|
]
|
|
117
151
|
|
|
118
152
|
/**
|
package/tokens.css
CHANGED
|
@@ -57,6 +57,18 @@
|
|
|
57
57
|
/* 柔和径向光晕版(用于品牌氛围点缀,不刺眼) */
|
|
58
58
|
--mg-brand-gradient-soft: linear-gradient(135deg, color-mix(in oklab, var(--mg-brand-gradient-from) 88%, white), var(--mg-brand-gradient-mid), var(--mg-brand-gradient-to));
|
|
59
59
|
|
|
60
|
+
/* ── 星点装饰(品牌氛围组件默认档,qa#688 下沉)──
|
|
61
|
+
此前 console-web public-shell.css 与官网 hero 各存一份字面值(逐项相同);
|
|
62
|
+
这里是唯一定义点,消费方在 .mg-decor-star 等容器上引用,逐星实例仍可用
|
|
63
|
+
同名局部变量 / inline style 覆盖出错落动画。值原样搬运,视觉零变化。 */
|
|
64
|
+
--mg-decor-star-opacity: 0.34;
|
|
65
|
+
--mg-decor-star-rotate: 0deg;
|
|
66
|
+
--mg-decor-star-scale: 1;
|
|
67
|
+
--mg-decor-star-x: 14px;
|
|
68
|
+
--mg-decor-star-y: -16px;
|
|
69
|
+
--mg-decor-star-x2: -10px;
|
|
70
|
+
--mg-decor-star-y2: 12px;
|
|
71
|
+
|
|
60
72
|
/* ── 中性灰阶(含基线在用的精确值;其余补标准 slate) ── */
|
|
61
73
|
--mg-gray-50: #f8fafc; /* 基线 raised */
|
|
62
74
|
--mg-gray-100: #f1f5f9;
|
|
@@ -119,6 +131,35 @@
|
|
|
119
131
|
--mg-text-xs-line: 1.5;
|
|
120
132
|
--mg-text-xs-tracking: 0.01em;
|
|
121
133
|
|
|
134
|
+
/* ── UI 字阶 / 行高(2026-11 V1.0.11 预览UI 下沉,源自控制台 release/v1.0.11)──
|
|
135
|
+
与上面的 --mg-text-* 不是同一把尺子,刻意并存,别互相别名:
|
|
136
|
+
· --mg-text-* 是**官网营销**字阶,px 值 + 无单位行高倍数(正文 16px × 1.6 = 25.6px);
|
|
137
|
+
· 本组是**应用 UI** 字阶,行高按 2px 整数网格落地(10/14 · 11/16 · 12/16 · 14/22 ·
|
|
138
|
+
16/24 · 18/24 · 24/32 · 28/36),控制台/后台的列表、表单、工具栏靠这个网格才对齐。
|
|
139
|
+
两者混用会同时出现「行高带小数」与「营销标题被 UI 档位绑住」两个问题。
|
|
140
|
+
⚠️ 命名撞车提醒:--mg-text-body = 16px(营销正文),--mg-font-size-body = 14px(UI 正文),
|
|
141
|
+
各自按家族取,不要跨家族替换。
|
|
142
|
+
micro(10px) / meta(11px) 是控制台特有的紧凑档,共享包此前最小只到 12px:
|
|
143
|
+
模型发现页 2026-09-03 用 computed style 逐项量过 PRD 原型(厂商名/状态标签/轴刻度/图例
|
|
144
|
+
都是 10px),智能客服面板宽 380px、窄屏还会收缩,11px 是元信息排得开的前提。
|
|
145
|
+
⚠️ 只补共享包确实没有的档;12px 及以上一律用本组 caption/body/value,不再页面级自建。 */
|
|
146
|
+
--mg-font-size-micro: 0.625rem; /* 10px */
|
|
147
|
+
--mg-line-height-micro: 0.875rem; /* 14px */
|
|
148
|
+
--mg-font-size-meta: 0.6875rem; /* 11px */
|
|
149
|
+
--mg-line-height-meta: 1rem; /* 16px */
|
|
150
|
+
--mg-font-size-caption: 0.75rem; /* 12px */
|
|
151
|
+
--mg-line-height-caption: 1rem; /* 16px */
|
|
152
|
+
--mg-font-size-body: 0.875rem; /* 14px */
|
|
153
|
+
--mg-line-height-body: 1.375rem; /* 22px */
|
|
154
|
+
--mg-font-size-value: 1rem; /* 16px */
|
|
155
|
+
--mg-line-height-value: 1.5rem; /* 24px */
|
|
156
|
+
--mg-font-size-title-sm: 1.125rem; /* 18px */
|
|
157
|
+
--mg-line-height-title-sm: 1.5rem; /* 24px */
|
|
158
|
+
--mg-font-size-page-title: 1.5rem; /* 24px */
|
|
159
|
+
--mg-line-height-page-title: 2rem; /* 32px */
|
|
160
|
+
--mg-font-size-display-sm: 1.75rem; /* 28px */
|
|
161
|
+
--mg-line-height-display-sm: 2.25rem;/* 36px */
|
|
162
|
+
|
|
122
163
|
/* ── 渲染因素(2026-08-06 补:此前只定义了族/字阶/字重,但同一份字体在不同
|
|
123
164
|
渲染设置下观感差别很大,缺了这几项就会出现「字体明明一样却看着不对」)── */
|
|
124
165
|
|
|
@@ -189,6 +230,10 @@
|
|
|
189
230
|
--mg-duration-fast: 0.15s;
|
|
190
231
|
--mg-duration-base: 0.25s; /* 基线 motion-fast */
|
|
191
232
|
--mg-duration-slow: 0.4s;
|
|
233
|
+
/* 上面四档量的是**一次动作**有多快(按压 / 悬停 / 切换);下面两档量的不是同一件事
|
|
234
|
+
—— 一个量「画多久」,一个量「转一圈多久」——所以单独立档,不复用 fast/base/slow。 */
|
|
235
|
+
--mg-duration-chart: 0.9s; /* 一次性入场(图表生长、相对条):0.4s 一闪而过等于没有,要看得见生长又不用等 */
|
|
236
|
+
--mg-duration-pulse: 2.4s; /* 常驻循环一圈(呼吸、流光):1s 内像故障闪烁,4s 以上察觉不到变化 */
|
|
192
237
|
--mg-ease-standard: cubic-bezier(0.4, 0, 0.2, 1);
|
|
193
238
|
--mg-ease-emphasized: cubic-bezier(0.16, 1, 0.3, 1);
|
|
194
239
|
/* 第三档缓动(qa#686 补件,UI 侧定案):纯减速、无加速起手,比 emphasized 更柔和平滑。
|
|
@@ -365,6 +410,26 @@
|
|
|
365
410
|
--mg-surface-solid: #f2f2f6;
|
|
366
411
|
--mg-surface-2: #f8fafc; /* 抬升面 / Dropdown(比卡片更亮,配阴影表达抬升) */
|
|
367
412
|
--mg-surface-3: #ffffff; /* 顶层面板 Modal/Tooltip(白 + 阴影) */
|
|
413
|
+
|
|
414
|
+
/* ── 表面编号别名(bg-0/1/2/3)—— 下沉自控制台 V1.0.11 ──
|
|
415
|
+
控制台按「层级编号」引用表面,官网/后台按「用途」引用,两套拼写指向同一批值。
|
|
416
|
+
库保留用途名(surface-*)为规范名,编号名在此收编,避免控制台各自再抄一份。
|
|
417
|
+
bg-0 = 卡片面(surface,已并入玻璃 → 半透明)
|
|
418
|
+
bg-1 = 页面底(--mg-bg)
|
|
419
|
+
bg-2 = 悬浮面(surface-2,Dropdown)
|
|
420
|
+
bg-3 = 顶层面板(surface-3,Modal/Tooltip)
|
|
421
|
+
-solid / -rgb 是 color-mix 与 rgba() 用的不透明替身:
|
|
422
|
+
★ 它们**不等于** --mg-bg-0 本身。--mg-surface 在深色下是白 7% 的半透明膜,
|
|
423
|
+
rgb 拿出来是 255,255,255,混进 color-mix 会得到一片发白的死灰。
|
|
424
|
+
所以 -solid 指向 --mg-surface-solid,-rgb 是"这层叠在常规页底上看起来是什么颜色"
|
|
425
|
+
的手工快照,换底色要连它一起改(控制台侧原本也是手工同步的)。 */
|
|
426
|
+
--mg-bg-0: var(--mg-surface);
|
|
427
|
+
--mg-bg-0-solid: var(--mg-surface-solid);
|
|
428
|
+
--mg-bg-0-rgb: 255, 255, 255;
|
|
429
|
+
--mg-bg-1: var(--mg-bg);
|
|
430
|
+
--mg-bg-1-rgb: 255, 255, 255;
|
|
431
|
+
--mg-bg-2: var(--mg-surface-2);
|
|
432
|
+
--mg-bg-3: var(--mg-surface-3);
|
|
368
433
|
/* 代码块底:中性近黑。原值 --mg-gray-950 #0f0f1a 带蓝紫相,海外绿站深色下代码面板发紫;
|
|
369
434
|
设计 2026-08-10 定为与控制台现行代码底同值的中性 #131316,不随市场带色相 */
|
|
370
435
|
--mg-code: #131316;
|
|
@@ -492,6 +557,12 @@
|
|
|
492
557
|
由 #BED4EF → #E7F4FF 整体提亮到近白,顶部不再压重色。 */
|
|
493
558
|
--mg-glass-canvas: linear-gradient(180deg, #edf5ff 0%, #f4faff 100%);
|
|
494
559
|
|
|
560
|
+
/* 画布实色兜底(prd#827 闪白):--mg-glass-canvas 是纯 linear-gradient、没有
|
|
561
|
+
background-color,快速滚动时未栅格化的瓦片会按文档根底色(默认白)填充 → 闪白。
|
|
562
|
+
值取本象限渐变两端的中值;**改渐变必须同步改这里**,否则兜底色和画布会差半个色阶。
|
|
563
|
+
四象限各一条,与各自的 --mg-glass-canvas 紧邻对应。 */
|
|
564
|
+
--mg-canvas-base: #f0f8ff;
|
|
565
|
+
|
|
495
566
|
/* 磨砂颗粒 */
|
|
496
567
|
--mg-glass-grain-opacity: 0.5;
|
|
497
568
|
--mg-glass-grain-blend: overlay;
|
|
@@ -524,6 +595,7 @@
|
|
|
524
595
|
/* 玻璃:只换画布与描边的色相(蓝→翠),veil/alpha/模糊/颗粒四档共用,
|
|
525
596
|
所以海外站不需要单独维护一套玻璃逻辑,只是画布换色。 */
|
|
526
597
|
--mg-glass-canvas: linear-gradient(180deg, #f5fbf6 0%, #fafdfb 100%); /* 明度/彩度对齐国内 #edf5ff→#f4faff,仅平移到品牌绿色相 */
|
|
598
|
+
--mg-canvas-base: #f8fcf9; /* 浅色·海外:上面渐变两端的中值 */
|
|
527
599
|
--mg-glass-line: #cfe6db;
|
|
528
600
|
--mg-glass-header-edge: rgba(238, 250, 244, 0.4);
|
|
529
601
|
|
|
@@ -584,6 +656,10 @@
|
|
|
584
656
|
--mg-surface-solid: #232329;
|
|
585
657
|
--mg-surface-2: #2e2e36; /* 悬浮 Dropdown */
|
|
586
658
|
--mg-surface-3: #3b3b44; /* 顶层 Modal/Tooltip */
|
|
659
|
+
/* 编号别名的 rgb 快照必须跟着深色档改(浅色是 255,255,255):
|
|
660
|
+
bg-0-rgb = --mg-surface-solid 的 rgb(#232329);bg-1-rgb = --mg-bg 的 rgb(#18181c)。 */
|
|
661
|
+
--mg-bg-0-rgb: 35, 35, 41;
|
|
662
|
+
--mg-bg-1-rgb: 24, 24, 28;
|
|
587
663
|
--mg-border: rgba(255, 255, 255, 0.08);
|
|
588
664
|
--mg-divider: rgba(255, 255, 255, 0.06);
|
|
589
665
|
--mg-fill-0: rgba(255, 255, 255, 0.025);
|
|
@@ -605,6 +681,7 @@
|
|
|
605
681
|
--mg-glass-surface-strong: color-mix(in oklab, var(--mg-glass-veil) 12%, transparent);
|
|
606
682
|
--mg-glass-header: color-mix(in oklab, var(--mg-glass-veil) 5%, transparent);
|
|
607
683
|
--mg-glass-canvas: linear-gradient(180deg, #1b2231 0%, #14161d 100%);
|
|
684
|
+
--mg-canvas-base: #181c27; /* 深色·国内:上面渐变两端的中值 */
|
|
608
685
|
--mg-glass-line: rgba(255, 255, 255, 0.10);
|
|
609
686
|
--mg-glass-header-edge: rgba(255, 255, 255, 0.4);
|
|
610
687
|
--mg-glass-grain-opacity: 0.34;
|
|
@@ -654,11 +731,64 @@
|
|
|
654
731
|
|
|
655
732
|
/* ═══════════════════════ 玻璃系统 · 第四象限 + 通用工具类 ═══════════════════════ */
|
|
656
733
|
|
|
734
|
+
/* ── 浮层表面(Float)—— 下沉自控制台 V1.0.11 ──────────────────────────
|
|
735
|
+
所有浮层(Popover / Dropdown / Select / Dialog / Sheet / Tooltip)表面的唯一配方。
|
|
736
|
+
|
|
737
|
+
为什么不复用 --mg-glass-surface:那一档是给内容面调的(浅色白 70% / 深色白 7%),
|
|
738
|
+
背后的正文能透读出来 —— 需求方 #504(同源 #449)当初正是因此把下拉面板一刀改成实色。
|
|
739
|
+
|
|
740
|
+
⚠️ 这里是**实底**,是定论不是待调值。浮层走过一轮玻璃实验(92% 不透明 + 24px 模糊 +
|
|
741
|
+
5% 品牌色染入)后被 owner 于 2026-09-17 否掉:那 8% 透光把整片抽屉底衬成发紫的灰,
|
|
742
|
+
与里面的纯白输入框一撞就脏,抽屉越大越明显。遮挡改由 --mg-float-opacity 直接给满,
|
|
743
|
+
层次改由投影 / 亮边 / 光晕表达,不靠透明度。
|
|
744
|
+
控制台至今还声明着 --mg-float-blur / --mg-float-saturate,但 .mg-float 已不消费它们
|
|
745
|
+
(底不透明,模糊什么都看不见,只剩每帧合成开销)——本库**刻意不收这两个**:
|
|
746
|
+
收进来就等于给「半透明浮层」留了个随时能复活的口子,而它已经被否过一次了。
|
|
747
|
+
|
|
748
|
+
命名用 float 不用 overlay:--mg-overlay-bg 已经是「模态遮罩 scrim」的名字,
|
|
749
|
+
同名两义会让后来的人改错地方。
|
|
750
|
+
|
|
751
|
+
深浅两档都写在下面,深色档**必须**在浅色 :root 之后(同特异性,靠源序取胜);
|
|
752
|
+
键名是 [data-theme='dark']——控制台 applyTheme() 在切深色时会同时设 data-theme,
|
|
753
|
+
删掉它本地的 [theme-mode='dark'] 副本后这条照样生效。 */
|
|
754
|
+
:root {
|
|
755
|
+
--mg-float-brand-mix: 0%; /* 浮层不染主题色 —— 2026-09-17 owner 看 API Key 抽屉「太丑」,
|
|
756
|
+
偏色叠在 bg-2 上整片发紫灰,与里面的纯白输入框撞得很脏。 */
|
|
757
|
+
--mg-float-opacity: 100%; /* 实底。92% 那 8% 透光在大面积抽屉上就是脏,不是质感;
|
|
758
|
+
遮挡改由不透明度直接保证,不再依赖 backdrop-filter。 */
|
|
759
|
+
--mg-float-surface: color-mix(in oklab, var(--mg-brand-base) var(--mg-float-brand-mix), var(--mg-bg-2));
|
|
760
|
+
--mg-float-bg: color-mix(in srgb, var(--mg-float-surface) var(--mg-float-opacity), transparent);
|
|
761
|
+
--mg-float-line: color-mix(in oklab, var(--mg-brand-base) 16%, var(--mg-glass-line));
|
|
762
|
+
--mg-float-sheen: rgba(255, 255, 255, 0.9); /* 顶部 1px 亮边 = 表面厚度的高光(玻璃档留名) */
|
|
763
|
+
/* 微光是「晕」不是「环」:用大扩散负 spread 的品牌色投影,别写 0 0 0 1px(那会变成第二道描边) */
|
|
764
|
+
--mg-float-glow: 0 8px 32px -14px color-mix(in oklab, var(--mg-brand-base) 30%, transparent);
|
|
765
|
+
--mg-float-shadow:
|
|
766
|
+
0 1px 2px rgba(16, 24, 40, 0.05),
|
|
767
|
+
0 12px 28px -10px rgba(16, 24, 40, 0.16),
|
|
768
|
+
0 28px 60px -24px rgba(16, 24, 40, 0.2);
|
|
769
|
+
}
|
|
770
|
+
|
|
771
|
+
/* 浮层表面深色档:暗底上靠「实底抬一档 + 品牌微光」立起来,不是靠更黑的面。
|
|
772
|
+
sheen 压到 12%(深色下白亮边一硬就假);glow 改用 --mg-brand-mid(深色档的提亮级),
|
|
773
|
+
--mg-brand-base 在暗底上晕不开。 */
|
|
774
|
+
[data-theme='dark'] {
|
|
775
|
+
--mg-float-brand-mix: 0%;
|
|
776
|
+
--mg-float-opacity: 100%;
|
|
777
|
+
--mg-float-line: color-mix(in oklab, var(--mg-brand-mid) 22%, rgba(255, 255, 255, 0.13));
|
|
778
|
+
--mg-float-sheen: rgba(255, 255, 255, 0.12);
|
|
779
|
+
--mg-float-glow: 0 8px 34px -14px color-mix(in oklab, var(--mg-brand-mid) 36%, transparent);
|
|
780
|
+
--mg-float-shadow:
|
|
781
|
+
0 2px 6px rgba(0, 0, 0, 0.34),
|
|
782
|
+
0 16px 38px -12px rgba(0, 0, 0, 0.48),
|
|
783
|
+
0 34px 68px -30px rgba(0, 0, 0, 0.55);
|
|
784
|
+
}
|
|
785
|
+
|
|
657
786
|
/* 深色 × 海外绿:前面三档已覆盖 浅蓝 / 浅绿 / 深蓝,这里补 深绿。
|
|
658
787
|
薄膜与颗粒沿用深色档,只换画布与描边色相。 */
|
|
659
788
|
[data-theme='dark'][data-market='global'],
|
|
660
789
|
[data-theme='dark'] [data-market='global'] {
|
|
661
790
|
--mg-glass-canvas: linear-gradient(180deg, #16241f 0%, #111614 100%);
|
|
791
|
+
--mg-canvas-base: #141d1a; /* 深色·海外:上面渐变两端的中值 */
|
|
662
792
|
--mg-glass-line: rgba(255, 255, 255, 0.10);
|
|
663
793
|
}
|
|
664
794
|
|
|
@@ -909,6 +1039,13 @@
|
|
|
909
1039
|
--mg-control-affix-gap: var(--mg-space-2);
|
|
910
1040
|
--mg-control-helper-gap: var(--mg-space-1);
|
|
911
1041
|
--mg-control-border-hover: var(--mg-border-hover);
|
|
1042
|
+
|
|
1043
|
+
/* 多行与下拉的高度约束 —— 下沉自控制台 V1.0.11(预览UI)
|
|
1044
|
+
textarea 默认 3 行 ≈ 80px,太矮:正文一多就出内部滚动条,用户要先滚再写。
|
|
1045
|
+
5rem 是 4 行的量,配 --mg-control-py-sm 后正好不溢出。
|
|
1046
|
+
select 列表 202px ≈ 5.5 项:够看清可选项,又不至于把下方表单推出视口。 */
|
|
1047
|
+
--mg-textarea-min-h: 5rem;
|
|
1048
|
+
--mg-select-list-max-h: 202px;
|
|
912
1049
|
}
|
|
913
1050
|
|
|
914
1051
|
/* ── 交互状态(State) ── */
|
|
@@ -998,7 +1135,7 @@
|
|
|
998
1135
|
--mg-toast-gap: var(--mg-space-2);
|
|
999
1136
|
--mg-toast-pad-x: var(--mg-space-4);
|
|
1000
1137
|
--mg-toast-pad-y: var(--mg-space-3);
|
|
1001
|
-
--mg-toast-radius: var(--mg-radius-
|
|
1138
|
+
--mg-toast-radius: var(--mg-radius-pill);
|
|
1002
1139
|
--mg-toast-bg: var(--mg-surface-3);
|
|
1003
1140
|
--mg-toast-border: var(--mg-border);
|
|
1004
1141
|
--mg-toast-shadow: var(--mg-shadow-lg);
|
|
@@ -1024,6 +1161,9 @@
|
|
|
1024
1161
|
--mg-progress-track-bg: var(--mg-fill-0);
|
|
1025
1162
|
--mg-progress-track-border: color-mix(in oklab, var(--mg-border) 40%, transparent);
|
|
1026
1163
|
--mg-progress-thumb-bg: #ffffff;
|
|
1164
|
+
/* 里程碑节点直径 —— 下沉自控制台 V1.0.11。刻度点要能被看见又不抢进度条本体,
|
|
1165
|
+
2rem 与 --mg-control-height-sm 同高,配表单行内的进度不撑高。 */
|
|
1166
|
+
--mg-progress-milestone-h: 2rem;
|
|
1027
1167
|
|
|
1028
1168
|
/* 品牌 */
|
|
1029
1169
|
--mg-progress-brand-bar: linear-gradient(90deg, var(--mg-brand-base), var(--mg-brand-mid));
|
|
@@ -1136,12 +1276,23 @@
|
|
|
1136
1276
|
--mg-panel-padding-md: var(--mg-space-4);
|
|
1137
1277
|
--mg-panel-padding-lg: var(--mg-space-5);
|
|
1138
1278
|
--mg-panel-padding-xl: var(--mg-space-6);
|
|
1279
|
+
|
|
1280
|
+
/* 默认档 —— 下沉自控制台 V1.0.11。历史上有 66 处直接写 var(--mg-panel-padding),
|
|
1281
|
+
缺它等于整条 padding 声明失效(静默故障)。规范名仍按尺寸取,这条只是 md 的别名。 */
|
|
1282
|
+
--mg-panel-padding: var(--mg-panel-padding-md);
|
|
1139
1283
|
}
|
|
1140
1284
|
|
|
1141
1285
|
/* ── 导航(Nav) ── */
|
|
1142
1286
|
:root {
|
|
1143
1287
|
--mg-nav-text-active: var(--mg-brand-deep);
|
|
1144
1288
|
--mg-nav-icon-active: var(--mg-brand-base);
|
|
1289
|
+
|
|
1290
|
+
/* 菜单列表(下拉菜单 / 导航分组 / 动作列表)—— 下沉自控制台 V1.0.11。
|
|
1291
|
+
内层留 0.375rem 比 item 自身的 space-3/space-2 小一档:容器内边距小于项内边距,
|
|
1292
|
+
鼠标划到边缘才不会觉得「菜单挤在框里」。 */
|
|
1293
|
+
--mg-menu-padding: 0.375rem;
|
|
1294
|
+
--mg-menu-item-px: var(--mg-space-3);
|
|
1295
|
+
--mg-menu-item-py: var(--mg-space-2);
|
|
1145
1296
|
}
|
|
1146
1297
|
|
|
1147
1298
|
/* --mg-brand-deep 在浅色下是「比 base 更深的品牌色」,当强调文字正合适;
|
|
@@ -1172,6 +1323,15 @@
|
|
|
1172
1323
|
--mg-on-primary: #ffffff;
|
|
1173
1324
|
--mg-favorite-bg-hover: var(--mg-error-bg-hover);
|
|
1174
1325
|
--mg-link-hover: var(--mg-brand-mid);
|
|
1326
|
+
/* 品牌语义兼容别名(2026-11 V1.0.11 预览UI 下沉):控制台/后台按 --mg-primary* / --mg-link
|
|
1327
|
+
书写,库里此前只有 --mg-brand*。按 §1「一个概念一个规范名」——本组是**单向兼容别名**,
|
|
1328
|
+
只指向规范名、不持有值,禁止把它们当新值的定义点,新代码一律写 --mg-brand-*。 */
|
|
1329
|
+
--mg-primary: var(--mg-brand-base);
|
|
1330
|
+
--mg-primary-hover: var(--mg-brand-mid);
|
|
1331
|
+
--mg-primary-active: var(--mg-brand-deep);
|
|
1332
|
+
--mg-primary-disabled: var(--mg-brand-light);
|
|
1333
|
+
--mg-primary-light: var(--mg-brand-pale);
|
|
1334
|
+
--mg-link: var(--mg-brand-base);
|
|
1175
1335
|
--mg-calendar-cell-size: 1.75rem;
|
|
1176
1336
|
--mg-sparkline-h: 1.75rem;
|
|
1177
1337
|
--mg-skeleton-h-md: 2rem;
|
|
@@ -1509,6 +1669,28 @@
|
|
|
1509
1669
|
--mg-favorite: var(--mg-error);
|
|
1510
1670
|
}
|
|
1511
1671
|
|
|
1672
|
+
/* ══════════════════════════════════════════════════════════════
|
|
1673
|
+
下沉自控制台的组件级 token —— 第五批:工作区页签(V1.0.11 预览UI 定案值)
|
|
1674
|
+
来源:modelgo-console-web release/v1.0.11 src/styles/tokens.css:1545-1548
|
|
1675
|
+
(原文注释:「特定UI已确认的翻面曲线及内层页签刻度,保持本轮设计原参数」)
|
|
1676
|
+
日期:2026-11-16
|
|
1677
|
+
|
|
1678
|
+
这两个值不在 --mg-radius-* / --mg-ease-* 的通用档位里,是 UI 本轮(1.0.11)
|
|
1679
|
+
对工作区页签这一处的定案:13px 是「外层 16px 圆角里再内缩一层」的刻度,
|
|
1680
|
+
硬套 radius-md(12px)/lg(16px) 都会和设计稿差 1~3px。故按组件值下沉,
|
|
1681
|
+
不改通用档位 —— 通用档位的依据只能是设计意图,不能拿单点值反推。
|
|
1682
|
+
══════════════════════════════════════════════════════════════ */
|
|
1683
|
+
:root {
|
|
1684
|
+
--mg-workspace-tab-radius: 13px;
|
|
1685
|
+
--mg-petal-flip-ease: cubic-bezier(.65, 0, .35, 1);
|
|
1686
|
+
|
|
1687
|
+
/* 历史短名仅供下游迁移兼容;规范名是 --mg-workspace-tab-radius / --mg-petal-flip-ease。
|
|
1688
|
+
注意:这两个不是 --mg-ui-preview-<hash> 那类「未定案的字面色逃生舱」,
|
|
1689
|
+
它们已有确定语义与单一真源,只是控制台侧还留着旧拼写。 */
|
|
1690
|
+
--mg-ui-workspace-tab-radius: var(--mg-workspace-tab-radius);
|
|
1691
|
+
--mg-ui-petal-flip-ease: var(--mg-petal-flip-ease);
|
|
1692
|
+
}
|
|
1693
|
+
|
|
1512
1694
|
/* ══════════════════════════════════════════════════════════════
|
|
1513
1695
|
第三条大道 · SITE 官网语义层(占位)
|
|
1514
1696
|
官网(modelgo-domestic-web / modelgo-global-web)专用组件语义 token。
|