# TVU Design System — Status

> **Last updated**: 2026-07-13 — **INFRA-F55 umbrella 关闭 + backlog 重组为轨道 A（设计系统本体）/ B（流程·多工具采纳）+ 6 项并行 shipped**（owner 确认团队/多工具采纳在推进，DS 与流程都要）。**轨道 A**：**F60 组合契约薄路线**（`./composition` 三产物 json/js/d.ts + `audit:composition-exports` drift gate + package.json exports/build/prepublishOnly，12 vitest）· **F57 Effect/Text Style 对齐 audit**（`audit:style-contract`，figma-styles `canonicalToken` 查表零启发式，真实数据 0 drift，9 vitest，挂 prepublishOnly）· **F65 安全清理 + 调查修正**（删 vite 死 chart.js/vue-chartjs external；subagent 调查证伪 backlog——echarts 是 **inline 非 external**，原 Bug1「运行时报错」不成立，1+3 同根 = bundle 膨胀 2.08MB/echarts 61%）。**2026-07-13 续 F65**：echarts `dependencies`→`devDependencies`（修双重投递，消费方不再冗余装 echarts；验证 ESM/UMD/dynamic 全无运行时逃逸 + 无 `.d.ts` 暴露 echarts 类型 + 506 vitest 绿）；**minify 调查后 DEFER**（Vite esbuild minify 逐字节 no-op / terser 反膨胀且忽略 options / post-build esbuild 撞 scripts-stdlib gate / 消费方 bundle 时自行 re-minify → 低 ROI，vite.config 留诚实注释）；**i18n 本地化 shipped**（`src/locale` TvuLocale provide/inject 字典 + `provideTvuLocale`/`useLocale` 导出 + 接入 7 SFC 的 8 aria-label + 1 可见 pageUnit，非破坏默认英文，5 单测+4 集成测，全量 515 vitest 绿）→ F65 实质收口，唯一残余=minify deferred。**轨道 B**：**F62-a mockup 报告防伪**（`audit:mockup-conformance --report` 落盘结构化 JSON〔fileKey/nodeIds/subAudits.exitCode/timestamp〕+ `audit-mockup-handoff-evidence.mjs` 从正则改验 report 文件〔存在/exitCode 全 0/24h 时效〕，手打 Integrity 文本失效，10 vitest + 冲烟 + `§M-DISCIPLINE.SYNC` 措辞更新）· **F62-b 消费仓库 chokepoint**（`templates/consumer-product/.githooks/` 零依赖 git hook，变体 A/B 通用〔A 追加 .husky、B 用 core.hooksPath〕，唯一硬依赖 node，fail-open 降级 + 显式残余缺口；修了 pwd→pwd -P symlink 假通过 bug）· **F63 多工具适配器**（`export-claude-design-bundle.mjs` 补 README 上游 gate 导航 + DTCG token 随包 + **组合契约随包发**〔`reference/composition.json`，照 DTCG 同款接进 bundle + README 三处导航，[[INFRA-F60]] 薄路线产物〕；新建 `_prompts/upstream-gate-codex.prompt.md` L2 Codex 适配器）· **F64 自触发脊梁**（`ds start` / `pnpm ds` 统一入口 + `.husky/post-checkout`/`pre-push` 非阻塞 hook）· **F61 gate 平权复核已满足**（INFRA-F40 早已挂 push:master）。全量 **510 vitest** + 关键 audit 链（status-consistency/composition-exports/style-contract/doc-sync/stale-anchors/scripts-stdlib/token-exports）全绿。**架构决策 owner 已拍**：实质改动走 PR + 分支保护（待落地 AGENTS #7）/ mockup handoff 进消费仓库 git / 视觉 job 走 GitHub 镜像仓。**defer（按 self-audit 推荐）**：F62-c 活体比对（需 Figma token 才能测）· F58 规则三层化（踩 owner 否决过的 wholesale-reorg territory + 需专门 SDD + 并行 session 动相邻文件）· F60 厚路线 / F65 minify（Vite 集成失灵，低 ROI）/ F63 元层（需 owner 拍或先验证）。**待 owner 一次性动作**：配只读 Gitea token → 解锁 F61 open-PR 雷达 + consumer 冒烟。
>
> **前情**：2026-07-10 INFRA-F55 支柱① TS/JSON token 出口 + F59 prop 命名统一 + F58 文档一致性 + 支柱④ 上游 gate（详见 STATUS-CHANGELOG 顶部）；2026-07-08 INFRA-F54 / F53 / 全生命周期评估存档。详见 STATUS-CHANGELOG / git。
> **本文档是项目状态 SoT**。任何 AI 工具新 session 起手第一份必读（早于 PROJECT_GOAL.md，因为这里直接告诉你"在哪"）。
> 任何 session wrap up 时**必须更新本文档**（见末尾"Wrap-up 协议"）。
>
> ⚠️ **排期 SoT 在 [`retrospection/design-spec-canonical-alignment-tracker.md`](./internal/retrospection/design-spec-canonical-alignment-tracker.md)**——本文件 Version Roadmap 段只是镜像。任何 "v0.X 包含哪些 / 先做哪个" 决策前先读 tracker 的 "排期原则" 自检清单。

