@qilitt-mickey/vue3-temp-skill 1.1.76 → 1.2.2

package/references/steps/step2-structure.md

@@ -1,73 +0,0 @@
-# design-apply · 第 2 步 · 结构先行（visible / position / form · structure_ops · layer · suppress · priority 消费）
-
-> **主入口与执行顺序见 [../design-apply.md](../design-apply.md)**；加载时机：进入施工时（先于一切样式）。
-
----
-
-### 第 2 步 · 结构先行（visible / position / form）
-
-**先改结构，后改样式**——结构变了选择器才稳定，样式才有处可落。
-
-- `visible: false` → 按条目 `visible_prop`（如 `platform-config.json` 的 `HideTabs`）或组件 `v-if` 隐藏；无现成通道时 `display: none`，作用域限定在条目 `style_scope` 内。**不删除任何代码行。**
-- `position` → 优先用 flex 顺序（`order` / DOM 位置调整），禁止绝对定位像素坐标。
-- `form` → 按条目 `forms` 枚举切换（如 tabs 的 `chrome`/`card` 走 `platform-config.json ShowModel`；内容区滚动模式走 `admin.content.container` 的 form（`fixed`/`scroll`/`auto` → 路由组件根节点 `data-content-mode` 属性，`auto` 为省略即钩子类探测）。枚举外的形态 → 报告，不猜。
-- **结构维度缺失即申报，禁止「只改令牌冒充落地」**：变更集把结构/方位/有无类意图写进 `style`（如指示条只在 `style.menu_active_indicator` 出现、无对应 `form`）时，按「结构意图缺失」处理——交付说明申报「设计侧需补 form + 几何 + 色值」，不得只覆盖颜色令牌交差（否则会出现「图上有、页面上没有」）。
-- `form` 的落点按上文「落地三落点判据」执行：**有 DOM/配置通道走通道，无通道需新节点走结构增量，纯视觉形态走设计层样式文件**。当某形态在本项目只有样式表达（如菜单指示条方位）时，该 form 允许落到样式层——这与「禁止把内容区高度模式降级成 SCSS」不冲突，判据是**该形态有没有非样式通道**。
-- `layout_type` → 改 `platform-config.json Layout` 字段，值域 `vertical/horizontal/mix`。**大屏全屏沉浸式等独立页不走此通道**（设计侧不填 `layout_type`，点位走 L3 落地）。
-
-**存在性收口（通用机制，第 2 步随结构处理）**：变更集未声明的**出厂多余元素**（设计效果图上不存在的按钮/图标/入口，如顶栏设置按钮）→ 按各条目口径处理：有条目者在对应点位上以 `visible:false` 收口（代码保留，`v-if`/`display:none`）；无条目者列入缺口清单申报「设计侧未声明，按无此元素收口」，同样以隐藏通道落地。禁止既不声明也不收口、让出厂元素顶替设计效果（如顶栏设置按钮：效果图上没有，漏收口则落地后仍显示）。反向同理：**设计声明了而出厂没有的元素**（如欢迎区问候语）必须按条目 `$note`/设计规范补齐结构（结构通道豁免底线二），缺失 = 未交付。
-
-**出厂演示占位内容等价（通用机制，第 2 步随存在性收口一并处理）**：模板演示页常带有**占位说明性文案与演示按钮**（用于演示"此处可放控件"的说明文字、占位操作列）。这类内容**不是设计效果**——凡落在设计效果图对应角色上的演示占位内容，必须按「效果」等价逻辑处理：
-- 有设计对应操作（设计声明了按钮/操作列的形态与语义）→ **替换为设计对应内容**（如把占位操作列替换为"查看/编辑/更多"及其形态），不得保留演示文案；
-- 设计未声明该点位（效果图上没有这个位置的操作）→ 收口隐藏（`visible:false` 或隐藏通道），不显示演示文字；
-- **判据一句话：还原后的页面不得残留模板的演示说明性文字与占位按钮——它们既不是设计效果，也不是交付目标。** 残留 = 把演示噪音当成了还原结果，即「效果 vs 内容」混淆的实景表现。
-
-**结构/样式图层分工**：`form`（高度模式、形态枚举）是**结构意图**，必须落到 DOM 属性/组件开关/配置字段（如 `data-content-mode`、`ShowModel`）；**禁止把结构意图降级翻译成 SCSS 变量写进样式文件**（form=scroll 只写 `--vts-margin` = 未施工）。样式文件（如 design-shell.scss）只承载 css_vars/custom_style_map 翻译产物；壳层通用文件禁止代打页面级结构属性（lay-content 硬编码 `data-content-mode="scroll"` 会压掉 `:has()` 自动定高探测，useTableSearch 高度链断裂致列表区整体崩坏，禁止此类写法）。
-
-**结构链不可侵（高度链保命红线）**：内容区高度链是**结构层**，已与视觉解耦，两侧各有边界——
-
-| 结构层（禁止改写） | 视觉层（设计自由落点） |
-|---|---|
-| `data-content-mode`（滚动归属，**页面根节点属性**） | 页面容器形态（卡 / 通栏 / 自绘）、底色、圆角、边框、内边距、阴影 |
-| `data-fill`（填满剩余高度，**逐层节点属性**） | 容器内部排布（标题区 / 筛选区 / 表格区的位置与间距） |
-
-- 设计要求换掉出厂卡片容器（去卡片、改通栏、改内部排布）→ **照做，不打折**：页面根声明 `data-content-mode`，把 `data-fill` **平移**到新容器及其「体」层，视觉全落设计层文件。此路径下 `tableHeight` 几何实测照常成立。
-- **双向禁止**：① 以「保高度」为由拒绝改容器/内边距/去卡片（= 放弃设计还原）；② 为凑还原效果改写壳层结构层规则、或在视觉层重写/压掉 `[data-fill]` / `.main-content[data-content-mode]`（= 高度链断裂，返工项）。
-
-#### 第 2 步附加 · 结构施工（structure_ops）与优先级策略
-
-**A. 结构施工 `structure_ops`（数据 / 结构驱动点位）**——有些点位**换不掉也写不出来**，因为呈现由数据源或模板结构决定。变更集给出 `structure_ops` 时必须照做，**只写 CSS = 无效声明**：
-
-| `op` | 含义 | 施工动作 |
-|---|---|---|
-| `add_node` | 新增语义节点 | 在模板按 `form` 保形插入（不删原代码），落点见「落地三落点判据」第 2 条 |
-| `remove_node` | 移除语义节点 | 按 `visible:false` 收口（隐藏不删）；确需物理移除时先确认无业务耦合 |
-| `move_node` | 调整节点位置 | 优先 flex `order` / DOM 位置调整，禁止绝对定位像素坐标 |
-| `render_branch` | 补渲染分支 | 例：状态列 `formatter` 返回纯文本 → 改为 `el-tag` 分支（`source` 指出数据来源） |
-| `bind_source` | 绑定数据源 | 例：金额列补 `class-name` / `align`、缩略图列补 `class-name` —— 属数据侧结论，**改 CSS 不算** |
-
-**判据一句话**：**这个点位的呈现，改 CSS 能改吗？** 改不了（图标在数据里、Tag 在模板分支里、类名没绑）→ 必须走 `structure_ops`；能改（颜色 / 圆角 / 间距）→ 走第 3 步样式落地。
-
-**B. 落点层级 `layer`（专治「值对了、位置不对」）**——同一点位的样式可能落在**宿主盒**或**内层文本盒**，两者不通用：
-
-- 变更集给了 `layer` → 严格按 `layer` 从条目 `anchors` 取对应选择器（parser 已在转换计划里给出 `@ … · host/inner 层`）。
-- 变更集**没给** `layer`、但条目 `preconditions` 指出必须落内层（如 EP 表头 `white-space`）→ 按 `preconditions` 落 inner 层，并在交付说明注明「设计侧未给 layer，按条目前置条件处理」。
-- **内层盒属性族强制校验**：`white-space` / `text-overflow` / `overflow` / `word-break` / `text-align` / `line-height` / `vertical-align` 这组属性**只在内层文本盒生效**——逐字段核对 `layer`；未指认且条目前置条件也没说 → **退回设计侧补声明**，禁止默认落 host（否则会被内层默认 `normal` 吃掉 → 表头竖排、行高撑大、列内容被压）。
-- 常规分工：高度 / 背景 / padding 落 host；文本换行、省略、对齐落 inner。
-- **几何语境必须随值迁移（双重内边距，否则表头标题会截断成 类…/包…/操…）**：出厂内层文本盒自带 padding 时（EP `.el-table .cell` 出厂 `padding: 0 12px`），把设计的 16px 落到 host 后**必须同步清零内层自带 padding**——否则实际内边距 = 16+12 = 28px/侧，列宽被挤、表头标题被省略号截断、视觉不适配常规。判据：**效果图的距离语义是「列缘到文字」的总距离；宿主/内层两层结构下必须拆成两段落地，两段之和等于设计值**。凡向 host 落 padding/border 类几何值，先查出厂内层盒的自带同族值再决定是否归零。
-
-**B2. 出厂形态互斥收口 `suppress`（治「新形态上了、旧形态残留」）**——条目带 `suppress` 时，逐通道执行收口，**收口优先走令牌重映射**（在令牌宿主作用域重声明令牌，零权重战争），令牌不存在才写属性：
-
-- 每条通道收口后必须在交付说明列出「通道名 → 收口方式 → 落点」，漏一条 = 出厂旧装饰残留。
-- 实例：侧栏 `form=pill` → `suppress: ["右指示条通道"]` → 在侧栏作用域把出厂右竖条令牌重映射为 `none`（出厂 `.el-menu-item.is-active { border-right: var(--…) }` 与 `design-tokens` 的 `3px solid` 令牌都无需改动）。
-- 页签 `form=flat` 属**多通道收口**：透明化激活底色块 + 去圆角间距 + 关闭钮常显 + 贯穿分割线 + 首页页签仅图标——必须逐通道列出并收口，漏任何一条 = 「整个样式和设计不一样」。
-
-**C. 覆写优先级 `priority`（禁止逐点硬堆 `!important`）**——条目 `priority.strategy` 给出本点位该怎么赢：
-
-| 策略 | 施工口径 |
-|---|---|
-| `scope_qualified` | 用条目 `style_scope` 作用域限定即可覆盖 |
-| `self_plus_important` | 目标处于**行内 style**（`:header-cell-style` 等）竞争下 → 先移除页面行内样式；无法移除时，作用域内提权并在交付说明申报 |
-| `deep_qualified` | 目标与**组件 scoped 规则同权重** → 提高选择器权重或走深度选择器显式取胜（**不能只靠「后置加载」**） |
-
-> **为什么必须显式处理**：同权重时胜负由样式注入顺序决定、不可控；靠「加 `!important` / 加宽选择器」逐点硬压，会把互不相干的点位耦合起来、副作用无人发现 → **累积成漂移而不是收敛**（这正是「越改越乱」的机理）。

