modelgo-design-tokens 0.6.1 → 0.6.3

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.
Files changed (4) hide show
  1. package/README.md +41 -0
  2. package/USAGE.md +11 -0
  3. package/package.json +3 -1
  4. package/tokens.css +293 -21
package/README.md CHANGED
@@ -3,6 +3,10 @@
3
3
  ModelGo 四端(控制台 / 国内官网 / 国外官网 / 文档站)统一设计 token 的**单一真源**。
4
4
  纯 CSS 变量,框架无关——React / Astro / VitePress 都能用。
5
5
 
6
+ > 🎨 **在线看全部 token**:<https://modelgo-design-tokens.pages.dev>
7
+ > 147 个变量分组可视化、国内/海外 × 浅色/深色舒适/深色酷炫实时预览、顶栏标注当前版本号。
8
+ > 本地要**改值并写回**真源用 `pnpm preview`,见 [可视化查看 / 改值](#可视化查看--改值)。
9
+
6
10
  ## 为什么是 token 而不是组件
7
11
 
8
12
  四端技术栈不同(React·Vite / Astro / VitePress),跨框架共享「组件」几乎不可能;
@@ -63,6 +67,42 @@ Tailwind v4 的站点(国内官网)在 `@theme` 里映射即可:
63
67
 
64
68
  需要在某市场里**固定**显示另一市场色(极少见)才用 `--mg-brand-cn-*` / `--mg-brand-global-*`。
65
69
 
70
+ ## 可视化查看 / 改值
71
+
72
+ `tokens.css` 是给机器读的,肉眼比对 147 个变量、四种 market×theme 组合并不现实。
73
+ `preview/index.html` 是它的可视化面板:分组列出全部 token、实时预览组件效果、直接改值并写回真源。
74
+
75
+ ```bash
76
+ pnpm preview # → http://127.0.0.1:5177
77
+ ```
78
+
79
+ - **改值即所见**:改任意输入框,右侧组件预览立刻跟着变;`market` / `theme` 一键切换,
80
+ 看同一套 token 在国内 / 海外 × 浅色 / 深色舒适 / 深色酷炫下的样子。
81
+ - **深浅色分别可改**:同名变量在 `:root` / `[data-market]` / `[data-theme]` 各处的定义会聚合到一行,
82
+ 每处独立编辑,不用在文件里翻来翻去。
83
+ - **写回是按行精确替换**:只换值,注释、「待设计确认」标记、缩进原样保留;
84
+ 若文件被外部改过,保存会被拒绝并提示刷新,不会盲写。⌘S 保存,`/` 聚焦搜索。
85
+
86
+ ### 线上规范站
87
+
88
+ **<https://modelgo-design-tokens.pages.dev>** —— 给设计、产品、其他端开发看的只读规范站,
89
+ 顶栏徽章标出当前 token 版本号。发布:
90
+
91
+ ```bash
92
+ pnpm preview:deploy # → Cloudflare Pages 项目 modelgo-design-tokens,生产分支 main
93
+ ```
94
+
95
+ 发上去的是 `index.html` + 当次的 `tokens.css` + 精简 `package.json`(只留 name/version/description)。
96
+ 线上默认读同源那份 `tokens.css`,与发布时的仓库状态严格一致;顶栏也能切到「线上发布版」
97
+ 从 unpkg 拉当前 npm 上的最新版对照 —— 用来确认「已发布的包」和「仓库里的真源」有没有脱节。
98
+
99
+ `preview/index.html` 零依赖、零构建、单文件,丢到任何静态托管都能跑;
100
+ 若同源没有 `tokens.css`,它会自动降级去读 unpkg 上的已发布版本。
101
+
102
+ 线上站是**只读镜像**:可以试改、看效果、导出 diff 或下载改好的 `tokens.css`,但不能在线保存。
103
+ 这是刻意的 —— 真源只有仓库里这一份 `tokens.css`,改动一律回 git 落地。
104
+ 若线上也能存,就出现第二真源,SSOT 就破了。
105
+
66
106
  ## 用法规范
67
107
 
68
108
  值统一 ≠ 用法统一。怎么用见 [USAGE.md](./USAGE.md)(颜色/字阶/wordmark/按钮/层级的 do & don't)。
@@ -77,6 +117,7 @@ Tailwind v4 的站点(国内官网)在 `@theme` 里映射即可:
77
117
  | 圆角 | `--mg-radius-{xs,sm,md,lg,xl,pill}` | |
78
118
  | 间距 | `--mg-space-{1,2,3,4,6,8,12,section}` | |
79
119
  | 按钮 | `--mg-btn-{height,height-sm,pad-x,radius,text,weight}` | |
120
+ | 产品市场 UX | `--mg-text-market-title`、`--mg-tile-*`、`--mg-control-*`、`--mg-media-*` | 官网内容卡与高密度市场页的共同契约 |
80
121
  | 语义色 | `--mg-bg`, `--mg-bg-alt`, `--mg-text-{0,1,2}`, `--mg-border` | 按主题切 |
81
122
 
82
123
  ## 落地节奏(建议)
package/USAGE.md CHANGED
@@ -53,6 +53,17 @@ token 解决"值统一",这页解决"用法统一"——四端照同一套规则
53
53
  - 间距走 4px 节奏(`--mg-space-*`);区块/区段用 `--mg-space-block / -section` 保持纵向韵律一致。
54
54
  - 按钮统一 `--mg-btn-*`(高 36 / 字 13 / 胶囊);主按钮 `--mg-btn-gradient` + `--mg-btn-shadow`。
55
55
 
56
+ ## 产品市场页
57
+
58
+ 国内官网与控制台模型广场共用一套视觉语言,但信息密度不同。官网内容区使用舒展的 `card`,模型列表、筛选和配置类页面使用紧凑的 `tile`;不要用一个卡片样式覆盖两种场景。
59
+
60
+ - **官网内容卡**:`--mg-radius-card`、`--mg-space-card-pad`、`--mg-shadow-card`,用于专题、能力介绍和落地页内容。
61
+ - **高密度 tile**:`--mg-tile-*`,用于模型卡、筛选栏、目录列表等可扫描、可点击的信息块;hover 只使用 `--mg-tile-border-hover` 与 `--mg-tile-shadow-hover`。
62
+ - **工具栏**:输入、搜索和排序使用 `--mg-control-*`;默认高 `--mg-control-height`,需要承担搜索主入口时才用 `--mg-control-height-lg`。聚焦态统一 `box-shadow: var(--mg-focus-ring)`。
63
+ - **市场页标题**:`--mg-text-market-title` 只用于模型目录等市场型产品页;官网营销页继续使用 `--mg-text-h1` / `--mg-text-hero`,控制台普通页面继续使用其页面标题档。
64
+ - **图片 Banner**:业务侧必须提供真实图片,图片铺满容器;文字可读性只叠加 `--mg-media-panel-overlay`。无图片时不伪造渐变 Banner,应隐藏该推荐位或由产品提供兜底素材。
65
+ - **图片上的操作**:文字使用 `--mg-media-text` / `--mg-media-text-muted`,主操作使用 `--mg-media-action-*`。不要在图片上继续使用普通品牌实底按钮,避免与背景竞争。
66
+
56
67
  ## 图标
57
68
 
58
69
  - **UI 图标统一 Lucide**:官网用 `lucide-react`,控制台目前走 `react-icons/lu`(同一套 Lucide 字形)——新代码统一到 `lucide-react`,老代码可暂留。
package/package.json CHANGED
@@ -1,10 +1,12 @@
1
1
  {
2
2
  "name": "modelgo-design-tokens",
3
- "version": "0.6.1",
3
+ "version": "0.6.3",
4
4
  "description": "ModelGo 四端统一设计 token(CSS 变量,框架无关):品牌色阶 / 字体 / 字阶 / 圆角 / 间距 / 按钮。",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "scripts": {
8
+ "preview": "node scripts/preview.mjs",
9
+ "preview:deploy": "node scripts/preview-deploy.mjs",
8
10
  "release": "node scripts/release.mjs",
9
11
  "postpublish": "bash scripts/notify-release.sh"
10
12
  },
package/tokens.css CHANGED
@@ -23,15 +23,14 @@
23
23
  --mg-brand-cn-pale: #e8ecfd;
24
24
  --mg-brand-cn-purple: #223de5; /* 主色改蓝后辅助色统一为主蓝(原紫 #9c67ff 弃用) */
25
25
 
26
- /* 浅色基线 = emerald(白底可读,控制台/文档浅色用,与 modelgo-global-web 实测现行 --brand-base 一致);
27
- 深色变体 = 亮草绿 #68e657(见 [data-theme=dark],与 modelgo-global-web 实测暗色渐变一致,国外官网深色站主色) */
26
+ /* 海外品牌绿:光暗共用同一个值 #0F9F59(设计决定:不分深浅两套,见 [data-theme=dark] 同值) */
28
27
  --mg-brand-global-deep: #047857;
29
- --mg-brand-global-base: #059669;
30
- --mg-brand-global-base-rgb: 5, 150, 105;
28
+ --mg-brand-global-base: #0F9F59;
29
+ --mg-brand-global-base-rgb: 15, 159, 89;
31
30
  --mg-brand-global-mid: #10b981;
32
31
  --mg-brand-global-light: #34d399;
33
32
  --mg-brand-global-pale: #a7f3d0;
34
- --mg-brand-global-purple: #059669; /* 海外无辅助紫,回落品牌绿 */
33
+ --mg-brand-global-purple: #0F9F59; /* 海外无辅助紫,回落品牌绿 */
35
34
 
36
35
  /* 当前市场(默认 = 国内)。需要锁定某市场色时直接用 --mg-brand-cn-* / --mg-brand-global-* */
37
36
  --mg-brand-deep: var(--mg-brand-cn-deep);
@@ -42,10 +41,15 @@
42
41
  --mg-brand-pale: var(--mg-brand-cn-pale);
43
42
  --mg-brand-purple: var(--mg-brand-cn-purple);
44
43
  --mg-brand-blue: #385aff;
45
- /* 品牌渐变:提炼自 logo 的多段扫色(蓝 → 品牌基色靛/翠 → 紫),而非单调两段 */
46
- --mg-brand-gradient: linear-gradient(135deg, var(--mg-brand-blue) 0%, var(--mg-brand-base) 50%, var(--mg-brand-purple) 100%);
44
+ /* 品牌渐变:三段扫色。端点抽成 -from/-mid/-to,由 [data-market] 路由 ——
45
+ 此前端点写死 --mg-brand-blue(#385aff,不随市场切),海外绿主题下渐变
46
+ 会从蓝扫到绿,混进了不属于该市场的色相。 */
47
+ --mg-brand-gradient-from: var(--mg-brand-blue);
48
+ --mg-brand-gradient-mid: var(--mg-brand-base);
49
+ --mg-brand-gradient-to: var(--mg-brand-purple);
50
+ --mg-brand-gradient: linear-gradient(135deg, var(--mg-brand-gradient-from) 0%, var(--mg-brand-gradient-mid) 50%, var(--mg-brand-gradient-to) 100%);
47
51
  /* 柔和径向光晕版(用于品牌氛围点缀,不刺眼) */
48
- --mg-brand-gradient-soft: linear-gradient(135deg, color-mix(in oklab, var(--mg-brand-blue) 88%, white), var(--mg-brand-base), var(--mg-brand-purple));
52
+ --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));
49
53
 
50
54
  /* ── 中性灰阶(含基线在用的精确值;其余补标准 slate) ── */
51
55
  --mg-gray-50: #f8fafc; /* 基线 raised */
@@ -66,9 +70,16 @@
66
70
  --mg-error: #ef4444; /* 待设计确认 */
67
71
  --mg-info: #3b82f6; /* 待设计确认 */
68
72
 
69
- /* ── 字体族(字体文件各端自托管 @font-face) ── */
70
- --mg-font-sans: 'PingFang SC', 'HarmonyOS Sans SC', 'Noto Sans SC', -apple-system, 'Inter', sans-serif;
71
- --mg-font-heading: 'PingFang SC', 'HarmonyOS Sans SC', 'Inter', -apple-system, sans-serif;
73
+ /* ── 字体族(字体文件各端自托管 @font-face) ──
74
+ 2026-08-06 需求方定:拉丁 Inter 优先,全端统一。
75
+ 此前规范是 PingFang 优先,而控制台自持一套 Inter 优先并注释「故意不收敛 SSOT」,
76
+ 导致同一个「推荐排序」在规范预览页与控制台里西文/数字长得不一样。本次以控制台
77
+ 那一档为准收敛到规范,控制台随后删除自持声明改引本 token。
78
+ 中文两者都落 PingFang SC(Inter 无 CJK 字形),差异只在西文与数字。
79
+ 例外:国内官网首页 / 企业治理 / 推荐计划三页按需求方要求维持原字形,
80
+ 由官网在各自根容器上覆盖 --font-sans,不在本规范开口子。 */
81
+ --mg-font-sans: 'Inter', 'PingFang SC', 'MiSans', 'HarmonyOS Sans SC', 'Microsoft YaHei', system-ui, sans-serif;
82
+ --mg-font-heading: 'Inter', 'PingFang SC', 'MiSans', 'HarmonyOS Sans SC', 'Microsoft YaHei', system-ui, sans-serif;
72
83
  --mg-font-mono: 'JetBrains Mono', 'Fira Code', 'Consolas', monospace;
73
84
  --mg-font-brand-latin: 'ModelGo Latin A';
74
85
  --mg-font-brand-cjk: 'ModelGo Chinese A';
@@ -101,6 +112,32 @@
101
112
  --mg-text-xs-line: 1.5;
102
113
  --mg-text-xs-tracking: 0.01em;
103
114
 
115
+ /* ── 渲染因素(2026-08-06 补:此前只定义了族/字阶/字重,但同一份字体在不同
116
+ 渲染设置下观感差别很大,缺了这几项就会出现「字体明明一样却看着不对」)── */
117
+
118
+ /* 抗锯齿:macOS 上 antialiased 明显更细、auto(次像素)更实。
119
+ 产品端一律 auto —— 消费方都没设,规范如实沿用,别在预览里偷偷加 antialiased。 */
120
+ --mg-font-smoothing: auto;
121
+
122
+ /* 数字:等宽数位。价格/用量/账单这类会跳动或需要竖排对齐的数字必须用,
123
+ 否则 1 比其他数字窄,列表滚动时数字会左右抖。 */
124
+ --mg-numeric-tabular: tabular-nums;
125
+ --mg-numeric-proportional: proportional-nums;
126
+
127
+ /* 中英混排:CJK 与西文之间的自动间隙。CJK 正文开启可读性更好,
128
+ 但会影响精确对齐的场景(表格数字列),故给出两档由消费方选。 */
129
+ --mg-text-autospace-on: normal;
130
+ --mg-text-autospace-off: no-autospace;
131
+
132
+ /* 字距补充档(原来只有 h1/h2/h3/xs 有,body/sm 缺,导致消费方各写各的) */
133
+ --mg-text-body-tracking: normal;
134
+ --mg-text-sm-tracking: normal;
135
+
136
+ /* 断行:中文不该按西文规则断词;长 API ID / 模型名需要能断 */
137
+ --mg-word-break-cjk: normal;
138
+ --mg-word-break-id: break-all;
139
+ --mg-line-break-cjk: strict;
140
+
104
141
  /* ── 圆角(基线:card20 / code16 / tag8 / btn999 + 通用 8/14/18) ── */
105
142
  --mg-radius-sm: 8px;
106
143
  --mg-radius-md: 14px;
@@ -156,15 +193,78 @@
156
193
  --mg-btn-weight: var(--mg-weight-bold);
157
194
  --mg-btn-bg: var(--mg-brand-base); /* 国内官网现行:实心主色底(breeze 风,非渐变) */
158
195
  --mg-btn-bg-hover: var(--mg-brand-deep); /* hover / pressed 深色(CN #0622c9;随市场切) */
159
- --mg-btn-gradient: linear-gradient(135deg, var(--mg-brand-blue) 0%, var(--mg-brand-base) 55%, var(--mg-brand-purple) 100%); /* 可选渐变变体 */
196
+ --mg-btn-gradient: linear-gradient(135deg, var(--mg-brand-gradient-from) 0%, var(--mg-brand-gradient-mid) 55%, var(--mg-brand-gradient-to) 100%); /* 可选渐变变体,端点同 --mg-brand-gradient 随市场切 */
160
197
  --mg-btn-shadow: 0 2px 12px color-mix(in oklab, var(--mg-brand-base) 25%, transparent);
161
198
 
199
+ /* ── 产品市场 UX:官网内容卡 + 高密度信息 tile + 工具栏 + 图片 Banner ──
200
+ 设计依据:2026-08 国内官网改版与控制台模型广场。官网保留舒展的 card,
201
+ 模型列表/筛选等高频信息区使用更紧凑的 tile;二者不混用。 */
202
+ --mg-text-market-title: 34px;
203
+ --mg-text-market-title-line: 1.5;
204
+ /* -0.025em = Tailwind tracking-tight,控制台模型广场 h1 实际在用的值
205
+ (catalog/index.tsx:318)。原为 -0.01em,与消费方不符且本 token 除预览页
206
+ 无其他消费方,故对齐到实际值。 */
207
+ --mg-text-market-title-tracking: -0.025em;
208
+
209
+ /* 2026-08-06:tile / control 的表面并入玻璃系统 —— 原来指向 --mg-surface(实色),
210
+ 和玻璃画布放一起就是"卡片是实心的、背景是玻璃的"两套语言。
211
+ 指向 --mg-glass-* 后,四象限(浅/深 × 蓝/绿)自动跟随,页面不必各写一遍。
212
+ 注意:blur 不能由变量自己生效,消费方要写
213
+ backdrop-filter: blur(var(--mg-glass-blur)),或直接挂 .mg-glass 工具类。 */
214
+ --mg-tile-bg: var(--mg-glass-surface);
215
+ --mg-tile-border: var(--mg-glass-line);
216
+ --mg-tile-border-hover: color-mix(in oklab, var(--mg-brand-base) 24%, var(--mg-border));
217
+ --mg-tile-radius: var(--mg-radius-md);
218
+ --mg-tile-pad: var(--mg-space-4);
219
+ --mg-tile-gap: var(--mg-space-3);
220
+ --mg-tile-shadow: var(--mg-shadow-card);
221
+ --mg-tile-shadow-hover: var(--mg-shadow-card-hover);
222
+
223
+ --mg-control-height: 40px;
224
+ --mg-control-height-lg: 48px;
225
+ --mg-control-pad-x: var(--mg-space-4);
226
+ --mg-control-radius: var(--mg-radius-md);
227
+ --mg-control-bg: var(--mg-glass-surface);
228
+ --mg-control-border: var(--mg-glass-line);
229
+ --mg-control-border-hover: var(--mg-border-hover);
230
+
231
+ --mg-media-panel-radius: var(--mg-radius-lg);
232
+ --mg-media-panel-overlay: linear-gradient(90deg, rgba(0, 0, 0, 0.68) 0%, rgba(0, 0, 0, 0.38) 46%, rgba(0, 0, 0, 0.08) 100%);
233
+ --mg-media-text: #ffffff;
234
+ --mg-media-text-muted: rgba(255, 255, 255, 0.8);
235
+ --mg-media-action-bg: #ffffff;
236
+ --mg-media-action-text: var(--mg-brand-deep);
237
+ --mg-media-action-border: rgba(255, 255, 255, 0.45);
238
+
162
239
  /* ── 图标(库已统一:UI=Lucide,品牌/厂商=@lobehub/icons;这里统一尺寸与线宽) ── */
163
240
  --mg-icon-xs: 14px;
164
241
  --mg-icon-sm: 16px;
165
242
  --mg-icon-md: 20px;
166
243
  --mg-icon-lg: 24px;
167
244
  --mg-icon-stroke: 2; /* Lucide 默认描边宽 */
245
+
246
+ /* ── 厂商/模型 logo 图标(@lobehub/icons,经 console ModelIcon 组件统一渲染)──
247
+ 尺寸原样固化自 console 现有 9 个调用点,按场景命名,不做人为合并:
248
+ 模型广场/详情页/对比/Playground/选择器/Dashboard/用量分析/任务列表各自的密度不同,
249
+ 强行收敛成一套 t-shirt 档位会在 1~2px 差异处产生看不出理由的视觉变化。
250
+ 圆角复用 --mg-radius-sm/md/lg/pill(对应 rounded-sm/md/lg/full),不新开一套。
251
+ 独立展示容器(模型广场卡片头像、详情页 Hero、相关模型卡片):
252
+ 背景 --mg-bg-1 + 1px solid --mg-border;
253
+ 行内裸露场景(Playground 模型条、任务列表、用量分析行首):不加背景与描边。 */
254
+ --mg-logo-size-dense: 18px; /* 任务列表行内 / 对比表头迷你图标 */
255
+ --mg-logo-size-inline: 22px; /* 用量分析行首 / 相关模型卡片 */
256
+ --mg-logo-size-compact: 24px; /* 对比弹窗 / Dashboard 排行榜 */
257
+ --mg-logo-size-row: 28px; /* 体验对话消息头像 */
258
+ --mg-logo-size-picker: 30px; /* 模型选择器 Dialog 列表行 */
259
+ --mg-logo-size-bar: 32px; /* Playground / 对比模式模型条 */
260
+ --mg-logo-size-card: 38px; /* 模型广场卡片(最常见的卡片图标) */
261
+ --mg-logo-size-panel: 40px; /* 模型选择器 Dialog 详情面板 */
262
+ --mg-logo-size-hero: 48px; /* 模型详情页 Hero */
263
+
264
+ /* logo 与相邻文字的行内间距:卡片级更松,紧凑行内更紧 */
265
+ --mg-logo-gap-xs: 6px; /* 任务列表 / Dashboard 排行等紧凑行 */
266
+ --mg-logo-gap-sm: 7px; /* 相关模型卡片头 */
267
+ --mg-logo-gap-md: 10px; /* 模型广场卡片顶行 / 选择器行 / Playground 触发按钮 */
168
268
  }