---

## 一句话目标

把 Figma 已发布 Library 做成 **AI 与开发可消费的双向 Figma↔Code 桥**（详见 [`PROJECT_GOAL.md`](./PROJECT_GOAL.md)）。

---

## Claude Code Plugin

UX 团队 AI workflow skill 的独立分发轨道（与 npm 包版本独立）。详见 [`docs/PLUGIN.md`](./PLUGIN.md)。

---

## 当前版本：v0.10.1（✅ published & verified — GitHub Packages `0.10.1` created 2026-06-15T02:53:38Z · CI run [27520993767](https://github.com/NancyZeng0210/TVU-Design-System/actions/runs/27520993767)）

| 项 | 值 |
|---|---|
| v0.10.1 内容 | ✅ 已发布。3 patch enforcement gate（consumer ESLint icon import gate / design kickoff packet CLI / feedback UI inventory gate）+ 携带首发的 0.10.0 段（见下行）|
| v0.10.0 内容（随 0.10.1 首度发布）| 2026-06-12 Notification + Message Figma→code 原子同步：`type` 改名（secondary warning→danger / none→default）+ 按钮色改 type 驱动（error/danger 红）+ dialog success / pop confirm danger 变体（36 members）+ slide 重构 + hug 高度 + #32 间距 token；`PromptMessage`→`Message` **BREAKING** 改名。`vue-tsc` + 264 vitest 全绿 |
| 上次 publish | ✅ 2026-06-15 → GitHub Packages [`@nancyzeng0210/tvu-design-system@0.10.1`](https://github.com/users/NancyZeng0210/packages/npm/package/tvu-design-system) (publish CI run [27520993767](https://github.com/NancyZeng0210/TVU-Design-System/actions/runs/27520993767) success；**Packages API verified** — `0.10.1` created 2026-06-15T02:53:38Z) |
| 包名 | `@nancyzeng0210/tvu-design-system`（latest published `0.10.1`）|
| 上一版本 | v0.9.0 → GitHub Packages [`0.9.0`](https://github.com/users/NancyZeng0210/packages/npm/package/tvu-design-system) (✅ published & API verified 2026-06-11T07:21:09Z, CI run [27330427930](https://github.com/NancyZeng0210/TVU-Design-System/actions/runs/27330427930)；内容：`dist/style.css` 全套 token/主题/@font-face 修复 + TopBar 时钟 Digital Numbers 字体 + `showMenu` default true→false) |
| 安装 | `pnpm add @nancyzeng0210/tvu-design-system`（需 `@nancyzeng0210` scope npmrc 配置，详见 [`GETTING_STARTED.md`](./GETTING_STARTED.md)） |
| Release 流程 | changesets + tag-triggered CI + audit gate（**16 strict**）+ Node 20/22 matrix pre-flight + render-gate + changesets-consumed guard + a11y-report（非阻塞）|
| 破坏性 (0.10.0) | `PromptMessage`→`Message` 改名；`Notification` `type` 值 secondary warning→danger / none→default（consumer 需更 import + 字面量，迁移见 CHANGELOG / MIGRATION）|
| 版本详情 | [`CHANGELOG.md`](../CHANGELOG.md) |
| 注 | ⚠️ 生态：`vue@3.5.36`（npm latest）官方发布损坏（workspace:* 未替换），consumer fresh install 需钉 `vue@3.5.35`；与本包发布无关 |

---

## 能力 × 成熟度（单一真源表 · INFRA-F58）

> 5 能力定义真源 = [`PROJECT_GOAL.md`](./PROJECT_GOAL.md) §一句话目标；本表只登记**当前成熟度 + 该能力状态的单一真源**，避免"读了 PROJECT_GOAL 承诺信以为真"（assessment §5 承诺-vs-实现）。成熟度变化改本表。

| # | 能力 | 成熟度 | 状态单一真源 |
|---|---|---|---|
| 1 | 开发 npm install 即用（Vue 组件 / token / 图标 / 样式） | 🟡 **partial** — Vue 全通；**token = CSS 变量 + DTCG JSON + TS 出口**（`./tokens` DTCG · `./tokens/js` resolved TS，INFRA-F55 支柱①）；**React 无 published npm 路径**（经 CE + `react-pilot` 内部 bindings，非 `./react` 导出） | `package.json` exports + PROJECT_GOAL §Token 架构 + assessment §5 |
| 2 | AI 拿 Figma URL → 定位代码 1:1 还原 | ✅ **done** — manifest 确定性验证 | `figma-data/render-verification-manifest.json`（930）+ FIGMA_AS_SOURCE_OF_TRUTH.md |
| 3 | AI 拿 代码 → 生成 / 还原 Figma | ⚠️ **DEFERRED（bypass equivalent）** — DS 代码 _可_ 经 manifest + 唯一库 `YbsPRUVmNdsbN40NNwh1Gn` 还原；缺的仅"全自动 Code Connect publish"（Pro plan 401）+ 非 DS 反查 + MCP config | PROJECT_GOAL 能力3 + `CAPABILITY_3_BYPASS.md` |
| 4 | AI 拿 文字/链接/截图/代码 → UX 效果图 + 可运行代码 | 🟡 **gate + AI 辅助合成**（非全自动生成器）；mockup 确定性后验强制化 = F55 缺口 A | PROJECT_GOAL 能力4 + assessment §4 支柱② 设计网 |
| 5 | 每个 Code 组件可追溯 Figma 来源 | ✅ **done** — canonical `data-figma-*` + manifest N:1 | canonical 组件 `data-figma-*` 属性 + manifest |

---

## Version Roadmap（剩余按版本线分组）

### 已 shipped

v0.2.0–v0.7.0 已发布；逐版本 retrospect + 历史 sprint 完成项详见 [`design-spec-canonical-alignment-tracker.md`](./internal/retrospection/design-spec-canonical-alignment-tracker.md) §轨道 A 已完成。


### 🟢 v0.7.0 contrast cleanup + RC prep（current sprint）

| 项 | 状态 | 备注 |
|---|---|---|
| color-contrast 1998 nodes cleanup | ✅ **library 段 47 配对全收口（2026-06-10）** | Group A = ACCEPT（2026-06-06 品牌决策）· Group B = WCAG 豁免 accept + **唯一标修项 #5 pagination 实测证伪**（#595959 真实底=白 cell 7.0:1 PASS）· Group C = **owner ruling accept**（"以 Figma 为真源，不修改"，2026-06-10）· Group D #11/#8/#14 = **测量伪影实锤**（axe 漏识别中间白层回退 body #141414——body light 主题仍暗底）。**零 Figma token 改动需求**；复跑 inspector 注意 body-bg fallback 伪影类。决策清单 [`a11y-contrast-designer-review-2026-06-01.md`](./internal/a11y-contrast-designer-review-2026-06-01.md) |
| non-text contrast 20 pairs cleanup | ✅ **accept 收口（2026-06-11 owner 拍板）** | 20 对全 accept = 有意设计（弱边框/分隔线是设计语言；select/input 自带填充提供辨识冗余，边框非唯一线索；20 对为 token 全枚举矩阵非全真实相邻）。`--line-border`=`--bg-layer3` light 同值对 owner 确认有意。零 Figma 改动 |
| reference adoption (3b) | 🟢 **first round done — bug fixed in v0.6.1，待用户重跑确认** | MicroApps vue-app 实测 + 发现 META-001 + v0.6.1 fix 全在 2026-05-19 完成；用户用 PAT 装 npm 版重跑应该 ESLint = CLI 对齐 |
| RC channel 测试 (5b) | ⏳ 等用户 | 用户决定哪些产品做 v1.0.0-rc.1 测试 |

### 🔵 v1.0.0（稳定承诺 — API 锁定）

> **触发条件**（详见 [`V1_RELEASE_CHECKLIST.md`](./V1_RELEASE_CHECKLIST.md)）：5 能力交付 (能力 3 旁路 ack) · ESLint plugin reference adoption · color-contrast clean · burn-in waived

| 项 | 估时 | 备注 |
|---|---|---|
| API lock + migration guide | ✅ 文档已 done | [`API_STABILITY.md`](./API_STABILITY.md) + [`MIGRATION_TO_V1.md`](./MIGRATION_TO_V1.md) |
| Tier 3-H a11y CI infrastructure | ✅ done | tests/a11y/ + playwright.a11y.config.ts |
| color-contrast 清零（carried past v0.7） | 🟢 设计师线全收口（2026-06-10/11） | library 47 对 + non-text 20 对全 accept（品牌决策/WCAG 豁免/伪影/有意设计）；axe 原始数字未清零（accept 型收口）→ CI a11y job 维持非阻塞；v1 DoD 的 "clean" 按 owner accept ack 判定（同能力 3 旁路 ack 范式）。docs-chrome/demo-local 段为 docs site 开发侧债务，与设计师线无关 |
| RC 测试通过 | ⏳ | 等用户 |

### ⚪ Deferred / Out of scope

| 项 | 状态 | 理由 |
|---|---|---|
| **能力 3 (AI code→Figma)** | DEFERRED bypass shipped | Figma Pro plan 限制；[`CAPABILITY_3_BYPASS.md`](./CAPABILITY_3_BYPASS.md) 提供等价方案 |
| **T1c Extract Pipeline** | PAUSED | plan owner "元层疑问"未解 |
| **Phase 8** 视觉脚本 + Code Connect | DEFERRED | 需 Figma Org plan 升级 |

---

## Active 后续工作

```
v1.0.0 (owner-gated)(2):  contrast 已 accept 收口 + burn-in waived → RC 通过后可 stamp（owner 显式 go 才启动，见 V1_RELEASE_CHECKLIST §🅿️）
RC product testing  (1):  等用户决定哪些 consumer 做 v1.0.0-rc.N 测试
Backlog (active)    (8):  【轨道A 设计系统本体】F57 非颜色token评估(推荐Effect/Text audit)·F60 组合契约随包发(薄路线可直接做)·F65 横切bug(echarts bundle+i18n硬编码,真缺陷)。【轨道B 流程·多工具采纳】F61 代码网+gate平权+open-PR雷达(原F56并入)·F62 设计网缺口A mockup防伪(a报告防伪可直接做)·F63 适配器(团队多工具→升Medium)·F64 自触发脊梁·F58 文档一致性+SoT(核心7子项shipped,残余=规则三层化)。全量见 backlog.md ## Active（C4 自动核）
  ↳ F55(全生命周期优化程序umbrella) owner 2026-07-10 关闭：主体已交付，剩余按轨道A(DS本体)/轨道B(流程·多工具采纳)拆独立entry；owner确认团队/多工具采纳在推进、DS与流程都要。架构决策已拍：实质改动走PR+分支保护/mockup handoff进消费仓库git/视觉job走GitHub镜像仓。待owner一次性:配只读Gitea token。
  ↳ F59(外观变体prop全组件统一+消灭style footgun) ✅ shipped 2026-07-10：8组件11改名+1删除(fill×5/type×4/color×2/state×1，删StepItem style)+prop-aliases 10 alias+audit-prop-naming横向一致性gate(SoT零硬编码,L4+L5)+MIGRATION/changeset(minor breaking)。全gate绿(438 vitest/render drift=0)+final opus review READY TO MERGE(2 Minor:opt-in concept检查/JSDoc例子已修)。entry 已删。
  ↳ F51(多版本快照) owner 2026-07-08 不接收：docs 站只留当前版本、不做跨版本切换；rebuild-on-demand 亦不采纳（同不可复现问题）。entry 已删。
  ↳ F41(icon 注解) 2026-07-08 核实 actionable 早 shipped+PASS（旧 grey-13 claim live 证伪）→ entry 已删；同 session 顺带根治 variables.css 头注释 `*/` 自闭合 bug（生成器模板 generate-tokens.mjs）。
  ↳ F46(docs CSS DRY) 2026-07-08 ④收口：18份漂移的 `.coverage-chip` + `.token-chip` 归一到主流簇规格、合并成 demo-shared.css 单一规则（离群 radio/progress/button 的 drift bg/min-height 归一）。①②③④全完成 → entry 已删。
design-review-queue (3):  设计侧待 designer 动手（off-scale px / multi-select padding outlier / 缺 disabled 变体），全 live 2026-06-11 验证 — 见 design-review-queue.md
Code-leads divergences (3): msg-bg-tinted-dark / chart-color-palette / pill-component-family — 见 translation/divergences-decisions.json
Deferred            (3):  能力3 bypass · T1c · Phase 8
```

**真正 next 可推进的**：**当前无立即可推进的工程 backlog**——F41 是 Low/可选 coverage 补全（无 blocker）。主线决策全在 owner 侧：v1.0 owner-gated 未启动 / RC 测试等用户选 consumer / design-review-queue 3 条待设计师。consumer token 缺口（v0.2–v0.8）已随 v0.9.0 修复并真渲染验证。

**排期决策必读**：[`retrospection/design-spec-canonical-alignment-tracker.md`](./internal/retrospection/design-spec-canonical-alignment-tracker.md) §排期原则 — **不按耗时 / 复杂度 / 成本最低排，按项目目标对齐 + 依赖解锁 + 自动化标准化排**。

---

## 起手必读链路

> **本节是 onboarding 链路的唯一 SoT**（AGENTS.md §必读链路 只登记任务触发表，不再维护并行清单 — 2026-06-10 system-review P1-07/P1-08 重构为两层，消除双链路 drift + 与仓库 lazy-load 原则对齐）。
>
> **⛔ Mandatory Gate**：任何 AI session 在第一个项目相关回答 / 推荐 / 任务前，**必须全文读完 L-core 四份**（~40KB ≈ 10-15min），并读完命中触发条件的 L-ref 最小集。机械执行：用 TodoWrite / TaskList 为 L-core 每项 + 命中的 L-ref 项各建 1 个 todo，逐个 Read 完才能回答。基于 partial L-core 给推荐 = **协议违反**。

### L-core — 每 session 全文必读（禁 grep / 跳读 / 摘要替代）

| # | 文件 | 作用 |
|---|---|---|
| **0** | ⭐ [`FIGMA_AS_SOURCE_OF_TRUTH.md`](./FIGMA_AS_SOURCE_OF_TRUTH.md) | **最高优先级原则** — Figma 真源 + 唯一合法 divergence + 禁止启发式验证 |
| 1 | **本文件 STATUS.md** | 知道在哪（状态镜像 + 本链路 SoT） |
| 2 | [`PROJECT_GOAL.md`](./PROJECT_GOAL.md) | 知道目标（5 个能力 + 受众 + 约束） |
| 3 | [`_plans/next-session-pickup-*.md`](./internal/_plans/) 最新一份<br>**⚡ 当前活跃优化程序（固定指针 · 不靠 mtime · 并行 session 再写新 pickup 也不漂移）**：[全生命周期优化](./internal/_plans/next-session-pickup-2026-07-08-full-lifecycle-optimization.md) → 存档 SoT [`full-lifecycle-assessment-2026-07-08`](./internal/full-lifecycle-assessment-2026-07-08.md)（tracked = backlog **INFRA-F55**） | 当前 sprint 操作手册 |

### L-ref — 最小集必读 + 命中触发再深读（各文件顶部有「🤖 AI 读取指引」）

| 文件 | 每 session 最小集 | 升级为全读 / 深读的触发 |
|---|---|---|
| [`AGENTS.md`](../AGENTS.md) | §硬规则表（含 Enforcement 层级列）+ §Onboarding Gate | 写 prompt / 审 executor → §工作流 + task-type 矩阵；commit 前 → §Git 工作流；**mockup 任务 → §Mockup Write Gate + §必读链路 7-10 整链升 mandatory** |
| [`tracker`](./internal/retrospection/design-spec-canonical-alignment-tracker.md) | §排期原则 | 任何"v0.X 包含哪些 / 先做哪个 / 该不该上 Tier N"决策 → 全读 |
| [`backlog.md`](./internal/backlog.md) | — | 当前 sprint task 对应 entry → **全文 Read（不是 grep）**；新增 entry → 先 grep 全部已用 ID |
| [`meta-rules.md`](./meta-rules.md) | 触发器目录（标题扫一遍） | 写 prompt / 设计机制 / 推荐方案前 → 反模式清单全读 |
| [`working-principles.md`](./working-principles.md) | 原则 0-8 标题 | 实现决策（命名 / token / API 形态）命中 → 对应原则全读 |
| [`translation/`](../src/design-system/translation/) 4 文件 | — | Figma↔Code 命名 / divergence / alias 决策时查对应文件 |
| mockup 链（AGENTS §7-10 + [`figma-component-catalog.md`](./internal/figma-component-catalog.md)） | — | **mockup 任务整链升 mandatory**（Mockup Write Gate 的 4 步前置不变，仍是硬规则） |

> **违反信号（分层版，命中任一 → 停下重读）**：
> - L-core 没读完就给项目相关回答 / 推荐 → 错（"我已经知道大概了 / 状态简单跳一步" 同罪）
> - L-core 或 backlog 当前 task entry 用 grep / 摘要替代全文 Read → 错
> - 命中 L-ref 触发条件却只读了标题 / 最小集 → 错（如排期决策没全读 tracker、mockup 任务没读 §7-10）
> - "memory 兜底替代 SoT" → 错（memory 是 AI 缓存，项目契约真源在仓库）
>
> **历史实证**：2026-05-13 session 10 跳过 PROJECT_GOAL + AGENTS → 首轮推荐缺 4 项硬约束（canonical SoT / plan owner 边界 / working-principles / meta-rules）→ 用户返工纠偏。2026-06-10 system-review P1-08：旧版"全量读 ~225KB（mockup +270KB）标 30min"失真 → gate 被默读架空；两层化让严格性落在读得完的集合上。

---

## Wrap-up 协议

> **session 收尾时读** [`docs/WRAP-UP.md`](./WRAP-UP.md)（每-session STATUS 必改项 + Release wrap-up + Retrospection 触发判断）。
> 核心一条：顶部 "Last updated" 改到今天 + 当日摘要（旧摘要 prepend 进 STATUS-CHANGELOG.md）；SessionEnd hook 自动核验日期。

---

## 文件关系（防混淆）

| 文档 | 用途 | 更新节奏 |
|---|---|---|
| **STATUS.md**（本文件） | 全局状态镜像 + 版本线分组 + Active 余量 | **每 session** |
| `PROJECT_GOAL.md` | 项目目标 + 5 个能力 + 受众 + 约束 | 大方向变才改（罕见） |
| `_plans/next-session-pickup-*.md` | 当前 sprint 操作手册（prompts / 任务顺序 / dirty 协议） | **每 sprint** |
| `CHANGELOG.md` | Release-facing（外部 consumer 看）| 每 release |
| `backlog.md` | 全量 entry 详情（Active only，完成直接删） | 每发现 / 每完成 |
| `retrospection/design-spec-canonical-alignment-tracker.md` | 设计规范完整计划 + 进度时间线（living doc）| **每 session wrap-up 前同步** |
| `retrospection/*.md` | 阶段复盘（决策 / 反模式 / 教训） | 每阶段完成 |
| `internal/STATUS-CHANGELOG.md` | 历史 session changelog 归档（从本文件拆出） | 每 session wrap-up |
| `WRAP-UP.md` | session 收尾协议（STATUS 必改项 / Release / retrospect 触发） | 罕见 |
| `PLUGIN.md` | Claude Code plugin 独立分发轨道 | 每 plugin release |

**真源关系**：STATUS.md 是各 SoT 的**镜像/导航**，不是 SoT 本身。具体决策仍在 PROJECT_GOAL / pickup / backlog / CHANGELOG。

### SoT 归属表（哪类事实以谁为准 · INFRA-F58）

> AI 读多份文档遇到冲突时，**以本表指定的真源为准**，其余处一律视为镜像/指针（镜像 stale 时以真源修镜像，不反向）。

| 事实类型 | 唯一真源 | 说明 |
|---|---|---|
| **npm 包当前版本号** | STATUS §当前版本（字面版本号只此一处）| README/PLUGIN/GETTING_STARTED/AGENTS 一律"见 STATUS"，不写字面版本（de-mirror 闸 `no-version` mode 强制）|
| **plugin 版本号** | `PLUGIN.md` §版本表 | 与 npm 版本独立；de-mirror 闸 `no-npm-version` mode 放行本文件自身 plugin 版本 |
| **发版历史 / changelog** | `CHANGELOG.md`（外部）+ `STATUS-CHANGELOG.md`（内部）| — |
| **排期 / 版本包含哪些** | `retrospection/design-spec-canonical-alignment-tracker.md` §排期原则 | STATUS Version Roadmap 段是镜像 |
| **Active backlog 全量** | `backlog.md` §Active | STATUS "Active 后续工作" 是计数镜像（C4 gate 核）|
| **5 能力定义** | `PROJECT_GOAL.md` §一句话目标 | 能力**成熟度/状态** → STATUS §能力×成熟度表 |
| **Figma↔Code 真源原则 + 合法 divergence** | `FIGMA_AS_SOURCE_OF_TRUTH.md` + `translation/divergences-decisions.json` | — |
| **组件公开 API（props/values）** | 组件 SFC `defineProps`（如 `ButtonBridge.vue`）+ 文档站组件页 | 文档示例必须与 SFC 一致；F58 实证 GETTING_STARTED/README 曾漂移 |
| **AI 协作硬规则 / 起手链路** | `AGENTS.md` §硬规则 + STATUS §起手必读链路 | 链路 SoT 在 STATUS，AGENTS 只登记任务触发表 |
| **文档间"改 X 复查 Y"依赖** | `docs/internal/doc-sync-map.json` | audit:doc-sync 校 |