package/references/steps/step3-style.md

@@ -1,38 +0,0 @@
-# design-apply · 第 3 步 · 样式落地（两层转换 + 语义值译表）
-
-> **主入口与执行顺序见 [../design-apply.md](../design-apply.md)**；加载时机：结构完成后。
-
----
-
-### 第 3 步 · 样式落地（两层转换 + 语义值译表）
-
-对每个 `style` 字段，按 parser 转换指令执行（parser 已把语义值解析为精确值，如 `钴蓝-5` → `#245BFF`）。**冲突裁决规则（免问）：凡变更集声明与项目出厂现状/模板既有口径冲突，一律按变更集执行——变更集是唯一施工依据，不反问、不逐次确认。**
-
-0. **尺寸字段先定意图，再选属性（不照抄数值）**：尺寸值不是「拿到多少就写多少」——先判它是**硬约束**（盒子尺寸由设计定死，与内容无关 → `width` / `height`）、**下限**（由文案撑开，值只是最小值 → `min-width`，按钮 / 标签 / 页签 / 表头列宽 / 操作槽 / 状态牌一律走这条）、还是**上限**（图形盒 → `max-width`）。三条铁律：
-   - **由文案撑开的盒子不许写 exact**：写死宽度后文案一变长就是换行 / 压缩 / 重叠渲染——「设计说 40px，代码就固定 40px」必然翻车。
-   - **exact + 盒内有文案 = 必须同时收口**：形态收口（如 `icon_only`）、文案隐藏、或改下限，三选一，不许只落宽度。
-   - **同一尺寸只认一个权威来源**：列宽只在列定义、槽宽只在组件参数。发现第二处来源（设计层 CSS / 业务配置 / 词典默认值）先收敛再施工。
-   落地后**按内容复核一次**：把文案换成更长的看是撑开还是畸形；装不下时按缺口回流设计侧，不得靠裁切 / 压缩 / 换行消化。
-
-1. **css_vars 层（优先）**：在条目 `style_scope` 作用域内覆盖该 CSS 变量。
-   ```scss
-   // 例：admin.layout.sidebar.menu 的 menu_bg = 钴蓝-9（#0D2A7F）
-   .sidebar-container {
-     --vts-theme-menu-bg: #0D2A7F;
-   }
-   ```
-2. **custom_style_map 层（兜底）**：无官方变量可用时，生成 `:deep()` 隔离样式。
-   ```scss
-   // 例：admin.layout.header.user_profile 的 avatar_width
-   .navbar :deep(.el-dropdown-link img) { width: 36px; height: 36px; }
-   ```
-   `sub_selectors` 有定义的字段（如 `avatar_*` → img、`name_*` → p）按对应选择器路由。
-3. **两层都未命中** → 值合法且选择器可定位时，当场生成作用域内自定义规则落设计层文件并在交付说明申报；仅「值非法 / 无法定位」才进缺口清单。
-4. **值未命中译表且非 hex**（parser 会提示）→ 能按数值字面量 / hex / 上下文判定的当场落地并申报；仅完全无法判定时进缺口清单、回流设计侧补齐（**不向用户反问**）。
-
-**同链令牌双层间距（G6 配套施工规则）**：词典 preconditions 标记「层间令牌链对账」的条目（父子两层盒共享同一条间距令牌链，如 `.app-main` ↔ `.main-content` 同链 `--layout-content-padding → --vts-margin`），落间距值时——
-
-- **只允许一个权威来源**：间距由其中一层承载，另一层归零。声明 `suppress_inner` 写明接管/清零口径（如「间距由 .app-main 统一承载 24px，.main-content 的 --vts-margin 归零」）。
-- **优先令牌通道，不抢物理属性**：在消费点作用域重映射同链令牌（`.app-main { --layout-content-padding: 24px; --vts-margin: 24px; }`），子层消费者自动跟随、两层同变；直接写 `.app-main { padding: 24px }` 而任由子层 `var(--vts-margin)` 保留出厂 8px = 物理叠加 32px/侧（「边距很大」的成因，design-audit E17 会拦截）。
-
-全局令牌（`global` 字段，**整套主题切换优先通道**）→ `design-tokens.scss` 对应变量（`basic/` 词典翻译，语义值走 `mapping/basic/semantic-values.json` 译表），主色走 `setEpThemeColor()` 链路。**壳层模块底色注意**：顶栏底色不走 global（无独立令牌），须以 `{"id": "admin.layout.header", "style": {"bg": "<值>"}}` 场景条目声明（scoped 覆盖 .navbar 底色）；侧栏底色两者皆可——global 走 `sidebar_bg`（--sidebar-bg 令牌链），场景条目走 `admin.layout.sidebar` 的 `bg`（--vts-theme-menu-bg）。

package/references/steps/step3b-shell.md

