mta-mcp 3.15.1 → 3.15.3

package/dist/index.js

@@ -6403,13 +6403,17 @@ var OUTPUT_GUIDE = {
     "- **token**: AppShadows.xxx token \u540D\uFF0C\u4F18\u5148\u4F7F\u7528\u4EE3\u66FF\u786C\u7F16\u7801 BoxShadow",
     "- **r**: borderRadius \u6570\u503C",
     "- **rp**: [left,top,right,bottom] \u76F8\u5BF9\u7236\u5BB9\u5668\u8FB9\u8DDD",
+    "- **vf**: [x,y,w,h] \u89C6\u89C9\u8FB9\u754C\uFF1B\u5F53\u80CC\u666F\u5C42/\u9634\u5F71\u8D85\u51FA\u7236 Group frame \u65F6\uFF0C\u5BB9\u5668\u5C3A\u5BF8\u548C\u89C6\u89C9\u5E95\u8FB9\u8DDD\u4F18\u5148\u770B vf",
     "- **icon/svg/cs/xs**: \u56FE\u6807\u6807\u8BC6/\u771F\u5B9E SvgPicture.string(...) \u4EE3\u7801/containerSize/contentSize",
+    "- **image/img/bitmapPath/bitmapScales**: \u4F4D\u56FE\u56FE\u5C42\u6807\u8BC6/Image.asset \u4EE3\u7801/\u5EFA\u8BAE\u843D\u76D8\u8DEF\u5F84/1x-3x \u5BFC\u51FA\u8981\u6C42",
     "- **svgMode/svgReason/svgFile**: preserve|tint / \u989C\u8272\u7B56\u7565\u539F\u56E0 / \u5EFA\u8BAE\u843D\u76D8\u6587\u4EF6\u540D",
     "- **text/style/family/textHeight**: \u6587\u672C\u5185\u5BB9/\u5B8C\u6574 TextStyle/\u5B57\u4F53\u65CF/\u884C\u9AD8\u6BD4",
     "- **lh/strut**: strutHeight / \u5B8C\u6574 StrutStyle(...)",
     "- **tag**: {bg,ph,pv,r,text} Tag\u5BB9\u5668\u4FE1\u606F",
     "- **layout**: {dir,gap,main,cross,pad} \u5E03\u5C40\u610F\u56FE",
     "- **ch**: \u5B50\u5143\u7D20\u6570\u7EC4\uFF08\u9012\u5F52\uFF09",
+    "- **designSurface**: {width,height,maxWidth,wideScreenRule} \u8BBE\u8BA1\u753B\u677F\u7EA6\u675F\uFF1B\u79FB\u52A8\u7AEF\u7A84\u753B\u677F\u5728\u5BBD\u5C4F\u5FC5\u987B\u505A\u5C45\u4E2D\u5939\u6301",
+    "- **selectionContext**: compact \u82E5\u53D1\u73B0\u9009\u4E2D\u7684\u662F\u5B50\u56FE\u5C42\uFF0C\u4F1A\u81EA\u52A8\u63D0\u5347\u5230\u6240\u5C5E\u753B\u677F/\u9876\u5C42\u5BB9\u5668\u5E76\u8BB0\u5F55 warning",
     "",
     "### \u4F7F\u7528\u65B9\u5F0F",
     "\u5148\u8BFB\u53D6 restorationContract.blockOrder/bodyCopyLedger/hardRules \u9501\u5B9A\u7ED3\u6784\uFF0C\u518D\u7528 tree \u4E2D\u7684 flutter* \u5B57\u6BB5\u586B\u5145\u6837\u5F0F\u548C\u5E03\u5C40\u7EC6\u8282\u3002",
@@ -6418,7 +6422,10 @@ var OUTPUT_GUIDE = {
     "- \u56FE\u6807\u662F\u5426\u8BEF\u7528\u65E7\u9875\u9762\u8D44\u4EA7\uFF1A\u540C\u540D\u7BAD\u5934/\u56FE\u6807\u9ED8\u8BA4\u4E0D\u53EF\u4FE1\uFF0C\u5148\u6838\u5BF9\u6765\u6E90\u56FE\u5C42",
     "- SVG \u662F\u5426\u8BEF\u52A0 ColorFilter\uFF1A\u4FDD\u7559\u539F\u8272\u7684 SVG \u4E0D\u5F97\u4E8C\u6B21\u67D3\u8272",
     "- \u56FE\u6807\u662F\u5426\u7528\u9519\u5C3A\u5BF8\uFF1A16x16 \u69FD\u4F4D\u4E0D\u7B49\u4E8E 16x16 \u56FE\u5F62\uFF0C\u6309 xs/cs \u5206\u79BB\u5360\u4F4D\u4E0E\u6E32\u67D3",
-    "- Bitmap \u662F\u5426\u8BEF\u5F53 SVG\uFF1ASketch Image \u56FE\u5C42\u5FC5\u987B\u5BFC\u51FA PNG + Image.asset",
+    "- Bitmap \u662F\u5426\u8BEF\u5F53 SVG\uFF1ASketch Image \u56FE\u5C42\u5FC5\u987B\u5BFC\u51FA PNG + Image.asset\uFF0C\u4E14\u8865\u9F50 2.0x/3.0x \u53D8\u4F53",
+    "- \u79FB\u52A8\u7AEF\u7A84\u753B\u677F\uFF08\u5982 390 \u5BBD\uFF09\u5728\u5BBD\u5C4F\u5FC5\u987B\u7528 Center + ConstrainedBox(maxWidth: designSurface.maxWidth) \u5939\u6301\uFF0C\u7981\u6B62\u8BA9 Positioned(left/right) \u76F4\u63A5\u62C9\u4F38\u5230\u5168\u5C4F",
+    "- \u82E5\u8282\u70B9\u540C\u65F6\u7ED9\u51FA f \u4E0E vf\uFF0C\u8BF4\u660E\u80CC\u666F\u5C42/\u9634\u5F71\u8D85\u51FA\u903B\u8F91 frame\uFF1B\u5BB9\u5668\u5C3A\u5BF8\u548C\u5E95\u90E8\u89C6\u89C9\u95F4\u8DDD\u4F18\u5148\u4F7F\u7528 vf",
+    "- \u82E5 selectionContext.autoPromoted=true\uFF0C\u8BF4\u660E\u4E4B\u524D\u9009\u4E2D\u4E86\u5185\u5C42 glyph\uFF1B\u540E\u7EED\u5C40\u90E8\u5BFC\u51FA\u56FE\u6807\u65F6\u5E94\u6539\u7528 cmd=svg \u9009\u4E2D\u5177\u4F53\u56FE\u5C42",
     "- \u9875\u9762\u9AA8\u67B6\u662F\u5426\u88AB\u4E1A\u52A1\u7EC4\u4EF6\u6539\u5199\uFF1A\u6807\u9898\u3001\u9876\u90E8\u5165\u53E3\u3001\u641C\u7D22\u5757\u548C\u5E95\u5BFC\u987A\u5E8F\u5FC5\u987B\u56DE\u770B restorationContract"
   ].join("\n")
 };