169
269
 
170
270
  /* ═══════════════════════ 2) SEMANTIC 语义(引用原子,浅色默认) ═══════════════════════ */
@@ -176,7 +276,16 @@
176
276
 
177
277
  --mg-bg: #ffffff; /* 页面 纯白(国内官网现行 breeze 风:白页面 + 灰卡片) */
178
278
  --mg-bg-alt: #f8f7ff; /* 交替块(极浅冷调) */
179
- --mg-surface: #f2f2f6; /* 卡片 breeze 浅灰(在白页面上区分内容块) */
279
+ /* 卡片面 —— 2026-08-06 起并入玻璃系统(这是"卡片颜色"的真源,
280
+ 控制台 --mg-bg-0 / --card-bg 与官网都指向它,改这里才是全站一次生效)。
281
+ 只改「卡片」这一层:--mg-surface-2/3 是 Dropdown / Modal / Tooltip,
282
+ 它们浮在内容之上、背后没有画布可透,必须保持不透明,否则文字会重叠穿帮。 */
283
+ --mg-surface: var(--mg-glass-surface);
284
+ /* 混合专用的实色卡片面。--mg-surface 并入玻璃后是半透明,任何
285
+ color-mix(… , var(--mg-surface)) 的结果都会带上透明度 —— 品牌色会直接透出来
286
+ (2026-08-06 踩过:--brand-pale 混完变成紫色渐变,模型体验输入框整块发紫)。
287
+ 需要"卡片色但必须不透明"的场景(色阶混合、图表底、遮罩)用这个。 */
288
+ --mg-surface-solid: #f2f2f6;
180
289
  --mg-surface-2: #f8fafc; /* 抬升面 / Dropdown(比卡片更亮,配阴影表达抬升) */