@@ -1,63 +0,0 @@
-# design-apply · 第 3 步附加 · 设计层落点文件 design-shell.scss（强制 · 覆写定律 · 自举）
-
-> **主入口与执行顺序见 [../design-apply.md](../design-apply.md)**；加载时机：写任何新 CSS 规则前。
-
----
-
-### 第 3 步附加 · 设计层落点文件（强制）
-
-所有「新增的 CSS 规则」一律写入 **`src/styles/design-shell.scss`**（出厂空文件，经 `index.scss` 末位 `@use` 加载），或写入页面级 `<style scoped>`；**不得**写进 `sidebar.scss` / `element-plus.scss` / `theme.scss` / `lay-*.vue` 等出厂文件去表达某张效果图的结论。
-
-⚠ **「末位加载」只决定「同源、同特异度」时的先后，压不过两类对手**——这是「规则明明写了却不生效」的头号成因：
-
-| 对手 | 为什么本文件会输 | 取胜方式 |
-|---|---|---|
-| **组件 `<style scoped>`** | Vite 下组件样式在全局样式**之后**动态注入；scoped 选择器末元素带 `[data-v-x]`（按一个类计权）。同特异度时后注入者胜 → 本文件出局 | 提权（≥3 层作用域限定 / 叠加属性伪类）——**不是靠文件顺序** |
-| **出厂规则里的 `!important`** | `!important` 高于任何特异度，提权无效 | 本点位也必须 `!important`，或改走通道变量 |
-
-每写一条新规则前，先按第 1 步输出的 `▸ 覆写优先级 priority` 判定对手类型与取胜方式（见下节）。
-
-#### 特异度必须**逐位比较**（`html` / `body` 抬不动「类位」）
-
-特异度写成三元组 `(a, b, c)`：`a` = id，`b` = **类 / 属性选择器 / 伪类**，`c` = 类型选择器 / 伪元素。比较顺序是**先比 `a` → 再比 `b` → 最后比 `c`**，`b` 位为 0 时 `c` 再大也没用。
-
-- `html` / `body` 是**类型选择器**，只加 `c` 位。对手 `b` 位更高时，加 `html body` **完全无效**。
-- 对手是组件 scoped（末元素 `[data-v-x]` 只加一个类，`b` 通常 ≤2）时，「抬一级作用域」有效；对手是 `body[layout='vertical'] .sidebar-container .el-menu-item`（属性 + 2 类 = `b=3`）时，`html body .sidebar-container .el-menu-item`（`b=2`）无论再加多少 `html`/`body` 都赢不了。
-- 正确的抬法是**加类**：在祖先链上补稳定的语义类（如 `.el-menu`）把 `b` 抬到与对手相等，再靠 `c`（`html body`）胜出。
-
-> **典型失效模式（权重错算回归）**：`sidebar.scss` 的 `body[layout='vertical'] .sidebar-container .el-menu-item { color: var(--vts-theme-menu-text) !important }`（`b=3`）压掉了设计层的 `html body .sidebar-container .el-menu-item { color: rgb(255 255 255 / 65%) !important }`（`b=2`）→ 菜单文字改用出厂令牌的**浅色主题值（黑）**落在设计强制的深色侧栏上 → **整栏菜单字全部消失**。规则没写错，是权重没算对。
-
-#### 改通道（令牌）优先于抢属性
-
-出厂用**语义令牌间接**设置属性时（`color: var(--vts-theme-menu-text)`、`background: var(--vts-theme-menu-bg)`…），**不要写同名属性去抢**，而是**在令牌宿主作用域重映射令牌**：
-
-```scss
-html body .sidebar-container {          /* 令牌宿主 = 该令牌被消费的元素所在作用域 */
-  --vts-theme-menu-text: rgb(255 255 255 / 65%);
-}
-```
-
-判据：**令牌在哪个元素上被声明，就在那个作用域重映射**。自定义属性按继承解析，出厂规则自己会消费新值 ⇒ **零权重战争**，也不受对手 `!important` 影响。适用范围：`--vts-theme-*` 全族。
-
-只有在「出厂没有该令牌」或「令牌语义与设计不符（如胶囊几何 `inset`/`radius`）」时才回到抢属性，并按上一条逐位比较。
-
-**统一顺序：① 先找令牌通道 → ② 无通道才抢属性（逐位比特异度）→ ③ 都不行才 `!important` + 注释对手。**
-
-> **间距类点位的补充纪律（G6/E17）**：出厂用**同链令牌间接**设置间距时（`padding: var(--vts-margin)`、`padding: var(--layout-content-padding)`），令牌通道不是「更优雅的选项」而是**唯一正确选项**——抢写物理 `padding` 会与邻层同链令牌值叠加（父层 24px + 子层出厂 8px = 32px/侧，「边距很大」）。在令牌宿主作用域重映射（`.app-main { --layout-content-padding: 24px; }`），全部消费者自动跟随。
-
-> 上例的正解就是①：在设计层把 `--vts-theme-menu-text/bg/hover/active-bg` 在 `.sidebar-container` 上重映射，出厂规则自己就画出白色的字与蓝色胶囊。
-
-写入纪律：
-
-- **本文件是产物，不是手改对象（流程红线）**：`design-shell.scss` 的每一行都必须由「变更集 + 词典」经本协议产出——发现缺规则时，正确动作是**补词典字段 / 前置条件 / 登记项**让下一次 design-apply 自动生成，**禁止绕过流程直接手写项目文件**。仅「补通道」（变量消费者 / form 枚举 / 组件中性默认）允许动出厂源码并单列申报。
-
-- **累积性红线（禁止整文件重写）**：本文件的**驱动源是变更集，不是词典**——「历史规则已落词典，重生成后会自动带出」**只在「本轮变更集交齐全部适用点位」时成立**。若上游只交了部分点位（`coverage.covered < applicable`、`gaps` 非空），按「出厂空文件」重建会把上一轮已落地的规则**整段覆盖**，用户侧表现为「布局样式全不对，只剩主题色」（例：620 行 → 77 行，同时上游 covered=31/186）。因此：
-  - **重建即合并**：本轮变更集未覆盖的既有段落**原样保留**，只增删本轮涉及的段；自举（文件缺失 → 新建）后不得把既有内容当作「历史包袱」丢弃；
-  - **落地前后各记一次状态**（设计层行数 + 已落地语义 ID 集合）：`node scripts/design-audit.mjs --project <落地项目>` 的 E12 会自动写 `.design/ledger.json` 台账并与历史峰值比对，**行数或点位骤降 = 交付回退**，必须停下并向上游回流，不得继续宣称完成；
-  - 上游交付不完整时，正确动作是**拒绝落地 + 回流设计侧补齐**，**不是「挑完整的那部分先落」**（只落全局主题令牌 = 假交付）。
-
-- 每条规则带来源标注（`/* <语义 ID> · <变更条目> */`），换设计时整段可替换；
-- 本文件内新增的 CSS 变量必须**定义 + 引用成对出现**（出厂已有消费者也算），避免死通道；
-- 出厂元素需关闭时（存在性收口）也在这里做：令牌置 `transparent` 或 `display:none`，**绝不删出厂代码行**；
-- 出厂 `--vts-theme-menu-active-before` 默认 `transparent` 且无消费者 → 声明 `form=indicator_*` 时必须在此文件内**同时**落地「关胶囊令牌 `menu_active_bg: transparent`」与「新建 `::after` 消费者」，缺一即未施工成功。
-- **自举（项目被还原到出厂时必做，幂等）**：文件不存在 → 新建（仅保留文件头纪律注释，无任何设计结论）+ 在 `src/styles/index.scss` **末位**补 `@use 'design-shell';`（必须末位，靠后置压出厂）。此动作属「补通道」，交付说明单列申报。**文件缺失时径直把设计规则写进 `element-plus.scss` / `sidebar.scss` / `theme.scss` = 污染出厂文件，禁止**（这也是「设计还原度为零」的常见成因：规则无处可落）。

package/references/steps/step3c-priority.md

@@ -1,26 +0,0 @@
-# design-apply · 第 3 步附加（之二）· 覆写优先级消费（硬步骤）
-
-> **主入口与执行顺序见 [../design-apply.md](../design-apply.md)**；加载时机：与 step3b 配套，落规则前逐条判定。
-
----
-
-### 第 3 步附加（之二）· 覆写优先级消费（ 硬步骤）
-
-第 1 步输出的 `▸ 覆写优先级 priority` **不是提示，是落地写法的硬要求**。每落一条规则前先按策略决定写法；写法错了，规则就是「写了不生效」——如面包屑 `visible:false` 写成 `display:none` 却照旧显示、页签关闭钮 `opacity` 写了却仍要 hover 才显。这类情形里两条规则本身都没写错，问题出在**赢了才是硬道理**这一步没做。
-
-| `priority.strategy` | 对手 | 必须的写法 | 自检判据 |
-|---|---|---|---|
-| `scope_qualified` | 无，或出厂**全局样式**（`sidebar.scss` / `element-plus.scss` / `theme.scss`，注意它们也在 `index.scss` 的 `@use` 链里、可能带 `!important` 且 `b` 位更高） | 按词典 selector 原样落；**逐位比过对手**（先 b 后 c）；出厂用 `var(--vts-theme-*)` 时优先重映射令牌 | 若实测仍被覆盖 → 升格按 `deep_qualified` 处理 |
-| `deep_qualified` | 组件 `<style scoped>`（平手 + 后注入） | **禁止裸类名**。≥3 层作用域限定（如 `html .a .b`）或叠加属性/伪类；仍平手才对本条补 `!important` | 写前自问：这条与组件 scoped 谁特异度高？**平手即错** |
-| `self_plus_important` | 出厂规则带 `!important` | 本条必须 `!important` + 注释写明「对手带 `!important`」；能改走通道变量时优先改通道 | 只抬特异度无效，别白费 |
-
-落地写法模板（每条规则标注来源 + 取胜依据）：
-
-```scss
-/* <语义 ID> · <变更条目> · 取胜依据：deep_qualified（对手 lay-*.vue scoped） */
-html .navbar .navbar-breadcrumb-wrap {
-  display: none; /* visible:false · 存在性收口，不删出厂代码行 */
-}
-```
-
-**`!important` 只允许出现在两种情形**：① `strategy = self_plus_important`（对手带 `!important`）；② 对手是组件 scoped 且提权后**实测**仍平手。其余一律靠作用域限定解决——逐点堆 `!important` 会让点位互相耦合、副作用累积成漂移，也就是「越改越乱」的机理。

