modelgo-design-tokens 0.11.0 → 0.11.1
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 +24 -0
- package/TOKEN-GOVERNANCE.md +30 -3
- package/base.css +11 -1
- package/console.css +12 -1
- package/package.json +1 -1
- package/scripts/check-token-usage.mjs +237 -32
- package/tokens.css +27 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,30 @@
|
|
|
2
2
|
|
|
3
3
|
## Unreleased
|
|
4
4
|
|
|
5
|
+
### Fixed
|
|
6
|
+
|
|
7
|
+
- **`check:usage` 修掉静默假绿,并补齐覆盖范围**(工具改动,不影响任何 token 值,
|
|
8
|
+
消费方无需升级即可用)。三个叠在一起的问题:
|
|
9
|
+
1. **找不到扫描目标时静默通过。** 原实现 `.filter(existsSync)` 把不存在的目标直接丢掉,
|
|
10
|
+
全丢光时扫 0 个文件仍打印 `Token usage check passed.`。而 `DEFAULT_TARGETS` 是相对
|
|
11
|
+
`cwd` 的兄弟仓路径,**在 worktree 里跑必然全部找不到**(cwd 是
|
|
12
|
+
`<repo>/.claude/worktrees/<name>`)—— 也就是说在 worktree 里这道门禁长期是假绿。
|
|
13
|
+
现在既感知 worktree 布局(能正确回溯到工作区根,也可用 `MODELGO_WORKSPACE` 覆盖),
|
|
14
|
+
又在一个目标都找不到、或扫到 0 个文件时以**退出码 2** 明确失败。
|
|
15
|
+
2. **只扫 console-web。** `DEFAULT_TARGETS` 另一项 `wt-console-glass` 早已不存在,
|
|
16
|
+
于是**国内官网、海外官网、文档站从未被扫过**。现在四端全覆盖。
|
|
17
|
+
3. **规则只查颜色和 z-index。** 库里 `ease` / `duration` / `radius` / `shadow` 早已成体系,
|
|
18
|
+
却一条都没查。补四条规则后存量从 22 处涨到 **402 处**(console-web 187 / 国内官网 180 /
|
|
19
|
+
海外官网 35 / 文档站 0),即原先只看得见 5.5%。
|
|
20
|
+
|
|
21
|
+
配套引入 `token-usage-baseline.json`:**存量不阻断,只拦新增**(照 `check:contrast` 的口径,
|
|
22
|
+
否则第一次接入就拦死所有提交,最后只会被 `--no-verify` 绕过)。key 为 `文件::规则`
|
|
23
|
+
不含行号,重构挪动代码不会误判成新增。收口 `-- --update-baseline`,看清单 `-- --all`。
|
|
24
|
+
|
|
25
|
+
⚠️ **已知缺口**:这道检查扫的是下游代码,本仓 pre-commit 只在 `tokens.css` 进暂存区时触发,
|
|
26
|
+
所以**它至今没有自动触发点**。要真正拦住下游新增硬编码,得在各端自己的提交期调用它。
|
|
27
|
+
详见 TOKEN-GOVERNANCE.md §6.1。
|
|
28
|
+
|
|
5
29
|
### Added
|
|
6
30
|
|
|
7
31
|
- **Token 分层产物:`base.css` / `console.css` / `website.css`**(241 / 434 / 4 个 token)。
|
package/TOKEN-GOVERNANCE.md
CHANGED
|
@@ -76,9 +76,36 @@
|
|
|
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.1 `check:usage` 的定位与它的缺口(读完再依赖它)
|
|
89
|
+
|
|
90
|
+
它扫的是**消费方源码**,不是本仓。所以:
|
|
91
|
+
|
|
92
|
+
- **它没有自动触发点。** 本仓 pre-commit 只在 `tokens.css` 进暂存区时触发,而本检查
|
|
93
|
+
和 `tokens.css` 无关;本仓提交时跑它也没意义(本仓提交不改下游代码)。
|
|
94
|
+
**「库侧门禁全绿」不代表下游没有新增硬编码。** 要真拦住,得在各端自己的提交期调用它
|
|
95
|
+
—— 这一步**尚未做**,是已知缺口。
|
|
96
|
+
- **存量不阻断**:`token-usage-baseline.json` 记 `文件::规则 → 处数`,只有新组合出现、
|
|
97
|
+
或已记组合处数变多才拦。key 刻意不含行号,重构挪代码不会被误判成新增。
|
|
98
|
+
收口用 `pnpm check:usage -- --update-baseline`,看清单用 `-- --all`。
|
|
99
|
+
- **豁免三种**:文件里写 `token-check-ignore` 整 file 跳过;`--x: <字面值>` 这种
|
|
100
|
+
token 定义行不算违规(本地 token 层该不该收进库是另一个议题);命中文本里已含
|
|
101
|
+
`var()` 的不算。
|
|
102
|
+
- **路径靠工作区布局推断**:默认按兄弟仓找(`modelgo-console-web/src` 等)。
|
|
103
|
+
在 worktree 里跑也能正确解析;布局不同用 `MODELGO_WORKSPACE=/path` 覆盖。
|
|
104
|
+
**找不到目标时会以退出码 2 失败,不会静默通过** —— 2026-08-24 之前它会把找不到的
|
|
105
|
+
目标静默丢掉、扫 0 个文件仍打印 `passed`,在 worktree 里跑必然假绿。
|
|
106
|
+
|
|
107
|
+
> 覆盖范围的历史教训:这个脚本原先只有 4 条规则(Tailwind 语义色、两个 legacy hex、
|
|
108
|
+
> z-index),且 `DEFAULT_TARGETS` 只含 console-web 和一个早已不存在的目录。
|
|
109
|
+
> 结果是**国内官网从未被扫过**,而库里成体系的 `ease` / `duration` / `radius` / `shadow`
|
|
110
|
+
> 一条都没查 —— 补齐后存量从 22 处涨到 402 处,即原先只看得见 5.5%。
|
|
111
|
+
> 新增规则时记住:**没被规则覆盖的维度,等于默许硬编码**。
|
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
|
@@ -46,9 +46,21 @@
|
|
|
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);
|
|
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 能过。 */
|
|
52
64
|
--mg-tile-shadow: var(--mg-shadow-card);
|
|
53
65
|
--mg-tile-shadow-hover: var(--mg-shadow-card-hover);
|
|
54
66
|
|
|
@@ -365,7 +377,6 @@
|
|
|
365
377
|
1.31,垫在实色 --mg-surface-solid 上只剩 1.19,会静默不达标。(qa#614 衍生) */
|
|
366
378
|
--mg-card-border: rgba(16, 24, 40, 0.13);
|
|
367
379
|
--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
380
|
}
|
|
370
381
|
[data-theme='dark'] {
|
|
371
382
|
--mg-card-border: rgba(255, 255, 255, 0.08);
|
package/package.json
CHANGED
|
@@ -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,47 @@ 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
|
+
const fromWorkspace = path.relative(WORKSPACE, abs)
|
|
125
|
+
if (!fromWorkspace.startsWith('..')) return fromWorkspace
|
|
126
|
+
const fromCwd = path.relative(ROOT, abs)
|
|
127
|
+
return fromCwd.startsWith('..') ? abs : fromCwd
|
|
128
|
+
}
|
|
129
|
+
|
|
39
130
|
function walk(dir, files = []) {
|
|
40
131
|
for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
|
|
41
132
|
if (SKIP_DIRS.has(entry.name)) continue
|
|
@@ -49,39 +140,153 @@ function walk(dir, files = []) {
|
|
|
49
140
|
return files
|
|
50
141
|
}
|
|
51
142
|
|
|
143
|
+
// ── 解析扫描目标:显式参数相对 cwd,默认目标相对工作区根 ──
|
|
144
|
+
const requested = dirArgs.length > 0
|
|
145
|
+
? dirArgs.map((d) => ({ label: d, abs: path.resolve(ROOT, d) }))
|
|
146
|
+
: DEFAULT_TARGETS.map((d) => ({ label: d, abs: path.resolve(WORKSPACE, d) }))
|
|
147
|
+
|
|
148
|
+
const present = requested.filter((t) => fs.existsSync(t.abs))
|
|
149
|
+
const absent = requested.filter((t) => !fs.existsSync(t.abs))
|
|
150
|
+
|
|
151
|
+
if (absent.length > 0) {
|
|
152
|
+
// 不再静默丢弃:找不到就说出来,哪个目标、找的是哪个绝对路径
|
|
153
|
+
console.error(`⚠ ${absent.length} 个扫描目标不存在,已跳过:`)
|
|
154
|
+
for (const t of absent) console.error(` ${t.label} → ${t.abs}`)
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
if (present.length === 0) {
|
|
158
|
+
console.error('')
|
|
159
|
+
console.error('✗ 配置错误:没有一个扫描目标存在,本次实际扫了 0 个文件。')
|
|
160
|
+
console.error(' 这不是「检查通过」——原实现在这种情况下会打印 passed,属于假绿。')
|
|
161
|
+
console.error('')
|
|
162
|
+
console.error(` 当前 cwd: ${ROOT}`)
|
|
163
|
+
console.error(` 推断的工作区根: ${WORKSPACE}`)
|
|
164
|
+
console.error('')
|
|
165
|
+
console.error(' 怎么办(任一):')
|
|
166
|
+
console.error(' · 显式传目录:node scripts/check-token-usage.mjs ../modelgo-console-web/src')
|
|
167
|
+
console.error(' · 指定工作区:MODELGO_WORKSPACE=/path/to/modelgo npm run check:usage')
|
|
168
|
+
process.exit(2)
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
const files = present.flatMap((t) => walk(t.abs))
|
|
172
|
+
if (files.length === 0) {
|
|
173
|
+
console.error(`✗ 配置错误:${present.length} 个目标存在,但没扫到任何可检查的文件。`)
|
|
174
|
+
console.error(` 目标: ${present.map((t) => t.label).join(', ')}`)
|
|
175
|
+
console.error(` 期望后缀: ${FILE_RE}`)
|
|
176
|
+
process.exit(2)
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
// ── 扫描 ──
|
|
52
180
|
const findings = []
|
|
53
|
-
for (const
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
181
|
+
for (const file of files) {
|
|
182
|
+
const content = fs.readFileSync(file, 'utf8')
|
|
183
|
+
if (content.includes(IGNORE)) continue
|
|
184
|
+
const lines = content.split(/\r?\n/)
|
|
185
|
+
for (const rule of rules) {
|
|
186
|
+
rule.pattern.lastIndex = 0
|
|
187
|
+
let match
|
|
188
|
+
while ((match = rule.pattern.exec(content)) !== null) {
|
|
189
|
+
if (match[0] === '') { rule.pattern.lastIndex++; continue }
|
|
190
|
+
if (rule.accept && !rule.accept(match[0])) continue
|
|
191
|
+
const line = content.slice(0, match.index).split(/\r?\n/).length
|
|
192
|
+
const text = lines[line - 1]?.trim() ?? ''
|
|
193
|
+
// 定义点豁免:`--x: <字面值>` 是在声明本地 token,不是「该用 token 却没用」。
|
|
194
|
+
// 本地 token 层该不该收进库是另一个议题,不由本规则判。
|
|
195
|
+
if (/^--[\w-]+\s*:/.test(text)) continue
|
|
196
|
+
findings.push({
|
|
197
|
+
file: displayPath(file),
|
|
198
|
+
line,
|
|
199
|
+
rule: rule.name,
|
|
200
|
+
value: match[0].replace(/\s+/g, ' ').slice(0, 80),
|
|
201
|
+
message: rule.message,
|
|
202
|
+
text,
|
|
203
|
+
})
|
|
72
204
|
}
|
|
73
205
|
}
|
|
74
206
|
}
|
|
75
207
|
|
|
76
|
-
|
|
77
|
-
|
|
208
|
+
// ── baseline 比对 ──
|
|
209
|
+
// key 刻意不含行号:重构挪动代码不该被当成新增违规;同文件同规则用计数兜住。
|
|
210
|
+
const BASELINE_FILE = path.join(ROOT, 'token-usage-baseline.json')
|
|
211
|
+
const keyOf = (f) => `${f.file}::${f.rule}`
|
|
212
|
+
|
|
213
|
+
const tally = (list) => {
|
|
214
|
+
const out = {}
|
|
215
|
+
for (const f of list) out[keyOf(f)] = (out[keyOf(f)] ?? 0) + 1
|
|
216
|
+
return out
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
const current = tally(findings)
|
|
220
|
+
|
|
221
|
+
if (flag('--update-baseline')) {
|
|
222
|
+
const payload = {
|
|
223
|
+
note: '下游硬编码存量快照。由 check:usage --update-baseline 生成,勿手改。key 为 文件::规则,值为处数。',
|
|
224
|
+
generatedFrom: present.map((t) => t.label),
|
|
225
|
+
counts: Object.fromEntries(Object.entries(current).sort(([a], [b]) => a.localeCompare(b))),
|
|
226
|
+
}
|
|
227
|
+
fs.writeFileSync(BASELINE_FILE, `${JSON.stringify(payload, null, 2)}\n`)
|
|
228
|
+
const total = Object.values(current).reduce((a, b) => a + b, 0)
|
|
229
|
+
console.log(`✔ 已写入 baseline:${total} 处存量、${Object.keys(current).length} 个 文件::规则 组合`)
|
|
230
|
+
console.log(` → ${path.relative(process.cwd(), BASELINE_FILE) || 'token-usage-baseline.json'}`)
|
|
231
|
+
process.exit(0)
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
let baseline = { counts: {} }
|
|
235
|
+
try {
|
|
236
|
+
baseline = JSON.parse(fs.readFileSync(BASELINE_FILE, 'utf8'))
|
|
237
|
+
} catch {
|
|
238
|
+
console.error('⚠ 未找到 token-usage-baseline.json,本次把所有命中都视为新增。')
|
|
239
|
+
console.error(' 首次接入请先跑:npm run check:usage -- --update-baseline')
|
|
240
|
+
}
|
|
241
|
+
const base = baseline.counts ?? {}
|
|
242
|
+
|
|
243
|
+
const blocking = []
|
|
244
|
+
for (const [key, count] of Object.entries(current)) {
|
|
245
|
+
const was = base[key] ?? 0
|
|
246
|
+
if (count > was) blocking.push({ key, was, now: count, items: findings.filter((f) => keyOf(f) === key) })
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
// 「已减少」只在本次真扫过的文件里判。否则显式传子集时(node ... <单个目录>),
|
|
250
|
+
// baseline 里其它端的条目会全被当成「已修好」刷一屏 —— 假信号一多,就没人看输出了。
|
|
251
|
+
const scanned = new Set(files.map((f) => displayPath(f)))
|
|
252
|
+
const fixed = Object.entries(base).filter(
|
|
253
|
+
([k, v]) => scanned.has(k.slice(0, k.lastIndexOf('::'))) && (current[k] ?? 0) < v,
|
|
254
|
+
)
|
|
255
|
+
|
|
256
|
+
if (flag('--all')) {
|
|
257
|
+
const total = Object.values(current).reduce((a, b) => a + b, 0)
|
|
258
|
+
console.log(`存量清单:${total} 处,${Object.keys(current).length} 个 文件::规则 组合\n`)
|
|
259
|
+
for (const f of findings) {
|
|
260
|
+
console.log(`- ${f.file}:${f.line} [${f.rule}] ${f.value}`)
|
|
261
|
+
}
|
|
262
|
+
process.exit(0)
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
console.log(`扫描 ${files.length} 个文件(${present.map((t) => t.label).join(', ')})`)
|
|
266
|
+
|
|
267
|
+
if (fixed.length > 0) {
|
|
268
|
+
console.log(`\n已减少 ${fixed.length} 个组合(baseline 里还记着更多,建议 --update-baseline 收口):`)
|
|
269
|
+
for (const [k, v] of fixed.slice(0, 10)) console.log(` ${k}: ${v} → ${current[k] ?? 0}`)
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
if (blocking.length === 0) {
|
|
273
|
+
const total = Object.values(current).reduce((a, b) => a + b, 0)
|
|
274
|
+
console.log(`\n✔ 硬编码门禁通过(无新增)。存量 ${total} 处已在 baseline,用 --all 查看清单。`)
|
|
78
275
|
process.exit(0)
|
|
79
276
|
}
|
|
80
277
|
|
|
81
|
-
console.error(
|
|
82
|
-
for (const
|
|
83
|
-
console.error(
|
|
84
|
-
console.error(` ${
|
|
85
|
-
|
|
278
|
+
console.error(`\n✗ 硬编码门禁未通过:${blocking.length} 个 文件::规则 有新增`)
|
|
279
|
+
for (const b of blocking) {
|
|
280
|
+
console.error(`\n ${b.key} (baseline ${b.was} → 现在 ${b.now})`)
|
|
281
|
+
console.error(` ${b.items[0].message}`)
|
|
282
|
+
for (const it of b.items.slice(0, 5)) {
|
|
283
|
+
console.error(` ${it.file}:${it.line} ${it.value}`)
|
|
284
|
+
console.error(` ${it.text.slice(0, 110)}`)
|
|
285
|
+
}
|
|
286
|
+
if (b.items.length > 5) console.error(` …… 另 ${b.items.length - 5} 处`)
|
|
86
287
|
}
|
|
288
|
+
console.error('')
|
|
289
|
+
console.error(' 存量不阻断,只拦新增。确实要放行(如第三方组件必须内联):')
|
|
290
|
+
console.error(` · 在该文件里写注释 ${IGNORE} 整file豁免`)
|
|
291
|
+
console.error(' · 或收口后跑 npm run check:usage -- --update-baseline')
|
|
87
292
|
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,9 +258,21 @@
|
|
|
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);
|
|
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 能过。 */
|
|
254
276
|
--mg-tile-shadow: var(--mg-shadow-card);
|
|
255
277
|
--mg-tile-shadow-hover: var(--mg-shadow-card-hover);
|
|
256
278
|
|
|
@@ -939,7 +961,10 @@
|
|
|
939
961
|
1.31,垫在实色 --mg-surface-solid 上只剩 1.19,会静默不达标。(qa#614 衍生) */
|
|
940
962
|
--mg-card-border: rgba(16, 24, 40, 0.13);
|
|
941
963
|
--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
|
|
964
|
+
/* --mg-tile-radius 不在这里定义:它属于上面「产品市场 UX」的 tile 家族,
|
|
965
|
+
此处曾重复声明同一个值(var(--mg-radius-md)),违反治理文档 §1
|
|
966
|
+
「一个概念只允许一个规范名」——同名两个定义点,改一处不会同步另一处,
|
|
967
|
+
而两处同值时这种漂移不会以任何错误的形式出现。 */
|
|
943
968
|
}
|
|
944
969
|
[data-theme='dark'] {
|
|
945
970
|
--mg-card-border: rgba(255, 255, 255, 0.08);
|