# F25 Cleanup — Audit 规则收窄 + 设计规则补全 (2026-05-09)
> Plan owner = Claude Code (Opus 4.7, 1M context)。
> Trigger：用户 review F22+F25 overnight run 后对 audit 设计提出 4 个反问，让 plan owner 重新审视规则缺陷。
> Lineage：F22 (`3376d4a0`) → F25-A (`236062c2`) → F25-B (`4d518e44`) → F25-C (`bf86c1f4`) → overnight summary (`556b1e34`) → F23 prompt (`d261cb73`) → 本次 cleanup
>
> 本报告记录 4 个 audit 规则缺陷的修正决策 + 配套设计规则文档化。
---
## 用户反问与 plan owner 修正
### Q1: docs/pages noMatch 应该 fix 还是 audit 不该报？
**用户**：Element Plus / v3 的 docs demo 都用 design tokens 渲染才能看到真实视觉。
**Plan owner 重审**：原 audit 设计错误。docs page 里的 `padding: 10px` / `padding: 6px` 等 156 个 noMatch findings：
- 不在 design system spacing scale 上（4/8/12/16/24/32/40/56）
- 也不在 figma 真源里（figma 是组件层真源，不规定 docs page 装饰值）
- 是 docs page 自身样式，**不该有**对应 token
**正解**（用户校正）：
- 组件层 (`src/components/` / `src/canonical/`) 应该完全用 token
- docs page 自动通过组件 consumer 继承 token discipline
- audit 不该扫 docs page
**修正动作**：
- `audit-no-hardcoded-design-tokens.mjs` 删除 `playground/docs/pages` 范围
- TARGETS 收窄到 `[src/components, src/canonical]`
- F25-C 已做的 docs/pages tokenize（27 文件 / 245 替换）不回滚（无害且实证 token 真实视觉）
### Q2: 35 hex / 83 残留 mono finding 是什么色？要不要 token 化？
**用户**：第三方 logo 的颜色不应该改，也不应该加到 color token 中；它们应该跟对应的图标组件挂钩，且只引用到对应的图标组件上。
**Plan owner 重审**：原推荐"加 semantic-mono-color allowlist"是把 figma 真源问题伪装成 code 层豁免，违反硬规则 #5。
**实证分析**：F25-B 后 83 个残留 mono-color finding 的 hex 分布：
- 5 个匹配 token 表 (`#2fb54e=brand` / `#ea4233=red` / `#3892f3=blue` / `#f68512=orange` / `#353535=grey-10`)：figma SVG export pipeline 把 Color Variable 解析成 hex literal，丢失绑定语义
- 30 个不匹配 (`#0866ff` Facebook 蓝 / `#9146ff` Twitch 紫 / `#b54a4a` brand red / etc.)：第三方 app/brand 固定色，**不属于 TVU design system**，封装在 catalog SVG 内部，外部组件只通过 `` 引用，颜色不会泄漏
**正解**（用户拍板）：
- 30 个非 token hex：不动，不报 audit，不入 backlog（设计意图 + 自然封装）
- 5 个 token-matching hex：当前不动（盲转 currentColor 风险破坏设计意图）
- audit 规则收窄到只 ERROR `#dbdbdb`（这是真正的"theme-able default 漏配 Variable"语义）
### Q3: 为什么 mono = error / multi = warn 这个二分？
**用户**：应该 figma 来什么色就显示什么色，单色多色都有可能；为什么单色报 error？
**Plan owner 重审**：原 audit 二分基于未经验证的 assumption "mono-color icon 都该是 theme-able"，但实际 Facebook icon 单色 `#0866ff` = 设计意图固定蓝，不该转 currentColor。我的二分**根本就是设计错了**。
**实际语义**（用户给出关键洞察）：
- figma 端"Color Type/Icon/Default" Variable 是设计师 default icon color 真源
- figma SVG export pipeline 把 Variable 解析成 literal `#dbdbdb`（grey-4 palette 值，但 designer 用它表达"应该是 Icon/Default"）
- 真正的 audit 价值：捕捉 `#dbdbdb` literal 漏转 currentColor
**修正动作**：
- `audit-icon-fill-currentcolor.mjs` 收窄：只 ERROR path fill 等于 `#dbdbdb`，删除 mono/multi 二分类
- 删 `figma-sync/audit-allowlist/icon-multicolor.json`（空白名单，规则收窄后不再需要）
- 同步扩展 F25-B 的 `transformSvgCurrentColor`：从"仅转 mono-color icon 中 #dbdbdb"扩展到"per-path 转任何 #dbdbdb 路径"，捕获 `*-off` / `*-stop` 类多色 icon 内的 #dbdbdb 主图层（7 个 icon / 4 个 catalog 文件追加修复）
### Q4: docs-page-bg-contrast audit 价值 < 维护成本
**用户**：同意删除。
**修正动作**：
- 删 `figma-sync/audit-docs-page-bg-contrast.mjs`
- 删 `package.json` 中 `audit:docs-page-bg-contrast` script 行
- F20 visual snapshot 落地后由像素 diff 自动捕获撞色（0 false positive）
---
## Audit 规则收窄前后对比
| Audit | 收窄前规则 | 收窄后规则 | 当前 finding |
|---|---|---|---:|
| icon-fill-currentcolor | mono-color path fill = error / multi-color = warn | path fill === `#dbdbdb` only = error | **0** (after extended transform) |
| component-no-inline-svg | unchanged — `