@qilitt-mickey/vue3-temp-skill 1.1.40 → 1.1.41

package/SKILL.md

@@ -93,6 +93,14 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 - 在目标项目执行 `pnpm lint:fix`、`pnpm type-check`；改动构建配置时再执行 `pnpm build`。
 - 最终说明：命中能力组、修改文件、功能验证、命令结果、未解决问题和下一步。
 
+## 出厂中性 · 变更集驱动（design-apply 架构红线）
+
+目标项目源码 = **中性初始化**，只提供能力通道（CSS 变量的消费者挂载点、form 枚举、DOM/属性钩子、正确的层叠优先级），**不预置任何具体设计的结论**（某个颜色、某句问候语、某个方位的指示条、某个硬编码尺寸）。
+
+- 一切设计决策由设计变更集驱动，经 `design-apply` 动态落到「设计层文件 `src/styles/design-shell.scss` / 页面级 scoped 样式 / DOM 属性与配置」，不落到出厂样式文件与出厂组件里。
+- 判据：换一张效果图只需换变更集、不必改源码 ⇒ 架构正确；需要改源码才能换 ⇒ 设计结论被烧进源码，必须回退为通道。
+- 出厂文件仅在「通道缺失」时可动（补变量消费者 / 补 form 枚举 / 修层叠优先级），且必须在交付说明中单列「补通道」条目写明缺失点。
+
 ## 项目事实优先级
 
 `目标项目当前源码` > `目标项目 package.json / 锁文件` > `本 Skill reference` > `通用 Vue 习惯`。

package/mapping/scenes/admin/content.json

@@ -27,7 +27,8 @@
         "fixed": "data-content-mode='fixed'：display:flex; flex:1 1 auto; height:100%; min-height:0; overflow:hidden（收回 el-scrollbar__view/.grow 祖先链）",
         "scroll": "data-content-mode='scroll'：flex:0 0 auto; min-height:100%; overflow:visible（整页滚动）",
         "auto": ":has(.vts-page-card|.vts-page-fill) 自动定高；未标记且无钩子类 → 滚动页（向后兼容）"
