# 2026-06-11 — Contrast 全线收口 + axe 测量伪影 pattern + backlog staleness 教训

> 触发：发现新 pattern（WRAP-UP §Retrospection 触发表 "学到通用工程经验 / 发现新 pattern → 必写"）。
> 关联 commit：`249e4882`（library 段收口 + BRIDGE staleness 清）、`73a0e4f7`（non-text 收口 + description API 更新落档）、`af1b6fef`（并行 session GRID 宽度修复）。

## 结果一句话

color-contrast 设计师线（library 文字 47 配对 + non-text 20 配对）**全部收口、零 Figma 改动**——不是修完了，是实测后发现"该修清单"里一半是测量伪影、另一半是 owner 知情决策；BRIDGE-DESIGN-REVIEW 的 Notification 两子项也是 stale（owner 早已修复）。

## 新 pattern 1：axe body-bg fallback 测量伪影类

**机理**：docs site 在 light 主题下 `body` 背景仍是 `#141414`（dark 默认），`.canonical-page` 白底盖在其上。axe-core 的背景检测一旦没识别到中间白层（层叠/滚动等原因），就回退到 body 色 → 报出 "fg on `#141414`" 的假失败。

**实证**（playwright 探针：computed color + painted-ancestor 链 + elementsFromPoint）：

| 报告项 | 报告配对 | 实测真实底 | 真实比值 |
|---|---|---|---|
| #5 pagination total/jumper | `#595959` on `#141414` (2.63) | `figma-members-grid__cell` #ffffff | **7.0:1 PASS** |
| #11 steps active title | `#000000` on `#141414` (1.13) | `.canonical-page` #ffffff | ≥17:1 PASS |
| #8 datetime value | `#141414` on `#353535` (1.50) | `.select-trigger` #ffffff | ≥17:1 PASS |
| #14 select value | `#141414` on `#4a4a4a` (2.07) | `.select-trigger` #ffffff | ≥17:1 PASS |

**纪律（复跑 inspector / 任何 axe 审计时生效）**：报告里 "light 主题 + `#141414`（或其他 dark-layer 色）背景" 的配对，**一律先疑伪影**——用 painted-ancestor 链实测真实绘制底，证实后才进设计师清单。决策视图 [`a11y-contrast-designer-review-2026-06-01.md`](../a11y-contrast-designer-review-2026-06-01.md) 顶部已登记。可选治本：给 inspector 加白层检测或对 axe bgColor 不可信项标 suspect。

## 新 pattern 2：designer-review backlog 的 staleness 半衰期

**实证**：BRIDGE-DESIGN-REVIEW 的 Notification 两子项（GRID 宽度 FILL / Confirm·Delete raw-hex）都在登记当天～次日就被 owner 修复，但 backlog 文字仍呈"待设计师"。用户一句"我记得至少 Notification 里应该没有 #33ab4f 了"挑战后，live `get_metadata`/`get_variable_defs`/`get_design_context` 复核证实全部已修。

**纪律**：把"等设计师"类 entry 报给 owner 之前，**先 live Figma 复核该 entry 是否 stale**（trigger-O：实际产品态 > 文档记载；owner 是并发编辑者 [[feedback_figma-library-concurrent-editing]]）。本次同型遗留：select placeholder 散绑 / input·select clear 图标 / multi-select padding / disabled 变体 4 条**未复核**，下次拿它们说事前先 live 验。

## 附带收获

- **accept 型收口的语义**：axe 原始数字不变 → CI a11y job 维持非阻塞不翻 blocking；v1 DoD 的 "color-contrast clean" 按 owner accept ack 判定（同能力 3 旁路 ack 范式）。
- **Figma component description 是 Figma 端真源**：sync 只读不写、不随轴模型自动更新；Notification set `1408:17154` 的旧 status 轴 description 实证为早期 AI API 写入，owner 授权后经 `use_figma` 更新为 form×type×closable 文案（在 publish 之后改的，待下次 publish 带给库消费方）。其他组件若做过同类轴重构，description 可能同样 stale——下次有人动组件轴时顺手查。