package/references/steps/step4-l3.md

@@ -1,14 +0,0 @@
-# design-apply · 第 4 步 · L3 新模块处理（分级布局）
-
-> **主入口与执行顺序见 [../design-apply.md](../design-apply.md)**；加载时机：存在未命中点位 / 新页面生成时。
-
----
-
-### 第 4 步 · L3 新模块处理（分级布局）
-
-- **验收对象闸（角色集合必须齐）**：验收页面的**角色集合**必须覆盖变更集声明的角色。缺角色的，按第 0.2 步「对接匹配 → 需适配」处置——**项目侧补齐该角色的骨架 / 结构**（走 `crud-pages` 样板 + L3 落地并申报），**不是要求设计侧换页面**。不得用出厂 demo 页充数：demo 页**结构上就没有**标题区 / 批量按钮 / 状态 Tag 这些角色 → 这类差异**无论怎么调 CSS 都消不掉**（不是样式问题，是角色集合不匹配）。
-- **页面映射闸（G13 · 角色集合 ≠ 页面增量）**：本步一切「生成骨架 / 新页面」的授权，**只指向变更集 `page_bindings` 显式声明 `target:"new"` 的条目**（且 `notes` 已申报）；`page_bindings` 缺省或 target 指向已有页面时，角色补齐一律落在**已有页面的结构增量**上（在既有路由页面内补角色节点），**禁止新建页面 / 路由 / 菜单项来承载角色**——效果图页面是设计角色坐标系（演示标题），项目侧按它换肤，不按它扩清单。
-- **列宽口径（业务层 / 设计层边界）**：表格**业务列宽度属业务层**，设计侧不声明、项目侧不按效果图硬套——效果图里的列宽只是其示例数据下的参考值。**唯一例外是操作列**：宽度由组件公式推算（`resolveOperateColumnWidth`，已含分割线占位），业务页禁止写死。**固定列自查（落完后必做，防「符合规范但不合常规」）**：操作列按钮不被裁、不换行、分割线居中可见；状态列标签完整；表头/单元格标题不被省略号截断——任何一项不满足即返工，禁止用「设计值就是对的」搪塞。
-
-- **L3 是施工指令，不是待办**：词典未命中的点位一律当场落地、交付说明申报「补映射」，不留待确认。新模块按「定制布局」三步走：① 基于全局规范生成结构（继承命名/作用域/组件规范）② 原子层字段（色彩/圆角/组件级）从 `basic/` + `component/` 词典借力 ③ 场景专属点位生成后**立即写入 mapping/ 对应场景域**（临时映射），累计复用 ≥3 次建议升级标准（由人工评审）。
-- 生成的新页面必须带构图钩子（`vts-page-card` / `vts-filter-area` / `vts-table-area` 等），保证后续变更集可命中。**本条仅在 G13 申报范围内生效**（`page_bindings` 有 `target:"new"` 条目）；无申报时本步不产出任何新页面文件。

package/references/steps/step5-gates.md

