@qilitt-mickey/vue3-temp-skill 1.1.46 → 1.1.48

package/mapping/component/overlay.json

@@ -58,6 +58,22 @@
         "hover_color": "--el-pagination-hover-color"
       },
       "custom_style_map": {}
+    },
+    "component.tooltip.base": {
+      "type": "global_component",
+      "component": "ElTooltip（原生）/ v-tippy（指令）",
+      "style_scope": ":root",
+      "css_vars": {
+        "bg_color": "--el-tooltip-bg-color",
+        "text_color": "--el-tooltip-color"
+      },
+      "custom_style_map": {
+        "radius": "border-radius",
+        "padding": "padding",
+        "font_size": "font-size",
+        "max_width": "max-width"
+      },
+      "$note": "全局提示气泡。项目内提示有**两条来路**——Element Plus 原生 ElTooltip（继承 --el-tooltip-* 令牌，如 ReAvatars 的 el-tooltip）与 v-tippy 指令（ReTableBar / ReCollapsible / ReAnchor / lay-tag 等处使用，走 tippy 主题，**不自动继承 --el-* 令牌**）。本条目面向 ElTooltip；若设计要求覆盖 v-tippy 气泡，须先确认 tippy 主题变量与本节令牌的对应关系，未映射时按「补通道」补主题变量并在交付说明单列申报（**不得假设自动生效**）。本条目为补建通道——此前登记表标 pending。"
     }
   }
 }

package/mapping/scenes/admin/content.json

