@qilitt-mickey/vue3-temp-skill 1.1.50 → 1.1.51

package/package.json

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

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

@@ -41,7 +41,9 @@
     { "id": "admin.layout.tabs", "form": "chrome", "style": { "bg": "#FFFFFF" } },
     {
       "id": "admin.content.table.header_cell",
-      "style": { "height": "48px", "bg": "#FAFAFA", "font_weight": "中等" }
+      "style": { "height": "48px", "padding": "16px", "bg": "#FAFAFA", "font_weight": "中等", "text_align": "左对齐", "nowrap": "不换行" },
+      "layer": { "height": "host", "padding": "host", "bg": "host", "font_weight": "host", "text_align": "inner", "nowrap": "inner" },
+      "suppress_inner": true
     },
     {
       "id": "admin.content.table.cell",
@@ -54,6 +56,7 @@
       "form": "filled",
       "style": { "bg": "#E8F3FF", "text_color": "钴蓝-5", "radius": "小圆角" }
     },
+    { "id": "component.tag.status", "form": "filled", "style": { "height": "24px", "radius": "小圆角", "bg_color": "#F6FFED" } },
     {
       "id": "admin.content.page_header",
       "style": { "title_size": "20px", "title_weight": "加粗", "desc_color": "钴蓝-3", "actions_gap": "8px" }
@@ -74,7 +77,6 @@
     { "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": "component.button.danger", "style": { "bg_color": "错误色", "border_color": "错误色", "text_color": "#FFFFFF" } },
     { "id": "admin.content.pagination", "style": { "active_bg": "钴蓝-5", "active_color": "#FFFFFF" } }
   ],