@@ -1,65 +0,0 @@
-# design-apply · 第 5 步 · 合规闸门（变更集专属检查清单）
-
-> **主入口与执行顺序见 [../design-apply.md](../design-apply.md)**；加载时机：施工完成后、验收前。
-
----
-
-### 第 5 步 · 合规闸门（变更集专属检查）
-
-跑 `code-quality` 全量清单之外，追加：
-
-- [ ] 变更集外的任何点位**零改动**（diff 只含变更集提到的文件/选择器）
-- [ ] **页面清单零增量（G13 页面绑定闸）**：diff 中不得出现新增的路由定义 / 菜单项 / 页面文件，除非变更集 `page_bindings` 显式声明 `target:"new"` 且 `notes` 已申报。效果图页面默认是设计角色坐标系（演示标题），落地 = 映射已有页面同步结构与样式；`page_bindings` 缺省时本项必须为零增量。验收只比「结构与样式」，不比「页面标题文字」
-- [ ] `visible: false` 的模块代码仍存在（只是隐藏）
-- [ ] **`!important` 使用合规**：新增 `!important` 仅允许两种情形——① 词典 `priority.strategy = self_plus_important`（对手带 `!important`）；② 对手为组件 scoped 且提权后**实测**仍平手；且每条带理由注释。其余一律靠作用域限定解决。无内联 style 硬编码色值（全部走变量）
-- [ ] 未修改 `src/components/`（Re* 组件库源码——**底线一**）
-- [ ] 未改动业务逻辑层（API/状态/事件——**底线二**；样式与结构通道内的 DOM 调整除外）
-- [ ] 两层样式全部落在 `style_scope` 作用域内，无全局泄漏
-- [ ] **类名冲突检查（AI 施工硬性步骤）**：新增 class 之前先在目标文件与同作用域全局样式中检索同名类——已存在时禁止直接追加重复定义，按三选一处理并在交付说明申报：① 语义相同 → **合并**进既有规则；② 语义不同 → 改用带点位前缀的新类名（如 `vts-<语义id末段>`）；③ 确需覆盖 → 走作用域内更高优先级（不写 `!important`）。重复类名（尤其跨 `<style>` 块的 scoped 样式重复定义）会触发编辑器/构建报错，**本项不通过不得交付**
-- [ ] **出厂中性检查（架构红线，不通过必须回退重做）**：diff 中不得出现「为表达本次设计而改写出厂文件」的产物——典型症状：把指示条方位/问候语 DOM/某个具体尺寸直接写进 `sidebar.scss`、`element-plus.scss`、`lay-navbar/index.vue`、`lay-content/index.vue` 等出厂载体；在出厂 `<component>` 上硬编码 `data-content-mode`/样式钩子。出厂文件若被改动，只能是「补通道」（补变量消费者 / 补 form 枚举 / 修层叠优先级，如已修的 `:has()` 与显式模式优先级反转），且必须在交付说明单列「补通道」条目写明缺失点；非此情形一律回退，改由 `design-shell.scss` + 变更集驱动。**模板源码注释保持中性**：diff 中不得出现「语义 ID / 本协议步骤号 / 面向 AI 的纪律条款」写进模板源码注释（如 `lay-content/index.vue`、`element-plus.scss`、`design-shell.scss` 的文件头与段落注释）；这类内容只允许存在于技能侧文档
-- [ ] **文本溢出回归检查**：改动侧栏菜单/顶栏/页签等含文字的模块后，必须确认「长文本显示」未被破坏（菜单项名称完整可见，必要时保留 ellipsis 溢出策略而不是隐藏/截断）；宽度相关字段（width/min-width/padding）改动后逐项目视验证
-- [ ] **尺寸意图兑现检查（每个尺寸字段都要能回答「谁决定这个数」）**：按下限语义落地——`≥N` → `min-width`、`≤N` → `max-width`、`exact` → `width`。逐项确认：① 由文案撑开的盒子（按钮 / 标签 / 页签 / 表头列宽 / 操作槽）**没有**写成固定 `exact`；② 写了 `exact` 的盒子要么内容恒定、要么已声明收口（形态收口 / 文案隐藏 / 改为下限）；③ **同一尺寸只有一个权威来源**——发现「列定义写死 X、模板或公式又算成 Y」「设计层 CSS 写一套、业务配置写另一套」时**先收敛再施工**，否则改一处不生效、排查时按死值反推必然误判。**实测口径**：把文案换成更长的（改名 / 多语言 / 长数据）看盒子是撑开还是畸形——撑开 = 下限语义正确；畸形（压缩 / 换行 / 重叠）= 硬约束没兜底，返工。**接受「看起来还行」不算通过**：静态尺寸对了不等于内容装得下，必须按内容度量复核一次
-- [ ] **形态与存在性目视验证（历史漏还原高发区，声明即必须验证，没做视同未交付）**：变更集声明了以下意图时，逐项在页面上确认真实生效——
-  - 语言切换 form=inline_switch → 顶栏出现「中|EN」并排文字（不再是纯图标）
-  - 折叠按钮 form=header_inline → 顶栏最左出现 40×40 折叠按钮且与首页页签左对齐；**同时侧栏底部出厂折叠条按设计隐藏（visible:false 声明时）**，避免双折叠按钮并存
-  - 侧栏 `menu_active_*` / `form=indicator_*` → **按变更集声明的 form 逐项核对**（indicator_left → 左侧竖条；indicator_right → 右侧竖条；indicator_underline → 底部横线；pill → 胶囊底色；none → 无指示）：方位/粗细/长度/圆角与变更集 style 字段一致，且出厂胶囊已关闭（`--vts-theme-menu-active-bg: transparent`）、`--vts-theme-menu-active-before` 消费者真实建成。**禁止用「左侧 3px」这类历史/词典结论替代当次声明**——设计换了就必须是新的方位与数值
-  - 顶栏未声明点位（设置按钮等）→ 已收口不显示；用户区 → 按 `form` 核对组合形态（`avatar_name` / `greeting_avatar_name` / `greeting_name` / `avatar_only` / `name_only`），其中 greeting 为结构增量节点（出厂无此 DOM，需 AI 按 form 插入后再验）
-  - 页签图标 → 按 `form` 核对（item 的 `text_only`/`with_icon`，home_tab 的 `icon_only`/`text`），出处是路由 `meta.icon` 数据或本次隐藏规则，不是源码常量
-  - 内容区 form=scroll/fixed → `data-content-mode` 属性落在**页面根节点**（不是样式文件、不是壳层组件），列表页自动定高未被压掉；填满链逐层带 `data-fill`（详见下方「高度链存活检查」）
-  - 操作栏 form=with_tools/left_batch → 刷新/密度/列设置三件套齐全；批量删除红底/导出白底/未选中置灰；**效果图上有状态性表现（禁用置灰/选中态）的控件必须已申报 `oracle.states`（G14）**——交付前用浏览器脚本触发对应交互态核对，静态目视激活态不算验证通过
-  - 操作列 form=text_link → **业务列定义的 icon 字段已移除**（纯文字无图标，只改 CSS 保留图标 = 未还原）；**按钮单行不换行且不被压缩**——列宽必须由内容度量推出，不得照抄某个固定数：`列宽 ≥ 平铺槽数 × 槽宽 + 实际单元格水平内边距`（槽宽与组件同源公式；**内边距取设计层实际生效的 td padding，而不是列宽公式内置的默认留白**——两者口径不一致就必然溢出，表现为按钮文字被压成两行或字符重叠）；删除项红色；≥3 个折叠「更多」带箭头
-  - tabs form → 页签形态切换生效（chrome/card）；激活态表现（有无下划线 / 是否仅文字变色 / 字重）按当次变更集 style 字段核对，**不以历史设计稿口径为准**
-- [ ] **高度链存活检查（结构层不被设计改动压垮，也不被"保高度"绑架）**：定高页（`form=fixed` 或列表页自动定高）还原后逐项确认——
-  - `data-content-mode` 落在**页面根节点**；从页面根到表格/画布容器**每层需填满的节点都带 `data-fill`**（换了视觉容器时属性已平移；横向分栏用 `data-fill="row"`）；
-  - `content` ref 仍绑在定高容器上（换容器后未丢），`otherRef` 仍在表格上方、分页仍在表格正下方；
-  - 表头 / 行 / 分页都在视口内，仅表格体内滚动，无外层滚动条、无拉伸 / 塌陷 / 双滚动条，`tableHeight > 0`；
-  - **结构层 diff 为空**：`lay-content/index.vue` 的 `.main-content[data-content-mode]` 与 `element-plus.scss` 的 `[data-fill]` 未被改动；同时确认没有「为保高度而放弃设计还原」（出厂卡片 / 内边距 / 内部排布原样未动而变更集声明了改动）——两个方向任一命中即返工
-- [ ] **映射通道活性检查（杂必查）**：样式落地引用的每个 CSS 变量必须在项目样式中**存在消费者**（`变量名` 有 `var(--xxx)` 引用点）；只定义不消费的变量 = 通道死路，翻译再准也不生效（例如 menu_active_indicator 缺 `--vts-theme-menu-active-before` 消费者时会「映射了却没效果」）。施工时 grep 核对，无消费者时改走消费者存在的作用域或补挂载点并申报。
-- [ ] **结构施工兑现检查（structure_ops 逐条对账，与红线同级）**：变更集 `structure_ops[]` 的**每一条 op** 都必须在交付说明给出「op → 落在哪个文件 / 哪个节点 / 怎么落的」；`add_node` 必须真的新增了元素或渲染分支（模板 diff 可验），`bind_source` 必须真的改了绑定（`class-name` / `align` / `formatter`）。出现「声明了 op、代码里找不到对应改动」= 交付不完整，禁止只改 CSS 冒充结构施工
-- [ ] **同权重失效检查（ · 专查「写了不生效」）**：逐条核对设计层新增规则是否真能取胜——① 对手是组件 `<style scoped>` 时，本条特异度必须**严格高于**它（**平手即错**，因为组件样式在全局之后注入）；② 对手带 `!important` 时本条必须同样 `!important`，或改走通道变量。**判定方法（必须真数，不许目测）**：对每条新规则与其对手分别写出特异度三元组 `(a,b,c)` 并**逐位比较（先 b 后 c）**，本条的 `b` 不大于对手即判为「失效」；`html` / `body` 只加 `c` 位，**对手 `b` 更高时加 `html body` 无效**，必须靠**加类**（祖先链补稳定语义类，如 `.el-menu`）把 `b` 抬到相等。同 `b` 时，`c` 更高者胜。③ **出厂用语义令牌间接设置该属性时（`var(--vts-theme-*)`），必须先走「令牌重映射」而不是抢属性**——在令牌宿主作用域重声明令牌即生效、零权重战争；只有无令牌或令牌语义不符时才抢属性。典型失效例：面包屑 `display:none`（与组件 scoped 同为 0,2,0）→ 照旧显示；页签关闭钮 `opacity`（同为 0,5,0）→ 仍要 hover 才显；页签项 `padding`（对手带 `!important`）→ 无论怎么抬特异度都改不动；**侧栏菜单 `color`（`b=2` 输给出厂 `b=3` + `!important`）→ 整栏菜单文字用浅色主题的黑色落在深色侧栏上、字全部消失**
-- [ ] **oracle 基线可用性检查**：变更集带 `oracle` 时——① `oracle.mockup` 必须是**本页型的场景基线图**（**与主题无关**：任何主题都读**同一张**，不得因换主题而改图、漏读或跳抽）。基线图色板与本次主题不一致时（图内 `data-mockup-theme` ↔ `changeset.theme`），声明 `oracle.theme_mapping: { "from": "<基线图色板>", "to": "<本次主题>" }`——它**只是色值归一**（verify 须带 `--from-theme/--to-theme`，几何 / 结构 / 字号逐点照比），**不减免任何读取与声明**；**不得因换主题色就判死闭环**，**也不得因换了主题色就降低本轮应有的覆盖期待**（「只有钴蓝能正经还原」是误读：基线图是场景基线、不是某主题的专属产物）；结构 / 形态与基线图有差异时另立基线图并登记 `baseline`；② `oracle.sids` 与 `changes[]` **双向闭合**：效果图里有、changes[] 未声明 = **欠声明**（该点位永远不可能被还原）；changes[] 已声明、效果图无 sid = **无基线**——**仅 `visible:false` 的隐藏点位豁免**（效果图上无可见元素可标 `data-sid`，parser 已自动豁免并打印清单）。其余两类出现即回流设计侧补齐，**不得直接开工**（`parser match` 已自动报出）；③ **状态性期望与孤儿对账（G14/G15，抽取产物层）**：效果图上有可见状态性表现的点位（禁用置灰 / 激活 / 选中）→ `oracle.json.states` 必须有对应 `<sid>@<state>` 期望（缺失 = 状态维度放弃验收）；交付前核对项目页渲染的每个区块都在 oracle 全集（sids ∪ absent ∪ residual ∪ states）内——孤儿点位 verify 当场 exit 1，提前自查可省一轮返工
-- [ ] **设计层闭环审计闸（机器断言，ERROR 必须清零）**：施工完成后跑 `node scripts/design-audit.mjs --project <落地项目> --container-width <内容区实际宽>`，或 `VUE3_AUDIT_PROJECT=<落地项目> npm run check`。本闸把「声明了 ≠ 生效」拆成逐条静态断言，替代肉眼目视，任一 ERROR 即视为未交付。**与 `parser/index.js audit` 的分工**：parser audit 管「通道与挂载点」（selector 有没有挂载点、变量有没有消费者），本闸管「生效性与形态」（层路由、层叠胜负、列宽预算、收口断言、形态成对）；E1/E4 是两者的故意重叠项，用作交叉校验：
-  - E1 变量悬空 → 使用了项目内无定义且无 `var()` 回退的自有变量，整条声明失效
-  - E2 层错位 → 内层盒属性族（`white-space` / `text-overflow` / `overflow` / `text-align` / `line-height` / `vertical-align` / `word-break`）写在表格宿主盒 `th/td.el-table__cell` 上而非 `> .cell`，会被 Element Plus 内层 `.cell` 覆盖
-  - E3 **层叠败北** → 本条声明的作用元素上的特异度 ≤ 组件 scoped 竞争者的实际特异度（scoped 编译会给末位选择器追加 `[data-v]`，等价 +1 类级；平手判负，因为组件样式晚于全局注入）
-  - E4 选择器挂空 → 设计层使用的项目类名在 `src/` 无挂载点（锚点必须锚「实际在」）
-  - E5 **列宽预算** → 存在既无 `width` 又无 `min-width` 的业务列；或 `min-width` 小于该列表头文案的最小占宽；或列宽合计溢出容器而未见滚动策略
-  - E6 收口断言 → 变更集 `visible:false` 的点位必须在设计层找到「命中该锚点且 `display:none !important`」的落点
-  - E7 激活态越层 → 激活胶囊/指示条写到了可展开分组的标题上（`.el-sub-menu__title` 须显式排除）
-  - E8 浮层残留 → 声明收口下拉浮层的 form，组件却仍保留 `ElDropdown` / `#dropdown` 消费（teleport 浮层样式层收不掉，必须结构收口）
-  - E9 形态收口缺件 → `icon_only` 只落了「显图标」而没有**在同一作用域内**收口文案（作用域外的兄弟变体收口不算成对）
-  - E10 scoped 挂空 → 组件 scoped 规则依赖运行时并不存在的类（结构重构后残留，永不命中）
-  - E11 **交付完整性** → `mode=restore` 时 `covered < applicable`（欠声明）/ `gaps` 非空 / 缺口未在 `pending[]` 台账化（下游「继续」无工作项可执行）/ 自报 `registrable` 与登记表实物不符 / `notes` 的成功话术与 `coverage` 字段互相矛盾。**该项是「只换了主题色」的第一现场**：上游残缺口 + 下游挑拣落地，两头都能被它抓住
-  - E12 **设计层累积性** → 设计层文件行数或变更集点位相比历史峰值骤降（上一轮成果被重建覆盖）。本项会写 `.design/ledger.json` 台账（`--no-ledger` 可关；`--changeset <path>` / `--design-layer <path>` 可指定），**台账同时是「继续」的断点续传依据**：`applicable − 已落地点数` 即剩余工作项，不再依赖自然语言回忆
-  - E13 **固定尺寸内容度量** → 设计层出现「固定 `width` 小于内容需求、且未声明收口兜底」的规则（典型：页签位 40px 里还留着标题、图标位里塞着文案）。固定宽装不下内容时文字会换行、被压缩、甚至字符重叠渲染——**「设计说 40px 就固定 40px」必然复现**。判据：盒内还有文案却用 exact 宽度又无收口
-  - E14 **列宽预算链自洽** → 列宽（含公式推出的值）扣掉**实际生效的 td 水平内边距**后装不下该列内容（操作列 = 平铺槽数 × 槽宽）；或同一列宽存在两个来源且值不一致（列定义死值 vs 模板公式）。**这是「按钮文字换行 / 重叠」的第一现场**
-  - E17 **层间令牌链对账** → 词典标记「层间令牌链对账」的条目（父子两层盒共享同链间距令牌，如 `.app-main` ↔ `.main-content` 同链 `--layout-content-padding → --vts-margin`）在设计层抢写了物理 padding/margin，而同链令牌在项目内仍有非零定义——父层设计值 + 子层令牌值叠加（24px + 8px = 32px/侧），**这是「内容区边距很大」的第一现场**。修复：改走令牌通道（重映射 `--layout-content-padding` / `--vts-margin`，两层同变），或把另一层同链间距归零
-  - E18 **激活态消费者成对落地** → 词典标记「激活态消费者成对落地」的条目（如 `admin.layout.sidebar.menu`）声明了指示条形态（form 含 `indicator` 或 style 含 `menu_active_indicator` / `active_indicator_*`），但设计层 ① 没有任何规则消费 `--vts-theme-menu-active-before`（只供值不建消费者）；② 消费者建了但令牌最终定义仍是 transparent（消费者在渲染、色值透明）；③ 消费者与出厂 sidebar.scss 同名 `::before` 胶囊对决权重不足（无 `!important` 背景且无 `html body` 提权，③ 为警告级）——三者任一命中，**竖条都不可见**。**这是「菜单激活态竖条消失」的第一现场**：同名伪元素是二选一对决，输 = 几何整体不渲染
-  - E16 **引用完整性** → 变更集 `oracle.mockup` / `coverage.registry` 指向的实物不存在（标识改名后未同步引用，全链路静默降级为无基线还原）；`mode=restore` 缺顶层 `theme` 字段
-- [ ] **列宽由表头文案反推（E5 落地口径）**：每个业务列（含选择列、序号列）都要显式声明 `width` 或 `min-width`，取值 ≥ 该列表头文案宽度 + 左右各 16px 内边距（CJK 按 1em、ASCII 按 0.6em 估）。无宽列只能拿出厂兜底宽度参与布局，会被相邻固定宽列挤压——**表头换行与省略号截断的唯一根因就在这里**，不接受「跑起来看着还行」
-
-- [ ] **缺口清单只含意图缺口**：清单每一项都必须是「设计侧未给值 / 值非法」且已注明「回流设计侧补齐」；能力缺口（词典缺 ID / 缺字段枚举 / 缺 form）不得出现在清单里——出现即把可落地项搁置
-- [ ] **台账逐行兑现对账（对账闸门）**：把设计侧交付的提取台账逐行过一遍，每行必须有落地结论——已落地（写明落在哪个文件/选择器）或已入缺口清单（写明缺失字段）。存在「台账有行、落地无结论」的行 = 交付不完整，与红线同级
-- [ ] **登记表覆盖率对账（子项级细闸，）**：带登记表交付时必须跑 `match --registry`——`C = A` 且无缺口才可交付；同时确认无「效果图标注缺口」（`always:true` 子项在效果图上都有同名 `data-sid`）。**禁止采信设计侧自报的 `coverage` 数字**（parser 会当场重算，自报数不参与）；缺口逐条点名回流设计侧
-- [ ] **零搁置交付**：最终回复不含「待确认」类停顿项；交付说明的「补映射 / 补通道 / 缺口回流」三段齐全（无内容写「无」）
-- [ ] `node parser/index.js build --dry` 通过（mapping 若有临时新增）