@@ -6509,14 +6516,30 @@ async function sketchMeasure(args) {
         scriptPath: tempScriptPath,
         scriptLength: fullScript.length,
         pluginInstall: installStatus,
-        instruction: "\u5C06 loaderScript \u4F20\u5165 mcp_sketch_run_code({ code: loaderScript }) \u6267\u884C\u3002\u8BBE\u8BA1\u7A3F\u8FD8\u539F\u9996\u8F6E\u4F18\u5148\u4F7F\u7528 cmd=compact\uFF1B\u53EA\u6709\u5F53 compact contract \u4E0D\u8DB3\u4EE5\u89E3\u91CA\u5C40\u90E8\u5E03\u5C40\u6216\u6837\u5F0F\u65F6\uFF0C\u518D\u8865\u7528 measure/style\u3002\u82E5\u504F\u5DEE\u96C6\u4E2D\u5728\u5355\u4E2A icon/svg/bitmap\uFF0C\u8BF7\u91CD\u65B0\u9009\u4E2D\u8BE5\u56FE\u5C42\u6267\u884C svg \u6216\u5C40\u90E8\u5BFC\u51FA\uFF0C\u5E76\u590D\u67E5 colorStrategy\u3001viewBox\u3001containerSize/contentSize\uFF0C\u907F\u514D\u590D\u7528\u65E7\u9875\u9762\u8D44\u4EA7\u3002\u8BF7\u5148\u5728 Sketch \u4E2D\u9009\u4E2D\u76EE\u6807\u753B\u677F/\u56FE\u5C42\u3002",
+        instruction: "\u5C06 loaderScript \u4F20\u5165 mcp_sketch_run_code({ code: loaderScript }) \u6267\u884C\u3002\u8BBE\u8BA1\u7A3F\u8FD8\u539F\u9996\u8F6E\u4F18\u5148\u4F7F\u7528 cmd=compact\uFF1B\u53EA\u6709\u5F53 compact contract \u4E0D\u8DB3\u4EE5\u89E3\u91CA\u5C40\u90E8\u5E03\u5C40\u6216\u6837\u5F0F\u65F6\uFF0C\u518D\u8865\u7528 measure/style\u3002\u82E5\u504F\u5DEE\u96C6\u4E2D\u5728\u5355\u4E2A icon/svg/bitmap\uFF0C\u8BF7\u91CD\u65B0\u9009\u4E2D\u8BE5\u56FE\u5C42\u6267\u884C svg \u6216\u5C40\u90E8\u5BFC\u51FA\uFF0C\u5E76\u590D\u67E5 colorStrategy\u3001viewBox\u3001containerSize/contentSize\u3001vf \u4E0E bitmapScales\uFF0C\u907F\u514D\u590D\u7528\u65E7\u9875\u9762\u8D44\u4EA7\u3002\u79FB\u52A8\u7AEF\u7A84\u753B\u677F\u8981\u6309 designSurface.maxWidth \u505A\u5BBD\u5C4F\u5939\u6301\u3002compact \u82E5\u68C0\u6D4B\u5230\u4F60\u9009\u4E2D\u7684\u662F\u5185\u5C42 glyph\uFF0C\u4F1A\u81EA\u52A8\u63D0\u5347\u5230\u6240\u5C5E\u753B\u677F\u5E76\u901A\u8FC7 selectionContext \u56DE\u62A5\u3002\u8BF7\u5148\u5728 Sketch \u4E2D\u9009\u4E2D\u76EE\u6807\u753B\u677F/\u56FE\u5C42\u3002",
         restoreChecklist: [
           "\u5148\u6309 restorationContract \u9501\u5B9A\u9875\u9762\u9AA8\u67B6\uFF0C\u518D\u5904\u7406\u5C40\u90E8\u6837\u5F0F",
           "\u5355\u4E2A\u56FE\u6807\u504F\u5DEE\u4F18\u5148\u5C40\u90E8\u91CD\u5BFC\u51FA\uFF0C\u4E0D\u590D\u7528\u5176\u5B83\u9875\u9762\u65E7\u8D44\u4EA7",
           "preserve \u6A21\u5F0F SVG \u7981\u6B62\u8FFD\u52A0 ColorFilter",
           "16x16 \u69FD\u4F4D\u4E0E 6x8/12x12 \u56FE\u5F62\u8981\u5206\u5F00\u5904\u7406",
-          "Sketch Image \u56FE\u5C42\u5BFC\u51FA PNG\uFF0C\u4E0D\u8981\u4F2A\u88C5\u6210 SVG \u4F7F\u7528"
+          "Sketch Image \u56FE\u5C42\u5BFC\u51FA PNG\uFF0C\u4E0D\u8981\u4F2A\u88C5\u6210 SVG \u4F7F\u7528\uFF0C\u5E76\u8865\u9F50 2.0x/3.0x \u53D8\u4F53",
+          "\u79FB\u52A8\u7AEF\u7A84\u753B\u677F\u5728\u5BBD\u5C4F\u5FC5\u987B\u7528 Center + ConstrainedBox(maxWidth: designSurface.maxWidth) \u5939\u6301\uFF0C\u7981\u6B62\u5168\u5C4F\u62C9\u4F38",
+          "\u82E5\u8282\u70B9\u540C\u65F6\u51FA\u73B0 f \u4E0E vf\uFF0C\u5BB9\u5668\u5C3A\u5BF8\u548C\u5E95\u90E8\u89C6\u89C9\u95F4\u8DDD\u4F18\u5148\u4F7F\u7528 vf\uFF0C\u4E0D\u8981\u53EA\u6284\u903B\u8F91 frame",
+          "\u82E5 compact \u8FD4\u56DE selectionContext.autoPromoted=true\uFF0C\u8BF4\u660E\u4E4B\u524D\u8BEF\u9009\u4E2D\u4E86\u5B50\u56FE\u5C42\uFF0C\u4E0D\u8981\u628A\u5185\u5C42 glyph \u5F53\u6574\u9875\u5408\u540C",
+          "\u4EE3\u7801\u751F\u6210\u540E\u5FC5\u987B\u8C03\u7528 validate_restoration \u6821\u9A8C\u9875\u9762\u9AA8\u67B6\u3001\u8D44\u4EA7\u6765\u6E90\u548C\u771F\u5B9E\u8DEF\u7531"
         ],
+        postRestoreValidator: {
+          skill: "validate_restoration",
+          required: true,
+          checks: ["contract-validator", "asset-source-validator", "route-review-validator"],
+          exampleArgs: {
+            measurePath: "/path/to/sketch-compact-output.json",
+            codeFilePath: "/path/to/generated_page.dart",
+            routeFilePath: "/path/to/app_pages.dart",
+            routeName: "AppRoutes.xxx",
+            projectPath: "/path/to/project"
+          }
+        },
         outputGuide: OUTPUT_GUIDE[cmd] || OUTPUT_GUIDE["measure"],
         loaderScript
       }, null, 2)
