modelgo-design-tokens 0.14.0 → 0.16.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 CHANGED
@@ -1,9 +1,44 @@
1
1
  # Changelog
2
2
 
3
- ## Unreleased
3
+ ## 0.16.0 — 2026-11-18
4
+
5
+ > 下沉官网组件 token 到 website 层(prd46#1970,#1847 的子任务)。
6
+ > **纯新增**:生效值对比「新增 27 项 / 删除 0 项 / 改变 0 项」,未改任何既有 0.15.0 声明值。
7
+
8
+ ### Added
9
+
10
+ - **CTA 按钮语义档 9 名**(`[data-market='global']`):`--mg-cta-primary-bg{,-hover,-active,-fg}` /
11
+ `--mg-cta-secondary-bg{,-hover,-active,-fg,-border}`。
12
+ 下沉自 `modelgo-global-web/src/styles/theme.css`,该处原注释即写明「待 modelgo-design-tokens
13
+ 收编 cta 档后删除本段、直接吃包里的值」。国际站黑白 CTA 是 Figma 定的视觉身份,保留为国际分档。
14
+ ⚠️ 国内站(`data-market='china'`)的 CTA 档**尚未定义**,等设计给值后补。
15
+
16
+ - **代码块高亮语义档 10 名**:`--mg-code-foreground` / `--mg-code-token-{keyword,function,string,
17
+ string-expression,link,constant,parameter,comment,punctuation}`。
18
+ 下沉自 `modelgo-global-web/.../api-quick-call-modal.css`,浅深两档照搬。
19
+ 灰阶是 Material 系(`#202124` / `#9aa0a6` / `#6e7378`),与本包 `--mg-gray-*` 的 Tailwind slate
20
+ 系没有精确对应值,故照搬 hex 不做映射——映射即改值,需设计依据后单独收敛。
21
+
22
+ ### Changed
23
+
24
+ - `token-layers.json`:`websitePrefixes` 增加 `code`。原规则下 `--mg-code-token-*` 会按
25
+ 「head=code 不匹配任何前缀」默认落到 console 层,与实际消费方(官网)不符。
26
+ `check:layers` 通过:base 275 · console 461 · website 25。
27
+
28
+
29
+ ## 0.15.0 — 2026-11-17
30
+
31
+ > 发版确认:owner 2026-11-17 指令「发」(§2 硬顺序步骤 1 的明确确认)。
32
+ > 消费方生效还需:升 `^0.15.0` + 删本地同名声明(见 `CONSUMER-SINK-CONSOLE-1.0.11.md`)。
4
33
 
5
34
  ### Added
6
35
 
36
+ - **下沉 V1.0.11 预览 UI 体系**(`1f8e564`,配套治理文档 `94fe23c` / `948a317` / `045f6b1`):
37
+ 16 个 UI 字阶(`--mg-ui-font-size/line-height/weight` 系列)、动效
38
+ `--mg-duration-chart` / `--mg-duration-pulse`、4 个 `--mg-canvas-base`、品牌语义别名。
39
+ **纯新增**:`tokens.css` 未改动任何既有 0.14.0 声明值,不升依赖的消费方零影响。
40
+ 验收基准(owner 2026-11-16):用规范产出的计算值 = 1.0.11 现值。
41
+
7
42
  - **新增 `--mg-decor-star-*` 星点装饰 token(7 个,base 层,qa#688)**:
8
43
  `opacity/rotate/scale/x/y/x2/y2`。此前 console-web `public-shell.css` 与官网 hero
9
44
  各自维护一份字面值(逐项相同),下沉为唯一定义点;值原样搬运,视觉零变化。
package/README.md CHANGED
@@ -1,15 +1,23 @@
1
1
  # modelgo-design-tokens
2
2
 
3
- ModelGo 四端(控制台 / 国内官网 / 国外官网 / 文档站)统一设计 token 的**单一真源**。
4
- 纯 CSS 变量,框架无关——React / Astro / VitePress 都能用。
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
- 四端技术栈不同(React·Vite / Astro / VitePress),跨框架共享「组件」几乎不可能;
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` + 当次的 `tokens.css` + 精简 `package.json`(只留 name/version/description)。
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,11 @@ pnpm preview:deploy # → Cloudflare Pages 项目 modelgo-design-tokens
131
140
 
132
141
  1. 发布本包到 npm(公共)。
133
142
  2. 选一端先接(建议国内官网),把本地变量改成引用 `--mg-*`,跑通构建+部署。
134
- 3. 验证无误后,其余三端逐个接入,删掉各自重复的 token 定义。
143
+ 3. 验证无误后,其余各端逐个接入,删掉各自重复的 token 定义。
135
144
 
136
145
  > `tokens.css` 里的具体数值是「对账两端现状后的起步建议」,可按设计意图调整;
137
- > 价值在于**统一命名 + 单一来源**,改视觉只改这一个文件、四端同步。
146
+ > 价值在于**统一命名 + 单一来源**,改视觉只改这一个文件、各端同步。
147
+
148
+ ## 控制台 UI 设计规范
149
+
150
+ [国内白、国内黑、国际黑规范与可浏览页面](docs/console-ui-spec/README.md)(2026-11-18 设计交接)。
@@ -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 (249 个 token)
2
+ modelgo-design-tokens · base.css (275 个 token)
3
3
  原子与跨端语义:品牌色阶/灰阶/字阶/间距/圆角/阴影/动效/层级/断点/面与文字/玻璃/状态语义色。必须自闭合——不得引用 console 或 website 的 token。
4
4
 
5
5
  ⚠️ 本文件由 scripts/split-tokens.mjs 从 tokens.css 生成,**不要手改**。
@@ -140,6 +140,35 @@
140
140
  --mg-text-xs-line: 1.5;
141
141
  --mg-text-xs-tracking: 0.01em;
142
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
+
143
172
  /* ── 渲染因素(2026-08-06 补:此前只定义了族/字阶/字重,但同一份字体在不同
144
173
  渲染设置下观感差别很大,缺了这几项就会出现「字体明明一样却看着不对」)── */
145
174
 
@@ -210,6 +239,10 @@
210
239
  --mg-duration-fast: 0.15s;
211
240
  --mg-duration-base: 0.25s; /* 基线 motion-fast */
212
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 以上察觉不到变化 */
213
246
  --mg-ease-standard: cubic-bezier(0.4, 0, 0.2, 1);
214
247
  --mg-ease-emphasized: cubic-bezier(0.16, 1, 0.3, 1);
215
248
  /* 第三档缓动(qa#686 补件,UI 侧定案):纯减速、无加速起手,比 emphasized 更柔和平滑。
@@ -303,6 +336,26 @@
303
336
  --mg-surface-2: #f8fafc; /* 抬升面 / Dropdown(比卡片更亮,配阴影表达抬升) */
304
337
  --mg-surface-3: #ffffff; /* 顶层面板 Modal/Tooltip(白 + 阴影) */
305
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
+
306
359
  /* 边框:柔和 hairline(浅色卡片"浮起"主要靠分层阴影,边框只做极淡勾勒,避免生硬) */
307
360
  --mg-border: color-mix(in oklab, var(--mg-brand-base) 9%, transparent); /* 市场分色 hairline(国内官网现行;随 [data-market] 品牌色自动切) */
308
361
  --mg-border-hover: color-mix(in oklab, var(--mg-brand-base) 50%, transparent);
@@ -477,6 +530,10 @@
477
530
  --mg-surface-solid: #232329;
478
531
  --mg-surface-2: #2e2e36; /* 悬浮 Dropdown */
479
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;
480
537
  --mg-border: rgba(255, 255, 255, 0.08);
481
538
  --mg-divider: rgba(255, 255, 255, 0.06);
482
539
  --mg-fill-0: rgba(255, 255, 255, 0.025);
@@ -530,8 +587,6 @@
530
587
  --mg-bp-2xl: 1536px;
531
588
  }
532
589
 
533
- /* ═══════════════════════ 玻璃系统 · 第四象限 + 通用工具类 ═══════════════════════ */
534
-
535
590
  /* 深色 × 海外绿:前面三档已覆盖 浅蓝 / 浅绿 / 深蓝,这里补 深绿。
536
591
  薄膜与颗粒沿用深色档,只换画布与描边色相。 */
537
592
  [data-theme='dark'][data-market='global'],
@@ -586,6 +641,7 @@
586
641
  --mg-on-primary: #ffffff;
587
642
  --mg-favorite-bg-hover: var(--mg-error-bg-hover);
588
643
  --mg-link-hover: var(--mg-brand-mid);
644
+ --mg-link: var(--mg-brand-base);
589
645
  --mg-icon-empty-size: 2rem;
590
646
  --mg-overlay-bg: var(--mg-overlay);
591
647
  --mg-overlay-blur: 8px;
package/console.css CHANGED
@@ -1,5 +1,5 @@
1
1
  /* ══════════════════════════════════════════════════════════════
2
- modelgo-design-tokens · console.css (438 个 token)
2
+ modelgo-design-tokens · console.css (461 个 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-md);
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,19 +649,19 @@
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;
567
663
  --mg-preview-thumb-size: 3rem;
568
664
  --mg-empty-min-h: 12.5rem;
569
- --mg-code-bg: var(--mg-gray-100);
570
- --mg-code-text: var(--mg-gray-900);
571
- }
572
-
573
- /* 深色覆盖 */
574
- [data-theme='dark'] {
575
- --mg-code-bg: var(--mg-gray-900);
576
- --mg-code-text: var(--mg-gray-100);
577
665
  }
578
666
  [data-market='china'] {
579
667
  --mg-trend-up: var(--mg-danger);
@@ -864,3 +952,25 @@
864
952
  --mg-table-row-hover-bg: var(--mg-state-hover-bg);
865
953
  --mg-table-row-selected-bg: var(--mg-state-selected-bg);
866
954
  }
955
+
956
+ /* ══════════════════════════════════════════════════════════════
957
+ 下沉自控制台的组件级 token —— 第五批:工作区页签(V1.0.11 预览UI 定案值)
958
+ 来源:modelgo-console-web release/v1.0.11 src/styles/tokens.css:1545-1548
959
+ (原文注释:「特定UI已确认的翻面曲线及内层页签刻度,保持本轮设计原参数」)
960
+ 日期:2026-11-16
961
+
962
+ 这两个值不在 --mg-radius-* / --mg-ease-* 的通用档位里,是 UI 本轮(1.0.11)
963
+ 对工作区页签这一处的定案:13px 是「外层 16px 圆角里再内缩一层」的刻度,
964
+ 硬套 radius-md(12px)/lg(16px) 都会和设计稿差 1~3px。故按组件值下沉,
965
+ 不改通用档位 —— 通用档位的依据只能是设计意图,不能拿单点值反推。
966
+ ══════════════════════════════════════════════════════════════ */
967
+ :root {
968
+ --mg-workspace-tab-radius: 13px;
969
+ --mg-petal-flip-ease: cubic-bezier(.65, 0, .35, 1);
970
+
971
+ /* 历史短名仅供下游迁移兼容;规范名是 --mg-workspace-tab-radius / --mg-petal-flip-ease。
972
+ 注意:这两个不是 --mg-ui-preview-<hash> 那类「未定案的字面色逃生舱」,
973
+ 它们已有确定语义与单一真源,只是控制台侧还留着旧拼写。 */
974
+ --mg-ui-workspace-tab-radius: var(--mg-workspace-tab-radius);
975
+ --mg-ui-petal-flip-ease: var(--mg-petal-flip-ease);
976
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "modelgo-design-tokens",
3
- "version": "0.14.0",
3
+ "version": "0.16.0",
4
4
  "description": "ModelGo 四端统一设计 token(CSS 变量,框架无关):品牌色阶 / 字体 / 字阶 / 圆角 / 间距 / 按钮。",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -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
- // 四端全覆盖。原来只有 console-web 和一个早已不存在的 wt-console-glass,
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
@@ -131,6 +131,35 @@
131
131
  --mg-text-xs-line: 1.5;
132
132
  --mg-text-xs-tracking: 0.01em;
133
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
+
134
163
  /* ── 渲染因素(2026-08-06 补:此前只定义了族/字阶/字重,但同一份字体在不同
135
164
  渲染设置下观感差别很大,缺了这几项就会出现「字体明明一样却看着不对」)── */
136
165
 
@@ -201,6 +230,10 @@
201
230
  --mg-duration-fast: 0.15s;
202
231
  --mg-duration-base: 0.25s; /* 基线 motion-fast */
203
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 以上察觉不到变化 */
204
237
  --mg-ease-standard: cubic-bezier(0.4, 0, 0.2, 1);
205
238
  --mg-ease-emphasized: cubic-bezier(0.16, 1, 0.3, 1);
206
239
  /* 第三档缓动(qa#686 补件,UI 侧定案):纯减速、无加速起手,比 emphasized 更柔和平滑。
@@ -377,6 +410,26 @@
377
410
  --mg-surface-solid: #f2f2f6;
378
411
  --mg-surface-2: #f8fafc; /* 抬升面 / Dropdown(比卡片更亮,配阴影表达抬升) */
379
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);
380
433
  /* 代码块底:中性近黑。原值 --mg-gray-950 #0f0f1a 带蓝紫相,海外绿站深色下代码面板发紫;
381
434
  设计 2026-08-10 定为与控制台现行代码底同值的中性 #131316,不随市场带色相 */
382
435
  --mg-code: #131316;
@@ -504,6 +557,12 @@
504
557
  由 #BED4EF → #E7F4FF 整体提亮到近白,顶部不再压重色。 */
505
558
  --mg-glass-canvas: linear-gradient(180deg, #edf5ff 0%, #f4faff 100%);
506
559
 
560
+ /* 画布实色兜底(prd#827 闪白):--mg-glass-canvas 是纯 linear-gradient、没有
561
+ background-color,快速滚动时未栅格化的瓦片会按文档根底色(默认白)填充 → 闪白。
562
+ 值取本象限渐变两端的中值;**改渐变必须同步改这里**,否则兜底色和画布会差半个色阶。
563
+ 四象限各一条,与各自的 --mg-glass-canvas 紧邻对应。 */
564
+ --mg-canvas-base: #f0f8ff;
565
+
507
566
  /* 磨砂颗粒 */
508
567
  --mg-glass-grain-opacity: 0.5;
509
568
  --mg-glass-grain-blend: overlay;
@@ -536,6 +595,7 @@
536
595
  /* 玻璃:只换画布与描边的色相(蓝→翠),veil/alpha/模糊/颗粒四档共用,
537
596
  所以海外站不需要单独维护一套玻璃逻辑,只是画布换色。 */
538
597
  --mg-glass-canvas: linear-gradient(180deg, #f5fbf6 0%, #fafdfb 100%); /* 明度/彩度对齐国内 #edf5ff→#f4faff,仅平移到品牌绿色相 */
598
+ --mg-canvas-base: #f8fcf9; /* 浅色·海外:上面渐变两端的中值 */
539
599
  --mg-glass-line: #cfe6db;
540
600
  --mg-glass-header-edge: rgba(238, 250, 244, 0.4);
541
601
 
@@ -596,6 +656,10 @@
596
656
  --mg-surface-solid: #232329;
597
657
  --mg-surface-2: #2e2e36; /* 悬浮 Dropdown */
598
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;
599
663
  --mg-border: rgba(255, 255, 255, 0.08);
600
664
  --mg-divider: rgba(255, 255, 255, 0.06);
601
665
  --mg-fill-0: rgba(255, 255, 255, 0.025);
@@ -617,6 +681,7 @@
617
681
  --mg-glass-surface-strong: color-mix(in oklab, var(--mg-glass-veil) 12%, transparent);
618
682
  --mg-glass-header: color-mix(in oklab, var(--mg-glass-veil) 5%, transparent);
619
683
  --mg-glass-canvas: linear-gradient(180deg, #1b2231 0%, #14161d 100%);
684
+ --mg-canvas-base: #181c27; /* 深色·国内:上面渐变两端的中值 */
620
685
  --mg-glass-line: rgba(255, 255, 255, 0.10);
621
686
  --mg-glass-header-edge: rgba(255, 255, 255, 0.4);
622
687
  --mg-glass-grain-opacity: 0.34;
@@ -666,11 +731,64 @@
666
731
 
667
732
  /* ═══════════════════════ 玻璃系统 · 第四象限 + 通用工具类 ═══════════════════════ */
668
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
+
669
786
  /* 深色 × 海外绿:前面三档已覆盖 浅蓝 / 浅绿 / 深蓝,这里补 深绿。
670
787
  薄膜与颗粒沿用深色档,只换画布与描边色相。 */
671
788
  [data-theme='dark'][data-market='global'],
672
789
  [data-theme='dark'] [data-market='global'] {
673
790
  --mg-glass-canvas: linear-gradient(180deg, #16241f 0%, #111614 100%);
791
+ --mg-canvas-base: #141d1a; /* 深色·海外:上面渐变两端的中值 */
674
792
  --mg-glass-line: rgba(255, 255, 255, 0.10);
675
793
  }
676
794
 
@@ -921,6 +1039,13 @@
921
1039
  --mg-control-affix-gap: var(--mg-space-2);
922
1040
  --mg-control-helper-gap: var(--mg-space-1);
923
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;
924
1049
  }
925
1050
 
926
1051
  /* ── 交互状态(State) ── */
@@ -1010,7 +1135,7 @@
1010
1135
  --mg-toast-gap: var(--mg-space-2);
1011
1136
  --mg-toast-pad-x: var(--mg-space-4);
1012
1137
  --mg-toast-pad-y: var(--mg-space-3);
1013
- --mg-toast-radius: var(--mg-radius-md);
1138
+ --mg-toast-radius: var(--mg-radius-pill);
1014
1139
  --mg-toast-bg: var(--mg-surface-3);
1015
1140
  --mg-toast-border: var(--mg-border);
1016
1141
  --mg-toast-shadow: var(--mg-shadow-lg);
@@ -1036,6 +1161,9 @@
1036
1161
  --mg-progress-track-bg: var(--mg-fill-0);
1037
1162
  --mg-progress-track-border: color-mix(in oklab, var(--mg-border) 40%, transparent);
1038
1163
  --mg-progress-thumb-bg: #ffffff;
1164
+ /* 里程碑节点直径 —— 下沉自控制台 V1.0.11。刻度点要能被看见又不抢进度条本体,
1165
+ 2rem 与 --mg-control-height-sm 同高,配表单行内的进度不撑高。 */
1166
+ --mg-progress-milestone-h: 2rem;
1039
1167
 
1040
1168
  /* 品牌 */
1041
1169
  --mg-progress-brand-bar: linear-gradient(90deg, var(--mg-brand-base), var(--mg-brand-mid));
@@ -1148,12 +1276,23 @@
1148
1276
  --mg-panel-padding-md: var(--mg-space-4);
1149
1277
  --mg-panel-padding-lg: var(--mg-space-5);
1150
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);
1151
1283
  }
1152
1284
 
1153
1285
  /* ── 导航(Nav) ── */
1154
1286
  :root {
1155
1287
  --mg-nav-text-active: var(--mg-brand-deep);
1156
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);
1157
1296
  }
1158
1297
 
1159
1298
  /* --mg-brand-deep 在浅色下是「比 base 更深的品牌色」,当强调文字正合适;
@@ -1184,6 +1323,15 @@
1184
1323
  --mg-on-primary: #ffffff;
1185
1324
  --mg-favorite-bg-hover: var(--mg-error-bg-hover);
1186
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);
1187
1335
  --mg-calendar-cell-size: 1.75rem;
1188
1336
  --mg-sparkline-h: 1.75rem;
1189
1337
  --mg-skeleton-h-md: 2rem;
@@ -1522,9 +1670,88 @@
1522
1670
  }
1523
1671
 
1524
1672
  /* ══════════════════════════════════════════════════════════════
1525
- 第三条大道 · SITE 官网语义层(占位)
1526
- 官网(modelgo-domestic-web / modelgo-global-web)专用组件语义 token。
1527
- 当前仍由官网本地 src/styles/tokens.css 维护,尚未下沉。
1528
- 待官网改造完成后,将官网的组件 token 迁入此处,统一为单一真源。
1529
- 届时本段会展开为:btn/hero/feature-card/step/faq/… 等官网组件 token。
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
+ 不改通用档位 —— 通用档位的依据只能是设计意图,不能拿单点值反推。
1530
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
+
1694
+ /* ══════════════════════════════════════════════════════════════
1695
+ 第三条大道 · SITE 官网语义层
1696
+ 官网(modelgo-web 国内 / modelgo-global-web 国际)专用组件语义 token。
1697
+ 判层见 token-layers.json 的 websitePrefixes/overrides。
1698
+
1699
+ 首批下沉(2026-11-18,prd46#1970):CTA 按钮语义档 + 代码块高亮语义档,
1700
+ 两组都照搬 modelgo-global-web 的现值,**未改任何设计值**(见 UNIFIED-UI-TOKEN.md §3 第 8 行)。
1701
+ ══════════════════════════════════════════════════════════════ */
1702
+
1703
+ /* ── CTA 按钮语义档 ─────────────────────────────────────────────
1704
+ 下沉自 modelgo-global-web src/styles/theme.css(原注释:
1705
+ 「命名占用 --mg-* 前缀是为了跟令牌包对齐,待 modelgo-design-tokens
1706
+ 收编 cta 档后删除本段、直接吃包里的值」——本次即收编)。
1707
+
1708
+ 国际站主/次 CTA 按 Figma 定的是白底黑字 / 黑底白字。黑白是无彩锚点、
1709
+ 属于视觉身份,不是自留配色,故保留为国际站分档。
1710
+ ⚠️ 国内站(data-market='china')的 CTA 档尚未定义,等设计给值后再补;
1711
+ 在那之前国内站读到的是 --mg-cta-* 未定义(与下沉前行为一致)。 */
1712
+ [data-market='global'] {
1713
+ --mg-cta-primary-bg: #ffffff;
1714
+ --mg-cta-primary-bg-hover: #f1f1f3;
1715
+ --mg-cta-primary-bg-active: #e6e6ea;
1716
+ --mg-cta-primary-fg: #0a0a0a;
1717
+
1718
+ --mg-cta-secondary-bg: #000000;
1719
+ --mg-cta-secondary-bg-hover: #0a0a0a;
1720
+ --mg-cta-secondary-bg-active: #050505;
1721
+ --mg-cta-secondary-fg: #ffffff;
1722
+ --mg-cta-secondary-border: rgba(255, 255, 255, 0.22);
1723
+ }
1724
+
1725
+ /* ── 代码块高亮语义档 ───────────────────────────────────────────
1726
+ 下沉自 modelgo-global-web …/models/detail/api-quick-call-modal.css。
1727
+ 只定义 token,不在组件里写死 hex;组件统一用本组 token 取色(引用形式见 api-quick-call-modal.css)。
1728
+
1729
+ 浅色档取品牌深档,保证淡灰底上可读;深色档以绿为主(国际站常驻深色):
1730
+ 关键字亮绿、函数浅绿、字符串薄荷绿,数字/常量用赭黄做唯一暖色点缀,
1731
+ 注释与标点退到灰阶。
1732
+
1733
+ ⚠️ 灰阶用的是 Material 系(#202124 / #9aa0a6 / #6e7378),与本包
1734
+ --mg-gray-* 的 Tailwind slate 系**不是同一套**,没有精确对应值,
1735
+ 故照搬 hex 不做映射——映射即改值,需设计依据后单独收敛。 */
1736
+ :root {
1737
+ --mg-code-foreground: #202124;
1738
+ --mg-code-token-keyword: var(--mg-brand-deep);
1739
+ --mg-code-token-function: var(--mg-brand-base);
1740
+ --mg-code-token-string: color-mix(in oklab, var(--mg-brand-deep) 80%, #202124);
1741
+ --mg-code-token-string-expression: var(--mg-code-token-string);
1742
+ --mg-code-token-link: var(--mg-code-token-string);
1743
+ --mg-code-token-constant: var(--mg-warning);
1744
+ --mg-code-token-parameter: #202124;
1745
+ --mg-code-token-comment: #9aa0a6;
1746
+ --mg-code-token-punctuation: #6e7378;
1747
+ }
1748
+ [data-theme='dark'] {
1749
+ --mg-code-foreground: var(--mg-gray-300);
1750
+ --mg-code-token-keyword: var(--mg-brand-mid);
1751
+ --mg-code-token-function: var(--mg-brand-light);
1752
+ --mg-code-token-string: color-mix(in oklab, var(--mg-brand-base) 62%, var(--mg-gray-100));
1753
+ --mg-code-token-constant: var(--mg-warning);
1754
+ --mg-code-token-parameter: var(--mg-gray-100);
1755
+ --mg-code-token-comment: var(--mg-gray-500);
1756
+ --mg-code-token-punctuation: var(--mg-gray-400);
1757
+ }
package/website.css CHANGED
@@ -1,5 +1,5 @@
1
1
  /* ══════════════════════════════════════════════════════════════
2
- modelgo-design-tokens · website.css (4 个 token)
2
+ modelgo-design-tokens · website.css (25 个 token)
3
3
  官网(domestic/global)专用组件语义。可引用 base,不得引用 console。当前仅 4 个:官网组件层大部分仍在官网本地 src/styles 维护、尚未下沉(见 tokens.css 头部「SITE 官网语义层(占位)」一节)。
4
4
 
5
5
  ⚠️ 本文件由 scripts/split-tokens.mjs 从 tokens.css 生成,**不要手改**。
@@ -44,3 +44,80 @@
44
44
  [data-theme='dark'] {
45
45
  --mg-header-bg: #18181c;
46
46
  }
47
+
48
+ /* ── 其他通用 ── */
49
+ :root {
50
+ --mg-code-bg: var(--mg-gray-100);
51
+ --mg-code-text: var(--mg-gray-900);
52
+ }
53
+
54
+ /* 深色覆盖 */
55
+ [data-theme='dark'] {
56
+ --mg-code-bg: var(--mg-gray-900);
57
+ --mg-code-text: var(--mg-gray-100);
58
+ }
59
+
60
+ /* ══════════════════════════════════════════════════════════════
61
+ 第三条大道 · SITE 官网语义层
62
+ 官网(modelgo-web 国内 / modelgo-global-web 国际)专用组件语义 token。
63
+ 判层见 token-layers.json 的 websitePrefixes/overrides。
64
+
65
+ 首批下沉(2026-11-18,prd46#1970):CTA 按钮语义档 + 代码块高亮语义档,
66
+ 两组都照搬 modelgo-global-web 的现值,**未改任何设计值**(见 UNIFIED-UI-TOKEN.md §3 第 8 行)。
67
+ ══════════════════════════════════════════════════════════════ */
68
+
69
+ /* ── CTA 按钮语义档 ─────────────────────────────────────────────
70
+ 下沉自 modelgo-global-web src/styles/theme.css(原注释:
71
+ 「命名占用 --mg-* 前缀是为了跟令牌包对齐,待 modelgo-design-tokens
72
+ 收编 cta 档后删除本段、直接吃包里的值」——本次即收编)。
73
+
74
+ 国际站主/次 CTA 按 Figma 定的是白底黑字 / 黑底白字。黑白是无彩锚点、
75
+ 属于视觉身份,不是自留配色,故保留为国际站分档。
76
+ ⚠️ 国内站(data-market='china')的 CTA 档尚未定义,等设计给值后再补;
77
+ 在那之前国内站读到的是 --mg-cta-* 未定义(与下沉前行为一致)。 */
78
+ [data-market='global'] {
79
+ --mg-cta-primary-bg: #ffffff;
80
+ --mg-cta-primary-bg-hover: #f1f1f3;
81
+ --mg-cta-primary-bg-active: #e6e6ea;
82
+ --mg-cta-primary-fg: #0a0a0a;
83
+
84
+ --mg-cta-secondary-bg: #000000;
85
+ --mg-cta-secondary-bg-hover: #0a0a0a;
86
+ --mg-cta-secondary-bg-active: #050505;
87
+ --mg-cta-secondary-fg: #ffffff;
88
+ --mg-cta-secondary-border: rgba(255, 255, 255, 0.22);
89
+ }
90
+
91
+ /* ── 代码块高亮语义档 ───────────────────────────────────────────
92
+ 下沉自 modelgo-global-web …/models/detail/api-quick-call-modal.css。
93
+ 只定义 token,不在组件里写死 hex;组件统一用本组 token 取色(引用形式见 api-quick-call-modal.css)。
94
+
95
+ 浅色档取品牌深档,保证淡灰底上可读;深色档以绿为主(国际站常驻深色):
96
+ 关键字亮绿、函数浅绿、字符串薄荷绿,数字/常量用赭黄做唯一暖色点缀,
97
+ 注释与标点退到灰阶。
98
+
99
+ ⚠️ 灰阶用的是 Material 系(#202124 / #9aa0a6 / #6e7378),与本包
100
+ --mg-gray-* 的 Tailwind slate 系**不是同一套**,没有精确对应值,
101
+ 故照搬 hex 不做映射——映射即改值,需设计依据后单独收敛。 */
102
+ :root {
103
+ --mg-code-foreground: #202124;
104
+ --mg-code-token-keyword: var(--mg-brand-deep);
105
+ --mg-code-token-function: var(--mg-brand-base);
106
+ --mg-code-token-string: color-mix(in oklab, var(--mg-brand-deep) 80%, #202124);
107
+ --mg-code-token-string-expression: var(--mg-code-token-string);
108
+ --mg-code-token-link: var(--mg-code-token-string);
109
+ --mg-code-token-constant: var(--mg-warning);
110
+ --mg-code-token-parameter: #202124;
111
+ --mg-code-token-comment: #9aa0a6;
112
+ --mg-code-token-punctuation: #6e7378;
113
+ }
114
+ [data-theme='dark'] {
115
+ --mg-code-foreground: var(--mg-gray-300);
116
+ --mg-code-token-keyword: var(--mg-brand-mid);
117
+ --mg-code-token-function: var(--mg-brand-light);
118
+ --mg-code-token-string: color-mix(in oklab, var(--mg-brand-base) 62%, var(--mg-gray-100));
119
+ --mg-code-token-constant: var(--mg-warning);
120
+ --mg-code-token-parameter: var(--mg-gray-100);
121
+ --mg-code-token-comment: var(--mg-gray-500);
122
+ --mg-code-token-punctuation: var(--mg-gray-400);
123
+ }