-      }
+      },
+      "$note": "⚠列表区保命通道：壳层 lay-content 禁止硬编码 data-content-mode（曾因壳层代打 scroll 压掉 :has() 自动探测，vts-page-card 列表页定高链断裂、useTableSearch 高度失准、列表区整体崩坏——已实证回退）。form=scroll 仅当设计侧显式声明整页滚动时，落到页面根节点属性；列表页默认 auto 自动定高。⚠层叠优先级（已修的出厂通道缺陷）：显式模式规则体必须排在 :has() 自动探测**之后**——同特异性下后置规则胜，写在前面会被 :has() 反压导致 form=scroll 失效；同时自动兜底分支已加 :not([data-content-mode])，与显式模式互斥。出厂 DOM 不带任何模式属性（中性），换设计只换页面根节点的声明值。"
     },
     "admin.content.page_header": {
       "type": "element",

package/mapping/scenes/admin/layout.json

@@ -53,6 +53,13 @@
       "selector": ".sidebar-container .el-menu",
       "file": "src/layout/components/lay-sidebar/NavVertical.vue",
       "style_scope": ".sidebar-container",
+      "forms": {
+        "pill": "出厂默认：整块胶囊底色高亮（sidebar.scss 消费 --vts-theme-menu-active-bg，带 !important）",
+        "indicator_left": "左侧竖条指示：先在本作用域覆写 --vts-theme-menu-active-bg: transparent 关胶囊，再于设计层新建 ::after 竖条（left:0）消费 --vts-theme-menu-active-before",
+        "indicator_right": "右侧竖条指示：同上关胶囊后 ::after 挂 right:0；不要用 factory 残留锚点 --menu-active-border-right（出厂未定义该令牌）",
+        "indicator_underline": "底部横线指示：关胶囊后 ::after 挂 bottom:0（宽取 100% 或指定宽度，厚取 indicator_thickness）",
+        "none": "无指示：胶囊与竖条均关闭，仅文字变色"
+      },
       "css_vars": {
         "menu_bg": "--vts-theme-menu-bg",
         "menu_text": "--vts-theme-menu-text",
@@ -67,9 +74,10 @@
       },
       "custom_style_map": {
         "active_indicator_width": "width",
+        "active_indicator_thickness": "height",
         "active_indicator_style": "border-radius"
       },
-      "$note": "侧栏配色挂载点为 html[data-theme='xxx']（theme.scss 8 套预设）；设计输出深色侧栏 → Theme=default + Version++（useTheme 规则），浅色 → Theme=light。menu_active_* 主题变量可被 --sidebar-* 覆写变量替换。⚠文本完整性红线：菜单项名称必须完整显示（el-menu 自带 ellipsis 折叠溢出菜单），禁止改 menu 文本截断/隐藏策略；item_height 加大时确认行高不挤压文字。宽度类改动（--sidebar-width）后必须目视验证长菜单名显示。"
+      "$note": "侧栏配色挂载点为 html[data-theme='xxx']（theme.scss 8 套预设）；设计输出深色侧栏 → Theme=default + Version++（useTheme 规则），浅色 → Theme=light。⚠文本完整性红线：菜单项名称必须完整显示（el-menu 自带 ellipsis 折叠溢出菜单），禁止改 menu 文本截断/隐藏策略；item_height 加大时确认行高不挤压文字。宽度类改动（--sidebar-width）后必须目视验证长菜单名显示。⚠激活态出厂中性基线（禁止把某张图的结论写进源码）：出厂形态 = pill 胶囊高亮；--vts-theme-menu-active-before 出厂默认 transparent 且**全项目无消费者**（死通道）。因此 form=indicator_* 时必须在本条目 style_scope 内成对落地两件事才算施工完成——① 覆写 --vts-theme-menu-active-bg: transparent 关胶囊；② 在设计层文件（不可写出厂 sidebar.scss）新建 ::after 消费者引用 var(--vts-theme-menu-active-before)。缺任一项 = 「映射了却没效果」。所有几何参数（方位/粗细/长度/圆角/内缩）取自变更集 style 字段，禁止写死 left:0 / 3px 等常量。"
     },
     "admin.layout.sidebar.collapse_trigger": {
       "type": "element",
@@ -206,13 +214,15 @@
       "selector": ".set-icon",
       "file": "src/layout/components/lay-navbar/index.vue",
       "style_scope": ".navbar",
+      "visible_prop": "无出厂配置开关（出厂常显）",
       "css_vars": {
         "height": "--vts-bar-height"
       },
       "custom_style_map": {
         "icon_size": "font-size",
         "width": "width"
-      }
+      },
+      "$note": "存在性收口默认对象：效果图未出现该按钮时，变更集以 visible:false 声明 → 落地为设计层文件内 .navbar .set-icon { display:none }（禁止删出厂代码行、禁止直接改 lay-navbar/index.vue 表达「这张图不要按钮」）。反向：设计需要该按钮时不声明即可（出厂已常显）。同一 DOM（含 v-tippy 提示）通用，图标/尺寸经本条目 style 字段动态覆盖。"
     },
     "admin.layout.header.user_profile": {
       "type": "component",
@@ -220,8 +230,15 @@
       "selector": ".navbar-right .el-dropdown-link",
       "file": "src/layout/components/lay-navbar/index.vue",
       "style_scope": ".navbar",
+      "forms": {
+        "avatar_name": "出厂默认：22×22 头像 + 用户名（window.userName），无问候语",
+        "greeting_avatar_name": "问候语 + 用户名 + 头像（问候节点出厂不存在 → 由 AI 按本 form 在 lay-navbar 用户区增量插入，属结构通道施工）",
+        "greeting_name": "问候语 + 用户名，无头像",
+        "avatar_only": "仅头像",
+        "name_only": "仅用户名"
+      },
       "sub_selectors": {
-        "$comment": "avatar/name 为点位内部部件，不设独立语义 ID（符合 4 段 ID 上限）；样式字段按前缀路由到对应选择器",
+        "$comment": "avatar/name 为点位内部部件，不设独立语义 ID（符合 4 段 ID 上限）；样式字段按前缀路由到对应选择器。form 含 greeting 时新增节点统一用 class 前缀 vts-header-greeting / vts-header-username（插入前先查重名）",
         "avatar": ".navbar-right .el-dropdown-link img",
         "name": ".navbar-right .el-dropdown-link p"
       },
@@ -235,8 +252,11 @@
         "avatar_radius": "border-radius",
         "name_font_size": "font-size",
         "name_font_weight": "font-weight",
+        "greeting_font_size": "font-size",
+        "greeting_font_weight": "font-weight",
         "gap": "gap"
-      }
+      },
+      "$note": "⚠出厂中性基线：出厂 DOM 只有「头像 img + 用户名 p」，**没有任何问候语节点**（词典曾误记 .header-welcome 已实现，属虚假前提）。因此 form 含 greeting 时必须走结构增量新增 DOM，且节点文案模板（时段问候语 + 用户名）由业务层提供，本点位只承载组合形态与样式——禁止把具体问候文案写进组件。反向同理：设计只要纯头像/纯用户名时以 form=avatar_only/name_only 声明，出厂多余节点同样按收口处理（隐藏不删）。"
     },
     "admin.layout.tabs": {
       "type": "module",
@@ -273,7 +293,11 @@
       "selector": ".tags-view .scroll-item:nth-child(1)",
       "file": "src/layout/components/lay-tag/index.vue（首页页签 = multiTags 首项；真实 DOM 无 .home-item 类）",
       "style_scope": ".tags-view",
-      "$comment": "真实 DOM：.scroll-item（首项）> .card-tab，图标经 resolveCardTabIcon 渲染 svg-icon.card-tab-icon。设计意图：40×40 纯图标按钮，不可关闭、不可拖拽",
+      "forms": {
+        "icon_only": "出厂默认：首位渲染 home 图标（meta.icon 缺省回退 'home'），无标题文字",
+        "text": "纯文字首位页签（隐藏图标且不占位）"
+      },
+      "$comment": "真实 DOM：.scroll-item（首项）> .card-tab，图标经 resolveCardTabIcon 渲染 svg-icon.card-tab-icon。出厂解析规则是数据驱动的：index===0 回退 'home'，其余按 meta.icon 有无渲染（空则不渲染不占位）——因此「有无图标」是-menu 数据/变更集可动态决定的，不是源码常量。尺寸类意图（如 40×40）由变更集 style 字段给出，词典不预设具体设计值。",
       "css_vars": {
         "width": "--vts-tag-card-height",
         "height": "--vts-tag-card-height"
@@ -290,7 +314,11 @@
       "selector": ".tags-view .scroll-item:not(:nth-child(1))",
       "file": "src/layout/components/lay-tag/index.vue（业务页签 = multiTags 非首项；真实 DOM 无 .tags-view-item 类）",
       "style_scope": ".tags-view",
-      "$comment": "真实 DOM：.scroll-item.is-closable > .card-tab（title + el-icon-close），激活态类 .is-active。设计意图：padding 0 12px、激活态仅文字变主色+字重 500 无下划线、关闭钮 12×12 常显 hover #FF4D4F。card 改色/几何优先走 --vts-tag-card-*（见 layout-theme.md），勿另复制选择器",
+      "forms": {
+        "text_only": "出厂默认：业务页签纯文字（meta.icon 为空 → 不渲染不占位）",
+        "with_icon": "业务页签带图标（由路由 meta.icon 驱动显示）"
+      },
+      "$comment": "真实 DOM：.scroll-item.is-closable > .card-tab（title + el-icon-close），激活态类 .is-active。⚠出厂中性基线：图标显隐由 resolveCardTabIcon 按 meta.icon 数据驱动，不是源码写死；「某张图要求业务页签无图标」必须以 form=text_only 显式声明后由变更集落地（隐藏 .card-tab-icon 且不占位），词典不预置任何设计的结论。间距/关闭钮尺寸/激活态表现等参数一律由当次变更集 style 字段给出。",
       "css_vars": {
         "card_height": "--vts-tag-card-height",
         "card_radius": "--vts-tag-card-radius",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qilitt-mickey/vue3-temp-skill",
-  "version": "1.1.40",
+  "version": "1.1.41",
   "type": "module",
   "description": "Vue 3 企业级中后台项目开发规范技能包 — core-kernel 架构、按需功能模块",
   "bin": {

package/references/design-apply.md

@@ -30,6 +30,28 @@ parser match（确定性翻译）→ 施工坐标 → AI 按坐标改代码 →
 
 无论哪条来路，落地流程一律走下文「执行流程」。
 
+## 出厂中性 · 变更集驱动（架构红线，违反即返工）
+
+**同一份模板源码，换一份变更集 = 换一套外观。** 任何「本次设计的结论」都不许固化进源码：
+
+| | 允许 | 禁止 |
+|---|---|---|
+| 模板源码 | 只提供**能力通道**：CSS 变量的消费者挂载点、form 枚举、DOM/属性钩子、正确的层叠优先级 | 预置**设计结论**：某个具体颜色、某句问候语、某个方位的指示条、某个硬编码尺寸 |
+| 设计产出 | AI 按本协议写入**设计层文件 / 页面级 scoped 样式 / DOM 属性与配置** | 为表达某张效果图而改写出厂样式文件与出厂组件（换设计即失效，且污染模板） |
+
+**判据（一句话）**：换一张效果图只需要换变更集、不需要改源码 ⇒ 架构正确；需要改源码才能换 ⇒ 设计结论被烧进了源码，必须回退为通道。
+
+- ❌ 反例：把「菜单激活指示条 = 左侧 3px」写死进 `sidebar.scss` / `element-plus.scss`；把问候语 DOM 直接加进 `lay-navbar/index.vue`；出厂 `<component>` 上硬编码 `data-content-mode="scroll"`。
+- ✅ 正例：`admin.layout.sidebar.menu` 暴露 `forms`（pill/indicator_left/indicator_right/indicator_underline/none）+ 几何字段，方位与粗细由变更集驱动；高度模式出厂不带任何属性，由页面根节点按变更集声明。
+
+**落地三落点判据**（每个变更字段先判落点再动手）：
+
+1. **有非样式通道**（DOM 属性 / 组件配置 / `platform-config.json`）→ 必须走该通道（form=scroll/fixed → 页面根节点 `data-content-mode`；form=card → `ShowModel`）。降级写成 SCSS = 未施工。
+2. **无通道且需改 DOM**（新增节点，如问候语欢迎区）→ 结构增量施工（AI 在组件模板内按 `form` 插入，保形插入、不删原代码）。
+3. **纯视觉表达**（颜色/圆角/间距/指示条几何）→ 设计层文件（见第 3 步）。
+
+**出厂文件仅在「通道缺失」时才可改动**，且须同时满足：① 补的是能力不是结论（补变量消费者、补 form 枚举、修层叠优先级）；② 在交付说明中单列「补通道」条目写明缺失点与修复内容。
+
 ## 输入契约（变更集 Schema v1.0）
 
 ```jsonc
@@ -95,8 +117,13 @@ node parser/index.js match --batch <changesets-dir>
 - `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` 为省略即钩子类探测）。枚举外的形态 → 报告，不猜。
+- `form` 的落点按上文「落地三落点判据」执行：**有 DOM/配置通道走通道，无通道需新节点走结构增量，纯视觉形态走设计层样式文件**。当某形态在本项目只有样式表达（如菜单指示条方位）时，该 form 允许落到样式层——这与「禁止把内容区高度模式降级成 SCSS」不冲突，判据是**该形态有没有非样式通道**。
 - `layout_type` → 改 `platform-config.json Layout` 字段，值域 `vertical/horizontal/mix`。**大屏全屏沉浸式等独立页不走此通道**（设计侧不填 `layout_type`，点位走 L3 落地）。
 
+**存在性收口（通用机制，第 2 步随结构处理）**：变更集未声明的**出厂多余元素**（设计效果图上不存在的按钮/图标/入口，如顶栏设置按钮）→ 按各条目口径处理：有条目者在对应点位上以 `visible:false` 收口（代码保留，`v-if`/`display:none`）；无条目者列入待补充清单申报「设计侧未声明，按无此元素收口」，同样以隐藏通道落地。禁止既不声明也不收口、让出厂元素顶替设计效果（顶栏设置按钮漏收口已实证：效果图无此按钮，落地后仍显示）。反向同理：**设计声明了而出厂没有的元素**（如欢迎区问候语）必须按条目 `$note`/设计规范补齐结构（结构通道豁免底线二），缺失 = 未交付。
+
+**结构/样式图层分工**：`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 高度链断裂致列表区整体崩坏——已回退，禁止复活）。
+
 ### 第 3 步 · 样式落地（两层转换 + 语义值译表）
 
 对每个 `style` 字段，按 parser 转换指令执行（parser 已把语义值解析为精确值，如 `钴蓝-5` → `#245BFF`）。**冲突裁决规则（免问）：凡变更集声明与项目出厂现状/模板既有口径冲突，一律按变更集执行——变更集是唯一施工依据，不反问、不逐次确认。**
@@ -119,6 +146,17 @@ node parser/index.js match --batch <changesets-dir>
 
 全局令牌（`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）。
 
+### 第 3 步附加 · 设计层落点文件（强制）
+
+所有「新增的 CSS 规则」一律写入 **`src/styles/design-shell.scss`**（出厂空文件，经 `index.scss` 末位 `@use` 加载 → 后置压出厂，无需 `!important`），或写入页面级 `<style scoped>`；**不得**写进 `sidebar.scss` / `element-plus.scss` / `theme.scss` / `lay-*.vue` 等出厂文件去表达某张效果图的结论。
+
+写入纪律：
+
+- 每条规则带来源标注（`/* <语义 ID> · <变更条目> */`），换设计时整段可替换；
+- 本文件内新增的 CSS 变量必须**定义 + 引用成对出现**（出厂已有消费者也算），避免死通道；
+- 出厂元素需关闭时（存在性收口）也在这里做：令牌置 `transparent` 或 `display:none`，**绝不删出厂代码行**；
+- 出厂 `--vts-theme-menu-active-before` 默认 `transparent` 且无消费者 → 声明 `form=indicator_*` 时必须在此文件内**同时**落地「关胶囊令牌 `menu_active_bg: transparent`」与「新建 `::after` 消费者」，缺一即未施工成功。
+
 ### 第 4 步 · L3 新模块处理（分级布局）
 
 - 新模块按「定制布局」三步走：① 基于全局规范生成结构（继承命名/作用域/组件规范）② 原子层字段（色彩/圆角/组件级）从 `basic/` + `component/` 词典借力 ③ 场景专属点位生成后**立即写入 mapping/ 对应场景域**（临时映射），累计复用 ≥3 次建议升级标准（由人工评审）。
@@ -135,13 +173,19 @@ node parser/index.js match --batch <changesets-dir>
 - [ ] 未改动业务逻辑层（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` + 变更集驱动
 - [ ] **文本溢出回归检查**：改动侧栏菜单/顶栏/页签等含文字的模块后，必须确认「长文本显示」未被破坏（菜单项名称完整可见，必要时保留 ellipsis 溢出策略而不是隐藏/截断）；宽度相关字段（width/min-width/padding）改动后逐项目视验证
 - [ ] **形态与存在性目视验证（历史漏还原高发区，声明即必须验证，没做视同未交付）**：变更集声明了以下意图时，逐项在页面上确认真实生效——
   - 语言切换 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` 属性落在页面根节点（不是样式文件），列表页 `:has(.vts-page-card)` 自动定高未被压掉——**列表页必验：表头/行/分页在视口内、表格高度正常（无拉伸/塌陷/双滚动条）**
   - 操作栏 form=with_tools/left_batch → 刷新/密度/列设置三件套齐全；批量删除红底/导出白底/未选中置灰
   - 操作列 form=text_link → **业务列定义的 icon 字段已移除**（纯文字无图标，只改 CSS 保留图标 = 未还原）；按钮单行不换行（列宽 ≥160px + nowrap）；删除项红色；≥3 个折叠「更多」带箭头
-  - tabs form → 页签形态切换生效（chrome/card）；激活态无主题色下划线（设计规范口径）
+  - tabs form → 页签形态切换生效（chrome/card）；激活态表现（有无下划线 / 是否仅文字变色 / 字重）按当次变更集 style 字段核对，**不以历史设计稿口径为准**
+- [ ] **映射通道活性检查（杂必查）**：样式落地引用的每个 CSS 变量必须在项目样式中**存在消费者**（`变量名` 有 `var(--xxx)` 引用点）；只定义不消费的变量 = 通道死路，翻译再准也不生效（menu_active_indicator 曾因 --vts-theme-menu-active-before 无消费者而「映射了却没效果」）。施工时 grep 核对，无消费者时改走消费者存在的作用域或补挂载点并申报。
 - [ ] **dark.scss 暗色同步**：新增视觉规则在 `html.dark` 有对应覆盖
 - [ ] 待补充清单已如实反馈（含点位 ID + 缺失字段名），未擅自补映射
 - [ ] `node parser/index.js build --dry` 通过（mapping 若有临时新增）