[ISSUE-0175] AI 界面尺寸漂移¶
病灶:可数的退化,不是审美口味¶
v0.14.4 时量出来:
| 项 | 种类 | 实际值 |
|---|---|---|
| 字号 | 8 | 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 |
| Chip 高度 | 5 | 16 / 18 / 20 / 22(+ 进度条的 4) |
| 间距 | — | 含 0.75(6px)、1.25(10px),不在 8pt 网格上 |
10px 和 11px 差一个像素 —— 用户根本感知不到。 它不构成层级,只制造不一致;但写代码的人会以为「这两处有意做了区分」, 于是下一版再加第 9 种。
怎么长出来的¶
v0.13.3 Chip height: 18
v0.13.7 加 20(账号状态标签,想要大一点)
v0.14.0 加 16(下拉里的小标记,想要小一点)
v0.14.3 加 22(可点击的变量 Chip,要够大能点)
每一次都有当时的理由,每一次都只看眼前那一处。 没有任何一步是错的,但四步加起来就是四种高度。
修¶
src/theme/ai-ui-tokens.ts:
- 字号 3 档(11 / 13 / 15),档间至少差 2px
- Chip 高度 2 档,按角色分:
inline—— 贴在一行文字里的标记(「视觉」「1M」「已改」)standalone—— 自己占一格、需要被扫到的状态(「已验证」「已失效」)
🔴 关键是按角色不按位置:原来那四档之间没有任何角色差异。 按角色分之后,「这里该用哪个」有唯一答案 —— 而每一次犹豫都会变成第 5 档。
元教训¶
🔴 这类问题不能靠文档治,只能靠闸。
我一直「知道」尺寸该一致 —— 知道没用,因为退化不是在「决定规范」的时候发生的, 是在「加第 20 个组件」的时候发生的,而那时人在想的是那个组件。
⇒ tests/ai-ui-tokens.test.ts 扫全部 ai-*.tsx:裸字号 / 裸 Chip 高度 = 红。
外加三条防「闸自己退化」:档间差 ≥2px、档数 ≤3、正文 ≥12px。
文档要读了才生效,闸是跑了就生效。