@qilitt-mickey/vue3-temp-skill 1.1.37 → 1.1.39

package/SKILL.md

@@ -24,7 +24,7 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 - 做一个订单仪表盘，含统计卡片和趋势图
 - 给现有 Demo 增加附件上传、导出或审批流
 - 把一个页面从 mock 改成真实 API
-- 落地一份设计变更集 JSON（上游 project-ui-design 产出，含语义 ID + 抽象样式字段）
+- 「按这份设计方案改造全系统」/ 落地设计技能产出的设计文件（用户可能是小白，只会给文件路径或拖入文件；见 §3b）
 
 ## 运行时只保留三件事
 
@@ -74,7 +74,16 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 - Demo 可以最小化数据和接口，但目录、类型、命名和组件边界要能承接后续开发。
 - 新依赖先检查目标项目；缺失时说明精确版本、原因和构建接线，确认后再安装。
 - 只有目标项目确实存在排除项、占位插件或缺失接线时，才读取 `addon-enable.md` 恢复配置。
-- **输入为设计变更集时**：不走常规闭环，改走 `design-apply.md` 协议——变更集是设计技能（project-ui-design）的中立产出（设计侧不感知下游），本 Skill 是统一获取与执行方；parser 匹配出施工坐标后按「结构先行、样式两层转换」落地，并过变更集合规闸门。
+- **输入为设计文件时**：用户给出设计技能（project-ui-design）产出的 JSON 文件（无论叫"设计方案/设计文件/变更集"）→ 不走常规闭环，改走 `design-apply.md` 协议——parser 匹配出施工坐标后按「结构先行、样式两层转换」落地，并过变更集合规闸门。
+
+### 3b. 小白用户执行纪律（design-apply 场景）
+
+使用者默认**不懂设计也不懂代码**，交互遵守四条：
+
+1. **全自动默认**：识别为设计文件落地后**直接开始执行 parser match → 结构 → 样式 → 闸门全流程**，不等用户逐步确认，不询问"是否继续"；唯一停顿点是文件缺失/版本不匹配/parser 报错——此时用大白话报告并给选择题。
+2. **术语不对用户出现**：对用户不说"变更集/语义 ID/三级匹配/pending/令牌"——说"设计方案/设计点位/自动适配/新增点位/全局样式"。这些词只出现在内部文档与交付说明里。
+3. **无文件时的引导**：用户说"全系统改成 XX 风格"但没给设计文件 → 提示一句话："请先在设计助手（project-ui-design 技能）里说『我要 XX 风格的全系统设计』拿到设计文件，再回来发给我"。如果本机同时装有设计技能，可直接引导用户回到设计会话完成设计，再回本项目落地。
+4. **交付话术**：完成后用大白话总结（改了哪些页面/哪些地方变了/怎么验收），不输出施工坐标等技术细节；验收引导统一为"运行 `pnpm dev` 打开页面对照看效果，哪里不满意直接说"。
 
 ### 4. 验证与交付
 

package/mapping/component/tag.json

@@ -0,0 +1,47 @@
+{
+  "$comment": "全局原子层 · 状态标签组件映射（EP 原生 el-tag）。对应设计侧 list-page §7 状态标签（filled 默认变体）与 component-spec 3.4 状态色映射。新增（2026-09-07 场景还原差异分析：状态/类型列纯文本无 Tag 是还原差异主因之一）。",
+  "meta": {
+    "layer": "basic",
+    "domain": "component_tag",
+    "version": "1.1.0",
+    "scene": "global",
+    "tech_stack": "vue3 + element-plus"
+  },
+  "mappings": {
+    "component.tag.status": {
+      "type": "global_component",
+      "component": "ElTag",
+      "default_props": { "effect": "light" },
+      "style_scope": ":root",
+      "forms": {
+        "filled": "浅色背景+浅边框+语义色文字（EP effect=light，设计侧默认变体）",
+        "outlined": "透明背景+语义色边框+语义色文字（EP effect=plain）",
+        "solid": "纯色填充+白字（EP effect=dark）",
+        "with_icon": "filled + 16px 图标（物流状态等带图标场景）"
+      },
+      "css_vars": {
+        "bg_color": "--el-tag-bg-color",
+        "text_color": "--el-tag-text-color",
+        "border_color": "--el-tag-border-color"
+      },
+      "custom_style_map": {
+        "height": "height",
+        "radius": "border-radius",
+        "font_size": "font-size",
+        "padding_x": "padding"
+      },
+      "$note": "状态语义色走 EP 功能色变量：success=--el-color-success / processing=--el-color-primary / warning=--el-color-warning / error=--el-color-danger。设计侧值口径：filled（默认）/outlined/solid/with_icon 四形态；多 Tag 列 >=3 列时四选二规则由设计侧在 changes 中按列声明 form，项目侧按 form 翻译 EP effect。列级声明机制（v1.1.0 澄清）：component.tag.status 是 :root 全局默认，逐列差异必须声明为内容点位（admin.content.table.cell_tag.<列语义> 走 pending/L3，或写入该列所属点位的 notes），禁止对全局 ID 声明多份互相覆盖的 form"
+    },
+    "component.tag.size": {
+      "type": "global_token",
+      "style_scope": ":root",
+      "css_vars": {},
+      "custom_style_map": {
+        "height": "height",
+        "font_size": "font-size",
+        "padding_x": "padding"
+      },
+      "$note": "设计值：高 24px、圆角 6px、字号 12px、内边距 0 8px（list-page §11.64）"
+    }
+  }
+}

