feat(ui): 定阴影两档与字阶 CSS 变量并接线 tokens.css（0-D 硬前置①②）

- gen-tokens.mjs 新增 TYPE_SCALE / SHADOW_TOKENS 真源，人读 typeScale 改为同源派生：
  第 3 档无单位行高 1.9 → 29.5px（15.5 × 1.9 = 29.45）
- 产物新增 18 个字阶 CSS 变量与两档阴影（亮档投影 / 暗档白色反相描边）
- --due 亮档第二次对比度修正：按「三底 ≥4.5 且剪报底 ≥4.55」取最小加深量
  ⇒ #9F5E10（f=0.994；剪报底 4.5571 / 纸 4.9309 / 面 5.1436）
- 新增剪报底「底 × 墨」组合断言 + ink-4 / 旧值 #A05F10 两条反例守门（ink-4 值不动）
- main.tsx 接线 ./ui/tokens.css（排 note-mark.css 之前），drift 测试加接线守卫
- 回写 ui-ux-system.md（阴影改名与剪报前景规则）与规格 §4.1/§4.2/§4.4

Author: Aparencia

app/scripts/gen-tokens.mjs

@@ -36,7 +36,7 @@ export const COLOR_TOKENS = [
   { name: "bg-sunken", light: "#F1EEE7", dark: "#100F0E", usage: "输入槽 / 骨架 / 内嵌" },
   { name: "bg-canvas", light: "#FBFAF8", dark: "#141312", usage: "窗口底（纸）" },
   { name: "bg-surface", light: "#FFFFFF", dark: "#1C1A18", usage: "卡片 / 列 / 阅读面" },
-  { name: "bg-raised", light: "#FFFFFF", dark: "#24211E", usage: "弹层 / 菜单 / 浮窗（亮档另加 --ed-shadow-1（0-D 前定值））" },
+  { name: "bg-raised", light: "#FFFFFF", dark: "#24211E", usage: "弹层 / 菜单 / 浮窗（亮档另加 --ed-shadow-1）" },
   { name: "border", light: "#EAE7E0", dark: "#2E2A26", usage: "横格 / 分隔" },
   { name: "border-strong", light: "#C9C4B8", dark: "#423C36", usage: "输入框 / 刻度底 / 引线" },
   { name: "ink-4", light: "#909088", dark: "#6E6A62", usage: "未确认（过渡态，3.22:1，见 ADR-032 第 4 条）" },
@@ -46,18 +46,43 @@ export const COLOR_TOKENS = [
   { name: "mark-clip", light: "#F4F1E9", dark: "#221F1B", usage: "剪报底纹（默认开，仅背景色不加边框）" },
   { name: "stamp", light: "#B3271E", dark: "#E0604F", usage: "状态戳 —— 全站唯一非中性色，绝不用于按钮" },
   { name: "ok", light: "#2F7A4F", dark: "#4FAE74", usage: "掌握 / 已毕业 / 成功回执" },
-  { name: "due", light: "#A05F10", dark: "#E0A44B", usage: "到期刻度 / 低置信点线 / 记忆语义文字（亮档原 #B26A12 实测仅 4.06:1，不合格，已改）" },
+  { name: "due", light: "#9F5E10", dark: "#E0A44B", usage: "到期刻度 / 低置信点线 / 记忆语义文字（亮档两次对比度修正：#B26A12 4.06:1 → #A05F10 → #9F5E10；最终值以剪报底余量 ≥0.05 为准）" },
   { name: "link", light: "#1F5FBF", dark: "#6E9BE8", usage: "链接 / 时间码 / 引用" },
   { name: "overlay", light: "#1A1A1A", dark: "#1A1A1A", usage: "遮罩基色（配 --ed-overlay-alpha 使用）" },
 ];
 
+/**
+ * 字阶结构化真源（规范 §4.2）—— CSS 变量与人读串**同源派生**，不允许各写一份。
+ * 第 3 档原为无单位行高 `1.9`，其余为 px（两种写法并存会让 CSS 无法统一消费）；
+ * 换算依据：15.5px × 1.9 = 29.45px ⇒ 取一位小数 **29.5px**（0.5px 是可用精度，
+ * 差 0.05px 不影响任何排版判定，且比 29px 更接近真实行高）。
+ */
+export const TYPE_SCALE = [
+  { size: 25, line: 34, weight: 600 },
+  { size: 17, line: 24, weight: 600 },
+  { size: 15.5, line: 29.5, weight: 400 },
+  { size: 13, line: 20, weight: 400 },
+  { size: 12, line: 18, weight: 500 },
+  { size: 11.5, line: 16, weight: 500 },
+];
+
+/**
+ * 阴影 token（规范 §4.2② · 2026-09-11 用户裁决「纸感双层暖墨」，提交 `44b6e05a`）。
+ * **暗档不用投影**，改白色反相描边（沿用 `docs/product/ui-ux-system.md:204` 的既有做法）——
+ * 暗底上的黑色投影看不见，只会让面板边缘糊成一团。
+ */
+export const SHADOW_TOKENS = [
+  { name: "shadow-1", light: "0 1px 2px rgba(28,25,23,.06), 0 4px 12px rgba(28,25,23,.08)", dark: "0 0 0 1px rgba(255,255,255,.06)", usage: "低层：菜单 / 浮层 / 小卡（亮档投影；暗档反相描边）" },
+  { name: "shadow-2", light: "0 2px 4px rgba(28,25,23,.06), 0 12px 32px rgba(28,25,23,.14)", dark: "0 0 0 1px rgba(255,255,255,.06)", usage: "高层：Modal / 浮窗（亮档投影；暗档反相描边）" },
+];
+
 /** 非颜色 token：两档共用（规范 §4.2） */
 export const SCALE_SOURCE = {
   fontFamilyBody: '"Source Han Serif SC", "Songti SC", SimSun, serif',
   fontFamilyUi: '"Inter", "Segoe UI Variable", "Microsoft YaHei UI", system-ui, sans-serif',
   fontFamilyMono: '"JetBrains Mono", Consolas, ui-monospace, monospace',
-  /** 字阶：字号/行高·字重（规范 §4.2，下界 12px；`11.5/16 mono` 为唯一点名例外） */
-  typeScale: ["25px/34px·600", "17px/24px·600", "15.5px/1.9·400", "13px/20px·400", "12px/18px·500", "11.5px/16px·500"],
+  /** 字阶：字号/行高·字重（规范 §4.2，下界 12px；`11.5/16 mono` 为唯一点名例外）—— 由 TYPE_SCALE 派生 */
+  typeScale: TYPE_SCALE.map((t) => `${t.size}px/${t.line}px·${t.weight}`),
   /** 间距：4 为半档，其余落 8px 网格 */
   spaceScale: [4, 8, 12, 16, 24, 32, 48],
   /** 圆角：3 印章 · 5 控件与卡 · 8 面板 · 10 浮层 */
@@ -104,12 +129,22 @@ ${light}
   --ed-font-ui: ${SCALE_SOURCE.fontFamilyUi};
   --ed-font-mono: ${SCALE_SOURCE.fontFamilyMono};
 
+  /* 字阶（规范 §4.2）：--ed-type-<n>-{size,line,weight}，n 与 TYPE_SCALE 下标同序（1 起） */
+${TYPE_SCALE.map((t, i) => [
+  `  --ed-type-${i + 1}-size: ${t.size}px;`,
+  `  --ed-type-${i + 1}-line: ${t.line}px;`,
+  `  --ed-type-${i + 1}-weight: ${t.weight};`,
+].join("\n")).join("\n")}
+
   /* 间距（4 为半档，仅图标内边距） */
 ${SCALE_SOURCE.spaceScale.map((n) => `  --ed-space-${n}: ${n}px;`).join("\n")}
 
   /* 圆角 */
 ${SCALE_SOURCE.radiusScale.map((r) => `  --ed-radius-${r.name}: ${r.px}px;`).join("\n")}
 
+  /* 阴影（规范 §4.2②）：亮档投影；暗档在 [data-theme="dark"] 里改为反相白描边 */
+${SHADOW_TOKENS.map((t) => `  --ed-${t.name}: ${t.light}; /* ${t.usage} */`).join("\n")}
+
   /* 遮罩 */
   --ed-overlay-alpha: ${SCALE_SOURCE.overlayAlpha};
 
@@ -119,6 +154,9 @@ ${SCALE_SOURCE.radiusScale.map((r) => `  --ed-radius-${r.name}: ${r.px}px;`).joi
 
 [data-theme="dark"] {
 ${dark}
+
+  /* 阴影：暗档不用投影，改白色反相描边（暗底上黑色投影不可见） */
+${SHADOW_TOKENS.map((t) => `  --ed-${t.name}: ${t.dark};`).join("\n")}
 }
 `;
 }
@@ -153,6 +191,7 @@ export const SCALE_TOKENS = {
   fontFamilyUi: ${JSON.stringify(SCALE_SOURCE.fontFamilyUi)},
   fontFamilyMono: ${JSON.stringify(SCALE_SOURCE.fontFamilyMono)},
   typeScale: ${JSON.stringify(SCALE_SOURCE.typeScale)},
+  typeScaleVars: ${JSON.stringify(TYPE_SCALE)},
   spaceScale: ${JSON.stringify(SCALE_SOURCE.spaceScale)},
   radiusScale: ${JSON.stringify(SCALE_SOURCE.radiusScale)},
   overlayAlpha: ${SCALE_SOURCE.overlayAlpha},

app/scripts/gen-tokens.test.mjs

@@ -11,7 +11,7 @@
  * 待并入或显式豁免。
  */
 import { describe, expect, it } from "vitest";
-import { COLOR_TOKENS, CONTRAST_BASELINE, SCALE_SOURCE, renderAll } from "./gen-tokens.mjs";
+import { COLOR_TOKENS, CONTRAST_BASELINE, SCALE_SOURCE, SHADOW_TOKENS, TYPE_SCALE, renderAll } from "./gen-tokens.mjs";
 import { contrastRatio } from "../src/ui/contrast.ts";
 
 describe("gen-tokens 规范数据", () => {
@@ -126,3 +126,84 @@ describe("renderAll", () => {
     expect(sizes.filter((n) => n < 12)).toEqual([11.5]);
   });
 });
+
+describe("字阶 CSS 变量（0-D 硬前置②）", () => {
+  it("6 档 × size/line/weight 共 18 个变量都在，且与 TYPE_SCALE 一一对应", () => {
+    const { css } = renderAll();
+    expect(TYPE_SCALE).toHaveLength(6);
+    for (const [i, t] of TYPE_SCALE.entries()) {
+      const n = i + 1;
+      expect(css, `第 ${n} 档 size`).toContain(`--ed-type-${n}-size: ${t.size}px;`);
+      expect(css, `第 ${n} 档 line`).toContain(`--ed-type-${n}-line: ${t.line}px;`);
+      expect(css, `第 ${n} 档 weight`).toContain(`--ed-type-${n}-weight: ${t.weight};`);
+    }
+    // 18 个变量名一个不多一个不少
+    expect(css.match(/--ed-type-\d-(size|line|weight)/g)?.length).toBe(18);
+  });
+
+  it("无单位行高已消灭（反例守门：/1.9 不得回归）", () => {
+    expect(SCALE_SOURCE.typeScale.join("|")).not.toContain("/1.9");
+    expect(SCALE_SOURCE.typeScale[2]).toBe("15.5px/29.5px·400");
+    expect(SCALE_SOURCE.typeScale[2]).toContain(`${TYPE_SCALE[2].line}px`);
+  });
+
+  it("字阶人读串与结构化真源同源（不允许各写一份）", () => {
+    expect([...SCALE_SOURCE.typeScale]).toEqual(
+      TYPE_SCALE.map((t) => `${t.size}px/${t.line}px·${t.weight}`),
+    );
+  });
+});
+
+describe("阴影 token（规范 §4.2②）", () => {
+  it("两档齐全，值逐字等于用户裁决", () => {
+    expect(SHADOW_TOKENS.map((t) => t.name)).toEqual(["shadow-1", "shadow-2"]);
+    expect(SHADOW_TOKENS[0].light).toBe("0 1px 2px rgba(28,25,23,.06), 0 4px 12px rgba(28,25,23,.08)");
+    expect(SHADOW_TOKENS[1].light).toBe("0 2px 4px rgba(28,25,23,.06), 0 12px 32px rgba(28,25,23,.14)");
+  });
+
+  it("暗档不是投影而是反相白描边，且两档各写一次", () => {
+    const { css } = renderAll();
+    for (const t of SHADOW_TOKENS) {
+      expect(t.dark).toBe("0 0 0 1px rgba(255,255,255,.06)");
+      expect(css).toContain(`--ed-${t.name}: ${t.light};`);
+      expect(css).toContain(`--ed-${t.name}: ${t.dark};`);
+    }
+  });
+
+  it("usage 串不得含注释终止符（会被写进 CSS 注释）", () => {
+    for (const t of SHADOW_TOKENS) expect(t.usage).not.toContain("*/");
+  });
+
+  it("产物里不再出现「引用未定义变量」的说明（0-A 交接第 1① 条）", () => {
+    const { css, ts } = renderAll();
+    expect(css).not.toContain("0-D 前定值");
+    expect(ts).not.toContain("0-D 前定值");
+  });
+});
+
+// 求解规则（Task 1 Step 6）：保持色相、RGB 三通道按同一系数 f 缩放取整，
+// 取满足「纸 ≥4.5 且 面 ≥4.5 且 剪报底 ≥4.55」的**最小加深量**。
+// 4.55 = 4.5 底线 + 0.05 余量：`#A05F10` 正是「卡在 4.4950」的反例，
+// hex 量化与将来底色微调都会吃掉没有余量的值 —— 故余量本身是硬要求。
+describe("--due 亮档第二次对比度修正（剪报底余量规则）", () => {
+  const CLIP = "#F4F1E9"; // --ed-mark-clip 亮档
+  const by = (n) => COLOR_TOKENS.find((t) => t.name === n);
+
+  it("新值满足全部三条（纸 / 面 / 剪报底），且剪报底留 ≥0.05 余量", () => {
+    const due = by("due").light;
+    expect(contrastRatio(due, "#FBFAF8"), "due/纸").toBeGreaterThanOrEqual(4.5);
+    expect(contrastRatio(due, "#FFFFFF"), "due/面").toBeGreaterThanOrEqual(4.5);
+    expect(contrastRatio(due, CLIP), "due/剪报底").toBeGreaterThanOrEqual(4.55);
+  });
+
+  it("反例守门：被替换掉的 #A05F10 在剪报底上仍低于 4.5（不得回归）", () => {
+    expect(contrastRatio("#A05F10", CLIP)).toBeLessThan(4.5);
+    // 更早的 #B26A12 连纸底都不过
+    expect(contrastRatio("#B26A12", "#FBFAF8")).toBeLessThan(4.5);
+  });
+
+  it("暗档 #E0A44B 未被牵连改动（暗档剪报底 7.49:1 本就达标）", () => {
+    expect(by("due").dark).toBe("#E0A44B");
+    expect(contrastRatio(by("due").dark, "#221F1B")).toBeGreaterThanOrEqual(4.5);
+  });
+});

app/src/main.tsx

@@ -1,6 +1,8 @@
 import React from "react";
 import ReactDOM from "react-dom/client";
 import App from "./App";
+// 设计系统 token（ADR-032）：只定义 :root / [data-theme="dark"] 的自定义属性，无选择器 ⇒ 零视觉变化
+import "./ui/tokens.css";
 // v0.16.1：正文多色荧光笔样式（remarkMarkHighlight 注入类名 note-mark[-{colorId}]）
 import "./note-mark.css";
 

app/src/ui/contrast.test.ts

@@ -3,9 +3,12 @@
  *
  * Why：规范 §4.3 的硬数字（11 / 4.5 / 3 / 10.5）是本批验收口径，必须由机器而非人眼守护；
  * 同时守住 hex 解析的边界（非法输入抛错而非静默回退）与两档不可合并且值不得回归。
+ * 批 0-D 追加：剪报底纹（`--ed-mark-clip`）作为**第三种底**参与判定 —— §4.3 的阈值是以
+ * 「阅读面」为基准定的，把文字放到剪报底上会换底，故「底 × 墨」组合必须逐对实测。
  */
 import { describe, expect, it } from "vitest";
 import { contrastRatio, meetsAA, parseHex, relativeLuminance } from "./contrast";
+import { COLOR_TOKENS } from "./tokens";
 
 describe("parseHex", () => {
   it("解析 6 位 hex", () => {
@@ -83,11 +86,15 @@ describe("contrastRatio", () => {
     expect(contrastRatio("#6E6E68", "#FBFAF8")).toBeGreaterThanOrEqual(4.5);
   });
 
-  it("规范：due 亮档达标（原 #B26A12 仅 4.06:1，低于正文线，已改 #A05F10）", () => {
-    expect(contrastRatio("#A05F10", "#FBFAF8")).toBeGreaterThanOrEqual(4.5);
-    expect(contrastRatio("#A05F10", "#FFFFFF")).toBeGreaterThanOrEqual(4.5);
-    // 反例守门：旧值不得回归
+  it("规范：due 亮档两次修正后达标（#B26A12 4.06:1 → #A05F10 → 本值）", () => {
+    expect(contrastRatio("#9F5E10", "#FBFAF8"), "due/纸").toBeGreaterThanOrEqual(4.5);
+    expect(contrastRatio("#9F5E10", "#FFFFFF"), "due/面").toBeGreaterThanOrEqual(4.5);
+    // 第二次修正的求解规则：剪报底须留 ≥0.05 余量（4.5 + 0.05 = 4.55），
+    // 因为 hex 量化与将来底色微调都会吃掉没有余量的值（#A05F10 正是卡在 4.4950 的反例）
+    expect(contrastRatio("#9F5E10", "#F4F1E9"), "due/剪报底").toBeGreaterThanOrEqual(4.55);
+    // 反例守门：两个旧值不得回归（各自在不同底上不达标）
     expect(contrastRatio("#B26A12", "#FBFAF8")).toBeLessThan(4.5);
+    expect(contrastRatio("#A05F10", "#F4F1E9")).toBeLessThan(4.5);
   });
 
   it("规范：ink-4 对纸底允许低于 4.5 但不低于 3:1", () => {
@@ -121,3 +128,42 @@ describe("meetsAA", () => {
     expect(meetsAA(2.99, { large: true })).toBe(false);
   });
 });
+
+// ---- 剪报底纹（0-D 硬前置 · 规范 §4.4 的防御性规则）------------------------------------
+// 裁决（2026-09-11 控制方）：剪报底纹**只改背景**，文字仍用所在层级的 `--ed-ink-*`，
+// **不新增前景 token**；因此原来按「面」定的阈值在这里要逐对重测一遍。
+// 实测（Task 1 报告，亮档底 `#F4F1E9`）：ink-1 15.4197 · ink-2 10.1204 · ink-3 4.5454 ·
+// stamp 5.7679 · ok 4.6310 · due 4.5571 · link 5.3968；**ink-4 仅 2.8489 ⇒ 禁止组合**。
+// 暗档底 `#221F1B`：ink-1 14.5564 · ink-2 10.7931 · ink-3 5.5052 · ink-4 3.0480 ·
+// stamp 4.6533 · ok 5.9688 · due 7.4863 · link 5.8732。
+describe("剪报底纹上的文字（底 × 墨组合 · 规范 §4.4）", () => {
+  const by = (n: string) => COLOR_TOKENS.find((t) => t.name === n);
+  const clipOf = (theme: "light" | "dark") => by("mark-clip")![theme];
+  const AA: ReadonlyArray<readonly [string, "light" | "dark"]> = [
+    ["ink-1", "light"], ["ink-1", "dark"],
+    ["ink-2", "light"], ["ink-2", "dark"],
+    ["ink-3", "light"], ["ink-3", "dark"],
+    ["stamp", "light"], ["stamp", "dark"],
+    ["ok", "light"], ["ok", "dark"],
+    ["due", "light"], ["due", "dark"],
+    ["link", "light"], ["link", "dark"],
+    ["ink-4", "dark"], // ink-4 是过渡态：只须 ≥3（§4.3）；**亮档不在名单里 —— 见下面反例守门**
+  ];
+  for (const [name, theme] of AA) {
+    it(`${theme} · ${name} / 剪报底`, () => {
+      const floor = name === "ink-4" ? 3 : 4.5;
+      expect(contrastRatio(by(name)![theme], clipOf(theme)), `${theme} ${name}/剪报底`).toBeGreaterThanOrEqual(floor);
+    });
+  }
+
+  // ★ 反例守门（范式 B，同 `#B26A12` 的写法）：把「禁止组合」钉成机器判据 ——
+  // 将来若有人把 ink-4 的文字放到剪报底纹上，这条断言就是那份"为什么不行"的证据。
+  it("规范：ink-4 亮档不得用于剪报底纹（实测低于其 3:1 过渡态例外）", () => {
+    expect(contrastRatio(by("ink-4")!.light, clipOf("light"))).toBeLessThan(3);
+  });
+
+  it("规范：due 亮档第二次修正——刚被替换掉的 #A05F10 在剪报底上仍不达标（防回归）", () => {
+    expect(contrastRatio("#A05F10", clipOf("light"))).toBeLessThan(4.5);
+    expect(contrastRatio(by("due")!.light, clipOf("light"))).toBeGreaterThanOrEqual(4.5);
+  });
+});

app/src/ui/tokens.css

@@ -8,7 +8,7 @@
   --ed-bg-sunken: #F1EEE7; /* 输入槽 / 骨架 / 内嵌 */
   --ed-bg-canvas: #FBFAF8; /* 窗口底（纸） */
   --ed-bg-surface: #FFFFFF; /* 卡片 / 列 / 阅读面 */
-  --ed-bg-raised: #FFFFFF; /* 弹层 / 菜单 / 浮窗（亮档另加 --ed-shadow-1（0-D 前定值）） */
+  --ed-bg-raised: #FFFFFF; /* 弹层 / 菜单 / 浮窗（亮档另加 --ed-shadow-1） */
   --ed-border: #EAE7E0; /* 横格 / 分隔 */
   --ed-border-strong: #C9C4B8; /* 输入框 / 刻度底 / 引线 */
   --ed-ink-4: #909088; /* 未确认（过渡态，3.22:1，见 ADR-032 第 4 条） */
@@ -18,7 +18,7 @@
   --ed-mark-clip: #F4F1E9; /* 剪报底纹（默认开，仅背景色不加边框） */
   --ed-stamp: #B3271E; /* 状态戳 —— 全站唯一非中性色，绝不用于按钮 */
   --ed-ok: #2F7A4F; /* 掌握 / 已毕业 / 成功回执 */
-  --ed-due: #A05F10; /* 到期刻度 / 低置信点线 / 记忆语义文字（亮档原 #B26A12 实测仅 4.06:1，不合格，已改） */
+  --ed-due: #9F5E10; /* 到期刻度 / 低置信点线 / 记忆语义文字（亮档两次对比度修正：#B26A12 4.06:1 → #A05F10 → #9F5E10；最终值以剪报底余量 ≥0.05 为准） */
   --ed-link: #1F5FBF; /* 链接 / 时间码 / 引用 */
   --ed-overlay: #1A1A1A; /* 遮罩基色（配 --ed-overlay-alpha 使用） */
 
@@ -27,6 +27,26 @@
   --ed-font-ui: "Inter", "Segoe UI Variable", "Microsoft YaHei UI", system-ui, sans-serif;
   --ed-font-mono: "JetBrains Mono", Consolas, ui-monospace, monospace;
 
+  /* 字阶（规范 §4.2）：--ed-type-<n>-{size,line,weight}，n 与 TYPE_SCALE 下标同序（1 起） */
+  --ed-type-1-size: 25px;
+  --ed-type-1-line: 34px;
+  --ed-type-1-weight: 600;
+  --ed-type-2-size: 17px;
+  --ed-type-2-line: 24px;
+  --ed-type-2-weight: 600;
+  --ed-type-3-size: 15.5px;
+  --ed-type-3-line: 29.5px;
+  --ed-type-3-weight: 400;
+  --ed-type-4-size: 13px;
+  --ed-type-4-line: 20px;
+  --ed-type-4-weight: 400;
+  --ed-type-5-size: 12px;
+  --ed-type-5-line: 18px;
+  --ed-type-5-weight: 500;
+  --ed-type-6-size: 11.5px;
+  --ed-type-6-line: 16px;
+  --ed-type-6-weight: 500;
+
   /* 间距（4 为半档，仅图标内边距） */
   --ed-space-4: 4px;
   --ed-space-8: 8px;
@@ -42,6 +62,10 @@
   --ed-radius-panel: 8px;
   --ed-radius-overlay: 10px;
 
+  /* 阴影（规范 §4.2②）：亮档投影；暗档在 [data-theme="dark"] 里改为反相白描边 */
+  --ed-shadow-1: 0 1px 2px rgba(28,25,23,.06), 0 4px 12px rgba(28,25,23,.08); /* 低层：菜单 / 浮层 / 小卡（亮档投影；暗档反相描边） */
+  --ed-shadow-2: 0 2px 4px rgba(28,25,23,.06), 0 12px 32px rgba(28,25,23,.14); /* 高层：Modal / 浮窗（亮档投影；暗档反相描边） */
+
   /* 遮罩 */
   --ed-overlay-alpha: 0.34;
 
@@ -66,4 +90,8 @@
   --ed-due: #E0A44B;
   --ed-link: #6E9BE8;
   --ed-overlay: #1A1A1A;
+
+  /* 阴影：暗档不用投影，改白色反相描边（暗底上黑色投影不可见） */
+  --ed-shadow-1: 0 0 0 1px rgba(255,255,255,.06);
+  --ed-shadow-2: 0 0 0 1px rgba(255,255,255,.06);
 }

app/src/ui/tokens.drift.test.ts

@@ -75,3 +75,13 @@ describe("token 门面一致性", () => {
     }
   });
 });
+
+describe("token 接线守卫", () => {
+  // Why：未接线的 `var(--ed-*)` **不会报错**，只会静默取不到值（见 tokens.ts 头注）。
+  // 批 0-D 的原语全靠这些变量着色/取阴影，漏一次 import 就会让整层原语在运行时失效，
+  // 而所有单元测试仍全绿 —— 故把这条从纪律变成机器判据。
+  it("应用入口 import 了 ui/tokens.css（未接线则所有 var(--ed-*) 运行时无值）", () => {
+    const main = readFileSync(join(HERE, "..", "main.tsx"), "utf8");
+    expect(main, "main.tsx 必须 import ./ui/tokens.css（见批 0-D 控制方裁决）").toContain('import "./ui/tokens.css";');
+  });
+});