@@ -6524,6 +6547,460 @@ async function sketchMeasure(args) {
   };
 }
 
+// src/tools/validateRestoration.ts
+import * as fs20 from "fs";
+import * as path20 from "path";
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseNestedJson(raw) {
+  let candidate = raw.trim();
+  for (let attempt = 0; attempt < 4; attempt += 1) {
+    try {
+      const parsed = JSON.parse(candidate);
+      if (typeof parsed === "string") {
+        candidate = parsed.trim();
+        continue;
+      }
+      if (isRecord2(parsed) && Array.isArray(parsed.content) && parsed.content[0] && isRecord2(parsed.content[0])) {
+        const text = parsed.content[0].text;
+        if (typeof text === "string") {
+          candidate = text.trim();
+          continue;
+        }
+      }
+      return parsed;
+    } catch {
+      if (candidate.startsWith("'") && candidate.endsWith("'") || candidate.startsWith('"') && candidate.endsWith('"')) {
+        candidate = candidate.slice(1, -1);
+      }
+      candidate = candidate.replace(/\\n/g, "\n").replace(/\\"/g, '"').replace(/\\\\/g, "\\");
+    }
+  }
+  return JSON.parse(candidate);
+}
+function loadMeasurePayload(args) {
+  const raw = args.measureContent || (args.measurePath ? fs20.readFileSync(args.measurePath, "utf-8") : "");
+  if (!raw) {
+    throw new Error("validate_restoration \u9700\u8981 measureContent \u6216 measurePath");
+  }
+  const parsed = parseNestedJson(raw);
+  if (!isRecord2(parsed)) {
+    throw new Error("measure payload \u89E3\u6790\u5931\u8D25\uFF0C\u7ED3\u679C\u4E0D\u662F\u5BF9\u8C61");
+  }
+  return parsed;
+}
+function hasAnyPattern(source, patterns) {
+  return patterns.some((pattern) => pattern.test(source));
+}
+function collectAssetContracts(node, bucket = []) {
+  if (!node) {
+    return bucket;
+  }
+  if (typeof node.svgFile === "string") {
+    bucket.push({
+      sketchName: node.iconSketchName || node.n || node.svgFile,
+      fileName: path20.posix.basename(node.svgFile),
+      mode: node.svgMode,
+      sourceType: "vector",
+      containerSize: node.cs,
+      contentSize: node.xs
+    });
+  }
+  if (node.t === "Image") {
+    bucket.push({
+      sketchName: node.n || "Image",
+      fileName: typeof node.bitmapFile === "string" ? path20.posix.basename(node.bitmapFile) : typeof node.bitmapPath === "string" ? path20.posix.basename(node.bitmapPath) : void 0,
+      sourceType: "bitmap",
+      scaleVariants: node.bitmapScales
+    });
+  }
+  for (const child of node.ch || []) {
+    collectAssetContracts(child, bucket);
+  }
+  return bucket;
+}
+function extractCodeAssets(codeContent) {
+  const matches = codeContent.match(/assets\/[A-Za-z0-9_./-]+\.(svg|png|jpg|jpeg|webp)/g);
+  return matches ? [...new Set(matches)] : [];
+}
+function hasCodePropertyLiteral(codeContent, property, value) {
+  const escapedValue = String(value).replace(".", "\\.");
+  return new RegExp(`${property}\\s*:\\s*${escapedValue}(?:\\.0+)?\\b`).test(codeContent);
+}
+function hasResponsiveSurfaceConstraint(codeContent, designWidth) {
+  const escapedWidth = String(designWidth).replace(".", "\\.");
+  const directPatterns = [
+    new RegExp(`maxWidth\\s*:\\s*${escapedWidth}(?:\\.0+)?\\b`),
+    new RegExp(`width\\s*:\\s*${escapedWidth}(?:\\.0+)?\\b`),
+    /ConstrainedBox\s*\(/,
+    /BoxConstraints\s*\([^)]*maxWidth\s*:/,
+    /LayoutBuilder\s*\(/,
+    /MediaQuery\.(sizeOf|of)\(/,
+    /math\.(min|max)\(/,
+    /clamp\(/
+  ];
+  return directPatterns.some((pattern) => pattern.test(codeContent));
+}
+function hasWideStretchRisk(codeContent) {
+  const edgePinnedPositioned = /Positioned\([\s\S]{0,220}left\s*:\s*[-\d.]+[\s\S]{0,220}right\s*:\s*[-\d.]+/.test(codeContent) || /Positioned\([\s\S]{0,220}right\s*:\s*[-\d.]+[\s\S]{0,220}left\s*:\s*[-\d.]+/.test(codeContent);
+  return edgePinnedPositioned || /SizedBox\.expand\s*\(/.test(codeContent) || /double\.infinity/.test(codeContent);
+}
+function collectVisualFrameContracts(node, bucket = []) {
+  if (!node) {
+    return bucket;
+  }
+  if (node.f && node.vf) {
+    const hasVisualDelta = node.f.some((value, index) => value !== node.vf[index]);
+    if (hasVisualDelta) {
+      bucket.push({
+        nodeName: node.n || node.t || "unknown",
+        frame: node.f,
+        visualFrame: node.vf
+      });
+    }
+  }
+  for (const child of node.ch || []) {
+    collectVisualFrameContracts(child, bucket);
+  }
+  return bucket;
+}
+function resolveProjectAssetPath(projectPath, assetPath) {
+  return path20.join(projectPath, assetPath);
+}
+function getBitmapScaleVariantPaths(projectPath, assetPath) {
+  const relativeDir = path20.posix.dirname(assetPath);
+  const fileName = path20.posix.basename(assetPath);
+  return [
+    path20.join(projectPath, relativeDir, "2.0x", fileName),
+    path20.join(projectPath, relativeDir, "3.0x", fileName)
+  ];
+}
+function extractPageClassName(codeContent) {
+  const match = codeContent.match(/class\s+([A-Za-z0-9_]+)\s+extends\s+(StatelessWidget|StatefulWidget)/);
+  return (match == null ? void 0 : match[1]) || null;
+}
+function buildContractValidator(payload, codeContent) {
+  var _a, _b, _c, _d, _e;
+  const findings = [];
+  const blockOrder = ((_a = payload.restorationContract) == null ? void 0 : _a.blockOrder) || [];
+  const navCopyLedger = ((_b = payload.restorationContract) == null ? void 0 : _b.navCopyLedger) || [];
+  const pageTitle = (_c = payload.restorationContract) == null ? void 0 : _c.pageTitle;
+  let requiredBlocks = 0;
+  let matchedBlocks = 0;
+  if (pageTitle) {
+    requiredBlocks += 1;
+    if (codeContent.includes(pageTitle)) {
+      matchedBlocks += 1;
+    } else {
+      findings.push({
+        id: "missing_page_title",
+        severity: "error",
+        message: `\u4EE3\u7801\u4E2D\u672A\u627E\u5230\u8BBE\u8BA1\u6807\u9898\u201C${pageTitle}\u201D`,
+        suggestion: "\u5148\u6309 restorationContract.pageTitle \u5BF9\u9F50\u9875\u9762\u6807\u9898\uFF0C\u518D\u7EE7\u7EED\u4FEE\u5C40\u90E8\u6837\u5F0F\u3002"
+      });
+    }
+  }
+  const needsBackButton = blockOrder.some((block) => /back/i.test(`${block.name || ""} ${block.label || ""}`));
+  if (needsBackButton) {
+    requiredBlocks += 1;
+    if (hasAnyPattern(codeContent, [/Get\.back\b/, /Navigator\.pop\b/, /arrow_back/i, /back_icon\.svg/, /back_button/i])) {
+      matchedBlocks += 1;
+    } else {
+      findings.push({
+        id: "missing_back_button_block",
+        severity: "error",
+        message: "\u8BBE\u8BA1\u7A3F\u5B58\u5728 Back Button\uFF0C\u4F46\u4EE3\u7801\u4E2D\u672A\u68C0\u6D4B\u5230\u8FD4\u56DE\u6309\u94AE\u5B9E\u73B0\u3002",
+        suggestion: "\u8865\u9F50\u8FD4\u56DE\u6309\u94AE\u4EA4\u4E92\u548C\u89C6\u89C9\u5B9E\u73B0\uFF0C\u4E0D\u8981\u53EA\u4FDD\u7559\u6807\u9898\u3002"
+      });
+    }
+  }
+  const needsSupportButton = blockOrder.some((block) => /customer service|support|客服/i.test(`${block.name || ""} ${block.label || ""}`));
+  if (needsSupportButton) {
+    requiredBlocks += 1;
+    if (hasAnyPattern(codeContent, [/customer[_ ]service/i, /support/i, /recipient_customer_service_button/i, /客服/])) {
+      matchedBlocks += 1;
+    } else {
+      findings.push({
+        id: "missing_customer_service_block",
+        severity: "error",
+        message: "\u8BBE\u8BA1\u7A3F\u5B58\u5728 Customer Service Button\uFF0C\u4F46\u4EE3\u7801\u4E2D\u672A\u68C0\u6D4B\u5230\u5BF9\u5E94\u5165\u53E3\u3002",
+        suggestion: "\u8865\u9F50\u5BA2\u670D\u6309\u94AE\uFF0C\u4E0D\u8981\u5728\u751F\u6210\u9636\u6BB5\u76F4\u63A5\u7701\u7565\u53F3\u4E0A\u89D2\u5165\u53E3\u3002"
+      });
+    }
+  }
+  const optionLabels = ["\u652F\u4ED8\u5B9D", "\u5FAE\u4FE1", "\u94F6\u884C\u5361"].filter((label) => navCopyLedger.includes(label));
+  if (optionLabels.length > 0) {
+    requiredBlocks += 1;
+    const missingOptions = optionLabels.filter((label) => !codeContent.includes(label));
+    if (missingOptions.length === 0) {
+      matchedBlocks += 1;
+    } else {
+      findings.push({
+        id: "missing_option_labels",
+        severity: "error",
+        message: `\u4EE3\u7801\u4E2D\u7F3A\u5C11\u8BBE\u8BA1\u7A3F\u9009\u9879\u6587\u6848: ${missingOptions.join(" / ")}`,
+        suggestion: "\u9009\u9879\u5361\u6587\u6848\u9ED8\u8BA4\u4EE5 navCopyLedger \u4E3A\u771F\u503C\uFF0C\u7981\u6B62\u81EA\u884C\u6539\u5199\u6216\u9057\u6F0F\u3002"
+      });
+    }
+  }
+  const needsStatusBar = navCopyLedger.includes("9:41") || hasAnyPattern(JSON.stringify(payload.tree || {}), [/"Signal"/, /"WiFi"/, /"Battery"/]);
+  if (needsStatusBar) {
+    requiredBlocks += 1;
+    if (hasAnyPattern(codeContent, [/9:41/, /Signal/, /WiFi/, /Battery/, /statusBar/i])) {
+      matchedBlocks += 1;
+    } else {
+      findings.push({
+        id: "missing_status_bar_block",
+        severity: "warning",
+        message: "\u8BBE\u8BA1\u7A3F\u9876\u90E8\u72B6\u6001\u680F\u5757\u672A\u843D\u5730\uFF0C\u5F53\u524D\u9875\u9762\u9AA8\u67B6\u4ECD\u7136\u4E0D\u5B8C\u6574\u3002",
+        suggestion: "\u5982\u679C\u76EE\u6807\u662F 1:1 \u8FD8\u539F\uFF0C\u9700\u628A 9:41 / Signal / WiFi / Battery \u8FD9\u7EC4\u9876\u90E8\u5757\u8865\u56DE\u3002"
+      });
+    }
+  }
+  const designWidth = ((_d = payload.designSurface) == null ? void 0 : _d.maxWidth) || ((_e = payload.artboard) == null ? void 0 : _e.w);
+  if (designWidth && designWidth <= 430) {
+    const isClamped = hasResponsiveSurfaceConstraint(codeContent, designWidth);
+    if (hasWideStretchRisk(codeContent) && !isClamped) {
+      findings.push({
+        id: "design_surface_constraint_missing",
+        severity: "error",
+        message: `\u5F53\u524D\u8BBE\u8BA1\u7A3F\u4E3A ${designWidth} \u5BBD\u79FB\u52A8\u7AEF\u753B\u677F\uFF0C\u4F46\u4EE3\u7801\u672A\u68C0\u6D4B\u5230\u5BBD\u5C4F\u5939\u6301\u7EA6\u675F\uFF0C\u5BBD\u7A97\u53E3\u4E0B\u4F1A\u88AB\u76F4\u63A5\u62C9\u4F38\u3002`,
+        suggestion: "\u5916\u5C42\u5148\u7528 Center + ConstrainedBox(maxWidth: designSurface.maxWidth) \u6216\u7B49\u6548\u7EA6\u675F\uFF0C\u518D\u5728\u7EA6\u675F\u5185\u4F7F\u7528 Positioned/Stack\u3002"
+      });
+    }
+  }
+  const visualFrameContracts = collectVisualFrameContracts(payload.tree);
+  for (const contract of visualFrameContracts) {
+    const [, , frameWidth, frameHeight] = contract.frame;
+    const [, , visualWidth, visualHeight] = contract.visualFrame;
+    const widthMismatch = frameWidth !== visualWidth && hasCodePropertyLiteral(codeContent, "width", frameWidth) && !hasCodePropertyLiteral(codeContent, "width", visualWidth);
+    const heightMismatch = frameHeight !== visualHeight && hasCodePropertyLiteral(codeContent, "height", frameHeight) && !hasCodePropertyLiteral(codeContent, "height", visualHeight);
+    if (widthMismatch || heightMismatch) {
+      findings.push({
+        id: "visual_frame_literal_mismatch",
+        severity: "warning",
+        message: `${contract.nodeName} \u7684\u89C6\u89C9\u8FB9\u754C\u662F ${visualWidth}x${visualHeight}\uFF0C\u4F46\u4EE3\u7801\u770B\u8D77\u6765\u4ECD\u5728\u4F7F\u7528\u903B\u8F91 frame ${frameWidth}x${frameHeight}\uFF0C\u5BB9\u6613\u9020\u6210\u5E95\u8FB9\u8DDD\u6216\u9634\u5F71\u89C6\u89C9\u8BEF\u5DEE\u3002`,
+        evidence: [`${contract.nodeName}: frame=${contract.frame.join(",")} visualFrame=${contract.visualFrame.join(",")}`],
+        suggestion: "\u5F53 compact \u540C\u65F6\u7ED9\u51FA f \u4E0E vf \u65F6\uFF0C\u5916\u5C42\u5BB9\u5668\u5C3A\u5BF8\u548C\u7531\u6B64\u63A8\u5BFC\u7684\u5E95\u90E8\u89C6\u89C9\u95F4\u8DDD\u4F18\u5148\u4EE5 vf \u4E3A\u51C6\u3002"
+      });
+    }
+  }
+  return {
+    passed: !findings.some((item) => item.severity === "error"),
+    requiredBlocks,
+    matchedBlocks,
+    findings
+  };
+}
+function buildAssetValidator(payload, codeContent, args) {
+  const findings = [];
+  const assetContracts = collectAssetContracts(payload.tree);
+  const expectedVectorFiles = new Set(
+    assetContracts.filter((item) => item.sourceType === "vector" && item.fileName).map((item) => item.fileName.toLowerCase())
+  );
+  const expectedBitmapCount = assetContracts.filter((item) => item.sourceType === "bitmap").length;
+  const codeAssets = extractCodeAssets(codeContent);
+  const codeVectorAssets = codeAssets.filter((asset) => asset.endsWith(".svg"));
+  const codeBitmapAssets = codeAssets.filter((asset) => /\.(png|jpg|jpeg|webp)$/.test(asset));
+  const unexpectedVectorAssets = codeVectorAssets.filter((asset) => !expectedVectorFiles.has(path20.posix.basename(asset).toLowerCase()));
+  if (unexpectedVectorAssets.length > 0) {
+    findings.push({
+      id: "unexpected_vector_assets",
+      severity: "error",
+      message: "\u4EE3\u7801\u4E2D\u5B58\u5728\u672A\u5728\u5F53\u524D\u8BBE\u8BA1\u7A3F contract \u4E2D\u51FA\u73B0\u7684 SVG \u8D44\u6E90\uFF0C\u7591\u4F3C\u590D\u7528\u4E86\u65E7\u9875\u9762\u8D44\u4EA7\u3002",
+      evidence: unexpectedVectorAssets,
+      suggestion: "\u5BF9\u8FD9\u4E9B\u56FE\u6807\u91CD\u65B0\u4ECE\u5F53\u524D\u753B\u677F\u5C40\u90E8\u5BFC\u51FA\uFF0C\u6216\u5728 validate_restoration \u901A\u8FC7\u524D\u4E0D\u8981\u7EE7\u7EED\u63D0\u4EA4\u9875\u9762\u3002"
+    });
+  }
+  if (expectedBitmapCount > 0 && codeBitmapAssets.length === 0) {
+    findings.push({
+      id: "missing_bitmap_assets",
+      severity: "warning",
+      message: `\u5F53\u524D\u8BBE\u8BA1\u7A3F\u5305\u542B ${expectedBitmapCount} \u4E2A Image \u56FE\u5C42\uFF0C\u4F46\u4EE3\u7801\u91CC\u6CA1\u6709\u4EFB\u4F55\u4F4D\u56FE\u8D44\u6E90\u5F15\u7528\u3002`,
+      suggestion: "\u68C0\u67E5\u662F\u5426\u628A Sketch Image \u56FE\u5C42\u9519\u8BEF\u5F53\u6210 SVG \u6216\u4EE3\u7801\u7ED8\u5236\u4E86\u3002"
+    });
+  }
+  if (codeBitmapAssets.length > 0) {
+    findings.push({
+      id: "bitmap_asset_source_check_required",
+      severity: "info",
+      message: "\u4EE3\u7801\u4E2D\u5B58\u5728\u4F4D\u56FE\u8D44\u6E90\uFF0C\u9700\u4EBA\u5DE5\u786E\u8BA4\u5B83\u4EEC\u6765\u81EA\u5F53\u524D\u753B\u677F\u800C\u4E0D\u662F\u65E7\u9875\u9762\u7F13\u5B58\u8D44\u6E90\u3002",
+      evidence: codeBitmapAssets,
+      suggestion: "\u4F4D\u56FE\u8D44\u6E90\u4F18\u5148\u6309\u5F53\u524D\u753B\u677F\u76F4\u63A5\u5BFC\u51FA\u5230 assets/icons/\uFF0C\u907F\u514D\u7EE7\u7EED\u590D\u7528\u65E7\u9875\u9762 PNG\u3002"
+    });
+  }
+  if (expectedBitmapCount > 0 && codeBitmapAssets.length > 0) {
+    const pageClassName = extractPageClassName(codeContent) || "";
+    const normalizedStem = pageClassName.replace(/Page$/, "").replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
+    if (normalizedStem) {
+      const hasPageLocalBitmap = codeBitmapAssets.some(
+        (asset) => path20.posix.basename(asset).toLowerCase().includes(normalizedStem)
+      );
+      if (!hasPageLocalBitmap) {
+        findings.push({
+          id: "bitmap_assets_not_page_local",
+          severity: "warning",
+          message: "\u5F53\u524D\u9875\u9762\u4F4D\u56FE\u8D44\u6E90\u770B\u8D77\u6765\u4E0D\u662F page-local \u547D\u540D\uFF0C\u5B58\u5728\u7EE7\u7EED\u590D\u7528\u65E7\u9875\u9762 PNG \u7684\u98CE\u9669\u3002",
+          evidence: codeBitmapAssets,
+          suggestion: "\u4F4D\u56FE\u8D44\u6E90\u4F18\u5148\u6309\u5F53\u524D\u9875\u9762\u547D\u540D\u5BFC\u51FA\uFF0C\u4F8B\u5982\u5E26\u4E0A\u9875\u9762 stem\uFF0C\u907F\u514D\u6DF7\u5165\u65E7\u9875\u9762\u901A\u7528 PNG\u3002"
+        });
+      }
+    }
+  }
+  const expectedBitmapScales = new Set(
+    assetContracts.filter((item) => item.sourceType === "bitmap").flatMap((item) => item.scaleVariants || [])
+  );
+  if (expectedBitmapCount > 0 && codeBitmapAssets.length > 0 && args.projectPath) {
+    const requiresRetinaVariants = expectedBitmapScales.size === 0 || expectedBitmapScales.has("2.0x") || expectedBitmapScales.has("3.0x");
+    if (requiresRetinaVariants) {
+      const missingRetinaEvidence = [];
+      for (const asset of codeBitmapAssets) {
+        const assetOnDisk = resolveProjectAssetPath(args.projectPath, asset);
+        if (!fs20.existsSync(assetOnDisk)) {
+          missingRetinaEvidence.push(`${asset} (base missing)`);
+          continue;
+        }
+        const variantPaths = getBitmapScaleVariantPaths(args.projectPath, asset);
+        const missingVariants = variantPaths.filter((variantPath) => !fs20.existsSync(variantPath)).map((variantPath) => path20.relative(args.projectPath, variantPath));
+        if (missingVariants.length > 0) {
+          missingRetinaEvidence.push(`${asset} -> missing ${missingVariants.join(", ")}`);
+        }
+      }
+      if (missingRetinaEvidence.length > 0) {
+        findings.push({
+          id: "bitmap_retina_variants_missing",
+          severity: "error",
+          message: "\u4F4D\u56FE\u8D44\u6E90\u7F3A\u5C11 2.0x/3.0x \u53D8\u4F53\uFF0C\u9AD8\u5206\u5C4F\u4E0B\u5BB9\u6613\u53D1\u7CCA\u3002",
+          evidence: missingRetinaEvidence,
+          suggestion: "\u6309\u5F53\u524D\u753B\u677F\u91CD\u65B0\u5BFC\u51FA PNG\uFF0C\u5E76\u8865\u9F50 assets/.../2.0x \u4E0E 3.0x \u53D8\u4F53\u540E\u518D\u9A8C\u6536\u3002"
+        });
+      }
+    }
+  }
+  const preserveContracts = assetContracts.filter((item) => item.mode === "preserve");
+  if (preserveContracts.length > 0 && /colorFilter\s*:|ColorFilter\./.test(codeContent)) {
+    findings.push({
+      id: "preserve_svg_tint_risk",
+      severity: "warning",
+      message: "\u5F53\u524D\u9875\u9762\u4EE3\u7801\u5305\u542B ColorFilter\uFF0C\u800C contract \u4E2D\u5B58\u5728 preserve \u6A21\u5F0F SVG\uFF0C\u5B58\u5728\u518D\u6B21\u67D3\u8272\u98CE\u9669\u3002",
+      evidence: preserveContracts.map((item) => item.fileName || item.sketchName),
+      suggestion: "\u68C0\u67E5 preserve SVG \u662F\u5426\u88AB\u6574\u4F53 tint\uFF0C\u5FC5\u8981\u65F6\u628A\u56FE\u6807\u6539\u4E3A\u4FDD\u7559\u539F\u8272\u8D44\u6E90\u3002"
+    });
+  }
+  return {
+    passed: !findings.some((item) => item.severity === "error"),
+    expectedAssetContracts: assetContracts,
+    codeAssets,
+    findings
+  };
+}
+function buildRouteReviewValidator(args, codeContent) {
+  const findings = [];
+  const pageClassName = extractPageClassName(codeContent);
+  let routeConnected = null;
+  let routeTarget = null;
+  let reviewHarnessReady = null;
+  if (args.routeFilePath && args.routeName) {
+    const routeContent = fs20.readFileSync(args.routeFilePath, "utf-8");
+    const routeIndex = routeContent.indexOf(`name: ${args.routeName}`);
+    if (routeIndex === -1) {
+      findings.push({
+        id: "route_not_found",
+        severity: "error",
+        message: `\u5728\u8DEF\u7531\u6587\u4EF6\u4E2D\u672A\u627E\u5230 ${args.routeName} \u7684\u5B9A\u4E49\u3002`,
+        suggestion: "\u751F\u6210\u9875\u9762\u540E\u5FC5\u987B\u786E\u8BA4\u771F\u5B9E\u8DEF\u7531\u5DF2\u7ECF\u63A5\u901A\uFF0C\u4E0D\u80FD\u505C\u7559\u5728\u5B64\u7ACB\u9875\u9762\u6587\u4EF6\u3002"
+      });
+    } else {
+      const routeChunk = routeContent.slice(routeIndex, routeIndex + 240);
+      routeConnected = true;
+      if (/_ComingSoonPage/.test(routeChunk)) {
+        routeConnected = false;
+        findings.push({
+          id: "route_points_to_placeholder",
+          severity: "error",
+          message: `${args.routeName} \u5F53\u524D\u4ECD\u7136\u6307\u5411 _ComingSoonPage\uFF0C\u5360\u4F4D\u9875\u672A\u66FF\u6362\u3002`,
+          suggestion: "\u628A page factory \u63A5\u5230\u771F\u5B9E\u9875\u9762\u7C7B\uFF0C\u800C\u4E0D\u662F\u4FDD\u7559\u5360\u4F4D\u5B9E\u73B0\u3002"
+        });
+      }
+      const routeTargetMatch = routeChunk.match(/page:\s*\(\)\s*=>\s*const\s+([A-Za-z0-9_]+)/) || routeChunk.match(/page:\s*\(\)\s*=>\s*([A-Za-z0-9_]+)\(/);
+      routeTarget = (routeTargetMatch == null ? void 0 : routeTargetMatch[1]) || null;
+      if (pageClassName && routeTarget && pageClassName !== routeTarget) {
+        findings.push({
+          id: "route_target_mismatch",
+          severity: "warning",
+          message: `\u8DEF\u7531\u76EE\u6807\u7C7B ${routeTarget} \u4E0E\u9875\u9762\u4E3B\u7C7B ${pageClassName} \u4E0D\u4E00\u81F4\u3002`,
+          suggestion: "\u786E\u8BA4\u8DEF\u7531\u63A5\u7684\u5C31\u662F\u5F53\u524D\u751F\u6210\u9875\u9762\uFF0C\u800C\u4E0D\u662F\u540C\u540D\u65E7\u9875\u9762\u3002"
+        });
+      }
+    }
+  }
+  if (args.projectPath) {
+    const reviewHarnessPath = path20.join(args.projectPath, "test/visual_regression/ui_review_golden_test.dart");
+    reviewHarnessReady = fs20.existsSync(reviewHarnessPath);
+    if (!reviewHarnessReady) {
+      findings.push({
+        id: "ui_review_harness_missing",
+        severity: "warning",
+        message: "\u9879\u76EE\u5185\u672A\u68C0\u6D4B\u5230 UI review golden harness\uFF0C\u751F\u6210\u540E\u65E0\u6CD5\u7ACB\u5373\u505A\u7ED3\u6784\u7EA7\u56DE\u5F52\u3002",
+        suggestion: "\u81F3\u5C11\u8865\u4E0A test/visual_regression/ui_review_golden_test.dart\uFF0C\u518D\u8BA9\u8FD8\u539F\u9875\u8FDB\u5165\u81EA\u52A8 review\u3002"
+      });
+    } else {
+      const reviewContent = fs20.readFileSync(reviewHarnessPath, "utf-8");
+      const pageStem = path20.basename(args.codeFilePath || "", path20.extname(args.codeFilePath || "")).replace(/_page$/, "");
+      if (pageStem && !reviewContent.includes(pageStem)) {
+        findings.push({
+          id: "ui_review_scenario_not_registered",
+          severity: "warning",
+          message: "UI review harness \u5DF2\u5B58\u5728\uFF0C\u4F46\u5F53\u524D\u9875\u9762\u8FD8\u6CA1\u6709\u4E13\u5C5E\u573A\u666F\u6CE8\u518C\u3002",
+          evidence: [reviewHarnessPath],
+          suggestion: "\u628A\u5F53\u524D\u9875\u9762\u52A0\u5165 visual regression \u573A\u666F\uFF0C\u907F\u514D\u53EA\u9760\u8089\u773C\u56DE\u5F52\u3002"
+        });
+      }
+    }
+  }
+  const recommendedNextSteps = [
+    "\u5148\u4FEE\u6B63\u6240\u6709 error \u7EA7\u522B\u95EE\u9898\uFF0C\u518D\u5904\u7406 warning",
+    "\u4FEE\u6B63\u8D44\u6E90\u6765\u6E90\u540E\u91CD\u65B0\u8FD0\u884C validate_restoration\uFF0C\u76F4\u5230 unexpected vector assets \u6E05\u96F6"
+  ];
+  if (args.routeFilePath && args.routeName) {
+    recommendedNextSteps.push(`\u786E\u8BA4 ${args.routeName} \u4E0D\u518D\u6307\u5411 _ComingSoonPage`);
+  }
+  if (args.projectPath) {
+    recommendedNextSteps.push("\u5C06\u9875\u9762\u6CE8\u518C\u5230 visual regression \u573A\u666F\u540E\u518D\u8FDB\u884C UI review");
+  }
+  return {
+    passed: !findings.some((item) => item.severity === "error"),
+    routeConnected,
+    routeTarget,
+    reviewHarnessReady,
+    findings,
+    recommendedNextSteps
+  };
+}
+async function validateRestoration(args) {
+  var _a;
+  if (!args.codeFilePath) {
+    throw new Error("validate_restoration \u9700\u8981 codeFilePath \u53C2\u6570");
+  }
+  if (!fs20.existsSync(args.codeFilePath)) {
+    throw new Error(`\u4EE3\u7801\u6587\u4EF6\u4E0D\u5B58\u5728: ${args.codeFilePath}`);
+  }
+  const payload = loadMeasurePayload(args);
+  const codeContent = fs20.readFileSync(args.codeFilePath, "utf-8");
+  const contractValidator = buildContractValidator(payload, codeContent);
+  const assetValidator = buildAssetValidator(payload, codeContent, args);
+  const routeReviewValidator = buildRouteReviewValidator(args, codeContent);
+  return {
+    artboardName: (_a = payload.artboard) == null ? void 0 : _a.name,
+    ok: contractValidator.passed && assetValidator.passed && routeReviewValidator.passed,
+    codeFilePath: args.codeFilePath,
+    contractValidator,
+    assetValidator,
+    routeReviewValidator
+  };
+}
+
 // src/tools/skillDefinitions.ts
 function wrapAsContent(data) {
   return {
@@ -6874,6 +7351,29 @@ var skillDefinitions = [
         outputPath: params.outputPath
       });
     }
+  },
+  {
+    name: "validate_restoration",
+    category: "sketch",
+    description: "\u6821\u9A8C\u8BBE\u8BA1\u8FD8\u539F\u7ED3\u679C\u3002\u5BF9\u7167 sketch_measure \u7684 restorationContract \u68C0\u67E5\u9875\u9762\u9AA8\u67B6\u3001\u8D44\u6E90\u6765\u6E90\u3001\u771F\u5B9E\u8DEF\u7531\u662F\u5426\u63A5\u901A\uFF0C\u4EE5\u53CA UI review \u573A\u666F\u662F\u5426\u51C6\u5907\u5B8C\u6210",
+    paramHints: [
+      { name: "measurePath", type: "string", description: "sketch_measure \u6267\u884C\u7ED3\u679C\u6587\u4EF6\u8DEF\u5F84\uFF0C\u6216\u4FDD\u5B58\u540E\u7684 compact JSON \u8DEF\u5F84" },
+      { name: "measureContent", type: "string", description: "\u76F4\u63A5\u4F20\u5165 sketch_measure \u7684 JSON \u6587\u672C\uFF08measurePath \u4E0E measureContent \u4E8C\u9009\u4E00\uFF09" },
+      { name: "codeFilePath", type: "string", required: true, description: "\u751F\u6210\u540E\u7684\u9875\u9762\u4EE3\u7801\u6587\u4EF6\u8DEF\u5F84" },
+      { name: "routeFilePath", type: "string", description: "\u8DEF\u7531\u6587\u4EF6\u8DEF\u5F84\uFF08\u7528\u4E8E\u68C0\u67E5\u662F\u5426\u4ECD\u6307\u5411\u5360\u4F4D\u9875\uFF09" },
+      { name: "routeName", type: "string", description: "\u8DEF\u7531\u540D\uFF0C\u5982 AppRoutes.recipientAdd" },
+      { name: "projectPath", type: "string", description: "\u9879\u76EE\u6839\u8DEF\u5F84\uFF08\u7528\u4E8E\u68C0\u67E5 visual review harness\uFF09" }
+    ],
+    handler: async (params) => {
+      return wrapAsContent(await validateRestoration({
+        measurePath: params.measurePath,
+        measureContent: params.measureContent,
+        codeFilePath: params.codeFilePath,
+        routeFilePath: params.routeFilePath,
+        routeName: params.routeName,
+        projectPath: params.projectPath
+      }));
+    }
   }
 ];