modelgo-design-tokens 0.11.0 → 0.12.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 +105 -0
- package/TOKEN-GOVERNANCE.md +65 -3
- package/base.css +11 -1
- package/console.css +51 -14
- package/package.json +2 -1
- package/scripts/check-token-usage.mjs +244 -32
- package/tokens.css +65 -14
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,111 @@
|
|
|
2
2
|
|
|
3
3
|
## Unreleased
|
|
4
4
|
|
|
5
|
+
### Fixed
|
|
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
|
+
|
|
30
|
+
- **`check:usage` 修掉静默假绿,并补齐覆盖范围**(工具改动,不影响任何 token 值,
|
|
31
|
+
消费方无需升级即可用)。三个叠在一起的问题:
|
|
32
|
+
1. **找不到扫描目标时静默通过。** 原实现 `.filter(existsSync)` 把不存在的目标直接丢掉,
|
|
33
|
+
全丢光时扫 0 个文件仍打印 `Token usage check passed.`。而 `DEFAULT_TARGETS` 是相对
|
|
34
|
+
`cwd` 的兄弟仓路径,**在 worktree 里跑必然全部找不到**(cwd 是
|
|
35
|
+
`<repo>/.claude/worktrees/<name>`)—— 也就是说在 worktree 里这道门禁长期是假绿。
|
|
36
|
+
现在既感知 worktree 布局(能正确回溯到工作区根,也可用 `MODELGO_WORKSPACE` 覆盖),
|
|
37
|
+
又在一个目标都找不到、或扫到 0 个文件时以**退出码 2** 明确失败。
|
|
38
|
+
2. **只扫 console-web。** `DEFAULT_TARGETS` 另一项 `wt-console-glass` 早已不存在,
|
|
39
|
+
于是**国内官网、海外官网、文档站从未被扫过**。现在四端全覆盖。
|
|
40
|
+
3. **规则只查颜色和 z-index。** 库里 `ease` / `duration` / `radius` / `shadow` 早已成体系,
|
|
41
|
+
却一条都没查。补四条规则后存量从 22 处涨到 **402 处**(console-web 187 / 国内官网 180 /
|
|
42
|
+
海外官网 35 / 文档站 0),即原先只看得见 5.5%。
|
|
43
|
+
|
|
44
|
+
配套引入 `token-usage-baseline.json`:**存量不阻断,只拦新增**(照 `check:contrast` 的口径,
|
|
45
|
+
否则第一次接入就拦死所有提交,最后只会被 `--no-verify` 绕过)。key 为 `文件::规则`
|
|
46
|
+
不含行号,重构挪动代码不会误判成新增。收口 `-- --update-baseline`,看清单 `-- --all`。
|
|
47
|
+
|
|
48
|
+
⚠️ **已知缺口**:这道检查扫的是下游代码,本仓 pre-commit 只在 `tokens.css` 进暂存区时触发,
|
|
49
|
+
所以**它至今没有自动触发点**。要真正拦住下游新增硬编码,得在各端自己的提交期调用它。
|
|
50
|
+
详见 TOKEN-GOVERNANCE.md §6.1。
|
|
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
|
+
|
|
5
110
|
### Added
|
|
6
111
|
|
|
7
112
|
- **Token 分层产物:`base.css` / `console.css` / `website.css`**(241 / 434 / 4 个 token)。
|
package/TOKEN-GOVERNANCE.md
CHANGED
|
@@ -76,9 +76,71 @@
|
|
|
76
76
|
## 6. 变更门禁
|
|
77
77
|
|
|
78
78
|
```bash
|
|
79
|
-
pnpm check:closure # var()
|
|
79
|
+
pnpm check:closure # var() 引用自闭合(含环 + 级联顺序)
|
|
80
80
|
pnpm check:contract # 主题与兼容别名契约
|
|
81
|
-
pnpm check:
|
|
81
|
+
pnpm check:contrast # 语义色对比度(有 baseline,只拦新增与恶化)
|
|
82
|
+
pnpm check:usage # 下游硬编码回归(有 baseline,只拦新增)
|
|
82
83
|
```
|
|
83
84
|
|
|
84
|
-
|
|
85
|
+
前三道由 `scripts/pre-commit-all.sh` 在 `tokens.css` 进暂存区时自动跑,是本仓提交期门禁的
|
|
86
|
+
唯一真源。设计值的取舍仍需设计依据与人工审阅,不能被脚本替代。
|
|
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
|
+
|
|
123
|
+
### 6.1 `check:usage` 的定位与它的缺口(读完再依赖它)
|
|
124
|
+
|
|
125
|
+
它扫的是**消费方源码**,不是本仓。所以:
|
|
126
|
+
|
|
127
|
+
- **它没有自动触发点。** 本仓 pre-commit 只在 `tokens.css` 进暂存区时触发,而本检查
|
|
128
|
+
和 `tokens.css` 无关;本仓提交时跑它也没意义(本仓提交不改下游代码)。
|
|
129
|
+
**「库侧门禁全绿」不代表下游没有新增硬编码。** 要真拦住,得在各端自己的提交期调用它
|
|
130
|
+
—— 这一步**尚未做**,是已知缺口。
|
|
131
|
+
- **存量不阻断**:`token-usage-baseline.json` 记 `文件::规则 → 处数`,只有新组合出现、
|
|
132
|
+
或已记组合处数变多才拦。key 刻意不含行号,重构挪代码不会被误判成新增。
|
|
133
|
+
收口用 `pnpm check:usage -- --update-baseline`,看清单用 `-- --all`。
|
|
134
|
+
- **豁免三种**:文件里写 `token-check-ignore` 整 file 跳过;`--x: <字面值>` 这种
|
|
135
|
+
token 定义行不算违规(本地 token 层该不该收进库是另一个议题);命中文本里已含
|
|
136
|
+
`var()` 的不算。
|
|
137
|
+
- **路径靠工作区布局推断**:默认按兄弟仓找(`modelgo-console-web/src` 等)。
|
|
138
|
+
在 worktree 里跑也能正确解析;布局不同用 `MODELGO_WORKSPACE=/path` 覆盖。
|
|
139
|
+
**找不到目标时会以退出码 2 失败,不会静默通过** —— 2026-08-24 之前它会把找不到的
|
|
140
|
+
目标静默丢掉、扫 0 个文件仍打印 `passed`,在 worktree 里跑必然假绿。
|
|
141
|
+
|
|
142
|
+
> 覆盖范围的历史教训:这个脚本原先只有 4 条规则(Tailwind 语义色、两个 legacy hex、
|
|
143
|
+
> z-index),且 `DEFAULT_TARGETS` 只含 console-web 和一个早已不存在的目录。
|
|
144
|
+
> 结果是**国内官网从未被扫过**,而库里成体系的 `ease` / `duration` / `radius` / `shadow`
|
|
145
|
+
> 一条都没查 —— 补齐后存量从 22 处涨到 402 处,即原先只看得见 5.5%。
|
|
146
|
+
> 新增规则时记住:**没被规则覆盖的维度,等于默许硬编码**。
|
package/base.css
CHANGED
|
@@ -230,7 +230,17 @@
|
|
|
230
230
|
|
|
231
231
|
/* ── 产品市场 UX:官网内容卡 + 高密度信息 tile + 工具栏 + 图片 Banner ──
|
|
232
232
|
设计依据:2026-08 国内官网改版与控制台模型广场。官网保留舒展的 card,
|
|
233
|
-
模型列表/筛选等高频信息区使用更紧凑的 tile;二者不混用。
|
|
233
|
+
模型列表/筛选等高频信息区使用更紧凑的 tile;二者不混用。
|
|
234
|
+
|
|
235
|
+
⚠️ 2026-08-24 更正上面这条依据的一半:「国内官网改版」这个依据已经失效。
|
|
236
|
+
国内官网的模型广场已并入控制台(modelgo-web 的 /models 只做 301 到
|
|
237
|
+
console.modelgo.com/models),官网侧不再有模型列表/筛选这类高密度场景;
|
|
238
|
+
且官网锁 ^0.6.2,本段是 0.6.2 之后进包的,它技术上也拿不到。
|
|
239
|
+
实测四端对本段的消费:console-web 21 个,国内官网 / 海外官网 / 文档站 0 个
|
|
240
|
+
——两个官网消费的是基础层(品牌色/字阶/圆角/间距),这是分工而非缺口,
|
|
241
|
+
正是上面「二者不混用」那句话的结果。
|
|
242
|
+
所以本段的现实消费方只有控制台。按治理文档 §3,零引用不构成删除理由,
|
|
243
|
+
token 保留;但后续改本段的值,设计依据要以控制台为对象,别再写官网。 */
|
|
234
244
|
--mg-text-market-title: 34px;
|
|
235
245
|
--mg-text-market-title-line: 1.5;
|
|
236
246
|
/* -0.025em = Tailwind tracking-tight,控制台模型广场 h1 实际在用的值
|
package/console.css
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/* ══════════════════════════════════════════════════════════════
|
|
2
|
-
modelgo-design-tokens · console.css (
|
|
2
|
+
modelgo-design-tokens · console.css (438 个 token)
|
|
3
3
|
控制台专用组件语义。可引用 base,不得引用 website。
|
|
4
4
|
|
|
5
5
|
⚠️ 本文件由 scripts/split-tokens.mjs 从 tokens.css 生成,**不要手改**。
|
|
@@ -46,11 +46,23 @@
|
|
|
46
46
|
--mg-tile-bg: var(--mg-glass-surface);
|
|
47
47
|
--mg-tile-border: var(--mg-glass-line);
|
|
48
48
|
--mg-tile-border-hover: color-mix(in oklab, var(--mg-brand-base) 24%, var(--mg-border));
|
|
49
|
+
/* tile 家族圆角的唯一定义点(下方「卡片(Card / Tile)」段曾重复声明同值,2026-08-24 撤除) */
|
|
49
50
|
--mg-tile-radius: var(--mg-radius-md);
|
|
50
51
|
--mg-tile-pad: var(--mg-space-4);
|
|
51
52
|
--mg-tile-gap: var(--mg-space-3);
|
|
52
|
-
|
|
53
|
-
|
|
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);
|
|
54
66
|
|
|
55
67
|
--mg-control-height: 40px;
|
|
56
68
|
--mg-control-height-lg: 48px;
|
|
@@ -92,7 +104,10 @@
|
|
|
92
104
|
--mg-logo-size-hero: 48px; /* 模型详情页 Hero */
|
|
93
105
|
|
|
94
106
|
/* logo 与相邻文字的行内间距:卡片级更松,紧凑行内更紧 */
|
|
95
|
-
|
|
107
|
+
/* 任务列表这类「图标紧贴文字」的行内配对场景(qa#686 更正:原注释还写了
|
|
108
|
+
「Dashboard 排行」,但排行榜行是 rank/logo/名称/金额一整行统一 gap-3(12px)
|
|
109
|
+
的多字段数据行布局,不是图标+文字紧配对,本就不该套这档,删掉这条误标) */
|
|
110
|
+
--mg-logo-gap-xs: 6px; /* 任务列表等紧凑行 */
|
|
96
111
|
--mg-logo-gap-sm: 7px; /* 相关模型卡片头 */
|
|
97
112
|
--mg-logo-gap-md: 10px; /* 模型广场卡片顶行 / 选择器行 / Playground 触发按钮 */
|
|
98
113
|
}
|
|
@@ -111,12 +126,18 @@
|
|
|
111
126
|
/* ── 图表分类色:6 色循环 ─────────────────────────────────────
|
|
112
127
|
多序列折线/柱状/面积图按序取用;单值进度条仍走 --mg-progress-*。
|
|
113
128
|
值取控制台现行(console-web/src/styles/tokens.css:63-80)。
|
|
114
|
-
深色档在下方 [data-theme]
|
|
129
|
+
深色档在下方 [data-theme] 块覆盖,六色现已全部提亮(qa#672)。
|
|
115
130
|
legacy 无前缀别名 --chart-cat-* 刻意不下沉 —— SSOT 只出 --mg- 前缀,
|
|
116
|
-
消费方自己维护兼容别名(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 的处理方式)。 */
|
|
117
137
|
--mg-chart-cat-1: #2a78d6; /* blue */
|
|
118
|
-
--mg-chart-cat-2: #
|
|
119
|
-
|
|
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,不改值 */
|
|
120
141
|
--mg-chart-cat-4: #008300; /* green */
|
|
121
142
|
--mg-chart-cat-5: #4a3aa7; /* indigo */
|
|
122
143
|
--mg-chart-cat-6: #e34948; /* red */
|
|
@@ -138,12 +159,17 @@
|
|
|
138
159
|
/* —— 舒适型(控制台/app 默认):暖炭灰底 + 锌灰文字 + 莫兰迪降饱和语义 —— */
|
|
139
160
|
[data-theme='dark'] {
|
|
140
161
|
|
|
141
|
-
/* 图表分类色深色档(下沉自 console-web/src/styles/tokens.css:622-627
|
|
142
|
-
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)略紧但仍有余量。 */
|
|
143
169
|
--mg-chart-cat-1: #3987e5;
|
|
144
170
|
--mg-chart-cat-2: #199e70;
|
|
145
171
|
--mg-chart-cat-3: #c98500;
|
|
146
|
-
--mg-chart-cat-4: #
|
|
172
|
+
--mg-chart-cat-4: #00a300;
|
|
147
173
|
--mg-chart-cat-5: #9085e9;
|
|
148
174
|
--mg-chart-cat-6: #e66767;
|
|
149
175
|
}
|
|
@@ -365,7 +391,6 @@
|
|
|
365
391
|
1.31,垫在实色 --mg-surface-solid 上只剩 1.19,会静默不达标。(qa#614 衍生) */
|
|
366
392
|
--mg-card-border: rgba(16, 24, 40, 0.13);
|
|
367
393
|
--mg-card-shadow: 0 1px 2px rgba(16, 24, 40, 0.04), 0 6px 16px -6px rgba(16, 24, 40, 0.10), 0 16px 32px -14px rgba(16, 24, 40, 0.08);
|
|
368
|
-
--mg-tile-radius: var(--mg-radius-md);
|
|
369
394
|
}
|
|
370
395
|
[data-theme='dark'] {
|
|
371
396
|
--mg-card-border: rgba(255, 255, 255, 0.08);
|
|
@@ -675,8 +700,20 @@
|
|
|
675
700
|
dialog 居中、受视口边距夹逼;sheet 贴边、占满高度。 */
|
|
676
701
|
:root {
|
|
677
702
|
--mg-dialog-pad: var(--mg-space-6);
|
|
678
|
-
/*
|
|
679
|
-
|
|
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);
|
|
680
717
|
--mg-dialog-min-width: 360px;
|
|
681
718
|
--mg-dialog-max-width: 720px;
|
|
682
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.
|
|
3
|
+
"version": "0.12.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",
|
|
@@ -1,18 +1,70 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
+
// scripts/check-token-usage.mjs
|
|
3
|
+
// ───────────────────────────────────────────────────────────────
|
|
4
|
+
// 下游硬编码回归检查:扫消费方源码里「本仓已有 token、却仍写死字面值」的地方。
|
|
5
|
+
//
|
|
6
|
+
// ⚠️ 本脚本没有自动触发点,必须由消费方 CI / pre-commit 或人工巡检调用。
|
|
7
|
+
// 本仓的 pre-commit(scripts/pre-commit-all.sh)只在 tokens.css 进暂存区时跑,
|
|
8
|
+
// 而本检查扫的是**下游代码**——本仓提交时跑它没有意义。所以「库侧门禁绿」
|
|
9
|
+
// 不代表下游没有硬编码。要真正拦住新增,得在各端自己的提交期调用本脚本。
|
|
10
|
+
//
|
|
11
|
+
// 存量不阻断(照 check:contrast 的口径):只有 baseline 里没记过的新增、
|
|
12
|
+
// 或已记条目数量继续变多才拦。否则第一次接入就会拦死所有提交,
|
|
13
|
+
// 最后只会被 --no-verify 绕过。
|
|
14
|
+
//
|
|
15
|
+
// 用法:
|
|
16
|
+
// node scripts/check-token-usage.mjs # 扫默认四端
|
|
17
|
+
// node scripts/check-token-usage.mjs <dir> [dir...] # 扫指定目录(相对 cwd)
|
|
18
|
+
// node scripts/check-token-usage.mjs --all # 列出全部存量,不阻断
|
|
19
|
+
// node scripts/check-token-usage.mjs --update-baseline # 存量收口,写回 baseline
|
|
20
|
+
//
|
|
21
|
+
// 退出码:0 通过;1 有新增;2 配置错误(没有一个扫描目标存在 / 扫到 0 个文件)。
|
|
22
|
+
//
|
|
23
|
+
// 2026-08-24 修:原实现 `.filter(existsSync)` 把找不到的目标**静默丢掉**,
|
|
24
|
+
// 全丢光时扫 0 个文件仍打印 “passed”。在 worktree 里跑必然如此(cwd 是
|
|
25
|
+
// <repo>/.claude/worktrees/<name>,`../modelgo-console-web` 解析到 worktrees 里),
|
|
26
|
+
// 于是门禁长期是假绿。现在既感知 worktree 布局、又在找不到时明确失败。
|
|
27
|
+
// ───────────────────────────────────────────────────────────────
|
|
2
28
|
import fs from 'node:fs'
|
|
3
29
|
import path from 'node:path'
|
|
4
30
|
|
|
5
31
|
const ROOT = process.cwd()
|
|
6
|
-
const
|
|
7
|
-
const
|
|
8
|
-
|
|
9
|
-
.filter((target) => fs.existsSync(target))
|
|
32
|
+
const args = process.argv.slice(2)
|
|
33
|
+
const flag = (name) => args.includes(name)
|
|
34
|
+
const dirArgs = args.filter((a) => !a.startsWith('--'))
|
|
10
35
|
|
|
11
|
-
|
|
12
|
-
|
|
36
|
+
/**
|
|
37
|
+
* 兄弟仓所在的工作区根。
|
|
38
|
+
* 主检出时 cwd 是 <workspace>/modelgo-design-tokens,工作区根是它的父目录;
|
|
39
|
+
* worktree 时 cwd 是 <repo>/.claude/worktrees/<name>,得先退回 <repo> 再取父目录。
|
|
40
|
+
* 可用 MODELGO_WORKSPACE 覆盖(CI 里仓库不一定是兄弟关系)。
|
|
41
|
+
*/
|
|
42
|
+
function resolveWorkspaceRoot() {
|
|
43
|
+
if (process.env.MODELGO_WORKSPACE) return path.resolve(process.env.MODELGO_WORKSPACE)
|
|
44
|
+
const inWorktree = ROOT.match(/^(.*)\/\.claude\/worktrees\/[^/]+$/)
|
|
45
|
+
return path.dirname(inWorktree ? inWorktree[1] : ROOT)
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
const WORKSPACE = resolveWorkspaceRoot()
|
|
49
|
+
|
|
50
|
+
// 四端全覆盖。原来只有 console-web 和一个早已不存在的 wt-console-glass,
|
|
51
|
+
// 于是国内官网的存量硬编码从来没被扫过。
|
|
52
|
+
const DEFAULT_TARGETS = [
|
|
53
|
+
'modelgo-console-web/src',
|
|
54
|
+
'modelgo-web/src',
|
|
55
|
+
'modelgo-global-web/src',
|
|
56
|
+
'modelgo-doc-web',
|
|
57
|
+
]
|
|
58
|
+
|
|
59
|
+
const SKIP_DIRS = new Set(['.git', 'node_modules', 'dist', 'build', 'coverage', '.claude', '.astro', '.vitepress'])
|
|
60
|
+
const FILE_RE = /\.(css|less|scss|tsx?|jsx?|astro|vue)$/
|
|
61
|
+
// 各端自己的 token 定义文件:那里写字面值是本职,不是违规
|
|
13
62
|
const SKIP_FILES = new Set(['tokens.css'])
|
|
14
63
|
const IGNORE = 'token-check-ignore'
|
|
15
64
|
|
|
65
|
+
/** 命中文本里已经在用 var(),说明不是硬编码(多值 box-shadow 里混了 token 的情况) */
|
|
66
|
+
const usesVar = (text) => text.includes('var(')
|
|
67
|
+
|
|
16
68
|
const rules = [
|
|
17
69
|
{
|
|
18
70
|
name: 'semantic-tailwind-color',
|
|
@@ -34,8 +86,54 @@ const rules = [
|
|
|
34
86
|
pattern: /\bz-(?:40|50|\[60\]|\[2000\])\b|zIndex:\s*(?:60|999|1000|9999|10000)\b/g,
|
|
35
87
|
message: 'Use --mg-z-* semantic layers for headers, overlays, sheets, modals, toasts, and devtools.',
|
|
36
88
|
},
|
|
89
|
+
// ── 以下四条 2026-08-24 新增。库里 ease/duration/radius/shadow 早就成体系,
|
|
90
|
+
// 但一条都没被查过,于是三端合计 328 处字面值静静躺着。
|
|
91
|
+
{
|
|
92
|
+
name: 'hardcoded-easing',
|
|
93
|
+
pattern: /cubic-bezier\([^)]*\)/g,
|
|
94
|
+
message:
|
|
95
|
+
'Use --mg-ease-standard (0.4,0,0.2,1) or --mg-ease-emphasized (0.16,1,0.3,1). ' +
|
|
96
|
+
'If your curve is neither, it is a missing token — raise it instead of inlining.',
|
|
97
|
+
},
|
|
98
|
+
{
|
|
99
|
+
name: 'hardcoded-transition-duration',
|
|
100
|
+
pattern: /transition(?:-duration)?:[^;{}]*/g,
|
|
101
|
+
message: 'Use --mg-duration-instant/fast/base/slow for transition timing.',
|
|
102
|
+
// 只在真出现时长字面值、且没用 token 时算违规
|
|
103
|
+
accept: (text) => !usesVar(text) && /(?:^|[\s(,:])\d*\.?\d+m?s\b/.test(text),
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
name: 'hardcoded-radius-px',
|
|
107
|
+
pattern: /border-radius:\s*[1-9]\d*px(?=\s*[;}!])/g,
|
|
108
|
+
message: 'Use --mg-radius-xs/sm/md/lg/pill (6/8/14/18/999px) instead of literal border-radius.',
|
|
109
|
+
},
|
|
110
|
+
{
|
|
111
|
+
name: 'hardcoded-shadow',
|
|
112
|
+
pattern: /box-shadow:[^;{}]*/g,
|
|
113
|
+
message: 'Use --mg-shadow-sm/md/lg or the semantic --mg-*-shadow aliases instead of literal shadow values.',
|
|
114
|
+
accept: (text) => !usesVar(text) && /(?:rgba?\(|#[0-9a-fA-F]{3,8})/.test(text) && !/\bnone\b/.test(text),
|
|
115
|
+
},
|
|
37
116
|
]
|
|
38
117
|
|
|
118
|
+
/**
|
|
119
|
+
* 显示用路径:默认相对工作区根(`modelgo-web/src/...`,跨端可读且能进 baseline)。
|
|
120
|
+
* 目标在工作区之外时(临时目录、CI 上非兄弟布局)退回相对 cwd,
|
|
121
|
+
* 避免打出一长串 ../../../ 让人看不出到底是哪个文件。
|
|
122
|
+
*/
|
|
123
|
+
function displayPath(abs) {
|
|
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 绕过;此处修根因,下游不必再关心这个。)
|
|
130
|
+
const fromCwd = path.relative(ROOT, abs)
|
|
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
|
|
135
|
+
}
|
|
136
|
+
|
|
39
137
|
function walk(dir, files = []) {
|
|
40
138
|
for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
|
|
41
139
|
if (SKIP_DIRS.has(entry.name)) continue
|
|
@@ -49,39 +147,153 @@ function walk(dir, files = []) {
|
|
|
49
147
|
return files
|
|
50
148
|
}
|
|
51
149
|
|
|
150
|
+
// ── 解析扫描目标:显式参数相对 cwd,默认目标相对工作区根 ──
|
|
151
|
+
const requested = dirArgs.length > 0
|
|
152
|
+
? dirArgs.map((d) => ({ label: d, abs: path.resolve(ROOT, d) }))
|
|
153
|
+
: DEFAULT_TARGETS.map((d) => ({ label: d, abs: path.resolve(WORKSPACE, d) }))
|
|
154
|
+
|
|
155
|
+
const present = requested.filter((t) => fs.existsSync(t.abs))
|
|
156
|
+
const absent = requested.filter((t) => !fs.existsSync(t.abs))
|
|
157
|
+
|
|
158
|
+
if (absent.length > 0) {
|
|
159
|
+
// 不再静默丢弃:找不到就说出来,哪个目标、找的是哪个绝对路径
|
|
160
|
+
console.error(`⚠ ${absent.length} 个扫描目标不存在,已跳过:`)
|
|
161
|
+
for (const t of absent) console.error(` ${t.label} → ${t.abs}`)
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
if (present.length === 0) {
|
|
165
|
+
console.error('')
|
|
166
|
+
console.error('✗ 配置错误:没有一个扫描目标存在,本次实际扫了 0 个文件。')
|
|
167
|
+
console.error(' 这不是「检查通过」——原实现在这种情况下会打印 passed,属于假绿。')
|
|
168
|
+
console.error('')
|
|
169
|
+
console.error(` 当前 cwd: ${ROOT}`)
|
|
170
|
+
console.error(` 推断的工作区根: ${WORKSPACE}`)
|
|
171
|
+
console.error('')
|
|
172
|
+
console.error(' 怎么办(任一):')
|
|
173
|
+
console.error(' · 显式传目录:node scripts/check-token-usage.mjs ../modelgo-console-web/src')
|
|
174
|
+
console.error(' · 指定工作区:MODELGO_WORKSPACE=/path/to/modelgo npm run check:usage')
|
|
175
|
+
process.exit(2)
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
const files = present.flatMap((t) => walk(t.abs))
|
|
179
|
+
if (files.length === 0) {
|
|
180
|
+
console.error(`✗ 配置错误:${present.length} 个目标存在,但没扫到任何可检查的文件。`)
|
|
181
|
+
console.error(` 目标: ${present.map((t) => t.label).join(', ')}`)
|
|
182
|
+
console.error(` 期望后缀: ${FILE_RE}`)
|
|
183
|
+
process.exit(2)
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
// ── 扫描 ──
|
|
52
187
|
const findings = []
|
|
53
|
-
for (const
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
188
|
+
for (const file of files) {
|
|
189
|
+
const content = fs.readFileSync(file, 'utf8')
|
|
190
|
+
if (content.includes(IGNORE)) continue
|
|
191
|
+
const lines = content.split(/\r?\n/)
|
|
192
|
+
for (const rule of rules) {
|
|
193
|
+
rule.pattern.lastIndex = 0
|
|
194
|
+
let match
|
|
195
|
+
while ((match = rule.pattern.exec(content)) !== null) {
|
|
196
|
+
if (match[0] === '') { rule.pattern.lastIndex++; continue }
|
|
197
|
+
if (rule.accept && !rule.accept(match[0])) continue
|
|
198
|
+
const line = content.slice(0, match.index).split(/\r?\n/).length
|
|
199
|
+
const text = lines[line - 1]?.trim() ?? ''
|
|
200
|
+
// 定义点豁免:`--x: <字面值>` 是在声明本地 token,不是「该用 token 却没用」。
|
|
201
|
+
// 本地 token 层该不该收进库是另一个议题,不由本规则判。
|
|
202
|
+
if (/^--[\w-]+\s*:/.test(text)) continue
|
|
203
|
+
findings.push({
|
|
204
|
+
file: displayPath(file),
|
|
205
|
+
line,
|
|
206
|
+
rule: rule.name,
|
|
207
|
+
value: match[0].replace(/\s+/g, ' ').slice(0, 80),
|
|
208
|
+
message: rule.message,
|
|
209
|
+
text,
|
|
210
|
+
})
|
|
72
211
|
}
|
|
73
212
|
}
|
|
74
213
|
}
|
|
75
214
|
|
|
76
|
-
|
|
77
|
-
|
|
215
|
+
// ── baseline 比对 ──
|
|
216
|
+
// key 刻意不含行号:重构挪动代码不该被当成新增违规;同文件同规则用计数兜住。
|
|
217
|
+
const BASELINE_FILE = path.join(ROOT, 'token-usage-baseline.json')
|
|
218
|
+
const keyOf = (f) => `${f.file}::${f.rule}`
|
|
219
|
+
|
|
220
|
+
const tally = (list) => {
|
|
221
|
+
const out = {}
|
|
222
|
+
for (const f of list) out[keyOf(f)] = (out[keyOf(f)] ?? 0) + 1
|
|
223
|
+
return out
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
const current = tally(findings)
|
|
227
|
+
|
|
228
|
+
if (flag('--update-baseline')) {
|
|
229
|
+
const payload = {
|
|
230
|
+
note: '下游硬编码存量快照。由 check:usage --update-baseline 生成,勿手改。key 为 文件::规则,值为处数。',
|
|
231
|
+
generatedFrom: present.map((t) => t.label),
|
|
232
|
+
counts: Object.fromEntries(Object.entries(current).sort(([a], [b]) => a.localeCompare(b))),
|
|
233
|
+
}
|
|
234
|
+
fs.writeFileSync(BASELINE_FILE, `${JSON.stringify(payload, null, 2)}\n`)
|
|
235
|
+
const total = Object.values(current).reduce((a, b) => a + b, 0)
|
|
236
|
+
console.log(`✔ 已写入 baseline:${total} 处存量、${Object.keys(current).length} 个 文件::规则 组合`)
|
|
237
|
+
console.log(` → ${path.relative(process.cwd(), BASELINE_FILE) || 'token-usage-baseline.json'}`)
|
|
238
|
+
process.exit(0)
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
let baseline = { counts: {} }
|
|
242
|
+
try {
|
|
243
|
+
baseline = JSON.parse(fs.readFileSync(BASELINE_FILE, 'utf8'))
|
|
244
|
+
} catch {
|
|
245
|
+
console.error('⚠ 未找到 token-usage-baseline.json,本次把所有命中都视为新增。')
|
|
246
|
+
console.error(' 首次接入请先跑:npm run check:usage -- --update-baseline')
|
|
247
|
+
}
|
|
248
|
+
const base = baseline.counts ?? {}
|
|
249
|
+
|
|
250
|
+
const blocking = []
|
|
251
|
+
for (const [key, count] of Object.entries(current)) {
|
|
252
|
+
const was = base[key] ?? 0
|
|
253
|
+
if (count > was) blocking.push({ key, was, now: count, items: findings.filter((f) => keyOf(f) === key) })
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
// 「已减少」只在本次真扫过的文件里判。否则显式传子集时(node ... <单个目录>),
|
|
257
|
+
// baseline 里其它端的条目会全被当成「已修好」刷一屏 —— 假信号一多,就没人看输出了。
|
|
258
|
+
const scanned = new Set(files.map((f) => displayPath(f)))
|
|
259
|
+
const fixed = Object.entries(base).filter(
|
|
260
|
+
([k, v]) => scanned.has(k.slice(0, k.lastIndexOf('::'))) && (current[k] ?? 0) < v,
|
|
261
|
+
)
|
|
262
|
+
|
|
263
|
+
if (flag('--all')) {
|
|
264
|
+
const total = Object.values(current).reduce((a, b) => a + b, 0)
|
|
265
|
+
console.log(`存量清单:${total} 处,${Object.keys(current).length} 个 文件::规则 组合\n`)
|
|
266
|
+
for (const f of findings) {
|
|
267
|
+
console.log(`- ${f.file}:${f.line} [${f.rule}] ${f.value}`)
|
|
268
|
+
}
|
|
269
|
+
process.exit(0)
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
console.log(`扫描 ${files.length} 个文件(${present.map((t) => t.label).join(', ')})`)
|
|
273
|
+
|
|
274
|
+
if (fixed.length > 0) {
|
|
275
|
+
console.log(`\n已减少 ${fixed.length} 个组合(baseline 里还记着更多,建议 --update-baseline 收口):`)
|
|
276
|
+
for (const [k, v] of fixed.slice(0, 10)) console.log(` ${k}: ${v} → ${current[k] ?? 0}`)
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
if (blocking.length === 0) {
|
|
280
|
+
const total = Object.values(current).reduce((a, b) => a + b, 0)
|
|
281
|
+
console.log(`\n✔ 硬编码门禁通过(无新增)。存量 ${total} 处已在 baseline,用 --all 查看清单。`)
|
|
78
282
|
process.exit(0)
|
|
79
283
|
}
|
|
80
284
|
|
|
81
|
-
console.error(
|
|
82
|
-
for (const
|
|
83
|
-
console.error(
|
|
84
|
-
console.error(` ${
|
|
85
|
-
|
|
285
|
+
console.error(`\n✗ 硬编码门禁未通过:${blocking.length} 个 文件::规则 有新增`)
|
|
286
|
+
for (const b of blocking) {
|
|
287
|
+
console.error(`\n ${b.key} (baseline ${b.was} → 现在 ${b.now})`)
|
|
288
|
+
console.error(` ${b.items[0].message}`)
|
|
289
|
+
for (const it of b.items.slice(0, 5)) {
|
|
290
|
+
console.error(` ${it.file}:${it.line} ${it.value}`)
|
|
291
|
+
console.error(` ${it.text.slice(0, 110)}`)
|
|
292
|
+
}
|
|
293
|
+
if (b.items.length > 5) console.error(` …… 另 ${b.items.length - 5} 处`)
|
|
86
294
|
}
|
|
295
|
+
console.error('')
|
|
296
|
+
console.error(' 存量不阻断,只拦新增。确实要放行(如第三方组件必须内联):')
|
|
297
|
+
console.error(` · 在该文件里写注释 ${IGNORE} 整file豁免`)
|
|
298
|
+
console.error(' · 或收口后跑 npm run check:usage -- --update-baseline')
|
|
87
299
|
process.exit(1)
|
package/tokens.css
CHANGED
|
@@ -232,7 +232,17 @@
|
|
|
232
232
|
|
|
233
233
|
/* ── 产品市场 UX:官网内容卡 + 高密度信息 tile + 工具栏 + 图片 Banner ──
|
|
234
234
|
设计依据:2026-08 国内官网改版与控制台模型广场。官网保留舒展的 card,
|
|
235
|
-
模型列表/筛选等高频信息区使用更紧凑的 tile;二者不混用。
|
|
235
|
+
模型列表/筛选等高频信息区使用更紧凑的 tile;二者不混用。
|
|
236
|
+
|
|
237
|
+
⚠️ 2026-08-24 更正上面这条依据的一半:「国内官网改版」这个依据已经失效。
|
|
238
|
+
国内官网的模型广场已并入控制台(modelgo-web 的 /models 只做 301 到
|
|
239
|
+
console.modelgo.com/models),官网侧不再有模型列表/筛选这类高密度场景;
|
|
240
|
+
且官网锁 ^0.6.2,本段是 0.6.2 之后进包的,它技术上也拿不到。
|
|
241
|
+
实测四端对本段的消费:console-web 21 个,国内官网 / 海外官网 / 文档站 0 个
|
|
242
|
+
——两个官网消费的是基础层(品牌色/字阶/圆角/间距),这是分工而非缺口,
|
|
243
|
+
正是上面「二者不混用」那句话的结果。
|
|
244
|
+
所以本段的现实消费方只有控制台。按治理文档 §3,零引用不构成删除理由,
|
|
245
|
+
token 保留;但后续改本段的值,设计依据要以控制台为对象,别再写官网。 */
|
|
236
246
|
--mg-text-market-title: 34px;
|
|
237
247
|
--mg-text-market-title-line: 1.5;
|
|
238
248
|
/* -0.025em = Tailwind tracking-tight,控制台模型广场 h1 实际在用的值
|
|
@@ -248,11 +258,23 @@
|
|
|
248
258
|
--mg-tile-bg: var(--mg-glass-surface);
|
|
249
259
|
--mg-tile-border: var(--mg-glass-line);
|
|
250
260
|
--mg-tile-border-hover: color-mix(in oklab, var(--mg-brand-base) 24%, var(--mg-border));
|
|
261
|
+
/* tile 家族圆角的唯一定义点(下方「卡片(Card / Tile)」段曾重复声明同值,2026-08-24 撤除) */
|
|
251
262
|
--mg-tile-radius: var(--mg-radius-md);
|
|
252
263
|
--mg-tile-pad: var(--mg-space-4);
|
|
253
264
|
--mg-tile-gap: var(--mg-space-3);
|
|
254
|
-
|
|
255
|
-
|
|
265
|
+
/* 卡片阴影结论(qa#686 UI 侧定案):tile 与 card 是同一档,深度取三层扩散——
|
|
266
|
+
即 --mg-card-shadow(见下方「卡片(Card / Tile)」段),2026-07-23 定的
|
|
267
|
+
Apple 风卡片语言「淡边框 + 柔和扩散阴影撑层次」,控制台 .mg-tile 100% 在用这个
|
|
268
|
+
(6 处消费,--mg-tile-shadow 本身 0 处),不是重新拍一遍、是把既成事实收编成真源。
|
|
269
|
+
直接改引 --mg-card-shadow,**不改** --mg-shadow-card(两层紧贴)本身:那条被
|
|
270
|
+
modelgo-web 官网在用(转发成 --modelgo-shadow-card),改它的值会连带改官网卡片,
|
|
271
|
+
而三层扩散这个决定只针对控制台,官网没人确认过。
|
|
272
|
+
hover 同理定为中性:.mg-tile-hover:hover 现在的硬编码就是本地 --shadow-md
|
|
273
|
+
(components.css:277),压根没走 --mg-shadow-card-hover 那条品牌染色 token,
|
|
274
|
+
这里改引 --mg-shadow-md 只是把既成事实收回真源,不是重新拍板。
|
|
275
|
+
--mg-shadow-card-hover(品牌染色)留给官网氛围场景用,未受影响。 */
|
|
276
|
+
--mg-tile-shadow: var(--mg-card-shadow);
|
|
277
|
+
--mg-tile-shadow-hover: var(--mg-shadow-md);
|
|
256
278
|
|
|
257
279
|
--mg-control-height: 40px;
|
|
258
280
|
--mg-control-height-lg: 48px;
|
|
@@ -301,7 +323,10 @@
|
|
|
301
323
|
--mg-logo-size-hero: 48px; /* 模型详情页 Hero */
|
|
302
324
|
|
|
303
325
|
/* logo 与相邻文字的行内间距:卡片级更松,紧凑行内更紧 */
|
|
304
|
-
|
|
326
|
+
/* 任务列表这类「图标紧贴文字」的行内配对场景(qa#686 更正:原注释还写了
|
|
327
|
+
「Dashboard 排行」,但排行榜行是 rank/logo/名称/金额一整行统一 gap-3(12px)
|
|
328
|
+
的多字段数据行布局,不是图标+文字紧配对,本就不该套这档,删掉这条误标) */
|
|
329
|
+
--mg-logo-gap-xs: 6px; /* 任务列表等紧凑行 */
|
|
305
330
|
--mg-logo-gap-sm: 7px; /* 相关模型卡片头 */
|
|
306
331
|
--mg-logo-gap-md: 10px; /* 模型广场卡片顶行 / 选择器行 / Playground 触发按钮 */
|
|
307
332
|
}
|
|
@@ -399,12 +424,18 @@
|
|
|
399
424
|
/* ── 图表分类色:6 色循环 ─────────────────────────────────────
|
|
400
425
|
多序列折线/柱状/面积图按序取用;单值进度条仍走 --mg-progress-*。
|
|
401
426
|
值取控制台现行(console-web/src/styles/tokens.css:63-80)。
|
|
402
|
-
深色档在下方 [data-theme]
|
|
427
|
+
深色档在下方 [data-theme] 块覆盖,六色现已全部提亮(qa#672)。
|
|
403
428
|
legacy 无前缀别名 --chart-cat-* 刻意不下沉 —— SSOT 只出 --mg- 前缀,
|
|
404
|
-
消费方自己维护兼容别名(console-web 已有)。
|
|
429
|
+
消费方自己维护兼容别名(console-web 已有)。
|
|
430
|
+
cat-2 / cat-3 浅色对比度不达 3:1(qa#672),处理不同:
|
|
431
|
+
cat-2 差距小(2.52→需3),微调即达标,见下方定值;
|
|
432
|
+
cat-3 差距大(1.94,压到 3 需降 L 7.6pt、金黄会变土黄),
|
|
433
|
+
不改值、改走「附使用约束」——只作填充/大面积用色,不单独承担
|
|
434
|
+
细线/图例圆点这类必须靠色本身识别的场景(同 --mg-text-3 的处理方式)。 */
|
|
405
435
|
--mg-chart-cat-1: #2a78d6; /* blue */
|
|
406
|
-
--mg-chart-cat-2: #
|
|
407
|
-
|
|
436
|
+
--mg-chart-cat-2: #17976a; /* teal,qa#672:#1baf7a → #17976a。四个浅色底一起判才发现
|
|
437
|
+
最差的是 --mg-surface-solid(#f2f2f6),不是 --mg-bg——单底估算会漏掉这项。L -5.5pt */
|
|
438
|
+
--mg-chart-cat-3: #eda100; /* amber,qa#672:对比度 1.94 不达 3,见上方注释与契约 note,不改值 */
|
|
408
439
|
--mg-chart-cat-4: #008300; /* green */
|
|
409
440
|
--mg-chart-cat-5: #4a3aa7; /* indigo */
|
|
410
441
|
--mg-chart-cat-6: #e34948; /* red */
|
|
@@ -587,12 +618,17 @@
|
|
|
587
618
|
--mg-shadow-hover-md: 0 12px 30px rgba(0, 0, 0, 0.38), 0 0 0 1px rgba(255, 255, 255, 0.05);
|
|
588
619
|
--mg-shadow-hover-lg: 0 20px 52px rgba(0, 0, 0, 0.46), 0 0 0 1px rgba(255, 255, 255, 0.06);
|
|
589
620
|
|
|
590
|
-
/* 图表分类色深色档(下沉自 console-web/src/styles/tokens.css:622-627
|
|
591
|
-
cat-4
|
|
621
|
+
/* 图表分类色深色档(下沉自 console-web/src/styles/tokens.css:622-627)。
|
|
622
|
+
cat-4 原两档同值——不是「深底上已足够亮」,是补深色档时漏改的那一个(qa#672):
|
|
623
|
+
实测在 --mg-bg 上 3.58:1 看着达标,但图表画在卡片面上,--mg-surface-2/-3
|
|
624
|
+
只有 2.72 / 2.24,同组最低。qa#613 划的「深色档不动」范围本不含这种漏填的情况,
|
|
625
|
+
此处按 qa#672 UI 侧裁决破例补齐,不算重开深色主题。
|
|
626
|
+
#008300 → #00a300:保持纯绿色相与满饱和度,仅提亮 L,对四个暗底最差处
|
|
627
|
+
(--mg-surface-3)达 3.29:1,比其余 5 色最低margin(cat-1 3.69)略紧但仍有余量。 */
|
|
592
628
|
--mg-chart-cat-1: #3987e5;
|
|
593
629
|
--mg-chart-cat-2: #199e70;
|
|
594
630
|
--mg-chart-cat-3: #c98500;
|
|
595
|
-
--mg-chart-cat-4: #
|
|
631
|
+
--mg-chart-cat-4: #00a300;
|
|
596
632
|
--mg-chart-cat-5: #9085e9;
|
|
597
633
|
--mg-chart-cat-6: #e66767;
|
|
598
634
|
}
|
|
@@ -939,7 +975,10 @@
|
|
|
939
975
|
1.31,垫在实色 --mg-surface-solid 上只剩 1.19,会静默不达标。(qa#614 衍生) */
|
|
940
976
|
--mg-card-border: rgba(16, 24, 40, 0.13);
|
|
941
977
|
--mg-card-shadow: 0 1px 2px rgba(16, 24, 40, 0.04), 0 6px 16px -6px rgba(16, 24, 40, 0.10), 0 16px 32px -14px rgba(16, 24, 40, 0.08);
|
|
942
|
-
--mg-tile-radius
|
|
978
|
+
/* --mg-tile-radius 不在这里定义:它属于上面「产品市场 UX」的 tile 家族,
|
|
979
|
+
此处曾重复声明同一个值(var(--mg-radius-md)),违反治理文档 §1
|
|
980
|
+
「一个概念只允许一个规范名」——同名两个定义点,改一处不会同步另一处,
|
|
981
|
+
而两处同值时这种漂移不会以任何错误的形式出现。 */
|
|
943
982
|
}
|
|
944
983
|
[data-theme='dark'] {
|
|
945
984
|
--mg-card-border: rgba(255, 255, 255, 0.08);
|
|
@@ -1288,8 +1327,20 @@
|
|
|
1288
1327
|
dialog 居中、受视口边距夹逼;sheet 贴边、占满高度。 */
|
|
1289
1328
|
:root {
|
|
1290
1329
|
--mg-dialog-pad: var(--mg-space-6);
|
|
1291
|
-
/*
|
|
1292
|
-
|
|
1330
|
+
/* qa#611 ③ 改判:撤回 08-18「不配固定档位、内容自适应」的定案,改回三档固定宽度。
|
|
1331
|
+
不是重新拍一遍——是控制台 Modal.tsx 的 SIZE_MAP 已经按这套分档跑了一段时间、
|
|
1332
|
+
且经过一次真实调整(console-web 114c3de0:sm 底宽 360→400,消除小弹窗「小气」感),
|
|
1333
|
+
数值直接取自那里,不是本仓另编一套:
|
|
1334
|
+
sm 400px 纯确认框(短提示 + 按钮,无表单字段)
|
|
1335
|
+
md 520px 默认,内容型表单/公告
|
|
1336
|
+
lg 720px 复杂多区(多个独立信息块/步骤)
|
|
1337
|
+
判据是内容类型,不是量出来的宽度。min/max 保留作区间兜底——
|
|
1338
|
+
个别有正当理由跳出三档的弹窗(如需要并排多列的对比工具)继续按内容定制宽度,
|
|
1339
|
+
不必也不应该被收进三档。 */
|
|
1340
|
+
--mg-dialog-width-sm: 400px;
|
|
1341
|
+
--mg-dialog-width-md: 520px;
|
|
1342
|
+
--mg-dialog-width-lg: 720px;
|
|
1343
|
+
--mg-dialog-width: var(--mg-dialog-width-md);
|
|
1293
1344
|
--mg-dialog-min-width: 360px;
|
|
1294
1345
|
--mg-dialog-max-width: 720px;
|
|
1295
1346
|
/* 90dvh:qa#611 ③ 定案不切 min(720px, 100dvh-128px),保持 qa#458 已验收的封顶行为 */
|