181
290
  --mg-surface-3: #ffffff; /* 顶层面板 Modal/Tooltip(白 + 阴影) */
182
291
  --mg-code: var(--mg-gray-950); /* 代码块底 */
@@ -196,9 +305,39 @@
196
305
  --mg-brand-selected-bg: color-mix(in oklab, var(--mg-brand-base) 8%, transparent); /* 选中态底色 */
197
306
  --mg-success-subtle: color-mix(in oklab, var(--mg-success) 12%, transparent);
198
307
 
199
- --mg-glass-tint: #ffffff;
200
- --mg-glass-blur: 18px;
201
- --mg-header-bg: rgba(255, 255, 255, 0.72); /* 基线 */
308
+ /* ══════════════════════════════════════════════════════════════
309
+ 玻璃系统(GLASS)—— 四端通用,页面只引 token / 工具类,不写死色值。
310
+ 覆盖两根轴:主题 [data-theme] × 市场 [data-market],共四象限。
311
+ 浅色蓝 = 本块;其余三档在文件下方各自的 [data-theme] / [data-market] 块里。
312
+
313
+ 为什么覆膜色统一用白、只改比例:
314
+ 深色下玻璃不是"更黑的面",而是暗底上的一层淡白薄膜(现实里的磨砂玻璃也是
315
+ 反射环境光而不是变暗)。早先试过把 tint 在深色切成 #1c1c22 让 surface 自动
316
+ 跟随 —— 结果是暗面压暗底,玻璃感直接消失。所以 veil 恒为白,靠 alpha 分档。
317
+
318
+ grain(磨砂)单列两个变量而不是写死:浅底要 overlay(同时提亮高光、压出暗粒),
319
+ 暗底 overlay 会过冲,得换 soft-light 并降强度。
320
+ ══════════════════════════════════════════════════════════════ */
321
+ --mg-glass-veil: #ffffff; /* 玻璃覆膜色:四档恒为白,只改 alpha */
322
+ --mg-glass-blur: 18px; /* 统一模糊半径 */
323
+
324
+ --mg-glass-surface: color-mix(in oklab, var(--mg-glass-veil) 70%, transparent);
325
+ --mg-glass-surface-strong: color-mix(in oklab, var(--mg-glass-veil) 84%, transparent);
326
+ --mg-glass-header: color-mix(in oklab, var(--mg-glass-veil) 30%, transparent);
327
+ --mg-glass-line: #dadff3;
328
+ --mg-glass-header-edge: rgba(241, 247, 255, 0.4); /* 40%:实色 2px 太硬,压到四成只留一道亮痕 */
329
+
330
+ /* 页面画布:整屏渐变,四象限各一条(设计定稿 2026-08-06:蓝 #B4CDEA → #E7F4FF) */
331
+ --mg-glass-canvas: linear-gradient(180deg, #bed4ef 0%, #e7f4ff 100%);
332
+
333
+ /* 磨砂颗粒 */
334
+ --mg-glass-grain-opacity: 0.5;
335
+ --mg-glass-grain-blend: overlay;
336
+
337
+ /* 兼容旧名(早期草稿用过 --mg-glass-tint / --mg-app-bg),指向新名,勿新增引用 */
338
+ --mg-glass-tint: var(--mg-glass-veil);
339
+ --mg-app-bg: var(--mg-glass-canvas);
340
+
202
341
  --mg-overlay: rgba(15, 23, 42, 0.5);
203
342
 
204
343
  --mg-shadow-card: 0 1px 3px rgba(0, 0, 0, 0.06); /* 基线 */
@@ -208,6 +347,12 @@
208
347
 
209
348
  /* ═══════════════════════ 3) MARKET 市场覆盖:当前市场指向 global 色阶 ═══════════════════════ */
210
349
  [data-market='global'] {
350
+ /* 玻璃:只换画布与描边的色相(蓝→翠),veil/alpha/模糊/颗粒四档共用,
351
+ 所以海外站不需要单独维护一套玻璃逻辑,只是画布换色。 */
352
+ --mg-glass-canvas: linear-gradient(180deg, #b7e0cd 0%, #e7fbf2 100%);
353
+ --mg-glass-line: #cfe6db;
354
+ --mg-glass-header-edge: rgba(238, 250, 244, 0.4);
355
+
211
356
  --mg-brand-deep: var(--mg-brand-global-deep);
212
357
  --mg-brand-base: var(--mg-brand-global-base);
213
358
  --mg-brand-base-rgb: var(--mg-brand-global-base-rgb);
@@ -215,6 +360,16 @@
215
360
  --mg-brand-light: var(--mg-brand-global-light);
216
361
  --mg-brand-pale: var(--mg-brand-global-pale);
217
362
  --mg-brand-purple: var(--mg-brand-global-purple);
363
+
364
+ /* 渐变:同色相内由亮翠收敛到主色,不往深里压。
365
+ 设计依据:2026-08-06 需求方指定 #16C76E → #0F9F59(先要求「不要有蓝色」,
366
+ 再否掉了第一版的明度阶写法——亮→深跨度大显生硬)。
367
+ -from/-mid 用字面值而非绿色阶变量:深色主题会重定义 --mg-brand-global-mid/deep,
368
+ 跟着走的话浅色深色就是两条不同的渐变;需求方要求两者统一,故钉死。
369
+ -mid 取两端中点,使三段结构渲染结果等同于原始的两段渐变。 */
370
+ --mg-brand-gradient-from: #16c76e;
371
+ --mg-brand-gradient-mid: #13b364;
372
+ --mg-brand-gradient-to: var(--mg-brand-global-base);
218
373
  }
219
374
 
220
375
  /* ═══════════════════════ 深色主题 —— 两套深色系 ═══════════════════════
@@ -223,7 +378,7 @@
223
378
  * 两套共用品牌原子(提亮,暗底可读);bg/文字/语义/阴影各一套。深色 ≠ 纯黑。
224
379
  * ═══════════════════════════════════════════════════════════════════ */
225
380
 
226
- /* 品牌色深色变体(两套深色共用):CN 提亮靛蓝、global 亮草绿 #68e657(与 modelgo-global-web 实测一致) */
381
+ /* 品牌色深色变体(两套深色共用):CN 提亮靛蓝、global 与浅色同值 #0F9F59 */
227
382
  [data-theme='dark'],
228
383
  [data-theme='dark-showcase'] {
229
384
  --mg-brand-cn-deep: #223de5;
@@ -233,8 +388,8 @@
233
388
  --mg-brand-cn-light: #bcd2fb;
234
389
  --mg-brand-cn-pale: #16224d;
235
390
  --mg-brand-global-deep: #34a52a;
236
- --mg-brand-global-base: #68e657;
237
- --mg-brand-global-base-rgb: 104, 230, 87;
391
+ --mg-brand-global-base: #0F9F59;
392
+ --mg-brand-global-base-rgb: 15, 159, 89;
238
393
  --mg-brand-global-mid: #8aec7d;
239
394
  --mg-brand-global-light: #b6f5ad;
240
395
  --mg-brand-global-pale: #1b2921;
@@ -248,7 +403,8 @@
248
403
  --mg-text-4: #52525b; /* 禁用 zinc-600 */
249
404
  --mg-bg: #18181c; /* 页面 暖炭灰(不过黑不过闷) */
250
405
  --mg-bg-alt: #1f1f25;
251
- --mg-surface: #232329; /* 卡片 稍亮炭灰 */
406
+ --mg-surface: var(--mg-glass-surface); /* 卡片并入玻璃(深色档 veil 7%) */
407
+ --mg-surface-solid: #232329;
252
408
  --mg-surface-2: #2e2e36; /* 悬浮 Dropdown */
253
409
  --mg-surface-3: #3b3b44; /* 顶层 Modal/Tooltip */
254
410
  --mg-border: rgba(255, 255, 255, 0.08);
@@ -261,6 +417,21 @@
261
417
  --mg-error: #c98b85; /* 陶土红 */
262
418
  --mg-info: #8aa0c4; /* 雾霾蓝 */
263
419
  --mg-glass-tint: #1c1c22;
420
+ /* 毛玻璃深色档:设计只给了浅色值,这里按同一构图关系推——
421
+ 浅色「冷调浅蓝渐变 + 高透白玻璃」→ 深色「冷调炭灰渐变 + 低透暗玻璃」。
422
+ surface / surface-strong / header 三个不用重写:它们是 color-mix(tint …),
423
+ tint 已切成暗值,透明度关系原样成立。只覆盖不能靠 tint 推导的三个。 */
424
+ /* 玻璃(深色·舒适):veil 仍是白,只把 alpha 从 50/72/30 压到 7/12/5 ——
425
+ 暗底上的玻璃是一层淡白薄膜,不是更暗的面。画布也必须是渐变而非纯色,
426
+ 否则磨砂和玻璃都没有明暗可依附(此前深色就是纯色 #101827,玻璃感全失)。 */
427
+ --mg-glass-surface: color-mix(in oklab, var(--mg-glass-veil) 7%, transparent);
428
+ --mg-glass-surface-strong: color-mix(in oklab, var(--mg-glass-veil) 12%, transparent);
429
+ --mg-glass-header: color-mix(in oklab, var(--mg-glass-veil) 5%, transparent);
430
+ --mg-glass-canvas: linear-gradient(180deg, #1b2231 0%, #14161d 100%);
431
+ --mg-glass-line: rgba(255, 255, 255, 0.10);
432
+ --mg-glass-header-edge: rgba(255, 255, 255, 0.4);
433
+ --mg-glass-grain-opacity: 0.34;
434
+ --mg-glass-grain-blend: soft-light;
264
435
  --mg-header-bg: rgba(24, 24, 28, 0.85);
265
436
  --mg-overlay: rgba(0, 0, 0, 0.55);
266
437
  --mg-shadow-card: 0 1px 2px rgba(0, 0, 0, 0.35);
@@ -276,7 +447,8 @@
276
447
  --mg-text-4: #5a5a68;
277
448
  --mg-bg: #0d0d11; /* 页面 近黑 */
278
449
  --mg-bg-alt: #111118;
279
- --mg-surface: #0c0d10; /* 卡片 */
450
+ --mg-surface: var(--mg-glass-surface); /* 卡片并入玻璃(酷炫档 veil 5%) */
451
+ --mg-surface-solid: #0c0d10;
280
452
  --mg-surface-2: #141517; /* 悬浮 */
281
453
  --mg-surface-3: #1c1d20; /* 顶层 */
282
454
  --mg-border: rgba(255, 255, 255, 0.1);
@@ -291,6 +463,16 @@
291
463
  --mg-brand-glow: color-mix(in oklab, var(--mg-brand-base) 28%, transparent); /* 凸显主题色:加强光晕 */
292
464
  --mg-brand-subtle: color-mix(in oklab, var(--mg-brand-base) 10%, transparent);
293
465
  --mg-glass-tint: #000000;
466
+ /* 酷炫档:近黑页底,玻璃面更暗、描边更亮一点以保住边界 */
467
+ /* 玻璃(深色·酷炫):近黑底,薄膜再降一档、描边再提一点保住边界 */
468
+ --mg-glass-surface: color-mix(in oklab, var(--mg-glass-veil) 5%, transparent);
469
+ --mg-glass-surface-strong: color-mix(in oklab, var(--mg-glass-veil) 9%, transparent);
470
+ --mg-glass-header: color-mix(in oklab, var(--mg-glass-veil) 4%, transparent);
471
+ --mg-glass-canvas: linear-gradient(180deg, #0f1622 0%, #090b0f 100%);
472
+ --mg-glass-line: rgba(255, 255, 255, 0.13);
473
+ --mg-glass-header-edge: rgba(255, 255, 255, 0.4);
474
+ --mg-glass-grain-opacity: 0.28;
475
+ --mg-glass-grain-blend: soft-light;
294
476
  --mg-header-bg: rgba(13, 13, 17, 0.85);
295
477
  --mg-overlay: rgba(0, 0, 0, 0.6);
296
478
  --mg-shadow-card: 0 2px 8px rgba(0, 0, 0, 0.4);
@@ -308,3 +490,93 @@
308
490
  --mg-bp-xl: 1280px;
309
491
  --mg-bp-2xl: 1536px;
310
492
  }
493
+
494
+ /* ═══════════════════════ 玻璃系统 · 第四象限 + 通用工具类 ═══════════════════════ */
495
+
496
+ /* 深色 × 海外绿:前面三档已覆盖 浅蓝 / 浅绿 / 深蓝,这里补 深绿。
497
+ 薄膜与颗粒沿用深色档,只换画布与描边色相。 */
498
+ [data-theme='dark'][data-market='global'],
499
+ [data-theme='dark'] [data-market='global'] {
500
+ --mg-glass-canvas: linear-gradient(180deg, #16241f 0%, #111614 100%);
501
+ --mg-glass-line: rgba(255, 255, 255, 0.10);
502
+ }
503
+ [data-theme='dark-showcase'][data-market='global'],
504
+ [data-theme='dark-showcase'] [data-market='global'] {
505
+ --mg-glass-canvas: linear-gradient(180deg, #0c1712 0%, #080b09 100%);
506
+ --mg-glass-line: rgba(255, 255, 255, 0.13);
507
+ }
508
+
509
+ /* ── 通用工具类:页面挂类名即可,不再各自写玻璃 CSS ──────────────────
510
+ .mg-glass-canvas 给页面外壳:整屏固定画布 + 磨砂颗粒(::before)
511
+ .mg-glass 给卡片 / 控件 / 浮层:玻璃面 + 描边 + 模糊
512
+ .mg-glass-strong 需要更实的场景(浮层、滚动态顶栏)
513
+ 四象限的差异全部由上面的 token 承担,这两个类不含任何主题判断。 */
514
+ .mg-glass-canvas {
515
+ position: relative;
516
+ isolation: isolate;
517
+ background: var(--mg-glass-canvas);
518
+ background-attachment: fixed;
519
+ }
520
+
521
+ /* 磨砂本体:feTurbulence 高频细噪,160px 无缝平铺。
522
+ 用 SVG 噪声而不是多层 radial-gradient —— 后者是"斑点",前者才是玻璃表面的细颗粒。
523
+ 刻意不加 backdrop-filter:那会把背后一切糊一层,浅底上呈灰翳(试过,显脏)。 */
524
+ .mg-glass-canvas::before {
525
+ content: '';
526
+ /* absolute 不是 fixed:fixed 会脱离这个容器、铺满整个视口 ——
527
+ 页面外壳上看不出区别(它本来就占满屏),但只要有人把这个类用在
528
+ 一个局部块上(比如 token 预览页的演示卡),磨砂就会蒙住整页。
529
+ absolute + 容器 position: relative,范围才被限制在容器内。 */
530
+ position: absolute;
531
+ inset: 0;
532
+ z-index: 0;
533
+ pointer-events: none;
534
+ /* 噪声链三步,缺一不可:
535
+ feTurbulence 出高频细噪(baseFrequency 0.7:比 0.85 粗一档,浅底上才看得出)
536
+ feColorMatrix saturate=0 去色 —— 原始 turbulence 是彩色噪点,overlay 到浅底上
537
+ 互相中和,看着"有一层雾但没有颗粒",这是之前看不清的主因
538
+ feComponentTransfer 拉对比(linear slope>1)—— 去色后噪点集中在中灰,
539
+ 不拉开的话 overlay 几乎不产生明暗差 */
540
+ background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='160' height='160'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='4' stitchTiles='stitch'/%3E%3CfeColorMatrix type='saturate' values='0'/%3E%3CfeComponentTransfer%3E%3CfeFuncR type='linear' slope='2.6' intercept='-0.8'/%3E%3CfeFuncG type='linear' slope='2.6' intercept='-0.8'/%3E%3CfeFuncB type='linear' slope='2.6' intercept='-0.8'/%3E%3C/feComponentTransfer%3E%3C/filter%3E%3Crect width='160' height='160' filter='url(%23n)'/%3E%3C/svg%3E");
541
+ background-size: 160px 160px;
542
+ mix-blend-mode: var(--mg-glass-grain-blend);
543
+ opacity: var(--mg-glass-grain-opacity);
544
+ }
545
+
546
+ /* 刻意不写 .mg-glass-canvas > * { position: relative } ——
547
+ 那会把子元素的 position 一律改成 relative,Tailwind 的 sticky 顶栏会被顶掉、
548
+ 导航不再置顶(2026-08-06 踩过)。改用 ::before 的 z-index: -1 + 本容器
549
+ isolation: isolate,内容天然在磨砂之上,不必碰任何子元素。 */
550
+
551
+ /* 导航条:顶栏专用的一档玻璃(比卡片更透,底部一条 2px 亮边勾勒)。
552
+ 写成工具类而不是让各外壳自己覆盖 —— 此前 /models 走 PublicShell 的定向覆盖、
553
+ /models/playground 走 DashboardHeader 组件自带的 Tailwind,两套写死值,
554
+ 页面一切换导航就换脸。挂这个类后两处同源。 */
555
+ .mg-glass-bar {
556
+ background: var(--mg-glass-header);
557
+ border-bottom: 2px solid var(--mg-glass-header-edge);
558
+ -webkit-backdrop-filter: blur(var(--mg-glass-blur)) saturate(1.15);
559
+ backdrop-filter: blur(var(--mg-glass-blur)) saturate(1.15);
560
+ }
561
+
562
+ /* 滚动后需要更实一点(内容从下面穿过时保证可读) */
563
+ .mg-glass-bar-strong {
564
+ background: var(--mg-glass-surface-strong);
565
+ border-bottom: 2px solid var(--mg-glass-header-edge);
566
+ -webkit-backdrop-filter: blur(var(--mg-glass-blur)) saturate(1.15);
567
+ backdrop-filter: blur(var(--mg-glass-blur)) saturate(1.15);
568
+ }
569
+
570
+ .mg-glass {
571
+ background: var(--mg-glass-surface);
572
+ border: 1px solid var(--mg-glass-line);
573
+ -webkit-backdrop-filter: blur(var(--mg-glass-blur)) saturate(1.15);
574
+ backdrop-filter: blur(var(--mg-glass-blur)) saturate(1.15);
575
+ }
576
+
577
+ .mg-glass-strong {
578
+ background: var(--mg-glass-surface-strong);
579
+ border: 1px solid var(--mg-glass-line);
580
+ -webkit-backdrop-filter: blur(var(--mg-glass-blur)) saturate(1.15);
581
+ backdrop-filter: blur(var(--mg-glass-blur)) saturate(1.15);
582
+ }