package/references/steps/step6-verify.md

@@ -1,77 +0,0 @@
-# design-apply · 第 6 步 · 渲染态验收（oracle 逐点 diff · 快照回归 · 残差豁免）
-
-> **主入口与执行顺序见 [../design-apply.md](../design-apply.md)**；加载时机：变更集含 oracle 时强制。
-
----
-
-### 第 6 步 · 渲染态验收（变更集含 `oracle` 时强制 · 闭环回路）
-
-第 5 步是静态自查，查不出「值对了、位置不对 / 写了没生效」。**只要变更集带 `oracle`（效果图基线），落地后必须做机器逐点比对**——这是「1:1 还原」能被证明、且不再漂移的唯一手段。
-
-**链路（抽取由浏览器完成，diff 由 parser 完成）**：
-
-1. **抽取期望值**：在浏览器打开效果图（`oracle.mockup`，元素已带 `data-sid`），对 `oracle.sids` 中每个 sid 取其代表性元素的 computed style，导出为 `{ "<sid>": { "<css属性>": "<值>" } }` → `oracle.json`。
-2. **抽取实测值**：在浏览器打开已落地页面，**按词典 `selector` / `anchors.target` 定位元素**（**项目页不要求打 `data-sid`**）做抽取 → `actual.json`。
-   - 先跑 `node parser/index.js verify --oracle oracle.json --resolve` 得到「sid → 词典 selector」定位计划；
-   - 抽取脚本（Playwright / 浏览器控制台）按计划 selector 取 `getComputedStyle(el)` 的白名单属性（padding / font-size / font-weight / text-align / color / background-color / border-radius / gap 等）；
-   - **期望端（效果图）用 `data-sid`、实测端（项目页）用词典 selector——两侧定位方式不必对称**：效果图是设计侧自控产物，项目页是消费方、不感知设计坐标。selector 挂载点错位由 `audit` 先于 `verify` 报出，责任链回到词典；
-   - 期望值**优先直接消费设计侧交付的 `oracle.json` 抽取产物**（期望 / 实测同源同口径）；无产物时再从 `oracle.mockup` 现场抽取；
-   - 两个页面的属性白名单必须一致，否则出现假缺口。
-3. **逐点 diff**：
-   ```bash
-   node parser/index.js verify --oracle oracle.json --actual actual.json
-   # 可选 --sids admin.content.table.header_cell,admin.layout.tabs.item  只验部分点位
-   # 同构异色归一（oracle.theme_mapping 已声明时必带）——基线图色值按语义槽位归一为本主题色值再比（几何/结构/字号照比）：
-   node parser/index.js verify --oracle oracle.json --actual actual.json --from-theme 钴蓝 --to-theme 橘橙
-   ```
-   退出码：存在缺口（含存在性缺口 / 基线漂移）→ `1`。
-
-**归因与处置（四类 + 状态/孤儿两类扩展，禁止用 `!important` 掩盖）**：
-
-| 归因 | 触发 | 处置 |
-|---|---|---|
-| **选择器落空** | oracle 有点位、actual 无（或某属性取不到） | 补挂载点：按 `structure_ops` 挂类 / 补 `data-sid` / 确认元素已渲染（属能力缺口，交付说明申报） |
-| **权重被压** | 颜色 / 字重 / 透明度 / 阴影类属性值不符 | 按词典 `priority` 声明的策略提权（`scope_qualified` / `self_plus_important` / `deep_qualified`） |
-| **语境错位** | 几何 / 盒模型属性（padding / 尺寸 / 对齐 / 行高）值不符 | 校准 `layer`（`host` vs `inner`）——值对了落错层 |
-| **存在性缺口（G12）** | `oracle.absent` 点位在页面仍渲染可见（`display` 非 `none`） | 补 `visible:false` 收口并按词典 `priority` 提权（面包屑 `display:none` 被同权重 scoped 规则反压即属此类——写了不生效） |
-| **状态缺口（G14）** | `oracle.states` 的 `<sid>@<state>` 交互态期望与实测不符 / 实测未取到 | 浏览器脚本**触发交互态**（`.click()` / `hover()` / `dispatchEvent`）后抽取到 `actual.states` 同名键；禁用态走结构通道（`disabled` 属性 / `:disabled` 类）+ 设计层样式（如效果图「批量按钮置灰 opacity:.4」在静态快照上取不到——页面静态抽的是激活态值，逐点 diff 验不到） |
-| **孤儿点位（G15）** | actual 中存在、oracle 全集（sids ∪ absent ∪ residual ∪ states）均无申报 | 两选一回流设计侧：应消失 → 收进 `oracle.absent`；该还原 → 补 `oracle.sids` + 效果图 `data-sid`。**G12 只断言「已申报的该消失」，孤儿闸补齐「未申报的出现了」——申报缺一个 = 漏网一个** |
-
-**存在性闸（`oracle.absent`）**：效果图上不存在的出厂点位（面包屑 / 设置铃铛等）逐条列入变更集 `oracle.absent`，verify 逐个断言「actual 不存在或 `display:none` / `visibility:hidden`」。**这类缺口无期望值，逐点 diff 永远验不到——不进 absent 就不在验收范围内**。
-
-**状态断言闸（`oracle.states`，G14）**：交互态（disabled / active / hover / focus / checked）在静态页面快照上取不到——效果图标注的状态性样式（批量按钮禁用置灰、页签激活字重）与页面静态抽取值**永远对不上或永远碰巧对上**，逐点 diff 均验不到。设计侧在 `oracle.json` 顶层声明：
-
-```json
-{
-  "sids": { "…": { "…": "…" } },
-  "states": {
-    "admin.content.list.batch_delete@disabled": { "opacity": "0.4", "cursor": "not-allowed" }
-  }
-}
-```
-
-`changes[] oracle.sids` **保持纯 sid**（不带 `@state` 后缀——G8 双向闭合与效果图 `data-sid` 对账不感知后缀）；状态期望只落 `oracle.json.states` 抽取产物层。实测端对称：`actual.json` 顶层 `states` 子对象，浏览器脚本对每键触发交互态后抽取。verify 逐键断言、计入缺口与归因（处置见上表）；`hover/focus/active` 等瞬态**必须**走 states 子对象（主条目静态值不能代表交互态），`disabled/checked` 可降级用 sid 主条目属性。**效果图上可见的状态性差异（禁用置灰 / 激活态）必须申报 states——不申报 = 状态维度放弃验收**。
-
-**孤儿点位对账闸（G15）**：verify 自动对账 actual 顶层点位与 oracle 全集（`sids ∪ absent ∪ residual_accepted ∪ states` 的 sid 部分），**未申报即出现 = 孤儿，exit 1**——效果图是验收的完备性基准，「图上没有、清单也没说」的页面元素不允许静默存活（它是下一轮「图上怎么多了个东西」体感的来源）。结构性键（`$` 前缀注释 / `sids` / `states`）不参与对账。
-
-**残差豁免（`oracle.residual_accepted`）**：`[{ "sid": …, "reason": … }]`（reason 必填）。命中豁免的属性差异降级为「已申报固有残差」提示行，不进缺口计数；验收报告单列豁免明细，逐条可审计。**机制推算值（等宽槽宽）、业务资产（logo 图形）必须申报**——不申报 = 每轮验收重新报缺口 = 「反复调整仍无改善」的体感来源。
-
-**快照回归（`--snapshot` / `--baseline`，治「上一轮改对的这一轮漂回」）**：
-
-```bash
-# 每轮动工前：先对当前页面跑一次 verify 并导出快照
-node parser/index.js verify --oracle oracle.json --actual actual.json --snapshot snapshot-r1.json
-# 本轮交付前：带 --baseline 与上轮快照比对
-node parser/index.js verify --oracle oracle.json --actual actual.json --baseline snapshot-r1.json
-```
-
-- 上轮 `hit` / `absent-hit`、本轮退步的点位 / 属性 = **基线漂移**，逐条列出且 `exit 1`——先回归上轮修法，再谈新缺口。（G14 状态键命中、G15 对账通过同样纳入上轮「命中」口径；上轮 `state-miss` / `orphan` 修复后本轮变 `hit` 属正常改善，不算漂移。）
-- 项目还原到出厂（design-shell 回空壳）后第一轮验证**不带** `--baseline`（基线已失真），改以 clean 夹具重新起拍。
-
-**夹具与设计资产的边界（职责单侧沉淀红线）**：设计侧效果图库的**基线图命名用中性名**（页面名 / 场景名，如 `后台管理端.html`）——**文件名里不要出现主题词**：主题身份只由图内 `data-mockup-theme` 与注册表 `baseline.<页型>.theme` 承担；文件名一旦带主题词，就会被读成「这是某主题专属的图」，换主题时误判成「无基线」而跳过读取。该命名是设计侧效果图库的专属资产命名——**项目侧（含 parser/fixtures 回归夹具）禁止出现与设计侧资产同名的文件**。回归需要 mockup 实物时，一律用「回归夹具-」前缀合成名（如 `回归夹具-列表页-钴蓝.html`），点集为回归机制定制、与真基线**不同且不可互替**；真实效果图基线唯一沉淀在设计侧 `page-specs/styles/<方案>/scenes/<场景>/mockups/`，项目侧 `oracle.mockup` 指向它靠 `resolveFirstExisting` 跨库解析（变更集同目录 → cwd → 技能根 → 设计侧兄弟目录），不做本地拷贝。
-
-- 验收结果写入最终回复（命中 N / 缺口 M / 归因分布 / 修正）与 `code-quality` 结果块；**不得只报「已完成」**。
-- **入场前置：闭环审计闸必须已清零**。`node scripts/design-audit.mjs --project <落地项目> --container-width <内容区实际宽>` 存在 ERROR 时不得进入渲染态验收——层错位 / 层叠败北 / 无宽列这类失效会让 verify 侧出现「期望值取不到」或「值对但不生效」的假缺口，先修闸门再比对，否则每轮都在给同一个根因换皮。
-- 变更集无 `oracle` 时输出 `N/A`（无基线），并在交付说明注明「无验收基线」——这是设计侧应补的项，回流设计侧。
-- 静态审计（audit）与渲染态验收（verify）**互补**：audit 查「通道是否存在」，verify 查「渲染结果是否一致」，两者都过才算闭环。
-- **三闸自洽口径（无 oracle 时也不放行）**：`mapping coverage` 全绿只证明「点位被覆盖」，`parser audit` 全绿只证明「通道与挂载点存在」，`design-audit` 全绿只证明「声明具备生效条件」——三者都不证明「渲染结果与效果图一致」。缺 `oracle` 的批次必须显式声明「本轮无渲染态基线」，不得用前两闸的绿灯冒充闭环。

