把已经统一的东西
写下来

表面与文字

这四组在 20+ 文件里零分叉，等于事实上已经是标准。 对比度是实测值，不是估的。

描边

全库最健康的一层：1px solid var(--line) 一个组合覆盖 51 个项目、1031 处， 而且真的走了变量。唯一杂音是 --line 分裂成 rgba(46 项目) 和 hex(29 项目)，这里统一取 rgba 版。

强调色 · 每个都有两版

左边是原色（只做填充/底/图标块/装饰），右边是压暗的 -ink 版（做文字/链接/小图标）。 这不是重复：7 个强调色当文字一个都不达标，压暗版才 AA。 深色主题下 -ink 自动换成提亮版，同名覆写。

五个角色

角色本身全库很清楚，乱的是命名：同一个角色平均有 8-10 种取值、4-6 种变量名 （等宽一个角色就有 --mono --font-mono --f-mono --vt-mono --ns-mono --fx-mono 六种写法）。

字号阶梯

这是全库最大的单点缺口：demo-night 有 818 处 clamp 字号、0 个字号 token。 大标题保留 clamp（她的习惯，固定 px 会打架），但上下限都写死；正文档固定不跟视口变。

圆角

12-13 个项目独立收敛到同一组数字，不是巧合：pill 999 / xl 34 / lg 24 / md 18。 sm 档全库没共识，取声明数最高的 12px。

间距 · 2px 网格

这不是 4/8 网格。实测 14px 出现 809 次比 16px 的 694 次还多， 14/18/22 三个奇数档和 16/24 平级。⛔ 按 4/8 制重排会和现存 1600+ 处声明打架。

阴影

色调已经统一（暖褐 tint rgba(53,42,33,·) 在 8-11 个项目复现）， 几何完全没统一（902 个不同取值，--shadow 一个名字下 73 个值）。 ⇒ 固定 tint + 三档 blur。

动效

180ms 是事实默认（35 项目/307 处）。120-200 挤了 6 个档、肉眼无差 ⇒ 收成 3 档。 expo-out 曲线有 12 个项目独立选中。⚠️ 53 个项目还在用裸 ease（浏览器默认、观感最平）——新页面别再写。

统计块 · 复用价值最高

原来 13 套实现同一个东西。数字用 <b> 不用 <div>， 等宽 tabular-nums 一列数才对得齐。母本 opening-market。

<div class="v-stat-grid">
  <div class="v-stat">
    <b class="v-stat-value">28<i>份</i></b>
    <span class="v-stat-label">收到反馈</span>
    <span class="v-stat-note">可选注释</span>
  </div>
</div>

<!-- 带占比条的版本 -->
VK.barRow('#bars', [
  { label: '线上', value: 18, note: '64%' },
  { label: '线下', value: 10, note: '36%' },
]);

Chip / Tag / Badge · 同一个原子的三种角色

69 个目录命中。筛选 chip 必须是 <button> 且带 aria-pressed—— 六个画廊版本里这个属性每次都得重写一遍，必漏。计数 <b> 也别省。

VK.filters('#filters', {
  items: [{ key: 'all', label: '全部' }, { key: 'a', label: '赛道 A' }],
  countOf: (k) => counts[k],          // 渲染成 <b>
  onChange: (keys) => render(keys),
});
VK.hint('#hint', shown, total, '份');  // 「已显示 N / M」

<span class="v-tag c-salmon">二次开发</span>
<span class="v-badge" data-state="ok">已确认</span>

卡片壳

画廊 6 版 + 18 处独立实现。 47 个 .gal-* 类名在三个版本里完全一致 ⇒ 壳子早就冻结了，只是没落成文件。 字段映射 {no, title, by, intro, tags[], badges[], shot, href}。 ⛔ 视觉变体别往这加（拼贴风、纸片风是她的创作面）。

控件条 · 搜索 + 筛选 + 排序 + 视图