@@ -74,7 +74,7 @@
     "admin.content.table.operation_bar": {
       "type": "element",
       "selector": ".vts-action-bar",
-      "file": "出厂 src/components/ReTableBar/src/bar.vue 的工具栏行（标题/按钮/工具三件套所在行）已挂 .vts-action-bar；右侧工具三件套源码实证：刷新 svg-icon + el-dropdown 密度（宽松/默认/紧凑）+ el-popover 列设置（bar.vue 内层行）",
+      "file": "条件通道：ReTableBar 内部工具栏行（标题/按钮/工具三件套所在行）是本条目的唯一合法挂载点；该行出厂**无语义类**，selector 命中前须按 structure_ops 给该行补挂 .vts-action-bar（属补通道，交付说明单列申报）。禁止挂到 ReTableBar 根节点（见 preconditions）。右侧工具三件套源码实证：刷新 svg-icon + el-dropdown 密度（宽松/默认/紧凑）+ el-popover 列设置",
       "style_scope": ".vts-page-card",
       "forms": {
         "with_tools": "工具三件套（刷新/密度/列设置）齐全——设计规范 list-page §4 要求三件套缺一不可（ReTableBar 出厂已具备，此为默认形态）",
@@ -120,8 +120,10 @@
       "css_vars": {
         "link_color": "--el-color-primary",
         "danger_color": "--el-color-danger",
-        "divider_color": "--vts-border-color"
+        "divider_color": "--re-op-divider-color",
+        "divider_gap": "--re-op-divider-gap"
       },
+      "$note": "操作列分割线为**条件通道**：出厂组件当前**没有**分割线元素——声明 divider_color / divider_gap 时，必须先按 structure_ops 在 ReTableOperate 模板按钮间 add_node `<span class=\"re-table-operate__divider\">`（中性元素，几何与颜色全走令牌：width/height/gap/color 分别挂 --re-op-divider-width/height/gap/color，出厂缺省 0 不可见），并同步给 resolveOperateColumnWidth 公式补分割线占位（(limit-1)×(width+2×gap)），否则最后按钮被裁——元素与公式缺一即申报补通道失败。列宽由组件公式推算，业务页禁止写死 width——列宽属业务层，设计侧不声明列宽（操作列除外）。",
       "custom_style_map": {
         "align": "text-align",
         "min_width": "min-width",
@@ -181,6 +183,7 @@
       ],
       "preconditions": [
         "Element Plus 表头是「宿主 th.el-table__cell + 内层 .cell 文本盒」两层结构；EP 出厂给内层 .cell 写了 white-space: normal，因此 nowrap / text-overflow 这类文本控制必须落在 inner 层，写在宿主 th 上会被内层覆盖（这是「表头竖排换行」的根因）。高度 / padding / 背景落在 host 层。",
+        "几何语境随值迁移：EP 内层 .cell 出厂自带 padding 0 12px，设计的 16px 落到 host 后必须同步把内层 .cell 的 padding 归零，否则实际内边距 16+12=28px/侧 → 列宽被挤、表头标题被省略号截断（类…/包…/操…），视觉不适配常规。数据单元格（td）同理。",
         "表头单元格可能被业务页用 :header-cell-style 注入行内样式，行内样式优先级高于一切类规则；使用本条目时须确认页面未在列上写死行内表头样式，若有则在页面侧移除、改由本条目承载。"
       ],
       "priority": {
@@ -305,6 +308,62 @@
       },
       "$note": "设计意图（§11.108-11.109）：列宽 72px 居中，缩略盒 40×40 圆角 6px。落地手段：列 className=col-thumb + el-image 40×40"
     },
+    "admin.content.table.selection_column": {
+      "type": "element",
+      "selector": ".vts-table-area .el-table__cell.el-table-column--selection",
+      "file": "业务 views（el-table-column type=\"selection\"；Element Plus 给选择列表头与单元格自动加 el-table-column--selection 类，无需业务自定义类名）",
+      "style_scope": ".vts-page-card",
+      "css_vars": {
+        "checked_bg": "--el-checkbox-checked-bg-color",
+        "checked_border": "--el-checkbox-checked-input-border-color",
+        "hover_border": "--el-checkbox-input-border-color-hover"
+      },
+      "custom_style_map": {
+        "text_align": "text-align",
+        "padding": "padding"
+      },
+      "anchors": [
+        { "kind": "class", "layer": "host", "target": ".vts-table-area .el-table__cell.el-table-column--selection" },
+        { "kind": "class", "layer": "inner", "target": ".vts-table-area .el-table__cell.el-table-column--selection > .cell" },
+        { "kind": "css_var", "target": "--el-checkbox-checked-bg-color" }
+      ],
+      "preconditions": [
+        "选择列由 el-table-column type=\"selection\" 渲染，Element Plus 自动在表头与单元格上加 el-table-column--selection 类——列未声明 type=selection 时本条目永不命中（项目源码实证：views/table/base/index.vue 已用 <el-table-column type=\"selection\" reserve-selection />）。",
+        "列宽与其他业务列同属**业务层**（设计侧不声明列宽）；本条目只承载对齐与勾选态配色。"
+      ],
+      "priority": {
+        "strategy": "scope_qualified",
+        "reason": "选择列无行内样式竞争，作用域限定到 .vts-page-card 即可覆盖。"
+      },
+      "$note": "设计意图（list-page §11.44 选择列）：窄列、居中、勾选态用主题主色。本条目为**补建通道**——此前登记表标 pending（项目侧无承载点位），选择列样式无处可落；勾选色走 EP 原生 --el-checkbox-* 令牌，随主题切换。"
+    },
+    "admin.content.table.row_density": {
+      "type": "element",
+      "selector": ".vts-table-area .el-table .el-table__cell",
+      "file": "src/components/ReTableBar/src/bar.vue（密度下拉：宽松/默认/紧凑 → el-table size = large/default/small）+ src/styles/element-plus.scss（单元格 padding 承载行高）",
+      "style_scope": ".vts-page-card",
+      "forms": {
+        "density": ["loose", "default", "compact"]
+      },
+      "css_vars": {},
+      "custom_style_map": {
+        "row_height": "min-height",
+        "cell_padding_y": "padding-block"
+      },
+      "anchors": [
+        { "kind": "class", "layer": "host", "target": ".vts-table-area .el-table .el-table__cell" },
+        { "kind": "class", "layer": "inner", "target": ".vts-table-area .el-table .el-table__cell > .cell" }
+      ],
+      "preconditions": [
+        "行高由「单元格 padding + 内容行高」共同决定（见 admin.content.table.cell）——声明行高档位时必须同时给出 padding 取值，只改其一会得到非预期行高。",
+        "出厂密度档位由 ReTableBar 的 size（large/default/small，源码实证 bar.vue 的宽松/默认/紧凑三项）驱动；设计侧只声明档位意图（form.density），具体 padding 由本项目按常规取值落定，不得照抄效果图某实例数据的行高。"
+      ],
+      "priority": {
+        "strategy": "scope_qualified",
+        "reason": "单元格 padding 属全局样式，作用域限定到 .vts-page-card 即可覆盖。"
+      },
+      "$note": "设计意图（list-page §11.40 行密度）：表格行高三档取一（宽松/默认/紧凑）。本条目为**补建通道**——此前登记表标 pending；语义档位 loose/default/compact ↔ 出厂 size large/default/small，项目侧负责映射。"
+    },
     "admin.content.table.area": {
       "type": "component",
       "component": "ElTable（useTableSearch tableHeight 定高）",

package/mapping/scenes/admin/layout.json

@@ -139,8 +139,12 @@
         "bg": "background-color",
         "box_shadow": "box-shadow",
         "gap": "gap",
-        "border_color": "border-color"
-      }
+        "border_color": "border-color",
+        "align_items": "align-items"
+      },
+      "preconditions": [
+        "顶栏内容垂直居中：--header-height 变更（如 54px）后，宿主 .navbar 必须显式 align-items: center——出厂顶栏内元素高度不一（折叠钮 40px / 文字行 / 头像），不显式声明会整体偏上（历史缺口：折叠按钮不垂直居中）。"
+      ]
     },
     "admin.layout.header.logo_area": {
       "type": "element",

package/package.json

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

package/parser/index.js

@@ -84,7 +84,7 @@ function main() {
     case "audit":
       return cmdAudit(args, dataset);
     case "verify":
-      return cmdVerify(args);
+      return cmdVerify(args, dataset);
     case "registry":
       return cmdRegistry(args, dataset);
     default:
@@ -103,7 +103,11 @@ function printHelp() {
   node parser/index.js match --batch <dir>                项目级批量匹配：目录下全部变更集 + 跨文件汇总
   node parser/index.js audit --project <dir> [<cs.json…>] 挂载点存在性 + 死通道静态审计（需目标项目源码）
   node parser/index.js verify --oracle <o.json> --actual <a.json> [--sids a,b]
-                                                          渲染态逐点验收：computed style 期望 vs 实测 diff（）
+                                                          渲染态逐点验收：computed style 期望 vs 实测 diff
+  node parser/index.js verify --oracle <o.json> --resolve [--sids a,b]
+                                                          实测端定位计划：sid → 词典 selector（项目页不打 data-sid 时按此抽取）
+  node parser/index.js verify … --from-theme 钴蓝 --to-theme 橘橙
+                                                          同构异色复用：按语义槽位把效果图色值归一为本主题色值再比（配合 oracle.theme_mapping）
   node parser/index.js registry <registry.json> [--verbose]
                                                           登记表通道核验：登记项 sid 是否在词典、dims 是否有落点（）
   node parser/index.js list [--scene admin] [--verbose]   列出全部语义 ID（--verbose 含字段与形态，供下发词汇约束）
@@ -675,8 +679,21 @@ function checkOracle(changeset, plan, valueDict) {
   };
   const declaredTheme = themeFromValue(changeset.global && changeset.global.brand_primary);
   const mockupTheme = [...themes].find(t => mockup.includes(t)) || null;
-  if (declaredTheme && mockupTheme && declaredTheme !== mockupTheme) {
-    issues.push(`主题错配：效果图是「${mockupTheme}」、本变更集主色是「${declaredTheme}」—— 跨主题复用效果图会让 verify 逐点比对必然全红，请换成本主题自己的效果图。`);
+
+  // 同构异色复用：设计侧在 oracle 声明 theme_mapping { "from": "钴蓝", "to": "橘橙" } =
+  // 明确本变更集与效果图同场景 / 同页面 / 同角色集合，仅主题色板不同（语义槽位 -1..-10 一一对应）。
+  // 此时沿用 from 主题效果图是合法基线：verify 用 --from-theme/--to-theme 把色值归一到语义槽位再比，
+  // 几何 / 结构 / 字号等非色属性逐点照比 —— 不允许「只换个颜色就闭环不了」。
+  const tm = oracle.theme_mapping && typeof oracle.theme_mapping === "object" ? oracle.theme_mapping : null;
+  const declaredReuse = !!(tm && tm.from && tm.to
+    && themes.has(tm.from) && themes.has(tm.to)
+    && declaredTheme === tm.to && mockupTheme === tm.from);
+
+  if (declaredReuse) {
+    console.log(`  ↺ 同构异色复用已声明：效果图「${tm.from}」→ 本主题「${tm.to}」（oracle.theme_mapping）。verify 需带 --from-theme ${tm.from} --to-theme ${tm.to} 做色值归一后比对。`);
+  }
+  else if (declaredTheme && mockupTheme && declaredTheme !== mockupTheme) {
+    issues.push(`主题错配：效果图是「${mockupTheme}」、本变更集主色是「${declaredTheme}」。同构异色（只换主题色板、场景/页面/角色集合不变）时，由设计侧在 oracle 声明 theme_mapping: { "from": "${mockupTheme}", "to": "${declaredTheme}" } 即可复用该效果图闭环；若结构 / 形态也变了，则必须换本主题自己的效果图。`);
   }
   if (!mockupTheme && mockup)
     issues.push(`效果图文件名不含任何已知主题词（${[...themes].join("/")}），无法确认主题一致性 —— 请核对是否复用了其它主题的效果图。`);
@@ -684,8 +701,14 @@ function checkOracle(changeset, plan, valueDict) {
   // ② 覆盖度（双向）
   const declaredIds = plan.map(p => p.id);
   const sidSet = new Set(sids);
+  // 仅 visible:false 的隐藏点位在效果图上没有可见元素可标 data-sid —— 豁免「无基线」判定
+  const hiddenOnly = new Set(
+    plan.filter(p => p.change && p.change.visible === false).map(p => p.id),
+  );
   const sidNotDeclared = sids.filter(s => !declaredIds.includes(s));
-  const declaredWithoutSid = declaredIds.filter(id => !sidSet.has(id));
+  const declaredWithoutSid = declaredIds.filter(id => !sidSet.has(id) && !hiddenOnly.has(id));
+  if (hiddenOnly.size > 0)
+    console.log(`  ℹ 隐藏点位（仅 visible:false）${hiddenOnly.size} 处豁免 sid 标注：${[...hiddenOnly].join("、")}`);
   if (sidNotDeclared.length > 0)
     issues.push(`欠声明 ${sidNotDeclared.length} 处：效果图里有、changes[] 未声明 → 该点位永远不可能被还原。\n      ${sidNotDeclared.join("、")}`);
   if (declaredWithoutSid.length > 0)
@@ -823,7 +846,29 @@ function checkRegistryCoverage(changeset, plan, opts = {}) {
   }
   if (changeset.global && Object.keys(changeset.global).length > 0)
     declared.add(GLOBAL_PSEUDO_ID);
-  const mockupSids = new Set(Array.isArray(changeset.oracle?.sids) ? changeset.oracle.sids : []);
+  const declaredSids = new Set(Array.isArray(changeset.oracle?.sids) ? changeset.oracle.sids : []);
+
+  // 实物闭合：打开 oracle.mockup 这个 HTML，数真实存在的 data-sid（不只看设计侧自报的 oracle.sids）
+  const mockupRef = changeset.oracle?.mockup;
+  let physicalSids = null;
+  let mockupFile = null;
+  if (typeof mockupRef === "string" && mockupRef.trim()) {
+    const cands = [path.resolve(mockupRef), path.resolve(ROOT, mockupRef), path.resolve(process.cwd(), mockupRef)];
+    for (const c of cands) {
+      try {
+        const html = readFileSync(c, "utf-8");
+        // 先剥离 HTML 注释再数 data-sid：注释内的同形串是说明文字、不是点位。
+        // 不剥离 → 注释可「兜住」一个实际缺失的标注，闸门全绿而基线为空（详见 mockup-extraction-spec.md §7.1）。
+        const stripped = html.replace(/<!--[\s\S]*?-->/g, "");
+        physicalSids = new Set([...stripped.matchAll(/data-sid\s*=\s*["']([^"']+)["']/g)].map(m => m[1]));
+        mockupFile = c;
+        break;
+      }
+      catch { /* 该候选路径不可读，试下一个 */ }
+    }
+  }
+  // 比对基准：优先效果图实物；实物读不到时退化为自报清单（并在下方告警）
+  const mockupSids = physicalSids || declaredSids;
 
   const applicable = items.filter(it => it.always === true || registrySids(it).some(s => mockupSids.has(s)));
   const gaps = applicable.filter(it => !registrySids(it).every(s => declared.has(s)));
@@ -832,6 +877,23 @@ function checkRegistryCoverage(changeset, plan, opts = {}) {
   console.log(`  登记表：${registryPath}（登记项 R=${items.length}）`);
   console.log(`  适用 A=${applicable.length} / 已兑现 C=${applicable.length - gaps.length} / 缺口 ${gaps.length}`);
 
+  // 实物校验：标注缺口的权威来源是效果图 HTML 里的 data-sid，而不是自报的 oracle.sids
+  let physicalGap = false;
+  if (physicalSids) {
+    console.log(`  效果图实物：${mockupFile}（实测 data-sid ${physicalSids.size} 个）`);
+    const declaredNoPhysical = [...declaredSids].filter(s => !physicalSids.has(s));
+    const physicalNoDeclared = [...physicalSids].filter(s => !declaredSids.has(s));
+    if (declaredNoPhysical.length > 0) {
+      console.log(`  ⚠ oracle.sids 声明了 ${declaredNoPhysical.length} 个点位，但效果图实物里没有对应 data-sid（无基线）：${declaredNoPhysical.join("、")}`);
+      physicalGap = true;
+    }
+    if (physicalNoDeclared.length > 0)
+      console.log(`  ℹ 效果图实物另有 ${physicalNoDeclared.length} 个 data-sid 未列入 oracle.sids（自报清单不全，不阻塞）：${physicalNoDeclared.join("、")}`);
+  }
+  else {
+    console.log(`  ⚠ 未能打开效果图实物（oracle.mockup 不可读）→ 本轮退化为按自报 oracle.sids 校验，实物闭合未生效`);
+  }
+
   // 效果图标注完整性：恒存在的子项必须能在效果图上找到同名 data-sid，否则基线根本抽不出来
   const unannotated = items.filter(it => it.always === true && !registrySids(it).some(s => mockupSids.has(s)));
   if (unannotated.length > 0) {
@@ -842,13 +904,20 @@ function checkRegistryCoverage(changeset, plan, opts = {}) {
     }
     console.log(`  ⚠ 效果图标注缺口 ${unannotated.length} 条：这些子项恒存在，却无同名 data-sid → 基线抽取不全`);
     console.log(`     涉及点位：${[...bySid.entries()].map(([s, n]) => `${s}(${n})`).join("、")}`);
+    physicalGap = true;
   }
 
-  if (gaps.length === 0) {
-    console.log(`  ✔ 覆盖率通过：C = A，无子项被静默丢失`);
+  if (gaps.length === 0 && !physicalGap) {
+    console.log(`  ✔ 覆盖率通过：C = A，无子项被静默丢失；效果图实物标注闭合`);
     return 0;
   }
 
+  if (gaps.length === 0 && physicalGap) {
+    console.log(`\n✘ 效果图实物标注不闭合 → exit 1（oracle.sids 与效果图 HTML 的 data-sid 不一致 / 恒存在子项缺标注）`);
+    console.log(`  处置：给效果图对应元素补 data-sid，或把该登记项降级 source: spec（见 mockup-extraction-spec.md §7）`);
+    return 1;
+  }
+
   const byGroup = new Map();
   for (const it of gaps) {
     const g = it.group || "（未分组）";
@@ -1275,9 +1344,10 @@ function cmdAudit(args, dataset) {
  * 本命令不做抽取，只做归一化 + 逐点 diff + 三类归因。
  *
  * CLI：node parser/index.js verify --oracle <oracle.json> --actual <actual.json> [--sids a,b,c]
+ *      实测端定位计划：node parser/index.js verify --oracle <oracle.json> --resolve [--sids a,b,c]
  * 退出码：存在缺口 → 1；全部命中 → 0。
  */
-function cmdVerify(args) {
+function cmdVerify(args, dataset) {
   // 几何 / 盒模型属性：值对不上 = 语境错位（宿主盒 / 内层盒模型 / 层叠上下文不同）
   const GEOMETRY_PROPS = new Set([
     "display", "position", "top", "right", "bottom", "left", "box-sizing",
@@ -1301,8 +1371,10 @@ function cmdVerify(args) {
   };
   const oraclePath = get("--oracle");
   const actualPath = get("--actual");
-  if (!oraclePath || !actualPath) {
+  const resolveOnly = args.includes("--resolve");
+  if (!oraclePath || (!resolveOnly && !actualPath)) {
     console.error("✖ 缺少参数：node parser/index.js verify --oracle <oracle.json> --actual <actual.json> [--sids a,b,c]");
+    console.error("    或输出实测端定位计划：node parser/index.js verify --oracle <oracle.json> --resolve [--sids a,b,c]");
     process.exit(1);
   }
   const sidsArg = get("--sids");
@@ -1335,12 +1407,53 @@ function cmdVerify(args) {
   };
 
   const oracle = readDump(oraclePath, "效果图期望");
-  const actual = readDump(actualPath, "项目实测");
 
   let sids = Object.keys(oracle);
   if (sidFilter)
     sids = sids.filter(s => sidFilter.has(s));
 
+  // 实测端定位闭合：--resolve 输出「sid → 词典 selector」抽取计划。
+  // 效果图端用 data-sid（设计侧自控）；项目页端不要求打 data-sid —— 浏览器按本计划的 selector 抽取。
+  if (resolveOnly) {
+    const index = buildMergedIndex(dataset || {});
+    console.log(`\n=== 实测端定位计划（sid → 词典 selector）===`);
+    console.log(`用途：项目页不要求打 data-sid —— 浏览器抽取脚本按下列 selector 定位元素取 computed style 生成 actual.json`);
+    console.log(`selector 挂载点存在性由 audit 静态校验；本计划只回答「按什么定位」。\n`);
+    let missing = 0;
+    for (const sid of sids) {
+      const entry = index[sid];
+      if (!entry) {
+        console.log(`  ✘ ${sid} —— 词典无此条目（L3 新点位，先落地并回写临时映射）`);
+        missing++;
+        continue;
+      }
+      const sels = [];
+      if (Array.isArray(entry.anchors)) {
+        for (const a of entry.anchors) {
+          if (a && a.kind === "class" && a.target)
+            sels.push(`[${a.layer || "host"}] ${a.target}`);
+        }
+      }
+      if (sels.length === 0 && entry.selector)
+        sels.push(`[host] ${entry.selector}`);
+      if (sels.length === 0) {
+        console.log(`  ✘ ${sid} —— 词典条目无 selector / anchors，无法定位`);
+        missing++;
+        continue;
+      }
+      console.log(`  · ${sid}`);
+      for (const s of sels)
+        console.log(`      ${s}`);
+    }
+    console.log(`\n汇总：${sids.length} 点位，${missing} 个无法定位`);
+    console.log(`抽取属性白名单两端必须一致（padding / font-size / font-weight / text-align / color / background-color / border-radius / gap 等，见 mockup-extraction-spec §3）；同构异色复用再加 --from-theme/--to-theme 做色值归一。`);
+    if (missing > 0)
+      process.exitCode = 1;
+    return;
+  }
+
+  const actual = readDump(actualPath, "项目实测");
+
   const normProp = p => String(p).trim().toLowerCase().replace(/_/g, "-");
   const normValue = v => {
     let s = String(v == null ? "" : v).trim().toLowerCase().replace(/\s+/g, " ");
@@ -1350,6 +1463,41 @@ function cmdVerify(args) {
     return s;
   };
 
+  // 同构异色主题归一：--from-theme 钴蓝 --to-theme 橘橙 时，把效果图的主题色族色值
+  // 按语义译表的槽位（-1..-10）映射为本主题同槽位色值再比对；译表之外的值原样保留。
+  const fromTheme = get("--from-theme");
+  const toTheme = get("--to-theme");
+  let themeAlias = null;
+  if (fromTheme && toTheme) {
+    try {
+      const sv = JSON.parse(readFileSync(path.join(ROOT, "mapping", "basic", "semantic-values.json"), "utf-8"));
+      const slotOf = {};
+      const hexOf = {};
+      for (const t of Object.values(sv.themes || {})) {
+        for (const [name, hex] of Object.entries(t.values || {})) {
+          const m = /^(.+?)-(\d+)$/.exec(name);
+          if (!m)
+            continue;
+          const key = String(hex).toLowerCase();
+          slotOf[`${t.label}|${key}`] = m[2];
+          hexOf[`${t.label}|${m[2]}`] = key;
+        }
+      }
+      themeAlias = (v) => {
+        let s = String(v == null ? "" : v).toLowerCase();
+        s = s.replace(/#([0-9a-f]{3})\b/g, (_, h) => `#${h[0]}${h[0]}${h[1]}${h[1]}${h[2]}${h[2]}`);
+        return s.replace(/#[0-9a-f]{6}/g, (hex) => {
+          const lvl = slotOf[`${fromTheme}|${hex}`];
+          return lvl ? (hexOf[`${toTheme}|${lvl}`] || hex) : hex;
+        });
+      };
+      console.log(`主题归一：效果图「${fromTheme}」→ 本主题「${toTheme}」（按语义槽位映射色值后比对，几何 / 结构照比）`);
+    }
+    catch (e) {
+      console.log(`⚠ 主题译表读取失败（${e.message}）—— 本轮不做主题色归一，色值类属性可能出现假缺口`);
+    }
+  }
+
   console.log(`渲染态验收（computed style 逐点比对）`);
   console.log(`效果图基线：${path.resolve(oraclePath)}`);
   console.log(`项目实测：${path.resolve(actualPath)}`);
@@ -1385,7 +1533,8 @@ function cmdVerify(args) {
         attr.selector_miss++;
         continue;
       }
-      if (normValue(expVal) === normValue(act[prop])) {
+      const expNorm = themeAlias ? themeAlias(expVal) : expVal;
+      if (normValue(expNorm) === normValue(act[prop])) {
         hitProps++;
         continue;
       }

package/references/design-apply.md

@@ -103,11 +103,41 @@ parser match（确定性翻译）→ 施工坐标 → AI 按坐标改代码 →
 
 ## 执行流程（按序，禁止跳步）
 
-### 第 0 步 · 版本与场景检查
+### 第 0 步 · 版本与场景检查 · 对接匹配（适配前置）· 运行时清场
+
+**0.1 版本与场景检查**
 
 - 变更集 `schema` 版本不在支持范围 → 停止，向上游（用户/设计侧）报告版本不匹配，不降级猜测。
 - `scene` 在 `parser list` 场景清单中无对应域 → 报告并列出支持的场景，等待确认。
 
+**0.2 对接匹配（适配前置）——把散落的匹配收拢为一个前置阶段**
+
+在施工前，把「设计意图 ⇄ 模板能力」整体对一遍，输出匹配结论，供**生成前**决策（而不是落地时才发现对不上）。三步判定：
+
+| 级 | 判定 | 依据 |
+|---|---|---|
+| **布局级** | `layout_type` 命中标准枚举？ | 命中 → 切布局模板池（§5.2）；未命中 → 变体派生 / 定制生成骨架（§5.3 / §5.4） |
+| **点位级** | 逐 id 三级匹配 | 一级完整命中 / 二级父级命中 / 三级未命中（§4.1） |
+| **形态级** | `form` 在条目 `forms` 枚举内？`structure_ops` 所需 DOM 钩子是否存在？ | 词典 `forms` / 模板源码 / `audit` |
+
+**输出三类结论，处置全在项目侧**：
+
+| 结论 | 判据 | 处置 |
+|---|---|---|
+| 完全匹配 | L1 ∧ form 在枚举 ∧ 无需结构 | 直接施工 |
+| 可派生 | L2 / 变体布局 / form 可映射 | 派生骨架或继承父级后施工 |
+| 需适配 | L3 / 定制布局 / 缺通道 / 需新 DOM | **先补通道 / 结构增量 / 生成骨架，再生成**；交付说明单列申报 |
+
+> **总原则（红线）：设计为主，项目侧适配。** 设计效果是目标态，模板是待适配的一方。"设计 ↔ 模板对不上"的出口**永远在项目侧**——**不回流设计侧改设计**。只有「设计侧未给值 / 值非法」（**意图缺口**）才回流设计侧。严禁以「模板不支持」为由要求设计改图。
+
+**0.3 运行时主题清场（T 通道先于 D/S/C）**
+
+主色 / 主题走的是**运行时通道**：`setEpThemeColor()` 把 `--el-color-primary` 写成 `documentElement` 的**内联样式**并持久化到 localStorage（读取优先级 = 浏览器持久化 ?? `platform-config.json`）。**内联样式 + 运行时持久化 ⇒ 设计层 CSS 与词典 selector 都赢不了。**
+
+- 落地前先读 localStorage（键 `responsive-layout`）的 `theme` / `epThemeColor`，与本变更集主题**不一致时清 key 或显式重设**；
+- 清场动作与结果写入交付说明（可回溯）；
+- **不清场则颜色类差异全部失真**——归因前必须先确认起点已对齐，否则会把「环境残留」误判成「落地失败」。
+
 ### 第 1 步 · parser 确定性匹配
 
 ```bash
@@ -233,6 +263,7 @@ node parser/index.js registry <restore-registry.json> [--verbose]         # 只
 - 变更集**没给** `layer`、但条目 `preconditions` 指出必须落内层（如 EP 表头 `white-space`）→ 按 `preconditions` 落 inner 层，并在交付说明注明「设计侧未给 layer，按条目前置条件处理」。
 - **内层盒属性族强制校验**：`white-space` / `text-overflow` / `overflow` / `word-break` / `text-align` / `line-height` / `vertical-align` 这组属性**只在内层文本盒生效**——逐字段核对 `layer`；未指认且条目前置条件也没说 → **退回设计侧补声明**，禁止默认落 host（历史缺口：表头「禁止换行」落 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` 时，逐通道执行收口，**收口优先走令牌重映射**（在令牌宿主作用域重声明令牌，零权重战争），令牌不存在才写属性：
 
@@ -315,6 +346,8 @@ html body .sidebar-container {          /* 令牌宿主 = 该令牌被消费的
 
 写入纪律：
 
+- **本文件是产物，不是手改对象（流程红线）**：`design-shell.scss` 的每一行都必须由「变更集 + 词典」经本协议产出——发现缺规则时，正确动作是**补词典字段 / 前置条件 / 登记项**让下一次 design-apply 自动生成，**禁止绕过流程直接手写项目文件**。历史规则已落词典的（侧栏令牌 / suppress / 表头内层 nowrap / 双重内边距归零 / 分割线通道），重生成后会自动带出；仅「补通道」（变量消费者 / form 枚举 / 组件中性默认）允许动出厂源码并单列申报。
+
 - 每条规则带来源标注（`/* <语义 ID> · <变更条目> */`），换设计时整段可替换；
 - 本文件内新增的 CSS 变量必须**定义 + 引用成对出现**（出厂已有消费者也算），避免死通道；
 - 出厂元素需关闭时（存在性收口）也在这里做：令牌置 `transparent` 或 `display:none`，**绝不删出厂代码行**；
@@ -344,6 +377,9 @@ html .navbar .navbar-breadcrumb-wrap {
 
 ### 第 4 步 · L3 新模块处理（分级布局）
 
+- **验收对象闸（角色集合必须齐）**：验收页面的**角色集合**必须覆盖变更集声明的角色。缺角色的，按第 0.2 步「对接匹配 → 需适配」处置——**项目侧补齐该角色的骨架 / 结构**（走 `crud-pages` 样板 + L3 落地并申报），**不是要求设计侧换页面**。不得用出厂 demo 页充数：demo 页**结构上就没有**标题区 / 批量按钮 / 状态 Tag 这些角色 → 这类差异**无论怎么调 CSS 都消不掉**（不是样式问题，是角色集合不匹配）。
+- **列宽口径（业务层 / 设计层边界）**：表格**业务列宽度属业务层**，设计侧不声明、项目侧不按效果图硬套——效果图里的列宽只是其示例数据下的参考值。**唯一例外是操作列**：宽度由组件公式推算（`resolveOperateColumnWidth`，已含分割线占位），业务页禁止写死。**固定列自查（落完后必做，防「符合规范但不合常规」）**：操作列按钮不被裁、不换行、分割线居中可见；状态列标签完整；表头/单元格标题不被省略号截断——任何一项不满足即返工，禁止用「设计值就是对的」搪塞。
+
 - **L3 是施工指令，不是待办**：词典未命中的点位一律当场落地、交付说明申报「补映射」，不留待确认。新模块按「定制布局」三步走：① 基于全局规范生成结构（继承命名/作用域/组件规范）② 原子层字段（色彩/圆角/组件级）从 `basic/` + `component/` 词典借力 ③ 场景专属点位生成后**立即写入 mapping/ 对应场景域**（临时映射），累计复用 ≥3 次建议升级标准（由人工评审）。
 - 生成的新页面必须带构图钩子（`vts-page-card` / `vts-filter-area` / `vts-table-area` 等），保证后续变更集可命中。
 
@@ -378,7 +414,7 @@ html .navbar .navbar-breadcrumb-wrap {
 - [ ] **映射通道活性检查（杂必查）**：样式落地引用的每个 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 冒充结构施工（历史缺口：操作列分割线 `add_node` 声明了但从未施工 → 按钮间竖线一直缺失）
 - [ ] **同权重失效检查（ · 专查「写了不生效」）**：逐条核对设计层新增规则是否真能取胜——① 对手是组件 `<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` 必须与**本次主题、本次页面**一致（禁止复用异主题效果图：主题错配会让逐点比对必然全红）；② `oracle.sids` 与 `changes[]` **双向闭合**：效果图里有、changes[] 未声明 = **欠声明**（该点位永远不可能被还原）；changes[] 已声明、效果图无 sid = **无基线**（落地后无法机器验收）。两类出现即回流设计侧补齐，**不得直接开工**（`parser match` 已自动报出）
+- [ ] **oracle 基线可用性检查**：变更集带 `oracle` 时——① `oracle.mockup` 必须与**本次主题、本次页面**一致；**同构异色复用除外**：变更集声明 `oracle.theme_mapping: { "from": "<效果图主题>", "to": "<本次主题>" }`（同场景 / 同页面 / 同角色集合、仅主题色板不同）时，允许复用 from 主题效果图，verify 必须带 `--from-theme/--to-theme` 做色值归一，**不得因换主题色就判死闭环**；结构 / 形态有差异时禁止复用；② `oracle.sids` 与 `changes[]` **双向闭合**：效果图里有、changes[] 未声明 = **欠声明**（该点位永远不可能被还原）；changes[] 已声明、效果图无 sid = **无基线**——**仅 `visible:false` 的隐藏点位豁免**（效果图上无可见元素可标 `data-sid`，parser 已自动豁免并打印清单）。其余两类出现即回流设计侧补齐，**不得直接开工**（`parser match` 已自动报出）
 - [ ] **dark.scss 暗色同步**：新增视觉规则在 `html.dark` 有对应覆盖
 - [ ] **缺口清单只含意图缺口**：清单每一项都必须是「设计侧未给值 / 值非法」且已注明「回流设计侧补齐」；能力缺口（词典缺 ID / 缺字段枚举 / 缺 form）不得出现在清单里——出现即把可落地项搁置
 - [ ] **台账逐行兑现对账（对账闸门）**：把设计侧交付的提取台账逐行过一遍，每行必须有落地结论——已落地（写明落在哪个文件/选择器）或已入缺口清单（写明缺失字段）。存在「台账有行、落地无结论」的行 = 交付不完整，与红线同级
@@ -393,12 +429,18 @@ html .navbar .navbar-breadcrumb-wrap {
 **链路（抽取由浏览器完成，diff 由 parser 完成）**：
 
 1. **抽取期望值**：在浏览器打开效果图（`oracle.mockup`，元素已带 `data-sid`），对 `oracle.sids` 中每个 sid 取其代表性元素的 computed style，导出为 `{ "<sid>": { "<css属性>": "<值>" } }` → `oracle.json`。
-2. **抽取实测值**：在浏览器打开已落地页面，对同名 `data-sid` 元素做同样抽取 → `actual.json`。
-   > 抽取脚本可用 Playwright / 浏览器控制台执行：`document.querySelectorAll('[data-sid]')` 遍历，读取 `getComputedStyle(el)` 的白名单属性（padding / font-size / font-weight / text-align / color / background-color / border-radius / gap 等）。两个页面的属性白名单必须一致，否则出现假缺口。
+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`。
 
@@ -416,6 +458,10 @@ html .navbar .navbar-breadcrumb-wrap {
 
 ## 词典维护纪律
 
+### 出厂状态漂移（词典假前提 = 事故源，落地前必查）
+
+**项目可能随时被还原到出厂**（design-shell 回空壳、`.changeset/*` 消失、本体系此前补的通道全部消失）。因此词典里凡「出厂已具备 X」类表述必须满足：① X 是**真出厂能力**（对照出厂源码可验证）；② 由本体系补建的通道一律写成**条件式**——「若缺失，按 structure_ops / 补通道流程补建并申报」，不写「已存在」。**落地前必须跑 `node parser/index.js audit --project <dir>`**：锚点/选择器/变量消费者存在性静态校验，会当场暴露词典假前提（曾发生：词典写「出厂已渲染分割线 / 工具栏行已挂语义类」，项目还原后全部失真 → 规则落空）。
+
 - mapping/ 是唯一事实源：施工前 `parser query <id>` 精读条目，**不凭记忆施工**。
 - **禁止编造的是「既有条目的映射」**（改既有 selector / css_vars / 变量指向 = 静默篡改，绝对禁止）。**词典缺 ID / 缺字段枚举不属编造**——那是新点位，按 L3 当场落地并写**新增的**临时映射条目，交付说明申报，等人工评审转正。
 - 「宁可不做，不做错」只适用于**设计侧未给值 / 值非法**的意图缺口；用它搁置能力缺口 = 交付失败。

package/references/cobalt-admin-restore.changeset.json

@@ -1,468 +0,0 @@
-{
-  "schema": "design.changeset/1.0",
-  "changeset_version": "1.0.0",
-  "mapping_version": "1.0.0",
-  "scene": "admin",
-  "layout_type": "vertical",
-  "global": {
-    "brand_primary": "钴蓝-5"
-  },
-  "changes": [
-    {
-      "id": "admin.layout.sidebar",
-      "style": {
-        "width": "208px",
-        "collapsed_width": "64px",
-        "bg": "#001529"
-      }
-    },
-    {
-      "id": "admin.layout.sidebar.logo_area",
-      "style": {
-        "height": "54px",
-        "title_font_size": "16px",
-        "title_font_weight": "中等",
-        "title_color": "#FFFFFF"
-      }
-    },
-    {
-      "id": "admin.layout.sidebar.menu",
-      "form": "pill",
-      "style": {
-        "padding_y": "8px",
-        "item_height": "40px",
-        "font_size": "14px",
-        "font_weight": "常规",
-        "text_color": "rgba(255,255,255,0.65)",
-        "menu_hover_bg": "rgba(255,255,255,0.08)",
-        "menu_active_bg": "钴蓝-5",
-        "menu_active_indicator": "钴蓝-5"
-      },
-      "priority": { "strategy": "deep_qualified" }
-    },
-    {
-      "id": "admin.layout.sidebar.collapse_trigger",
-      "visible": false
-    },
-    {
-      "id": "admin.layout.header",
-      "style": {
-        "height": "54px",
-        "padding_x": "24px",
-        "bg": "#FFFFFF",
-        "border_color": "#F0F0F0"
-      }
-    },
-    {
-      "id": "admin.layout.header.collapse_trigger",
-      "form": "header_inline",
-      "style": {
-        "btn_width": "40px",
-        "btn_height": "40px",
-        "icon_size": "16px",
-        "border_radius": "6px"
-      }
-    },
-    {
-      "id": "admin.layout.header.logo_area",
-      "visible": false
-    },
-    {
-      "id": "admin.layout.header.breadcrumb",
-      "visible": false,
-      "priority": { "strategy": "deep_qualified" }
-    },
-    {
-      "id": "admin.layout.header.lang_switch",
-      "form": "inline_switch",
-      "style": {
-        "gap": "2px",
-        "icon_size": "16px",
-        "text_color": "#000000A6"
-      }
-    },
-    {
-      "id": "admin.layout.header.fullscreen",
-      "style": {
-        "icon_size": "16px",
-        "width": "32px"
-      }
-    },
-    {
-      "id": "admin.layout.header.setting_button",
-      "style": {
-        "icon_size": "16px",
-        "hover_bg": "#FAFAFA",
-        "text_color": "#000000A6"
-      }
-    },
-    {
-      "id": "admin.layout.header.user_profile",
-      "form": "greeting_avatar_name",
-      "style": {
-        "avatar_width": "28px",
-        "avatar_height": "28px",
-        "avatar_radius": "9999px",
-        "name_font_size": "14px",
-        "name_font_weight": "中等",
-        "greeting_font_size": "14px",
-        "gap": "12px",
-        "text_color": "#000000E6",
-        "hover_bg": "#FAFAFA"
-      },
-      "structure_ops": [{ "op": "add_node", "node": "问候区" }]
-    },
-    {
-      "id": "admin.layout.tabs",
-      "form": "flat",
-      "style": {
-        "height": "40px",
-        "bg": "#FFFFFF",
-        "border_bottom": "1px solid #F0F0F0",
-        "padding_inline": "0px"
-      },
-      "priority": { "strategy": "deep_qualified" }
-    },
-    {
-      "id": "admin.layout.tabs.home_tab",
-      "form": "icon_only",
-      "style": {
-        "width": "40px",
-        "height": "40px",
-        "icon_size": "16px",
-        "icon_color": "钴蓝-5"
-      }
-    },
-    {
-      "id": "admin.layout.tabs.item",
-      "form": "text_only",
-      "style": {
-        "card_height": "40px",
-        "padding_x": "12px",
-        "title_gap": "6px",
-        "close_size": "12px",
-        "close_opacity": "0.45",
-        "close_hover_color": "#FF4D4F",
-        "divider_color": "#F0F0F0"
-      },
-      "priority": { "strategy": "deep_qualified" }
-    },
-    {
-      "id": "admin.layout.tabs.item_active",
-      "form": "text_color_only",
-      "style": {
-        "text_color": "钴蓝-5",
-        "font_weight": "中等"
-      }
-    },
-    {
-      "id": "admin.layout.tabs.divider",
-      "style": {
-        "width": "1px",
-        "height": "100%",
-        "bg": "#F0F0F0",
-        "opacity": "1"
-      }
-    },
-    {
-      "id": "admin.layout.tabs.context_menu",
-      "style": {
-        "width": "120px",
-        "border_color": "#F0F0F0",
-        "radius": "6px"
-      }
-    },
-    {
-      "id": "admin.content.container",
-      "form": "fixed"
-    },
-    {
-      "id": "admin.layout.content",
-      "style": {
-        "padding": "24px"
-      }
-    },
-    {
-      "id": "component.card.base",
-      "style": {
-        "bg_color": "#FFFFFF",
-        "radius": "8px",
-        "border_color": "transparent",
-        "box_shadow": "0 2px 8px rgba(0,0,0,0.06)",
-        "padding_x": "0px",
-        "padding_y": "0px"
-      }
-    },
-    {
-      "id": "admin.content.page_header",
-      "style": {
-        "margin_bottom": "1px solid #F0F0F0",
-        "title_size": "20px",
-        "title_weight": "加粗",
-        "desc_size": "14px",
-        "desc_color": "#000000A6",
-        "actions_gap": "8px",
-        "padding_x": "20px",
-        "padding_y": "20px"
-      }
-    },
-    {
-      "id": "admin.content.filter_area",
-      "style": {
-        "radius": "6px",
-        "padding_y": "20px",
-        "padding_x": "20px",
-        "margin_bottom": "1px solid #F0F0F0",
-        "bg": "#FFFFFF",
-        "border_color": "#F0F0F0",
-        "font_size": "14px",
-        "text_color": "#000000E6",
-        "text_align": "右对齐",
-        "icon_size": "16px",
-        "gap": "20px"
-      }
-    },
-    {
-      "id": "admin.content.table.operation_bar",
-      "style": {
-        "gap": "8px",
-        "padding_y": "20px 20px 8px",
-        "btn_height": "32px",
-        "btn_radius": "6px",
-        "btn_font_size": "14px",
-        "font_size": "14px",
-        "font_weight": "常规",
-        "text_color": "#000000E6"
-      }
-    },
-    {
-      "id": "admin.content.table.area",
-      "style": {
-        "radius": "8px",
-        "header_bg": "#FAFAFA",
-        "header_text": "#000000E6",
-        "row_hover_bg": "#FAFAFA",
-        "bg_color": "#FFFFFF"
-      }
-    },
-    {
-      "id": "admin.content.table.header_cell",
-      "layer": { "padding": "host", "text_align": "inner" },
-      "style": {
-        "height": "48px",
-        "padding": "16px",
-        "bg": "#FAFAFA",
-        "font_size": "14px",
-        "font_weight": "中等",
-        "text_color": "#000000E6",
-        "text_align": "左对齐",
-        "border_bottom": "1px solid #F0F0F0",
-        "nowrap": "禁止换行",
-        "gap": "8px",
-        "icon_size": "16px"
-      },
-      "priority": { "strategy": "self_plus_important" }
-    },
-    {
-      "id": "admin.content.table.cell",
-      "layer": "host",
-      "style": {
-        "padding": "16px",
-        "height": "55px",
-        "font_size": "14px",
-        "font_weight": "常规",
-        "text_color": "#000000E6",
-        "border_bottom": "1px solid #F0F0F0",
-        "vertical_align": "居中",
-        "nowrap": "禁止换行"
-      }
-    },
-    {
-      "id": "admin.content.table.cell_status",
-      "form": "filled",
-      "style": {
-        "bg": "#F6FFED",
-        "border_color": "#D9F7BE",
-        "text_color": "#52C41A",
-        "font_size": "12px",
-        "radius": "6px",
-        "icon_size": "16px"
-      },
-      "structure_ops": [{ "op": "render_branch", "node": "状态列" }]
-    },
-    {
-      "id": "admin.content.table.cell_amount",
-      "layer": "inner",
-      "style": {
-        "align": "右对齐"
-      },
-      "structure_ops": [{ "op": "bind_source", "node": "金额列", "source": "列类名" }]
-    },
-    {
-      "id": "admin.content.table.operation_column",
-      "style": {
-        "link_color": "钴蓝-5",
-        "danger_color": "#FF4D4F",
-        "divider_color": "#F0F0F0",
-        "align": "居中",
-        "min_width": "160px",
-        "column_width": "160px",
-        "nowrap": "禁止换行",
-        "bg": "#FFFFFF",
-        "box_shadow": "-2px 0 4px rgba(0,0,0,0.06)",
-        "font_size": "14px",
-        "gap": "8px",
-        "radius": "6px",
-        "vertical_align": "居中"
-      },
-      "structure_ops": [
-        { "op": "render_branch", "node": "操作列图标" },
-        { "op": "add_node", "node": "操作列分隔线" }
-      ]
-    },
-    {
-      "id": "admin.content.pagination",
-      "style": {
-        "font_size": "14px",
-        "text_color": "#000000A6",
-        "gap": "8px",
-        "margin_bottom": "20px",
-        "padding_y": "8px 20px",
-        "active_bg": "钴蓝-5",
-        "active_color": "#FFFFFF",
-        "border_color": "#D9D9D9",
-        "hover_color": "钴蓝-5"
-      }
-    },
-    {
-      "id": "admin.content.empty_state",
-      "style": {
-        "font_size": "14px",
-        "text_color": "#000000A6",
-        "icon_size": "40px",
-        "padding": "40px"
-      }
-    },
-    {
-      "id": "component.button.primary",
-      "style": {
-        "bg_color": "钴蓝-5",
-        "text_color": "#FFFFFF",
-        "border_color": "钴蓝-5",
-        "font_weight": "常规",
-        "padding_x": "15px",
-        "height": "32px",
-        "radius": "6px"
-      }
-    },
-    {
-      "id": "component.button.default",
-      "style": {
-        "bg_color": "#FFFFFF",
-        "text_color": "#000000E6",
-        "border_color": "#D9D9D9",
-        "font_weight": "常规",
-        "padding_x": "15px",
-        "height": "32px",
-        "radius": "6px"
-      }
-    },
-    {
-      "id": "component.button.danger",
-      "style": {
-        "bg_color": "#FF4D4F",
-        "text_color": "#FFFFFF",
-        "border_color": "#FF4D4F",
-        "font_weight": "常规",
-        "padding_x": "12px",
-        "height": "32px",
-        "radius": "6px"
-      }
-    },
-    {
-      "id": "component.tag.status",
-      "form": "filled",
-      "style": {
-        "bg_color": "#F6FFED",
-        "text_color": "#52C41A",
-        "border_color": "#D9F7BE",
-        "font_size": "12px",
-        "radius": "6px",
-        "icon_size": "16px"
-      }
-    },
-    {
-      "id": "component.input.base",
-      "style": {
-        "bg_color": "#FFFFFF",
-        "text_color": "#000000E6",
-        "border_color": "#D9D9D9",
-        "radius": "6px",
-        "height": "32px",
-        "font_size": "14px",
-        "icon_size": "16px",
-        "padding_x": "12px"
-      }
-    },
-    {
-      "id": "component.pagination.base",
-      "style": {
-        "height": "32px",
-        "gap": "8px",
-        "radius": "6px",
-        "active_bg": "钴蓝-5",
-        "active_color": "#FFFFFF",
-        "border_color": "#D9D9D9",
-        "text_color": "#000000E6",
-        "hover_color": "钴蓝-5",
-        "icon_size": "16px"
-      }
-    }
-  ],
-  "oracle": {
-    "mockup": "project-ui-design/references/page-specs/styles/default/scenes/admin/mockups/list-page/运单管理-钴蓝.html",
-    "sids": [
-      "admin.layout.sidebar",
-      "admin.layout.sidebar.logo_area",
-      "admin.layout.sidebar.menu",
-      "admin.layout.header",
-      "admin.layout.header.collapse_trigger",
-      "admin.layout.header.lang_switch",
-      "admin.layout.header.fullscreen",
-      "admin.layout.header.setting_button",
-      "admin.layout.header.user_profile",
-      "admin.layout.tabs",
-      "admin.layout.tabs.home_tab",
-      "admin.layout.tabs.item",
-      "admin.layout.tabs.item_active",
-      "admin.layout.tabs.divider",
-      "admin.layout.content",
-      "admin.content.container",
-      "component.card.base",
-      "admin.content.page_header",
-      "admin.content.filter_area",
-      "admin.content.table.operation_bar",
-      "admin.content.table.area",
-      "admin.content.table.header_cell",
-      "admin.content.table.cell",
-      "admin.content.table.cell_status",
-      "admin.content.table.cell_amount",
-      "admin.content.table.operation_column",
-      "admin.content.pagination",
-      "component.button.primary",
-      "component.button.default",
-      "component.button.danger",
-      "component.tag.status",
-      "component.input.base",
-      "component.pagination.base"
-    ]
-  },
-  "coverage": {
-    "registry": "project-ui-design/references/page-specs/styles/default/scenes/admin/restore-registry.json",
-    "registrable": 186,
-    "applicable": 186,
-    "covered": 186,
-    "gaps": []
-  },
-  "notes": "钴蓝主题 admin 列表页完整还原变更集（首版，待 verify 验收）。值优先取效果图精确字面量；官方主色走语义值 钴蓝-5。侧栏为深色 #001529（钴蓝主题壳层约定）。cell_thumb 列本页未出现故未声明；sidebar.collapse_trigger / header.logo_area 按出厂中性收口（visible:false）。"
-}