package/scripts/apply-final-gate.mjs

@@ -1,170 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * 终态机读凭证闸（apply-final-gate）
- *
- * 定位：design-apply 会话的**唯一合法结束凭证**。「会话结束条件」过去是文档条款（人读），
- * 执行会话可以不跑、绕过、或以自述结束——失效模式：项目侧审计带 ERROR 的交付物
- * 以「已完成」收尾。本脚本把终态判定权交给机器：
- *
- *   串联四道闸 → 全部清零才输出 FINAL-GATE: PASS 并把凭证写入交付台账；
- *   任何一步非零 → FINAL-GATE: FAIL，会话不得以完成态结尾，必须继续修复。
- *
- * 闸序（前置闸先跑，贵的后跑）：
- *   1. changeset-selfcheck（设计侧交付闸 D0–D13，含 G2 还原语义覆盖现算）
- *   2. parser match（通道 / 挂载点 / G 闸）
- *   3. parser audit（挂载点存在性 + 死通道静态审计）
- *   4. design-audit（设计层闭环审计 E0–E16，含层叠胜负真算与列宽预算链）
- *
- * 用法：
- *   node scripts/apply-final-gate.mjs --project <落地项目根目录> [--container-width <px>] [--changeset <变更集.json>]
- *
- * 退出码：0 = PASS（凭证已写入 ledger.json）；1 = FAIL；2 = 用法/环境错误。
- */
-
-import { execFileSync } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const NODE = process.execPath;
-
-const argv = process.argv.slice(2);
-const argValue = (flag, fallback = null) => {
-  const i = argv.indexOf(flag);
-  return i >= 0 && argv[i + 1] ? argv[i + 1] : fallback;
-};
-
-const PROJECT = path.resolve(argValue("--project", "") || "");
-if (!PROJECT || !fs.existsSync(PROJECT)) {
-  console.error("用法：node scripts/apply-final-gate.mjs --project <落地项目根目录> [--container-width <px>] [--changeset <变更集.json>]");
-  console.error(`  项目不存在：${PROJECT || "(未提供 --project)"}`);
-  process.exit(2);
-}
-const CONTAINER_WIDTH = argValue("--container-width", "1200");
-
-// ── 变更集发现（与 design-audit 同口径：多目录 + 显式 --changeset 优先）──
-const DESIGN_DIRS = [".design", "design", ".changeset"];
-let changeset = argValue("--changeset") ? path.resolve(argValue("--changeset")) : null;
-if (!changeset) {
-  const found = [];
-  for (const d of DESIGN_DIRS) {
-    const full = path.join(PROJECT, d);
-    if (!fs.existsSync(full)) continue;
-    for (const f of fs.readdirSync(full)) {
-      if (!/changeset.*\.json$/i.test(f) || /^_/.test(f)) continue;
-      const fullFile = path.join(full, f);
-      if (fs.statSync(fullFile).isFile()) found.push({ file: fullFile, mtime: fs.statSync(fullFile).mtimeMs });
-    }
-  }
-  found.sort((a, b) => b.mtime - a.mtime);
-  changeset = found[0]?.file || null;
-}
-if (!changeset || !fs.existsSync(changeset)) {
-  console.error(`FINAL-GATE: FAIL（无变更集）`);
-  console.error(`  ${PROJECT} 下未发现变更集（查找 .design、design、.changeset）——没有交付物就没有终态。`);
-  process.exit(1);
-}
-
-// ── 跨技能脚本定位（部署副本是同级技能目录；开发期 E 盘源同构）──
-const UI_DESIGN_ROOT =
-  argValue("--ui-design-root") ||
-  [path.resolve(__dirname, "..", "..", "project-ui-design"), path.resolve(__dirname, "..", "project-ui-design")].find((p) =>
-    fs.existsSync(path.join(p, "scripts", "changeset-selfcheck.mjs")),
-  ) ||
-  null;
-const SELFCHECK = UI_DESIGN_ROOT ? path.join(UI_DESIGN_ROOT, "scripts", "changeset-selfcheck.mjs") : null;
-const PARSER = path.resolve(__dirname, "..", "parser", "index.js");
-const DESIGN_AUDIT = path.join(__dirname, "design-audit.mjs");
-
-const steps = [];
-const run = (name, cmd, args) => {
-  const label = `${name}（${args.filter((a) => !a.startsWith("--") || a === "--project" || a === "--registry").map((a) => (a.length > 60 ? a.slice(0, 57) + "…" : a)).join(" ")}）`;
-  try {
-    const out = execFileSync(cmd, args, { encoding: "buffer", timeout: 300000 }).toString("utf-8");
-    steps.push({ name, ok: true, label, output: out });
-    return true;
-  } catch (e) {
-    const out = `${e.stdout ? e.stdout.toString("utf-8") : ""}${e.stderr ? e.stderr.toString("utf-8") : ""}`;
-    steps.push({ name, ok: false, label, output: out });
-    return false;
-  }
-};
-
-console.log(`\n=== 终态机读凭证闸（apply-final-gate）===`);
-console.log(`  项目：${PROJECT}`);
-console.log(`  变更集：${path.relative(PROJECT, changeset).replace(/\\/g, "/")}\n`);
-
-let allOk = true;
-
-// 1. 设计侧交付闸
-if (SELFCHECK) {
-  allOk = run("① 交付闸 changeset-selfcheck", NODE, [SELFCHECK, "--changeset", changeset]) && allOk;
-} else {
-  steps.push({
-    name: "① 交付闸 changeset-selfcheck",
-    ok: false,
-    label: "未找到 project-ui-design 技能",
-    output: "",
-  });
-  console.error("  ✖ 未定位到 project-ui-design/scripts/changeset-selfcheck.mjs——部署不完整，按失败处理（fail-closed）。");
-  allOk = false;
-}
-
-// 2/3. parser 闸
-if (fs.existsSync(PARSER)) {
-  allOk = run("② parser match（通道与 G 闸）", NODE, [PARSER, "match", changeset]) && allOk;
-  allOk = run("③ parser audit（挂载点静态审计）", NODE, [PARSER, "audit", "--project", PROJECT, changeset]) && allOk;
-} else {
-  console.error("  ✖ 未定位到 parser/index.js——技能部署不完整，按失败处理（fail-closed）。");
-  steps.push({ name: "②/③ parser 闸", ok: false, label: "parser/index.js 缺失", output: "" });
-  allOk = false;
-}
-
-// 4. 设计层闭环审计（由它维护 ledger 轮次；--changeset 固定同一份，避免多份并存时各闸看错对象）
-allOk = run("④ design-audit（设计层闭环审计）", NODE, [DESIGN_AUDIT, "--project", PROJECT, "--container-width", CONTAINER_WIDTH, "--changeset", changeset]) && allOk;
-
-// ── 汇总 + 凭证落账 ─────────────────────────────────────────
-console.log(`\n${"=".repeat(56)}`);
-for (const s of steps) {
-  console.log(`  ${s.ok ? "✓" : "✗"} ${s.name}`);
-  if (!s.ok) {
-    const tail = s.output.trim().split("\n").slice(-14).join("\n    ");
-    if (tail) console.log(`    ${tail}`);
-  }
-}
-
-const status = allOk ? "PASS" : "FAIL";
-console.log(`\nFINAL-GATE: ${status}`);
-if (allOk) {
-  console.log(`  四闸清零，交付完成。凭证已写入 .design/ledger.json（finalGate）。`);
-} else {
-  const firstBad = steps.find((s) => !s.ok);
-  console.log(`  终态未达成（首个未清零闸：${firstBad?.name || "?"}）——会话不得以完成态结尾，须继续修复后复跑。`);
-}
-
-// 凭证写入 ledger.json（不改动 design-audit 维护的轮次历史，只追加 finalGate 字段）
-try {
-  const ledgerPath = path.join(PROJECT, ".design", "ledger.json");
-  let ledger = {};
-  if (fs.existsSync(ledgerPath)) {
-    try {
-      ledger = JSON.parse(fs.readFileSync(ledgerPath, "utf-8"));
-    } catch {
-      ledger = {};
-    }
-  }
-  ledger.finalGate = {
-    status,
-    at: new Date().toISOString(),
-    changeset: path.relative(PROJECT, changeset).replace(/\\/g, "/"),
-    steps: steps.map((s) => ({ name: s.name, ok: s.ok })),
-  };
-  fs.mkdirSync(path.dirname(ledgerPath), { recursive: true });
-  fs.writeFileSync(ledgerPath, JSON.stringify(ledger, null, 2) + "\n", "utf-8");
-} catch {
-  /* 台账写入失败不改变终态判定，凭证以本命令退出码为准 */
-}
-
-process.exit(allOk ? 0 : 1);