六个画廊版本完全同构。交互细节（命中说明行、「已显示 N/M」）重写必漏。母本 gallery.html:79-108。

模态

51 个目录各写一遍，每次手写必漏一项。 这四件在 kit.js 里已经做好了：焦点陷阱 / Esc 关闭 / 点背板关闭 / 关闭后焦点还给触发元素， 外加左右键翻页。

const m = VK.modal('#detail');
m.onNav = (dir) => show(idx + dir);   // ← → 翻页
m.open(detailHtml(item));

<div class="v-modal" id="detail">
  <button class="v-modal-back" data-close aria-label="关闭"></button>
  <div class="v-modal-inner" role="dialog" aria-modal="true">
    <button class="v-modal-x" data-close aria-label="关闭">×</button>
    <div data-modal-body></div>
  </div>
</div>

议程卡

7 版各写一遍，每期活动必有。单日/双日退化逻辑用 :has() 处理—— 这段重写必错，照抄。母本 opening-market/app.js:667。

页面骨架 / 按钮 / 空态

topbar + brand-mark 在 10 个 html 里逐字相同； section-head 三件套 13 个 css 各写一遍；sticky 全库 178 个文件、层级各写各的 ⇒ 一律走 --z-sticky。入场动画 data-reveal 在 ~25 个 js 里各写一遍，现在自动接线。

形象硬规则 · 六条

每一条都是被她当场否决过才校准出来的，不是我解读定妆图得来的。 判据锚＝以她认可的成品为准。有效打法是双参考（定妆十二格 + 她认可的那张定稿）， prompt 写 match reference 2's exact face style，一轮就对。

两套合法画风 · ⛔ 拿错基准＝连翻两轮

这是视觉层最贵的一个坑：风格没错、基准拿错，出来就是废的。开工前先确认这一件事。

色板：现在是三套，互不相通

「已经有一套统一四色」这个前提不成立。 三套之间没有一个共同的 token 名，也没有任何一处把它们互指。 风格指南那套最成熟（带活动线映射 + 「一张物料只用一个主色」的使用规则）， ⇒ 最小动作＝把它升成 token 名，另两套标「待归一」，⛔ 不要一次全改。

物料尺寸规格表

原来散在各处。「1086×1448 vs 1080×1440」这种差 6px 的历史遗留最容易在贴回坐标上出事 ⇒ 收成一张表。images.edit 默认吐 1024×1536，必须显式传 size="auto"。

质检闸口 · 已内置，不用手动补

这一层是「我能自己验的」和「只有她能判的」之间的分界线。 ⚠️ 视觉核验在本环境是永久断链的：Read 读图常空返、截图工具也返回空图 ⇒ 颜色/构图/像不像本人只有她能判，⛔ 别假装验过。 所以规则必须写成能用 OCR / 像素扫描量的形式。

她本人否决过的 · 原话有据

⛔ 别再试第二遍。列出原话是为了让下一个会话不需要重新挨一次骂才知道。

工程红线 · 踩过事故

这些和审美无关，是结构性会再犯的。 共同形状是：判据写死了、真源有两份、或者兜底把 bug 变成了看起来合理的结果。

高频翻车字 · 凡出现必查

治法＝写字形拆解 + 逐个禁写法，禁写法必须填上一轮实际画错的那个字 （「桥 is 木+乔 — ⛔NEVER 梯, ⛔NEVER 杨」）。泛泛禁没用。 小字混排拉丁+中文是模型最弱项，有效打法不是加禁令，是清空竞争元素。

网页层三条硬红线

公开页面的注释view-source 就能看见，写在注释里不等于藏起来了。

四层，各管一件事

三件还没收口的事 · 摆出来不动手

这三个都是同一个东西有两份真源，改一处另一处照样再犯。 ⛔ 我没去改——它们都牵着已上线的东西，得她点头。

两件只有她能拍板的