@@ -104,10 +106,10 @@
     ]
   },
   "coverage": {
-    "registry": "registry-sample.json",
-    "registrable": 6,
-    "applicable": 4,
-    "covered": 4,
+    "registry": "references/page-specs/styles/default/scenes/admin/restore-registry.json",
+    "registrable": 186,
+    "applicable": 186,
+    "covered": 186,
     "gaps": []
   },
   "pending": [

package/parser/index.js

@@ -395,12 +395,16 @@ function matchOne(file, dataset, batchSummary, opts = {}) {
   // oracle 验收基线（：设计侧给的效果图 + 待比对点位；项目侧落地后跑 verify 逐点 diff）
   // mockup 相对路径解析以「变更集同目录」为第一基准（协议约定 oracle 产物与变更集同目录），
   // 其次 cwd / 技能根（历史行为兼容）。
-  checkOracle(changeset, plan, valueDict, { strict: mode === "restore", filePath: file });
+  // G11 oracle 基线闸：restore 模式下返回值非 0 = 阻断（与 G8 同级）
+  const oracleGaps = checkOracle(changeset, plan, valueDict, { strict: mode === "restore", filePath: file }) || 0;
   checkCoverage(changeset, { strict: mode === "restore" });
   // 登记表覆盖率（子项级细闸）：以登记表为权威、当场重算 A/C，设计侧自报的 coverage 不参与
-  const regGaps = checkRegistryCoverage(changeset, plan, opts);
+  // strict（mode=restore）同时驱动 G9 登记表身份闸与 G10 dims 兑现闸
+  const regGaps = checkRegistryCoverage(changeset, plan, { ...opts, strict: mode === "restore" });
   if (batchSummary)
-    batchSummary.registryGaps += regGaps;
+    batchSummary.registryGaps += regGaps + oracleGaps;
+  else if (regGaps + oracleGaps > 0)
+    process.exitCode = 1;
 
   // 输出转换计划
   console.log(`\n=== 三级匹配结果（scene=${changeset.scene}，${plan.length} 条）===`);
@@ -735,11 +739,12 @@ function priorityRequirement(strategy) {
 function checkOracle(changeset, plan, valueDict, opts = {}) {
   const oracle = changeset.oracle;
   if (!oracle || typeof oracle !== "object") {
-    if (opts.strict)
+    if (opts.strict) {
       console.error(`\n✖ mode=restore 下 oracle 缺失（G8 模式闸要求，见变更集校验段）——基线三件套不完整，先回设计侧补齐。`);
-    else
-      console.log(`\n提示：变更集未提供 oracle 验收基线（场景还原应给）—— 落地后无法做 computed style 逐点比对，还原度不可证明，建议回流设计侧补齐。`);
-    return;
+      return 1; // G11：restore 下基线缺失 = 阻断，不再是提示后继续
+    }
+    console.log(`\n提示：变更集未提供 oracle 验收基线（场景还原应给）—— 落地后无法做 computed style 逐点比对，还原度不可证明，建议回流设计侧补齐。`);
+    return 0;
   }
 
   const sids = Array.isArray(oracle.sids) ? oracle.sids : [];
@@ -819,11 +824,22 @@ function checkOracle(changeset, plan, valueDict, opts = {}) {
 
   if (issues.length === 0) {
     console.log(`  ✔ oracle 校验通过：主题一致、覆盖度双向闭合`);
-    return;
+    return 0;
+  }
+  // G11 oracle 基线硬闸（2026-09-21 机制化）：restore 模式下基线问题从「⚠ 软提示」升格为阻断。
+  //   历史缺口：主题错配 / 欠声明 / 无基线只打 ⚠ 就继续——基线断了仍绿灯交付，
+  //   verify 无从做 1:1 证明，「细节没还原到位」在交付时不可见。
+  if (opts.strict) {
+    console.error(`\n✖ oracle 基线问题（G11 · ${issues.length} 类 → 拒绝执行）：`);
+    for (const it of issues)
+      console.error(`  ✘ ${it}`);
+    console.error(`  处置：按上列各条回设计侧补齐基线（换本主题效果图 / 补 sids 声明 / 声明 theme_mapping 同构异色复用）后重跑。`);
+    return 1;
   }
   console.log(`\n⚠ oracle 基线问题（${issues.length} 类）：`);
   for (const it of issues)
     console.log(`  ✘ ${it}`);
+  return 0;
 }
 
 /**
@@ -867,7 +883,7 @@ function checkCoverage(changeset, opts = {}) {
     console.log(`  ✘ ${it}`);
 }
 
-/** 依次尝试候选路径，返回首个存在者（相对路径基准：变更集所在目录 → 当前工作目录 → 技能仓库根） */
+/** 依次尝试候选路径，返回首个存在者（相对路径基准：变更集所在目录 → 当前工作目录 → 技能仓库根 → 兄弟设计技能 project-ui-design 根） */
 function resolveFirstExisting(raw, filePath) {
   if (!raw || typeof raw !== "string")
     return null;
@@ -877,6 +893,10 @@ function resolveFirstExisting(raw, filePath) {
   if (filePath)
     bases.push(path.dirname(filePath));
   bases.push(process.cwd(), ROOT);
+  // 兄弟技能根：真实设计侧登记表/效果图沉淀在 project-ui-design（设计侧 page-specs），
+  // 跨库引用时允许相对该根解析（两侧技能目录同级部署是标准布局）。
+  const sibling = path.resolve(ROOT, "..", "project-ui-design");
+  bases.push(sibling);
   for (const base of bases) {
     const candidate = path.resolve(base, raw);
     if (existsSync(candidate))
@@ -919,6 +939,12 @@ function checkRegistryCoverage(changeset, plan, opts = {}) {
       console.error(`\n✖ 登记表文件不存在：${opts.registryArg}`);
       return 1;
     }
+    if (opts.strict) {
+      // G9 前置缺口：mode=restore 却解析不到登记表实物（G8 只验了字符串非空）
+      console.error(`\n✖ G9 登记表身份闸：mode=restore 但登记表实物不存在（coverage.registry="${raw}" 解析失败）→ 拒绝执行。`);
+      console.error(`  覆盖率分母必须来自「方案 × 场景」的真实登记表，否则壳层/表格细粒度点位从分母消失，欠声明不可数。`);
+      return 1;
+    }
     console.log(`\n提示：未提供登记表（--registry 或 coverage.registry）—— 组级台账只防「整组忘光」，组内子项被静默丢失无法计数，建议场景还原带登记表。`);
     return 0;
   }
@@ -931,6 +957,23 @@ function checkRegistryCoverage(changeset, plan, opts = {}) {
     console.error(`\n✖ 登记表读取/解析失败：${registryPath} —— ${e.message}`);
     return 1;
   }
+
+  // G9 登记表身份闸（2026-09-21 机制化）：restore 模式下，登记表必须属于「本变更集声明的方案 × 场景」，
+  //   且必须是有 items 的真登记表。历史缺口：G8 只验 coverage.registry 是非空字符串——
+  //   拿 6 条的回归夹具 registry-sample.json、甚至别的方案/场景的登记表都能过 G8，
+  //   覆盖率分母（R=186 的壳层+表格子项）被偷换成小表，「面包屑/顶栏图标/表头 nowrap」这类点位
+  //   从分母里消失 → 欠声明不可数 → 细节还原缺口一路绿灯。凡「身份对不上的表」视同没有表。
+  const scheme = typeof changeset.scheme === "string" ? changeset.scheme : "";
+  const scene = typeof changeset.scene === "string" ? changeset.scene : "";
+  const regScheme = typeof registry.design_scheme === "string" ? registry.design_scheme : "";
+  const regScene = typeof registry.scene === "string" ? registry.scene : "";
+  const identityMismatch = (regScheme && scheme && regScheme !== scheme) || (regScene && scene && regScene !== scene);
+  if (opts.strict && (identityMismatch || !regScheme || !regScene)) {
+    console.error(`\n✖ G9 登记表身份闸：登记表 ${path.basename(registryPath)} 属于 scheme="${regScheme || "?"}"/scene="${regScene || "?"}"，与变更集 scheme="${scheme || "?"}"/scene="${scene || "?"}" 不一致（或缺身份字段）→ 拒绝执行。`);
+    console.error(`  处置：coverage.registry 改指「${scheme} × ${scene}」方案的登记表（如设计侧 page-specs/styles/<方案>/scenes/<场景>/restore-registry.json）。`);
+    return 1;
+  }
+
   const items = Array.isArray(registry.items) ? registry.items : [];
   if (items.length === 0) {
     console.error(`\n✖ 登记表不含 items：${registryPath}`);
@@ -972,11 +1015,56 @@ function checkRegistryCoverage(changeset, plan, opts = {}) {
   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)));
+
+  // G10 dims 兑现闸（2026-09-21 机制化）：「兑现」从「ID 出现」升格为「ID 出现 且 dims 维度全部出现」。
+  //   历史缺口：只数 ID——声明了 admin.content.table.header_cell 却漏掉 nowrap / font_weight /
+  //   text_align 等关键维度也算「已兑现」→ 表头竖排（nowrap 丢失）、字重不对（font_weight 丢失）
+  //   这类「点位在、细节丢」的症状一路绿灯。核对口径：dims 中的 form 看 change.form；
+  //   其余维度看 change.style ∪ change.layer 的键；source:none（登记即兑现）、global 伪点位
+  //   （全局通道字段名与登记 dims 不同构）、visible:false 隐藏点位不做 dims 机检。
+  const hiddenIds = new Set((changeset.changes || []).filter(c => c && c.visible === false).map(c => c.id));
+  const missingDimsOf = (it, change) => {
+    const dims = it.dims || [];
+    const styleKeys = new Set([...Object.keys(change.style || {}), ...Object.keys(change.layer || {})]);
+    const missing = [];
+    if (dims.includes("form") && change.form === undefined)
+      missing.push("form");
+    for (const d of dims.filter(d => d !== "form")) {
+      if (!styleKeys.has(d))
+        missing.push(d);
+    }
+    return missing;
+  };
+  const dimsGaps = []; // { item, missing }
+  const gaps = applicable.filter(it => {
+    const sids = registrySids(it);
+    if (!sids.every(s => declared.has(s)))
+      return true; // ID 级欠声明（原有缺口口径）
+    if (it.source === "none")
+      return false;
+    const primary = sids.find(s => s !== GLOBAL_PSEUDO_ID);
+    if (!primary)
+      return false; // global 伪点位条目
+    if (hiddenIds.has(primary))
+      return false; // visible:false 点位 dims 豁免（与 oracle 隐藏点位豁免同口径）
+    const change = (changeset.changes || []).find(c => c.id === primary);
+    if (!change)
+      return false; // 经 pending/visible 兑现且无 style 意图条目 → dims 由台账人工闸承载
+    const missing = missingDimsOf(it, change);
+    if (missing.length === 0)
+      return false;
+    dimsGaps.push({ item: it, missing });
+    return false;
+  });
 
   console.log(`\n=== 登记表覆盖率（子项级细闸 · 当场重算）===`);
   console.log(`  登记表：${registryPath}（登记项 R=${items.length}）`);
-  console.log(`  适用 A=${applicable.length} / 已兑现 C=${applicable.length - gaps.length} / 缺口 ${gaps.length}`);
+  console.log(`  适用 A=${applicable.length} / 已兑现 C=${applicable.length - gaps.length} / 缺口 ${gaps.length}${dimsGaps.length > 0 ? ` / dims 缺口 ${dimsGaps.length}（G10）` : ""}`);
+  if (dimsGaps.length > 0) {
+    console.log(`  ⚠ dims 兑现缺口 ${dimsGaps.length} 条（ID 已声明、dims 维度未给全）：`);
+    for (const { item, missing } of dimsGaps.slice(0, 10))
+      console.log(`      ${item.rule}  ${registrySids(item).join(" + ")}  缺 dims=[${missing.join(",")}]`);
+  }
 
   // 实物校验：标注缺口的权威来源是效果图 HTML 里的 data-sid，而不是自报的 oracle.sids
   let physicalGap = false;
@@ -1008,17 +1096,24 @@ function checkRegistryCoverage(changeset, plan, opts = {}) {
     physicalGap = true;
   }
 
-  if (gaps.length === 0 && !physicalGap) {
-    console.log(`  ✔ 覆盖率通过：C = A，无子项被静默丢失；效果图实物标注闭合`);
+  if (gaps.length === 0 && dimsGaps.length === 0 && !physicalGap) {
+    console.log(`  ✔ 覆盖率通过：C = A，无子项被静默丢失；dims 维度全兑现（G10）；效果图实物标注闭合`);
     return 0;
   }
 
-  if (gaps.length === 0 && physicalGap) {
+  if (gaps.length === 0 && dimsGaps.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;
   }
 
+  if (dimsGaps.length > 0 && opts.strict) {
+    console.log(`\n✘ dims 兑现缺口（G10 · ID 已声明但 dims 维度未给全，共 ${dimsGaps.length} 条 → exit 1）：`);
+    for (const { item, missing } of dimsGaps)
+      console.log(`      ${item.rule}  ${registrySids(item).join(" + ")}  缺 dims=[${missing.join(",")}]`);
+    console.log(`  处置：在对应 changes[] 条目的 style/layer 补齐所缺维度取值（值来源见 source 字段）；「点位在、细节丢」正是样式细节不还原的机制成因。`);
+  }
+
   const byGroup = new Map();
   for (const it of gaps) {
     const g = it.group || "（未分组）";
@@ -1035,7 +1130,8 @@ function checkRegistryCoverage(changeset, plan, opts = {}) {
     if (!opts.verbose && list.length > shown.length)
       console.log(`      …（同组其余 ${list.length - shown.length} 条，加 --verbose 展开）`);
   }
-  return gaps.length;
+  // G10 dims 缺口计入返回值：strict 模式下 =「交付不完整」与欠声明同级
+  return gaps.length + (opts.strict ? dimsGaps.length : 0);
 }
 
 /**