package/mapping/scenes/admin/content.json

@@ -1,10 +1,10 @@
 {
-  "$comment": "admin 场景 · 内容区功能点位映射。admin.content.container 为壳层高度模式通道（源码实证，lay-content/index.vue）；其余 6 条为页面构图点位：类名为 vue3-temp-skill crud-pages.md L1-L9 标准样板约定，样式规则与令牌已落地（element-plus.scss 消费 design-tokens.scss L235-251 构图令牌，dark.scss 消费 vts-filter-area），存量表格 demo（views/table/{base,treeTable,vxe-table}）已对齐样板；pagination 为 Element Plus 实证类（RePagination 根节点即 el-pagination，无自定义语义类）。",
+  "$comment": "admin 场景 · 内容区功能点位映射。admin.content.container 为壳层高度模式通道（源码实证，lay-content/index.vue）；其余为页面构图点位：类名为 vue3-temp-skill crud-pages.md L1-L9 标准样板约定，样式规则与令牌已落地（element-plus.scss 消费 design-tokens.scss L235-251 构图令牌，dark.scss 消费 vts-filter-area），存量表格 demo（views/table/{base,treeTable,vxe-table}）已对齐样板；pagination 为 Element Plus 实证类（RePagination 根节点即 el-pagination，无自定义语义类）。新增表格细粒度点位（operation_column/cell_amount/cell_thumb），对应设计侧 list-page §26.12-26.15。v1.1.0：operation_column 补 column_width/nowrap（按钮挤行修复）；operation_bar 补 with_tools/left_batch 形态与批量按钮配色置灰字段（对应 list-page §4 三件套与批量区规范）。",
   "meta": {
     "layer": "scene",
     "scene": "admin",
     "domain": "content",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "tech_stack": "vue3 + element-plus + vue3-web-temp"
   },
   "mappings": {
@@ -62,13 +62,75 @@
     "admin.content.table.operation_bar": {
       "type": "element",
       "selector": ".vts-action-bar",
-      "file": "业务 views（crud-pages 操作栏 / ReTableBar）",
+      "file": "业务 views（crud-pages 操作栏 / ReTableBar）；ReTableBar 右侧工具三件套源码实证：刷新 svg-icon + el-dropdown 密度（宽松/默认/紧凑）+ el-popover 列设置（bar.vue L155-243）",
       "style_scope": ".vts-page-card",
+      "forms": {
+        "with_tools": "工具三件套（刷新/密度/列设置）齐全——设计规范 list-page §4 要求三件套缺一不可（ReTableBar 出厂已具备，此为默认形态）",
+        "left_batch": "左侧批量操作区（批量删除红底 + 批量导出白底，未选中置灰 opacity 0.4 + cursor not-allowed）——经 slots.buttons 插入，出厂多数 demo 未用"
+      },
       "css_vars": {
         "gap": "--action-bar-gap",
         "padding_y": "--action-bar-padding-y"
       },
-      "custom_style_map": {}
+      "custom_style_map": {
+        "btn_height": "height",
+        "btn_radius": "border-radius",
+        "btn_font_size": "font-size",
+        "batch_delete_bg": "background-color",
+        "batch_disabled_opacity": "opacity"
+      },
+      "$note": "对应设计侧 list-page §4/§11.25-11.36：flex 两端对齐、pad 20px 20px 8px、左侧批量（始终展示未选中置灰）、右侧工具三件套。批量删除红底走 batch_delete_bg（--el-color-danger 链）；置灰态走 batch_disabled_opacity。v1.1.0 扩字段（2026-09-08 对账：原仅 gap/padding_y 两字段，批量按钮配色/置灰/三件套存在性无承接）。demo 噪音按钮（如『表单提交』）去留属业务层，变更集 notes 申报双层交付后由项目侧业务闭环移除"
+    },
+    "admin.content.table.operation_column": {
+      "type": "element",
+      "selector": ".vts-table-area .el-table__cell.re-table-operate, .vts-table-area .el-table-fixed-column--right",
+      "file": "业务 views（ReTableOperate 渲染，crud-pages.md L9 强制；fixed=right）",
+      "style_scope": ".vts-page-card",
+      "forms": {
+        "text_link": "纯文字链接无图标（对应设计 list-table-action-no-icon=true；ReTableOperate text 档位）",
+        "icon_text": "图标+文字（ReTableOperate icon 字段，出厂常见形态）"
+      },
+      "css_vars": {
+        "link_color": "--el-color-primary",
+        "danger_color": "--el-color-danger",
+        "divider_color": "--vts-border-color"
+      },
+      "custom_style_map": {
+        "align": "text-align",
+        "min_width": "min-width",
+        "column_width": "width",
+        "nowrap": "white-space",
+        "divider_width": "width",
+        "divider_height": "height",
+        "more_arrow_size": "font-size"
+      },
+      "$note": "对应设计侧 list-page §5/§26.14：纯文字链接、无图标、短分割线隔离（1px×14px）、>=3 个折叠到更多（带 10px 箭头）、表头文字居中；操作列固定宽 160px + white-space:nowrap 禁止换行（按钮挤行多行 = 还原差异主因之一，v1.1.0 补 column_width/nowrap 字段）。项目侧落地手段：ReTableOperate 的 list 项去 icon 字段 + type:danger 表达红色删除 + limit 折叠 + 列宽 props；折叠阈值为组件 props（结构层），不在样式映射内。fieldPending 机制提示：设计侧声明本点位但未带 min_width/column_width 时，AI 施工必须回填出厂值 160px/nowrap 并在交付说明注明，禁止留空导致按钮换行"
+    },
+    "admin.content.table.cell_amount": {
+      "type": "element",
+      "selector": ".vts-table-area .el-table__cell.col-price, .vts-table-area .el-table__cell.is-right",
+      "file": "业务 views（金额列 className 约定，对齐设计 list-table-col-price）",
+      "style_scope": ".vts-page-card",
+      "css_vars": {},
+      "custom_style_map": {
+        "align": "text-align",
+        "font_variant_numeric": "font-variant-numeric"
+      },
+      "$note": "对应设计侧 §11.110 col-price：右对齐 + tabular-nums 等宽数字。落地手段：列定义加 class-name=col-price + align=right；「等宽数字」为定性词，施工时译为 font-variant-numeric: tabular-nums。新增（同上差异分析：金额列左对齐/格式异常）"
+    },
+    "admin.content.table.cell_thumb": {
+      "type": "element",
+      "selector": ".vts-table-area .el-table__cell.col-thumb",
+      "file": "业务 views（缩略图列 className 约定，对齐设计 col-thumb/thumb-box）",
+      "style_scope": ".vts-page-card",
+      "css_vars": {},
+      "custom_style_map": {
+        "thumb_width": "width",
+        "thumb_height": "height",
+        "thumb_radius": "border-radius",
+        "column_width": "width"
+      },
+      "$note": "对应设计侧 §11.108-11.109：列宽 72px 居中，缩略盒 40×40 圆角 6px。落地手段：列 className=col-thumb + el-image 40×40；设计侧按数值字面量直书 thumb_width/height=40px（v1.0 协议第 3 条）。新增（同上差异分析：图片列大图 vs 缩略盒）"
     },
     "admin.content.table.area": {
       "type": "component",

package/mapping/scenes/admin/layout.json

@@ -1,10 +1,10 @@
 {
-  "$comment": "admin 场景 · 布局模块语义 ID 全属性映射（vue3-web-temp 框架组件实证）。每条含结构定位（selector/file）、形态切换（forms）、样式映射（css_vars 优先 + custom_style_map 兜底）。style_scope 为样式必须包裹的容器类名；:root 表示全局令牌层。",
+  "$comment": "admin 场景 · 布局模块语义 ID 全属性映射（vue3-web-temp 框架组件实证）。每条含结构定位（selector/file）、形态切换（forms）、样式映射（css_vars 优先 + custom_style_map 兜底）。style_scope 为样式必须包裹的容器类名；:root 表示全局令牌层。v1.1.0：新增 admin.layout.header.collapse_trigger（顶栏内嵌折叠按钮，对应设计侧 unified-framework §6.23；出厂折叠在侧栏底部，header_inline 形态走 v-if 保形插入）。",
   "meta": {
     "layer": "scene",
     "scene": "admin",
     "domain": "layout",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "tech_stack": "vue3 + element-plus + vue3-web-temp"
   },
   "mappings": {
@@ -69,7 +69,7 @@
         "active_indicator_width": "width",
         "active_indicator_style": "border-radius"
       },
-      "$note": "侧栏配色挂载点为 html[data-theme='xxx']（theme.scss 8 套预设）；设计输出深色侧栏 → Theme=default + Version++（useTheme 规则），浅色 → Theme=light。menu_active_* 主题变量可被 --sidebar-* 覆写变量替换"
+      "$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）后必须目视验证长菜单名显示。"
     },
     "admin.layout.sidebar.collapse_trigger": {
       "type": "element",
@@ -96,6 +96,7 @@
       "style_scope": ".navbar",
       "default_props": { "height": "var(--vts-bar-height)" },
       "children": [
+        "admin.layout.header.collapse_trigger",
         "admin.layout.header.logo_area",
         "admin.layout.header.breadcrumb",
         "admin.layout.header.lang_switch",
@@ -146,7 +147,8 @@
       "file": "src/components/ReLanguageSwitch/src/index.vue",
       "style_scope": ".navbar",
       "forms": {
-        "icon_only": "出厂现状：纯图标触发器（.language-trigger > .language-icon），下拉菜单选语言"
+        "icon_only": "出厂现状：纯图标触发器（.language-trigger > .language-icon），下拉菜单选语言",
+        "inline_switch": "并排切换形态（下拉项平铺为触发器旁的切换组，按 V3.0 §4.2 v-if 保形切换，不删原代码）"
       },
       "css_vars": {
         "icon_color": "--el-text-color-regular",
@@ -163,6 +165,28 @@
       },
       "$note": "inline_switch 并排切换形态需增量插入片段（变更集 form=inline_switch 时按 V3.0 §4.2 v-if 保形切换，不删原代码）"
     },
+    "admin.layout.header.collapse_trigger": {
+      "type": "element",
+      "selector": ".navbar .header-collapse-btn",
+      "file": "src/layout/components/lay-navbar/index.vue（顶栏内嵌形态为增量插入；出厂折叠按钮位于侧栏，见 admin.layout.sidebar.collapse_trigger）",
+      "style_scope": ".navbar",
+      "forms": {
+        "header_inline": "顶栏内嵌折叠按钮（设计规范 unified-framework §6.23：40×40 纯图标、无左内边距、与首页页签左对齐、hover 仅文字加深无背景变化）——出厂无此元素，按 ReLanguageSwitch inline_switch 同款 v-if 保形插入机制落地，不删侧栏折叠条代码",
+        "sidebar_bottom": "出厂现状：侧栏底部折叠条（SidebarLeftCollapse）",
+        "sidebar_center": "侧栏侧缘中点（SidebarCenterCollapse）"
+      },
+      "css_vars": {
+        "icon_color": "--el-text-color-regular",
+        "hover_bg": "--el-fill-color-light"
+      },
+      "custom_style_map": {
+        "btn_width": "width",
+        "btn_height": "height",
+        "icon_size": "font-size",
+        "border_radius": "border-radius"
+      },
+      "$note": "设计规范把折叠按钮定义在顶栏最左（与页签栏首页页签左对齐）。form=header_inline 时 AI 增量插入按钮片段（useApp isCollapse 切换），样式全部走 custom_style_map 生成的 :deep 隔离规则；出厂 sidebar_bottom 形态保留不删（显隐≠删除）。新增（2026-09-08 场景还原对账：设计侧有 §6.23 参数、项目侧无承接点位，折叠按钮位置还原失败的主因）"
+    },
     "admin.layout.header.fullscreen": {
       "type": "component",
       "component": "SidebarFullScreen",

package/package.json

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

package/parser/fixtures/changeset-fullpage-restore.json

@@ -0,0 +1,81 @@
+{
+  "$comment": "端到端示例 · 整页场景还原（对照效果图逐模块提取的完整交付样例，模拟设计技能真实产出）。覆盖：global 主题 + 壳层全模块 + 列表页全字段 + 表格细粒度点位（操作列形态/状态Tag/金额对齐/缩略图）+ pending 新点位。值口径演示：主题色用语义值（钴蓝-N/错误色）、尺寸用数值字面量（28px/40px 等，设计侧 v1.0 协议第 3 条合法通道）、灰阶用临时主题 hex + notes 申报。业务功能差异（新增运单按钮功能、demo 演示按钮去留）不在本变更集范围，走项目侧业务闭环开发（双层交付）。运行：node parser/index.js match <本文件>（cwd 为 skill 根）。",
+  "schema": "design.changeset/1.0",
+  "changeset_version": "1.0.0",
+  "mapping_version": "1.0.0",
+  "scene": "admin",
+  "layout_type": "vertical",
+  "global": {
+    "brand_primary": "钴蓝-5",
+    "sidebar_bg": "钴蓝-10"
+  },
+  "changes": [
+    { "id": "admin.layout.sidebar", "style": { "bg": "钴蓝-10" } },
+    { "id": "admin.layout.sidebar.logo_area", "style": { "bg": "钴蓝-10", "title_color": "#FFFFFF" } },
+    {
+      "id": "admin.layout.sidebar.menu",
+      "style": {
+        "menu_bg": "钴蓝-10",
+        "menu_text": "钴蓝-2",
+        "menu_hover_bg": "钴蓝-8",
+        "menu_title_hover": "#FFFFFF",
+        "sub_menu_bg": "钴蓝-9",
+        "sub_menu_active_text": "#FFFFFF",
+        "menu_active_bg": "钴蓝-5",
+        "menu_active_indicator": "钴蓝-5"
+      }
+    },
+    { "id": "admin.layout.header", "style": { "bg": "#FFFFFF" } },
+    { "id": "admin.layout.header.lang_switch", "form": "inline_switch" },
+    {
+      "id": "admin.layout.header.user_profile",
+      "style": { "avatar_width": "28px", "avatar_height": "28px", "avatar_radius": "全圆角", "name_font_size": "14px", "name_font_weight": "中等" }
+    },
+    { "id": "admin.layout.tabs", "form": "chrome", "style": { "bg": "#FFFFFF" } },
+    {
+      "id": "admin.content.page_header",
+      "style": { "title_size": "20px", "title_weight": "加粗", "desc_color": "钴蓝-3", "actions_gap": "8px" }
+    },
+    {
+      "id": "admin.content.filter_area",
+      "style": { "radius": "小圆角", "padding_y": "宽松", "padding_x": "宽松", "bg": "#FFFFFF", "border_bottom": "1px solid #F0F0F0" }
+    },
+    {
+      "id": "admin.content.table.operation_bar",
+      "style": { "gap": "8px", "padding_y": "紧凑" }
+    },
+    {
+      "id": "admin.content.table.operation_column",
+      "form": "text_link",
+      "style": { "link_color": "钴蓝-5", "danger_color": "错误色", "align": "center", "divider_color": "#F0F0F0" }
+    },
+    { "id": "admin.content.table.area", "style": { "header_bg": "#FAFAFA", "row_hover_bg": "#FAFAFA", "radius": "小圆角" } },
+    { "id": "admin.content.table.cell_amount", "style": { "align": "right", "font_variant_numeric": "等宽数字" } },
+    { "id": "admin.content.table.cell_thumb", "style": { "thumb_width": "40px", "thumb_height": "40px", "thumb_radius": "小圆角" } },
+    { "id": "component.tag.status", "form": "filled", "style": { "height": "24px", "radius": "小圆角" } },
+    { "id": "admin.content.pagination", "style": { "active_bg": "钴蓝-5", "active_color": "#FFFFFF" } }
+  ],
+  "pending": [
+    {
+      "proposed_id": "admin.content.page_header.greeting",
+      "function": "页面标题下的说明副标题（一句话描述页面用途）",
+      "parent": "admin.content.page_header"
+    },
+    {
+      "proposed_id": "admin.content.table.cell_status_badge",
+      "function": "表格状态列的带图标状态胶囊（图标+文字+浅色底）",
+      "parent": "admin.content.table.area"
+    },
+    {
+      "proposed_id": "admin.content.table.cell_route_arrow",
+      "function": "表格线路列的起点到终点箭头展示（如 上海→北京）",
+      "parent": "admin.content.table.area"
+    },
+    {
+      "proposed_id": "admin.content.table.cell_link",
+      "function": "表格内可点击的链接文字单元（如运单号）",
+      "parent": "admin.content.table.area"
+    }
+  ],
+  "notes": "整页场景还原样例（对照效果图逐模块提取）。效果图定制冲突项：侧栏底色用钴蓝-10（极深）而非模板默认 #001529，以用户效果图为准；顶栏保持白底。灰阶临时色申报：白 #FFFFFF、浅灰 #FAFAFA、边框灰 #F0F0F0 为中性色（不属任何主题梯度），按临时主题 hex 直写，全主题通用。页面存在业务结构改动（标题区按钮数量与功能、demo 演示内容去留），需项目侧双层交付：页面结构层走业务闭环开发重建，视觉语义层按本变更集落地。问候语（下午好，张伟）文案属业务层，本变更集只声明其载体形态与样式。"
+}

package/parser/index.js

@@ -33,7 +33,11 @@ const ROOT = path.resolve(__dirname, "..");
 
 /** 定性值（非色彩类语义描述，如 中等/全圆角/宽松）：不参与译表，AI 按字段语义施工，不告警。
  *  注意：模块级常量必须在 main() 调用前声明（TDZ），勿下移到文件底部。 */
-const QUALITATIVE_RE = /^(中等|加粗|常规|细|粗|小圆角|全圆角|直角|宽松|紧凑|标准|大|中|小)$/;
+const QUALITATIVE_RE = /^(中等|加粗|常规|细|粗|小圆角|全圆角|直角|宽松|紧凑|标准|大|中|小|等宽数字)$/;
+/** 数值字面量：带 CSS 单位的精确尺寸（40px / 1.5rem / 50%）——设计侧已消歧的精确值，透传不提示 */
+const NUMERIC_VALUE_RE = /^\d+(\.\d+)?(px|rem|em|%|vh|vw|pt)$/i;
+/** 复合样式字面量：含空格的多段值（如 1px solid #F0F0F0）按已消歧处理（hex 已被禁词校验限定位置） */
+const COMPOSITE_VALUE_RE = /\s/;
 
 main();
 
@@ -503,11 +507,13 @@ function buildSemanticValueIndex(dataset) {
   return dict;
 }
 
-/** 语义值解析：hex 透传 → 中文名查表 → 英文名查表 → null（未命中） */
+/** 语义值解析：hex/rgb/hsl 透传 → 数值/复合字面量透传 → 中文名查表 → 英文名查表 → null（未命中） */
 function resolveSemanticValue(value, valueDict) {
   const v = String(value).trim();
   if (/^#([0-9a-fA-F]{3,8})$/.test(v) || /^(rgb|hsl)a?\(/i.test(v))
     return v;
+  if (NUMERIC_VALUE_RE.test(v) || COMPOSITE_VALUE_RE.test(v))
+    return v;
   if (valueDict && valueDict[v])
     return valueDict[v];
   return null;

package/parser/regression.js

@@ -91,6 +91,13 @@ const steps = [
   },
   {
     key: "H",
+    name: "match 整页场景还原样例（壳层+内容区全模块 L1 + 数值字面量透传）",
+    script: INDEX,
+    args: ["match", path.join(FIXTURES, "changeset-fullpage-restore.json")],
+    expect: { code: 0, includes: "#245BFF" },
+  },
+  {
+    key: "I",
     name: "build --dry 产物链自检",
     script: INDEX,
     args: ["build", "--dry"],
@@ -101,7 +108,7 @@ const steps = [
 const results = [];
 let failed = 0;
 
-console.log("=== A-H 端到端一键回归 ===\n");
+console.log("=== A-I 端到端一键回归 ===\n");
 
 for (const step of steps) {
   const { status, stdout, stderr } = spawnSync(
@@ -134,4 +141,4 @@ if (failed > 0) {
   console.error(`\n✖ ${failed} 步未通过，见上方详情`);
   process.exit(1);
 }
-console.log("\n✔ A-H 全部通过，mapping/parser 可提交或发版");
+console.log("\n✔ A-I 全部通过，mapping/parser 可提交或发版");

package/references/design-apply.md

@@ -134,7 +134,15 @@ node parser/index.js match --batch <changesets-dir>
 - [ ] 未修改 `src/components/`（Re* 组件库源码——**底线一**）
 - [ ] 未改动业务逻辑层（API/状态/事件——**底线二**；样式与结构通道内的 DOM 调整除外）
 - [ ] 两层样式全部落在 `style_scope` 作用域内，无全局泄漏
-- [ ] `dark.scss` 暗色同步：新增视觉规则在 `html.dark` 有对应覆盖
+- [ ] **类名冲突检查（AI 施工硬性步骤）**：新增 class 之前先在目标文件与同作用域全局样式中检索同名类——已存在时禁止直接追加重复定义，按三选一处理并在交付说明申报：① 语义相同 → **合并**进既有规则；② 语义不同 → 改用带点位前缀的新类名（如 `vts-<语义id末段>`）；③ 确需覆盖 → 走作用域内更高优先级（不写 `!important`）。重复类名（尤其跨 `<style>` 块的 scoped 样式重复定义）会触发编辑器/构建报错，**本项不通过不得交付**
+- [ ] **文本溢出回归检查**：改动侧栏菜单/顶栏/页签等含文字的模块后，必须确认「长文本显示」未被破坏（菜单项名称完整可见，必要时保留 ellipsis 溢出策略而不是隐藏/截断）；宽度相关字段（width/min-width/padding）改动后逐项目视验证
+- [ ] **形态与存在性目视验证（2026-09-08 追加，历史漏还原高发区）**：变更集声明了以下意图时，逐项在页面上确认真实生效，声明了但没做的视同未交付——
+  - 语言切换 form=inline_switch → 顶栏出现「中|EN」并排文字（不再是纯图标）
+  - 折叠按钮 form=header_inline → 顶栏最左出现 40×40 折叠按钮且与首页页签左对齐
+  - 操作栏 form=with_tools/left_batch → 刷新/密度/列设置三件套齐全；批量删除红底/导出白底/未选中置灰
+  - 操作列声明过 form 或样式 → 按钮单行不换行（列宽 ≥160px + nowrap）
+  - tabs form → 页签形态切换生效（chrome/card）；激活态无主题色下划线（设计规范口径）
+- [ ] **dark.scss 暗色同步**：新增视觉规则在 `html.dark` 有对应覆盖
 - [ ] 待补充清单已如实反馈（含点位 ID + 缺失字段名），未擅自补映射
 - [ ] `node parser/index.js build --dry` 通过（mapping 若有临时新增）
 
@@ -151,7 +159,7 @@ node parser/index.js match --batch <changesets-dir>
 ## 端到端回归（改 parser/mapping 后必跑）
 
 ```bash
-node parser/regression.js        # 一键跑完 A-H 八步（自动断言退出码与关键输出，任一失败 exit 1 并回显详情）
+node parser/regression.js        # 一键跑完 A-I 九步（自动断言退出码与关键输出，任一失败 exit 1 并回显详情）
 npm run regression               # 等价写法
 ```
 
@@ -165,10 +173,11 @@ node parser/index.js match parser/fixtures/changeset-neg1.json    # D. 负例1
 node parser/index.js match parser/fixtures/changeset-neg2.json    # E. 负例2：exit 1（mapping_version 不匹配）
 node parser/index.js match parser/fixtures/changeset-neg3.json    # F. 负例3：exit 1（禁词/非法 ID/位置违规，逐条列出）
 node parser/index.js match parser/fixtures/changeset-legacy.json  # G. 旧协议：exit 0 + layout 键/schema 历史值两条告警
-node parser/index.js build --dry                          # H. 产物链自检
+node parser/index.js match parser/fixtures/changeset-fullpage-restore.json  # H. 整页场景还原样例：exit 0；壳层+内容区全模块 L1 命中；数值字面量（40px 等）透传无 ⚠
+node parser/index.js build --dry                          # I. 产物链自检
 ```
 
-通过标准：regression.js 输出 `A✔ B✔ … H✔` 且 exit 0；分步跑时各步符合注释预期。夹具含义见各文件 `$comment`。
+通过标准：regression.js 输出 `A✔ B✔ … I✔` 且 exit 0；分步跑时各步符合注释预期。夹具含义见各文件 `$comment`。
 
 ## 配套工具（作者/维护侧）