modelgo-design-tokens 0.11.1 → 0.13.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
@@ -4,6 +4,29 @@
4
4
 
5
5
  ### Fixed
6
6
 
7
+ - **`check:usage` 的 baseline key 在 worktree 里会带上 worktree 名,导致 baseline 整体失配**
8
+ (工具改动,不影响任何 token 值)。`displayPath` 原先优先按「工作区根」算相对路径,
9
+ 于是消费方在自己仓的 worktree 里跑时,key 变成
10
+ `modelgo-console-web/.claude/worktrees/<名>/src/...` —— 换个 worktree 名、或回主检出跑,
11
+ **每一处存量都会被当成新增违规**,baseline 直接失效。
12
+ 改为优先按 cwd 算:消费方在自己仓根跑(扫 `src`)时 key 恒为 `src/...`,主检出与任意
13
+ worktree 通用;上游扫兄弟仓时 cwd 在本仓、相对路径以 `..` 开头,自动退回工作区根,
14
+ 仍得到 `modelgo-console-web/src/...`,上游 baseline 不受影响。两种场景均已实测。
15
+
16
+ > 2026-08-24 接入 console-web 时踩到,当时靠调用侧显式传 `MODELGO_WORKSPACE` 绕过。
17
+ > 本次修根因,**下游不必再关心这个环境变量**(已设的留着也无害)。
18
+
19
+ ### Changed
20
+
21
+ - **收口 `token-usage-baseline.json`:402 → 320 处**(144 → 124 个组合)。
22
+ console-web 清掉 63 处硬编码(27 处 `cubic-bezier` 换 `--mg-ease-*`、36 处
23
+ `border-radius` px 换 `--mg-radius-*`)后,baseline 虚高 82 处 —— 虚高等于凭空给出
24
+ 免罚额度,那个区间内的新增抓不到,门禁被静默削弱。存量减少后必须收口。
25
+
26
+ ## 0.11.1
27
+
28
+ ### Fixed
29
+
7
30
  - **`check:usage` 修掉静默假绿,并补齐覆盖范围**(工具改动,不影响任何 token 值,
8
31
  消费方无需升级即可用)。三个叠在一起的问题:
9
32
  1. **找不到扫描目标时静默通过。** 原实现 `.filter(existsSync)` 把不存在的目标直接丢掉,
@@ -26,6 +49,115 @@
26
49
  所以**它至今没有自动触发点**。要真正拦住下游新增硬编码,得在各端自己的提交期调用它。
27
50
  详见 TOKEN-GOVERNANCE.md §6.1。
28
51
 
52
+ ### Changed
53
+
54
+ - **弹窗宽度改回三档固定值,撤回 0.10.0 的「不分档」定案**(qa#611 ③ 改判)。新增
55
+ `--mg-dialog-width-sm/-md/-lg`(400/520/720px),`--mg-dialog-width` 短名指向 `-md`。
56
+ - **不是重新拍一遍,是把控制台已经跑通的分类收编成真源**:console-web 的
57
+ `Modal.tsx` 早就有一套 `SIZE_MAP`(sm 400 / md 520 / lg 720),且经过一次真实调整
58
+ (`114c3de0`:sm 底宽 360→400,消除小弹窗「小气」感)。本仓 0.10.0 时定的「不分档,
59
+ 内容在 min/max 之间自适应」和控制台的实际做法从一开始就没对上——控制台 100% 的
60
+ 弹窗走 `Modal.tsx`,没有一个是靠 min/max 自适应出来的。
61
+ - 判据是**内容类型**,不是量出来的宽度:`sm` 纯确认框(短提示 + 按钮,无表单字段)、
62
+ `md` 默认内容型表单/公告、`lg` 复杂多区(多个独立信息块/步骤)。
63
+ - `--mg-dialog-min-width` / `-max-width` 保留作区间兜底,不是被三档取代:极少数有正当
64
+ 理由跳出三档的弹窗(如需要并排多列的对比工具,实测 1024px)继续按内容定制宽度。
65
+ - 待消费方接入:`Dialog.tsx` 目前仍是 `w-full max-w-lg`(512px 硬编码),`Modal.tsx` 的
66
+ `SIZE_MAP` 三个值虽与本次定的数值完全相同、但仍是硬编码 Tailwind class,没有引用本仓
67
+ token——升级后把 `SIZE_MAP` 改成引用 `var(--mg-dialog-width-sm/-md/-lg)`,视觉上零变化
68
+ (数值本来就一样),只是把值的归属收回真源。
69
+
70
+ - **图表分类色纳入对比度门禁 + 定案两处不达标值**(qa#672,UI 侧定案)。
71
+ `contrast-contract.json` 补 `--mg-chart-cat-1..6` 六条 rules,`need: 3`,`on: @backdrops`
72
+ ——此前既不在 `rules` 也不在 `exempt`,是契约空白,改图表色一直没有客观判据。
73
+ - **cat-2 浅色**:`#1baf7a` → `#17976a`。四个浅色底一起判才发现最差的是
74
+ `--mg-surface-solid`(`#f2f2f6`,2.52:1),不是 `--mg-bg`——按单底估算会漏掉这项。
75
+ L 降 5.5pt,四底最低 margin 3.09:1。
76
+ - **cat-3 浅色不改值**:`#eda100` 实测 1.94,压到 3:1 需降 L 7.6pt、金黄会明显偏土黄,
77
+ 按 74b6676 立的「达标取最小改动、不以牺牲观感换数字」原则不改。改走「附使用约束」
78
+ (同 `--mg-text-3` 的处理方式):cat-3 只作填充/大面积用色,不单独承担细线(约 2px)
79
+ 或图例圆点(约 8px)这类必须靠色本身识别的场景,约束写进 `contrast-contract.json`
80
+ 该条的 `note`。8 项存量(`--mg-bg` 2.17 / `--mg-surface-solid` 1.94 /
81
+ `--mg-surface-2` 2.07 / `--mg-surface-3` 2.17,浅色两市场各 4 项)记入
82
+ `contrast-baseline.json`,不阻断。
83
+ - **cat-4 深色补提亮**:`#008300` → `#00a300`。原深浅两档同值不是「深底上已足够亮」,
84
+ 是补深色档时漏改的一个——单背景(`--mg-bg` 3.58:1)看着达标,但图表画在卡片面上,
85
+ `--mg-surface-2`/`-3` 只有 2.72/2.24。qa#613 划的「深色档不动」范围本不含这种漏填
86
+ 的情况,此处按 UI 侧裁决破例补齐,不是重开深色主题;保持纯绿色相与满饱和度、仅提亮
87
+ L,四底最低 margin 3.29:1(`--mg-surface-3`)。
88
+ - `check:closure` / `check:contract` / `check:layers` / `check:contrast` 全过;
89
+ 存量从 0 项(此前从未纳入判定)变为 8 项(全部是上面 cat-3 的已知例外)。
90
+
91
+ - **卡片阴影收敛为三层扩散,hover 定为中性**(qa#686,UI 侧定案)。`--mg-tile-shadow`
92
+ 改引 `--mg-card-shadow`(原 `--mg-shadow-card`,两层紧贴),`--mg-tile-shadow-hover`
93
+ 改引 `--mg-shadow-md`(原 `--mg-shadow-card-hover`,品牌染色)。
94
+ - **不是重新拍一遍,是把 2026-07-23 就定过的「Apple 风卡片语言」收编成真源**:
95
+ `--mg-card-shadow` 三层扩散是 console-web `.mg-tile` 实际在用的值(6 处消费,
96
+ `--mg-tile-shadow` 本身 0 处),components.css 里明确写着这个日期与依据。
97
+ - **不改 `--mg-shadow-card` 本身**:那条被 `modelgo-web`(国内官网)在用(转发成
98
+ `--modelgo-shadow-card`),改它的值会连带改官网卡片,而三层扩散这个决定只针对
99
+ 控制台,官网没人确认过。改的是 `--mg-tile-shadow` 的指向,不碰共享 token 的值。
100
+ - hover 中性同理不是新拍的:`.mg-tile-hover:hover` 现在的硬编码就是本地 `--shadow-md`
101
+ (console-web/src/styles/components.css:277),压根没走 `--mg-shadow-card-hover`,
102
+ 这里只是把既成事实收回真源;`--mg-shadow-card-hover`(品牌染色)留给官网氛围场景,
103
+ 未受影响。
104
+ - **顺带更正 `--mg-logo-gap-xs` 的注释**:原写「任务列表 / Dashboard 排行等紧凑行」,
105
+ 但 Dashboard 排行榜实测是 rank/logo/名称/金额一整行统一 `gap-3`(12px) 的多字段数据行
106
+ 布局,不是「图标紧贴文字」的配对场景,本就不该套这档——删掉这条误标,不改 Dashboard
107
+ 代码、不改 token 值。
108
+ - `check:closure` / `check:contract` / `check:layers` / `check:contrast` 全过。
109
+
110
+ - **补第三档缓动 `--mg-ease-decelerate`**(qa#686 补件,webkubor 建单时漏记,UI 侧定案)。
111
+ 新增 `--mg-ease-decelerate: cubic-bezier(0.25, 1, 0.5, 1)`,与既有 `--mg-ease-standard`
112
+ (有加速也有减速,偏对称)/ `--mg-ease-emphasized`(强减速,带冲过头再回落的强调感)
113
+ 三档分明。
114
+ - **值取事实标准,不是新拍的**:console-web 现行 12 处内联在用同一个值(输入框聚焦、
115
+ 卡片透明度、流光效果、模型卡等跨多个不相关模块),库里此前只有两档,逼得这条只能
116
+ 散落内联。
117
+ - **两个单次变体一并归并,不单独保留**:`cubic-bezier(0.22,1,0.36,1)`(KpiCard 圆环
118
+ 动画)与 `cubic-bezier(0.25,1,0.33,1)`(Dashboard 顶栏 tab 指示条)各只用了 1 次,
119
+ 同属「快启动、纯减速」形状,无独立设计意图,判定为手调时未对齐主曲线的漂移——
120
+ 跟本轮 qa#686 阴影两套并存是同一种问题形状。折进新档的视觉影响可忽略:两处都是
121
+ 装饰性微交互,不承载状态反馈。
122
+ - 待消费方接入:上述 15 处内联全部改引 `var(--mg-ease-decelerate)`,视觉零变化
123
+ (值本来就是同一个,或差异在装饰性动效里不可辨)。
124
+ - `check:closure` / `check:contract` / `check:layers` / `check:layers-sync` /
125
+ `check:contrast` 全过;归入 `base` 层(`ease` 前缀),四端共享,非控制台专属。
126
+
127
+ - **补齐对比度门禁剩余 105 个未覆盖颜色 token**(`check:coverage` 报的缺口,同 qa#672 的
128
+ 处理方式——**本次只补契约,不改任何颜色值**)。`contrast-contract.json` 新增 26 条
129
+ rules + 79 条 exempt,`check:coverage` 的「① check:contrast」缺口从 105 降到 0。
130
+ - **26 条判入 rules**:`btn-link-text`(±hover) / `btn-neutral-text` / `btn-danger-text`
131
+ 等按钮文字,`toast-*-icon` 四个图标,`progress-*-text` 五个进度条文字,
132
+ `segmented-active-text`、`nav-text-active`/`nav-icon-active`、`link-hover`、
133
+ `code-text`、`media-action-text`,以及 `featured-chip-fg` + 六个
134
+ `modality-*-featured-fg`(「精选 Chip」家族,此前完全没判过)。阈值沿用既有口径:
135
+ 正文 4.5、非文字图标 3、Chip/Badge 类 7。
136
+ - **79 条判入 exempt**,分六类,复用已有豁免判据、不是新拍的口径:
137
+ 色阶原语(`brand-cn-*`/`brand-global-*`/`gray-*` 等 33 个,只在被消费时才落到具体
138
+ 背景,消费它的语义 token 已单独判)、装饰性渐变/填充(`brand-gradient-*`/
139
+ `progress-*-bar`/`select-bg-*` 等 15 个)、基础状态填充色(`--mg-warning`/`-error`/
140
+ `-info` 3 个——**补的是 0.10.0 就该补的坑**:`--mg-success` 的豁免理由里写了「同理适用
141
+ warning/error/info」,但当时只把 `success` 一个存进了 exempt 数组,另三个只停在文字
142
+ 描述里,`check:coverage` 才把这个「说了但没做」的缺口照出来)、阴影效果(4 个,
143
+ `-shadow-hover` 后缀没被覆盖率脚本的正则捕到)、背景填充漏判(3 个,`-bg-active` /
144
+ 组件专属底色同理)、纯别名(19 个,`btn-primary-text`→`on-primary` 等 `var()` 直转,
145
+ 实际判定见其指向的已判 token)。另 2 个(`media-text`/`media-text-muted`)判定为
146
+ 「静态分析算不出」——叠在强度可变的渐变遮罩上、遮罩下方是任意视频内容,同本仓已知的
147
+ 「预览站也只能挡机器判得了的」边界,需消费方人工核验。
148
+ - ⚠️ **矩阵一算,65 项存量不达标浮出来**(记入 `contrast-baseline.json`,不阻断),
149
+ 其中数条明显是真问题而不是噪音,**值本身待设计方确认**:
150
+ - `精选 Chip` 七个家族全部只有 **1.01~1.27:1**(需 7),本质是没被算过——这组 Chip
151
+ 叠着半透明底,静态合成的结果比看起来更差。
152
+ - `代码块文字` 1.15:1(需 4.5),`媒体面板操作按钮文字` 1.46:1(需 4.5),都是明显
153
+ 不达标而非临界。
154
+ - `按钮文字·link`、`进度条文字·brand/rainbow`、`文字链接·hover`、`分段控制器选中态
155
+ 文字` 集中在 2.3~4.2:1(需 4.5),是同一个根因:这几处的 fg 全部复用海外品牌绿
156
+ `--mg-brand-global-base`(`#0F9F59`)/`--mg-brand-mid`,该色阶本身在浅色背景上就不够
157
+ 深,跟 qa#672 的「品牌色提亮保饱和」是同一类矛盾。
158
+ - `按钮文字·danger` 3.96:1(需 4.5),临界未达标。
159
+ - `check:closure` / `check:contract` / `check:layers` / `check:contrast` 全过。
160
+
29
161
  ### Added
30
162
 
31
163
  - **Token 分层产物:`base.css` / `console.css` / `website.css`**(241 / 434 / 4 个 token)。
@@ -85,6 +85,41 @@ pnpm check:usage # 下游硬编码回归(有 baseline,只拦新增)
85
85
  前三道由 `scripts/pre-commit-all.sh` 在 `tokens.css` 进暂存区时自动跑,是本仓提交期门禁的
86
86
  唯一真源。设计值的取舍仍需设计依据与人工审阅,不能被脚本替代。
87
87
 
88
+ ### 6.0 绿灯只代表没报错,不代表检查过(硬规则)
89
+
90
+ 本仓 2026-08 连续出现三次**同一形状**的故障,三次都不以「报错」的形式出现,而以
91
+ 「根本没算到」的形式出现 —— 所以只看退出码永远发现不了:
92
+
93
+ | 案例 | 门禁当时的输出 | 实际情况 |
94
+ |---|---|---|
95
+ | [qa#672](https://gitlab.ops.modelgo.com/qa/ai-quality-platform/-/issues/672) | 「对比度门禁:96 组合 · 达标 96」 | `--mg-chart-cat-*` 整族不在 `contrast-contract.json` 里,图表色**一次都没被算过**(浅色 cat-3 实测 1.94,远低于 3:1) |
96
+ | `check:usage` 扫描目标 | `Token usage check passed.` | `.filter(existsSync)` 把找不到的目标静默丢掉,扫了 **0 个文件**(在 worktree 里跑必然如此) |
97
+ | `token-usage-baseline` | 「无新增,通过」 | 存量从 402 降到 320 后没收口,baseline 虚高 82 处 = **凭空发放 82 处免罚额度**,那个区间内的新增抓不到 |
98
+
99
+ 由此定三条硬规则:
100
+
101
+ 1. **扫描类门禁「找不到目标」必须失败,不许静默通过。** 目标缺失是配置错误,不是
102
+ 「没有问题」。`check:usage` 现在在这种情况下以退出码 2 失败并打印它找的绝对路径。
103
+ 2. **baseline 减少时也必须收口**,不是只在增加时更新。虚高多少就等于凭空发放多少免罚
104
+ 额度 —— 这是门禁被静默削弱的典型方式,而且它不会报任何错。
105
+ 3. **新增一族颜色 token 时,要么进 `contrast-contract.json` 的 `rules` 被判,要么进
106
+ `exempt` 并写明豁免依据(引 WCAG 条款)。** 两头都不在 = 它永远不会被算,而门禁
107
+ 照样报「全达标」。
108
+
109
+ 配套自检(**只报告、不阻断**,退出码恒 0):
110
+
111
+ ```bash
112
+ pnpm check:coverage # 每道门禁「实际检查了什么、漏了什么」
113
+ pnpm check:coverage --verbose # 列出全部未覆盖家族
114
+ ```
115
+
116
+ 它会告诉你:对比度契约覆盖了几个前景色、还有多少「画在前面、人眼要分辨」的颜色两头
117
+ 都不在(排除背景面与装饰效果之后);`check:usage` 的 8 条规则覆盖了哪些维度、哪些
118
+ 维度库里有成体系的 token 却没有任何规则拦它被写死;baseline 现在记着多少存量。
119
+
120
+ 为什么不阻断:覆盖缺口要不要补是设计与工程的判断(比如品牌色阶该不该按正文阈值判),
121
+ 机器定不了。**硬拦只会逼人加豁免,那比看得见的缺口更糟。**
122
+
88
123
  ### 6.1 `check:usage` 的定位与它的缺口(读完再依赖它)
89
124
 
90
125
  它扫的是**消费方源码**,不是本仓。所以:
package/base.css CHANGED
@@ -1,5 +1,5 @@
1
1
  /* ══════════════════════════════════════════════════════════════
2
- modelgo-design-tokens · base.css (241 个 token)
2
+ modelgo-design-tokens · base.css (242 个 token)
3
3
  原子与跨端语义:品牌色阶/灰阶/字阶/间距/圆角/阴影/动效/层级/断点/面与文字/玻璃/状态语义色。必须自闭合——不得引用 console 或 website 的 token。
4
4
 
5
5
  ⚠️ 本文件由 scripts/split-tokens.mjs 从 tokens.css 生成,**不要手改**。
@@ -200,6 +200,13 @@
200
200
  --mg-duration-slow: 0.4s;
201
201
  --mg-ease-standard: cubic-bezier(0.4, 0, 0.2, 1);
202
202
  --mg-ease-emphasized: cubic-bezier(0.16, 1, 0.3, 1);
203
+ /* 第三档缓动(qa#686 补件,UI 侧定案):纯减速、无加速起手,比 emphasized 更柔和平滑。
204
+ 值取控制台现行 console-web/src/index.css:95-98 等 12 处(输入框聚焦/卡片透明度/
205
+ 流光效果/模型卡,跨多个不相关模块),是事实标准,不是新拍的。另有 2 个各只用 1 次
206
+ 的相近变体(KpiCard 圆环动画 (0.22,1,0.36,1)、Dashboard 顶栏 tab 指示条
207
+ (0.25,1,0.33,1))——同属「快启动、纯减速」形状,无独立设计意图,按此定案一并归并,
208
+ 消费方接入时改引本 token,不再各自内联。 */
209
+ --mg-ease-decelerate: cubic-bezier(0.25, 1, 0.5, 1);
203
210
 
204
211
  /* ── 层级 z-index —— 全站唯一一套,勿在下方分区再开第二套 ──────────
205
212
  2026-08-17 合并:此前 BASE 这里与 CONSOLE 大道各有一套,
package/console.css CHANGED
@@ -1,5 +1,5 @@
1
1
  /* ══════════════════════════════════════════════════════════════
2
- modelgo-design-tokens · console.css (434 个 token)
2
+ modelgo-design-tokens · console.css (438 个 token)
3
3
  控制台专用组件语义。可引用 base,不得引用 website。
4
4
 
5
5
  ⚠️ 本文件由 scripts/split-tokens.mjs 从 tokens.css 生成,**不要手改**。
@@ -50,19 +50,19 @@
50
50
  --mg-tile-radius: var(--mg-radius-md);
51
51
  --mg-tile-pad: var(--mg-space-4);
52
52
  --mg-tile-gap: var(--mg-space-3);
53
- /* ⚠️ 已知未收敛:本包里「卡片阴影」有两套并存,名字几乎一样但值不同、角色也不同 ——
54
- ① --mg-tile-shadow → --mg-shadow-card → --mg-shadow-sm(两层紧贴),
55
- 符合治理文档 §4「语义别名单向指向档位」的方向硬规则;
56
- ② --mg-card-shadow(见下方「卡片(Card / Tile)」段)自己持字面值,
57
- 三层扩散、投影范围大得多,是控制台 .mg-tile 现在实际在用的那个。
58
- 后果:想让 .mg-tile 改引 ①,卡片会明显变扁、失去「浮起」感;hover 还会从
59
- 中性阴影变成品牌色光晕(--mg-shadow-card-hover 是品牌染色,本为官网氛围设计,
60
- 控制台高密度列表满屏光晕会很吵)。所以 console 至今没换,不是漏了。
61
- 怎么收要设计定,且按 §2「不得用消费方现有样式反推本仓设计值」——不能因为
62
- 控制台在用 ② 就把 ① 改成 ②。缺的是「卡片阴影该多深」这个设计结论本身。
63
- 未收敛不影响正确性:两者都无环、都自闭合,check:closure 能过。 */
64
- --mg-tile-shadow: var(--mg-shadow-card);
65
- --mg-tile-shadow-hover: var(--mg-shadow-card-hover);
53
+ /* 卡片阴影结论(qa#686 UI 侧定案):tile 与 card 是同一档,深度取三层扩散——
54
+ 即 --mg-card-shadow(见下方「卡片(Card / Tile)」段),2026-07-23 定的
55
+ Apple 风卡片语言「淡边框 + 柔和扩散阴影撑层次」,控制台 .mg-tile 100% 在用这个
56
+ (6 处消费,--mg-tile-shadow 本身 0 处),不是重新拍一遍、是把既成事实收编成真源。
57
+ 直接改引 --mg-card-shadow,**不改** --mg-shadow-card(两层紧贴)本身:那条被
58
+ modelgo-web 官网在用(转发成 --modelgo-shadow-card),改它的值会连带改官网卡片,
59
+ 而三层扩散这个决定只针对控制台,官网没人确认过。
60
+ hover 同理定为中性:.mg-tile-hover:hover 现在的硬编码就是本地 --shadow-md
61
+ (components.css:277),压根没走 --mg-shadow-card-hover 那条品牌染色 token,
62
+ 这里改引 --mg-shadow-md 只是把既成事实收回真源,不是重新拍板。
63
+ --mg-shadow-card-hover(品牌染色)留给官网氛围场景用,未受影响。 */
64
+ --mg-tile-shadow: var(--mg-card-shadow);
65
+ --mg-tile-shadow-hover: var(--mg-shadow-md);
66
66
 
67
67
  --mg-control-height: 40px;
68
68
  --mg-control-height-lg: 48px;
@@ -104,7 +104,10 @@
104
104
  --mg-logo-size-hero: 48px; /* 模型详情页 Hero */
105
105
 
106
106
  /* logo 与相邻文字的行内间距:卡片级更松,紧凑行内更紧 */
107
- --mg-logo-gap-xs: 6px; /* 任务列表 / Dashboard 排行等紧凑行 */
107
+ /* 任务列表这类「图标紧贴文字」的行内配对场景(qa#686 更正:原注释还写了
108
+ 「Dashboard 排行」,但排行榜行是 rank/logo/名称/金额一整行统一 gap-3(12px)
109
+ 的多字段数据行布局,不是图标+文字紧配对,本就不该套这档,删掉这条误标) */
110
+ --mg-logo-gap-xs: 6px; /* 任务列表等紧凑行 */
108
111
  --mg-logo-gap-sm: 7px; /* 相关模型卡片头 */
109
112
  --mg-logo-gap-md: 10px; /* 模型广场卡片顶行 / 选择器行 / Playground 触发按钮 */
110
113
  }
@@ -123,12 +126,18 @@
123
126
  /* ── 图表分类色:6 色循环 ─────────────────────────────────────
124
127
  多序列折线/柱状/面积图按序取用;单值进度条仍走 --mg-progress-*。
125
128
  值取控制台现行(console-web/src/styles/tokens.css:63-80)。
126
- 深色档在下方 [data-theme] 块覆盖:cat-4 绿两档同值,其余提亮。
129
+ 深色档在下方 [data-theme] 块覆盖,六色现已全部提亮(qa#672)。
127
130
  legacy 无前缀别名 --chart-cat-* 刻意不下沉 —— SSOT 只出 --mg- 前缀,
128
- 消费方自己维护兼容别名(console-web 已有)。 */
131
+ 消费方自己维护兼容别名(console-web 已有)。
132
+ cat-2 / cat-3 浅色对比度不达 3:1(qa#672),处理不同:
133
+ cat-2 差距小(2.52→需3),微调即达标,见下方定值;
134
+ cat-3 差距大(1.94,压到 3 需降 L 7.6pt、金黄会变土黄),
135
+ 不改值、改走「附使用约束」——只作填充/大面积用色,不单独承担
136
+ 细线/图例圆点这类必须靠色本身识别的场景(同 --mg-text-3 的处理方式)。 */
129
137
  --mg-chart-cat-1: #2a78d6; /* blue */
130
- --mg-chart-cat-2: #1baf7a; /* teal */
131
- --mg-chart-cat-3: #eda100; /* amber */
138
+ --mg-chart-cat-2: #17976a; /* teal,qa#672:#1baf7a → #17976a。四个浅色底一起判才发现
139
+ 最差的是 --mg-surface-solid(#f2f2f6),不是 --mg-bg——单底估算会漏掉这项。L -5.5pt */
140
+ --mg-chart-cat-3: #eda100; /* amber,qa#672:对比度 1.94 不达 3,见上方注释与契约 note,不改值 */
132
141
  --mg-chart-cat-4: #008300; /* green */
133
142
  --mg-chart-cat-5: #4a3aa7; /* indigo */
134
143
  --mg-chart-cat-6: #e34948; /* red */
@@ -150,12 +159,17 @@
150
159
  /* —— 舒适型(控制台/app 默认):暖炭灰底 + 锌灰文字 + 莫兰迪降饱和语义 —— */
151
160
  [data-theme='dark'] {
152
161
 
153
- /* 图表分类色深色档(下沉自 console-web/src/styles/tokens.css:622-627):
154
- cat-4 绿两档同值(深底上已足够亮),其余提亮以保住暗底对比度 */
162
+ /* 图表分类色深色档(下沉自 console-web/src/styles/tokens.css:622-627)。
163
+ cat-4 原两档同值——不是「深底上已足够亮」,是补深色档时漏改的那一个(qa#672):
164
+ 实测在 --mg-bg 上 3.58:1 看着达标,但图表画在卡片面上,--mg-surface-2/-3
165
+ 只有 2.72 / 2.24,同组最低。qa#613 划的「深色档不动」范围本不含这种漏填的情况,
166
+ 此处按 qa#672 UI 侧裁决破例补齐,不算重开深色主题。
167
+ #008300 → #00a300:保持纯绿色相与满饱和度,仅提亮 L,对四个暗底最差处
168
+ (--mg-surface-3)达 3.29:1,比其余 5 色最低margin(cat-1 3.69)略紧但仍有余量。 */
155
169
  --mg-chart-cat-1: #3987e5;
156
170
  --mg-chart-cat-2: #199e70;
157
171
  --mg-chart-cat-3: #c98500;
158
- --mg-chart-cat-4: #008300;
172
+ --mg-chart-cat-4: #00a300;
159
173
  --mg-chart-cat-5: #9085e9;
160
174
  --mg-chart-cat-6: #e66767;
161
175
  }
@@ -686,8 +700,20 @@
686
700
  dialog 居中、受视口边距夹逼;sheet 贴边、占满高度。 */
687
701
  :root {
688
702
  --mg-dialog-pad: var(--mg-space-6);
689
- /* 不配固定档位:宽度由内容在 min/max 之间自适应(qa#611 ③ 定案,撤回 400/560/720 分档)。
690
- 消费方接的时候去掉 Dialog 的 w-full,否则所有弹窗仍会一律撑到 max-width。 */
703
+ /* qa#611 ③ 改判:撤回 08-18「不配固定档位、内容自适应」的定案,改回三档固定宽度。
704
+ 不是重新拍一遍——是控制台 Modal.tsx 的 SIZE_MAP 已经按这套分档跑了一段时间、
705
+ 且经过一次真实调整(console-web 114c3de0:sm 底宽 360→400,消除小弹窗「小气」感),
706
+ 数值直接取自那里,不是本仓另编一套:
707
+ sm 400px 纯确认框(短提示 + 按钮,无表单字段)
708
+ md 520px 默认,内容型表单/公告
709
+ lg 720px 复杂多区(多个独立信息块/步骤)
710
+ 判据是内容类型,不是量出来的宽度。min/max 保留作区间兜底——
711
+ 个别有正当理由跳出三档的弹窗(如需要并排多列的对比工具)继续按内容定制宽度,
712
+ 不必也不应该被收进三档。 */
713
+ --mg-dialog-width-sm: 400px;
714
+ --mg-dialog-width-md: 520px;
715
+ --mg-dialog-width-lg: 720px;
716
+ --mg-dialog-width: var(--mg-dialog-width-md);
691
717
  --mg-dialog-min-width: 360px;
692
718
  --mg-dialog-max-width: 720px;
693
719
  /* 90dvh:qa#611 ③ 定案不切 min(720px, 100dvh-128px),保持 qa#458 已验收的封顶行为 */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "modelgo-design-tokens",
3
- "version": "0.11.1",
3
+ "version": "0.13.0",
4
4
  "description": "ModelGo 四端统一设计 token(CSS 变量,框架无关):品牌色阶 / 字体 / 字阶 / 圆角 / 间距 / 按钮。",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -10,6 +10,7 @@
10
10
  "check:contrast": "node scripts/check-token-contrast.mjs",
11
11
  "check:diff": "node scripts/diff-token-values.mjs",
12
12
  "check:usage": "node scripts/check-token-usage.mjs",
13
+ "check:coverage": "node scripts/check-gate-coverage.mjs",
13
14
  "check:layers": "node scripts/check-token-layers.mjs",
14
15
  "check:layers-sync": "node scripts/split-tokens.mjs --check",
15
16
  "split": "node scripts/split-tokens.mjs",
@@ -121,10 +121,17 @@ const rules = [
121
121
  * 避免打出一长串 ../../../ 让人看不出到底是哪个文件。
122
122
  */
123
123
  function displayPath(abs) {
124
- const fromWorkspace = path.relative(WORKSPACE, abs)
125
- if (!fromWorkspace.startsWith('..')) return fromWorkspace
124
+ // 先试相对 cwd —— 消费方在自己仓根跑(扫 src)时命中这条,key 恒为 `src/...`。
125
+ // 这一步的顺序是关键:反过来先算工作区根的话,消费方在 worktree 里跑会得到
126
+ // `modelgo-console-web/.claude/worktrees/<名>/src/...`,worktree 名进了 baseline 的
127
+ // key,换个 worktree 或回主检出就全部失配、每一处都被当成新增违规 —— baseline
128
+ // 直接失效。(2026-08-24 接入 console-web 时踩到,当时靠在调用侧显式传
129
+ // MODELGO_WORKSPACE 绕过;此处修根因,下游不必再关心这个。)
126
130
  const fromCwd = path.relative(ROOT, abs)
127
- return fromCwd.startsWith('..') ? abs : fromCwd
131
+ if (!fromCwd.startsWith('..')) return fromCwd
132
+ // 上游扫兄弟仓时 cwd 在本仓,得退到工作区根才能得到 `modelgo-console-web/src/...`
133
+ const fromWorkspace = path.relative(WORKSPACE, abs)
134
+ return fromWorkspace.startsWith('..') ? abs : fromWorkspace
128
135
  }
129
136
 
130
137
  function walk(dir, files = []) {
package/tokens.css CHANGED
@@ -191,6 +191,13 @@
191
191
  --mg-duration-slow: 0.4s;
192
192
  --mg-ease-standard: cubic-bezier(0.4, 0, 0.2, 1);
193
193
  --mg-ease-emphasized: cubic-bezier(0.16, 1, 0.3, 1);
194
+ /* 第三档缓动(qa#686 补件,UI 侧定案):纯减速、无加速起手,比 emphasized 更柔和平滑。
195
+ 值取控制台现行 console-web/src/index.css:95-98 等 12 处(输入框聚焦/卡片透明度/
196
+ 流光效果/模型卡,跨多个不相关模块),是事实标准,不是新拍的。另有 2 个各只用 1 次
197
+ 的相近变体(KpiCard 圆环动画 (0.22,1,0.36,1)、Dashboard 顶栏 tab 指示条
198
+ (0.25,1,0.33,1))——同属「快启动、纯减速」形状,无独立设计意图,按此定案一并归并,
199
+ 消费方接入时改引本 token,不再各自内联。 */
200
+ --mg-ease-decelerate: cubic-bezier(0.25, 1, 0.5, 1);
194
201
 
195
202
  /* ── 层级 z-index —— 全站唯一一套,勿在下方分区再开第二套 ──────────
196
203
  2026-08-17 合并:此前 BASE 这里与 CONSOLE 大道各有一套,
@@ -262,19 +269,19 @@
262
269
  --mg-tile-radius: var(--mg-radius-md);
263
270
  --mg-tile-pad: var(--mg-space-4);
264
271
  --mg-tile-gap: var(--mg-space-3);
265
- /* ⚠️ 已知未收敛:本包里「卡片阴影」有两套并存,名字几乎一样但值不同、角色也不同 ——
266
- ① --mg-tile-shadow → --mg-shadow-card → --mg-shadow-sm(两层紧贴),
267
- 符合治理文档 §4「语义别名单向指向档位」的方向硬规则;
268
- ② --mg-card-shadow(见下方「卡片(Card / Tile)」段)自己持字面值,
269
- 三层扩散、投影范围大得多,是控制台 .mg-tile 现在实际在用的那个。
270
- 后果:想让 .mg-tile 改引 ①,卡片会明显变扁、失去「浮起」感;hover 还会从
271
- 中性阴影变成品牌色光晕(--mg-shadow-card-hover 是品牌染色,本为官网氛围设计,
272
- 控制台高密度列表满屏光晕会很吵)。所以 console 至今没换,不是漏了。
273
- 怎么收要设计定,且按 §2「不得用消费方现有样式反推本仓设计值」——不能因为
274
- 控制台在用 ② 就把 ① 改成 ②。缺的是「卡片阴影该多深」这个设计结论本身。
275
- 未收敛不影响正确性:两者都无环、都自闭合,check:closure 能过。 */
276
- --mg-tile-shadow: var(--mg-shadow-card);
277
- --mg-tile-shadow-hover: var(--mg-shadow-card-hover);
272
+ /* 卡片阴影结论(qa#686 UI 侧定案):tile 与 card 是同一档,深度取三层扩散——
273
+ 即 --mg-card-shadow(见下方「卡片(Card / Tile)」段),2026-07-23 定的
274
+ Apple 风卡片语言「淡边框 + 柔和扩散阴影撑层次」,控制台 .mg-tile 100% 在用这个
275
+ (6 处消费,--mg-tile-shadow 本身 0 处),不是重新拍一遍、是把既成事实收编成真源。
276
+ 直接改引 --mg-card-shadow,**不改** --mg-shadow-card(两层紧贴)本身:那条被
277
+ modelgo-web 官网在用(转发成 --modelgo-shadow-card),改它的值会连带改官网卡片,
278
+ 而三层扩散这个决定只针对控制台,官网没人确认过。
279
+ hover 同理定为中性:.mg-tile-hover:hover 现在的硬编码就是本地 --shadow-md
280
+ (components.css:277),压根没走 --mg-shadow-card-hover 那条品牌染色 token,
281
+ 这里改引 --mg-shadow-md 只是把既成事实收回真源,不是重新拍板。
282
+ --mg-shadow-card-hover(品牌染色)留给官网氛围场景用,未受影响。 */
283
+ --mg-tile-shadow: var(--mg-card-shadow);
284
+ --mg-tile-shadow-hover: var(--mg-shadow-md);
278
285
 
279
286
  --mg-control-height: 40px;
280
287
  --mg-control-height-lg: 48px;
@@ -323,7 +330,10 @@
323
330
  --mg-logo-size-hero: 48px; /* 模型详情页 Hero */
324
331
 
325
332
  /* logo 与相邻文字的行内间距:卡片级更松,紧凑行内更紧 */
326
- --mg-logo-gap-xs: 6px; /* 任务列表 / Dashboard 排行等紧凑行 */
333
+ /* 任务列表这类「图标紧贴文字」的行内配对场景(qa#686 更正:原注释还写了
334
+ 「Dashboard 排行」,但排行榜行是 rank/logo/名称/金额一整行统一 gap-3(12px)
335
+ 的多字段数据行布局,不是图标+文字紧配对,本就不该套这档,删掉这条误标) */
336
+ --mg-logo-gap-xs: 6px; /* 任务列表等紧凑行 */
327
337
  --mg-logo-gap-sm: 7px; /* 相关模型卡片头 */
328
338
  --mg-logo-gap-md: 10px; /* 模型广场卡片顶行 / 选择器行 / Playground 触发按钮 */
329
339
  }
@@ -421,12 +431,18 @@
421
431
  /* ── 图表分类色:6 色循环 ─────────────────────────────────────
422
432
  多序列折线/柱状/面积图按序取用;单值进度条仍走 --mg-progress-*。
423
433
  值取控制台现行(console-web/src/styles/tokens.css:63-80)。
424
- 深色档在下方 [data-theme] 块覆盖:cat-4 绿两档同值,其余提亮。
434
+ 深色档在下方 [data-theme] 块覆盖,六色现已全部提亮(qa#672)。
425
435
  legacy 无前缀别名 --chart-cat-* 刻意不下沉 —— SSOT 只出 --mg- 前缀,
426
- 消费方自己维护兼容别名(console-web 已有)。 */
436
+ 消费方自己维护兼容别名(console-web 已有)。
437
+ cat-2 / cat-3 浅色对比度不达 3:1(qa#672),处理不同:
438
+ cat-2 差距小(2.52→需3),微调即达标,见下方定值;
439
+ cat-3 差距大(1.94,压到 3 需降 L 7.6pt、金黄会变土黄),
440
+ 不改值、改走「附使用约束」——只作填充/大面积用色,不单独承担
441
+ 细线/图例圆点这类必须靠色本身识别的场景(同 --mg-text-3 的处理方式)。 */
427
442
  --mg-chart-cat-1: #2a78d6; /* blue */
428
- --mg-chart-cat-2: #1baf7a; /* teal */
429
- --mg-chart-cat-3: #eda100; /* amber */
443
+ --mg-chart-cat-2: #17976a; /* teal,qa#672:#1baf7a → #17976a。四个浅色底一起判才发现
444
+ 最差的是 --mg-surface-solid(#f2f2f6),不是 --mg-bg——单底估算会漏掉这项。L -5.5pt */
445
+ --mg-chart-cat-3: #eda100; /* amber,qa#672:对比度 1.94 不达 3,见上方注释与契约 note,不改值 */
430
446
  --mg-chart-cat-4: #008300; /* green */
431
447
  --mg-chart-cat-5: #4a3aa7; /* indigo */
432
448
  --mg-chart-cat-6: #e34948; /* red */
@@ -609,12 +625,17 @@
609
625
  --mg-shadow-hover-md: 0 12px 30px rgba(0, 0, 0, 0.38), 0 0 0 1px rgba(255, 255, 255, 0.05);
610
626
  --mg-shadow-hover-lg: 0 20px 52px rgba(0, 0, 0, 0.46), 0 0 0 1px rgba(255, 255, 255, 0.06);
611
627
 
612
- /* 图表分类色深色档(下沉自 console-web/src/styles/tokens.css:622-627):
613
- cat-4 绿两档同值(深底上已足够亮),其余提亮以保住暗底对比度 */
628
+ /* 图表分类色深色档(下沉自 console-web/src/styles/tokens.css:622-627)。
629
+ cat-4 原两档同值——不是「深底上已足够亮」,是补深色档时漏改的那一个(qa#672):
630
+ 实测在 --mg-bg 上 3.58:1 看着达标,但图表画在卡片面上,--mg-surface-2/-3
631
+ 只有 2.72 / 2.24,同组最低。qa#613 划的「深色档不动」范围本不含这种漏填的情况,
632
+ 此处按 qa#672 UI 侧裁决破例补齐,不算重开深色主题。
633
+ #008300 → #00a300:保持纯绿色相与满饱和度,仅提亮 L,对四个暗底最差处
634
+ (--mg-surface-3)达 3.29:1,比其余 5 色最低margin(cat-1 3.69)略紧但仍有余量。 */
614
635
  --mg-chart-cat-1: #3987e5;
615
636
  --mg-chart-cat-2: #199e70;
616
637
  --mg-chart-cat-3: #c98500;
617
- --mg-chart-cat-4: #008300;
638
+ --mg-chart-cat-4: #00a300;
618
639
  --mg-chart-cat-5: #9085e9;
619
640
  --mg-chart-cat-6: #e66767;
620
641
  }
@@ -1313,8 +1334,20 @@
1313
1334
  dialog 居中、受视口边距夹逼;sheet 贴边、占满高度。 */
1314
1335
  :root {
1315
1336
  --mg-dialog-pad: var(--mg-space-6);
1316
- /* 不配固定档位:宽度由内容在 min/max 之间自适应(qa#611 ③ 定案,撤回 400/560/720 分档)。
1317
- 消费方接的时候去掉 Dialog 的 w-full,否则所有弹窗仍会一律撑到 max-width。 */
1337
+ /* qa#611 ③ 改判:撤回 08-18「不配固定档位、内容自适应」的定案,改回三档固定宽度。
1338
+ 不是重新拍一遍——是控制台 Modal.tsx 的 SIZE_MAP 已经按这套分档跑了一段时间、
1339
+ 且经过一次真实调整(console-web 114c3de0:sm 底宽 360→400,消除小弹窗「小气」感),
1340
+ 数值直接取自那里,不是本仓另编一套:
1341
+ sm 400px 纯确认框(短提示 + 按钮,无表单字段)
1342
+ md 520px 默认,内容型表单/公告
1343
+ lg 720px 复杂多区(多个独立信息块/步骤)
1344
+ 判据是内容类型,不是量出来的宽度。min/max 保留作区间兜底——
1345
+ 个别有正当理由跳出三档的弹窗(如需要并排多列的对比工具)继续按内容定制宽度,
1346
+ 不必也不应该被收进三档。 */
1347
+ --mg-dialog-width-sm: 400px;
1348
+ --mg-dialog-width-md: 520px;
1349
+ --mg-dialog-width-lg: 720px;
1350
+ --mg-dialog-width: var(--mg-dialog-width-md);
1318
1351
  --mg-dialog-min-width: 360px;
1319
1352
  --mg-dialog-max-width: 720px;
1320
1353
  /* 90dvh:qa#611 ③ 定案不切 min(720px, 100dvh-128px),保持 qa#458 已验收的封顶行为 */