mta-mcp 3.15.0 → 3.15.2

package/dist/index.js

@@ -2893,7 +2893,7 @@ init_smartAgentMatcher();
 async function getCompactStandards(args) {
   const logger4 = new ConsoleLogger();
   const manager = new StandardsManager();
-  const mode = args.mode || "key-rules";
+  const mode = normalizeMode(args.mode);
   try {
     let context = detectContext(args, logger4);
     if (args.projectPath && fs12.existsSync(args.projectPath)) {
@@ -2905,16 +2905,16 @@ async function getCompactStandards(args) {
       imports: context.imports,
       scenario: args.scenario || context.scenario
     });
-    let responseContent;
+    const responseContent = {};
     switch (mode) {
       case "summary":
-        responseContent = buildSummaryResponse(standardUris, manager);
+        Object.assign(responseContent, buildSummaryResponse(standardUris, manager));
         break;
       case "key-rules":
-        responseContent = buildKeyRulesResponse(standardUris, context, manager);
+        Object.assign(responseContent, buildKeyRulesResponse(standardUris, context, manager));
         break;
       case "full":
-        responseContent = buildFullResponse(standardUris, manager);
+        Object.assign(responseContent, buildFullResponse(standardUris, manager));
         break;
     }
     if (args.projectPath && context.userConfiguredAgents) {
@@ -2942,6 +2942,12 @@ async function getCompactStandards(args) {
     };
   }
 }
+function normalizeMode(mode) {
+  if (mode === "summary" || mode === "key-rules" || mode === "full") {
+    return mode;
+  }
+  return "key-rules";
+}
 async function analyzeProject2(projectPath, logger4) {
   var _a, _b;
   const result = {
@@ -3330,7 +3336,12 @@ function getFlutterDesignRestorationKeyRules() {
 ### \u6570\u636E\u4F7F\u7528\u4F18\u5148\u7EA7
 - \u9996\u8F6E\u4EE3\u7801\u751F\u6210: \`compact.restorationContract\` + \`compact.tree\`
 - \u5C40\u90E8\u6837\u5F0F/\u56FE\u6807\u8BCA\u65AD: \u518D\u8865\u8BFB \`measure\` \u6216 \`style\`
-- \u53EA\u8981 contract \u4E0E\u73B0\u6709\u4E1A\u52A1\u7EC4\u4EF6\u51B2\u7A81\uFF0C\u4F18\u5148\u4FDD\u8BC1\u8BBE\u8BA1\u7A3F\u7ED3\u6784\u4E00\u81F4\uFF0C\u518D\u51B3\u5B9A\u662F\u5426\u590D\u7528\u7EC4\u4EF6`
+- \u53EA\u8981 contract \u4E0E\u73B0\u6709\u4E1A\u52A1\u7EC4\u4EF6\u51B2\u7A81\uFF0C\u4F18\u5148\u4FDD\u8BC1\u8BBE\u8BA1\u7A3F\u7ED3\u6784\u4E00\u81F4\uFF0C\u518D\u51B3\u5B9A\u662F\u5426\u590D\u7528\u7EC4\u4EF6`,
+    `### SVG / \u8D44\u6E90\u56DE\u5F52\u68C0\u67E5
+- \u5982\u679C \`iconSvgMeta.colorStrategy=preserve\`\uFF0C\u6216 SVG \u81EA\u5E26 \`fill-opacity\` / \u6E10\u53D8 / \u591A\u8272\u8DEF\u5F84\uFF0C**\u7981\u6B62**\u518D\u52A0 \`ColorFilter\`
+- \u65E7\u9875\u9762\u7684\u540C\u540D\u7BAD\u5934/\u56FE\u6807\u8D44\u6E90\u9ED8\u8BA4\u4E0D\u53EF\u4FE1\uFF1B\u5C40\u90E8\u56FE\u6807\u504F\u5DEE\u4F18\u5148\u4ECE\u5F53\u524D\u753B\u677F\u91CD\u65B0\u5BFC\u51FA\uFF0C\u4E0D\u76F4\u63A5\u590D\u7528\u5168\u5C40\u8D44\u4EA7
+- 16\xD716 \u901A\u5E38\u662F\u70B9\u51FB\u69FD\u4F4D\u800C\u975E\u56FE\u5F62\u771F\u5B9E\u5C3A\u5BF8\uFF1B\u5F53 compact/measure \u7ED9\u51FA \`containerSize\` \u4E0E \`contentSize\` \u65F6\uFF0C\u5FC5\u987B\u5206\u79BB\u5360\u4F4D\u4E0E\u6E32\u67D3
+- Sketch \u7684 \`Image\` \u56FE\u5C42\u5FC5\u987B\u5BFC\u51FA PNG + \`Image.asset\`\uFF0C\u4E0D\u8981\u4F2A\u88C5\u6210 SVG \u7528 \`SvgPicture\``
   ];
 }
 function isDesignRestorationScenario(scenario, imports) {
@@ -5495,6 +5506,59 @@ function ensureWorkspaceConfig(workspacePath) {
 
 // src/tools/queryTroubleshootingCases.ts
 var logger2 = createLogger("QueryTroubleshootingCases");
+var KEYWORD_ALIAS_MAP = {
+  svg: ["\u77E2\u91CF", "svgpicture", "svgpicture.asset"],
+  color: ["\u989C\u8272", "\u8272\u503C", "\u53D1\u7070", "\u53D1\u6D45", "\u53D8\u6DE1"],
+  colorfilter: ["color filter", "\u4E8C\u6B21\u67D3\u8272", "\u67D3\u8272"],
+  opacity: ["\u900F\u660E\u5EA6", "fill-opacity", "alpha"],
+  viewbox: ["view box", "\u89C6\u53E3"],
+  icon: ["\u56FE\u6807", "badge", "flag"],
+  chevron: ["arrow", "\u7BAD\u5934"],
+  bitmap: ["\u4F4D\u56FE", "png", "image.asset"],
+  layout: ["\u5E03\u5C40", "spacing", "\u95F4\u8DDD", "\u504F\u79FB"],
+  sketch: ["\u8BBE\u8BA1\u7A3F", "\u8FD8\u539F", "measure", "restoration"]
+};
+function normalizeKeyword(value) {
+  return value.trim().toLowerCase();
+}
+function expandKeywords(keywords) {
+  const expanded = /* @__PURE__ */ new Set();
+  for (const keyword of keywords) {
+    const normalized = normalizeKeyword(keyword);
+    if (!normalized) continue;
+    expanded.add(normalized);
+    for (const [canonical, aliases] of Object.entries(KEYWORD_ALIAS_MAP)) {
+      if (canonical === normalized || aliases.some((alias) => normalized.includes(alias) || alias.includes(normalized))) {
+        expanded.add(canonical);
+        for (const alias of aliases) {
+          expanded.add(alias);
+        }
+      }
+    }
+  }
+  return [...expanded];
+}
+function inferImplicitTags(id, title, problemType, content) {
+  const source = `${id} ${title} ${problemType} ${content}`.toLowerCase();
+  const inferred = /* @__PURE__ */ new Set();
+  for (const [canonical, aliases] of Object.entries(KEYWORD_ALIAS_MAP)) {
+    const candidates = [canonical, ...aliases];
+    if (candidates.some((candidate) => source.includes(candidate))) {
+      inferred.add(canonical);
+    }
+  }
+  if (source.includes("sketch") || source.includes("\u8BBE\u8BA1\u7A3F") || source.includes("\u8FD8\u539F")) {
+    inferred.add("sketch");
+  }
+  return [...inferred];
+}
+function extractErrorKeywords(errorMessage) {
+  if (!(errorMessage == null ? void 0 : errorMessage.trim())) {
+    return [];
+  }
+  const rawMatches = errorMessage.toLowerCase().match(/colorfilter|fill-opacity|viewbox|svgpicture(?:\.asset)?|image\.asset|bitmap|chevron|arrow|opacity|颜色|透明度|箭头|图标|位图|设计稿|还原|间距|布局|发灰|发浅|模糊|复用|旧资源|png|svg|icon/g) || [];
+  return expandKeywords([...new Set(rawMatches)]);
+}
 function extractCaseMetadata(filePath, framework) {
   try {
     const content = fs18.readFileSync(filePath, "utf-8");
@@ -5531,6 +5595,7 @@ function extractCaseMetadata(filePath, framework) {
       timeSaved = timeSavedMatch[1] || `${timeSavedMatch[2]}\u8F6E\u5BF9\u8BDD`;
     }
     const id = path17.basename(filePath, ".md");
+    tags = [.../* @__PURE__ */ new Set([...tags, ...inferImplicitTags(id, title, problemType || "", content)])];
     return {
       id,
       framework,
@@ -5548,10 +5613,14 @@ function extractCaseMetadata(filePath, framework) {
 }
 function calculateMatchScore(caseData, keywords, errorMessage) {
   let score = 0;
+  const expandedKeywords = expandKeywords(keywords);
+  const idLower = caseData.id.toLowerCase();
   const titleLower = caseData.title.toLowerCase();
   const problemTypeLower = caseData.problemType.toLowerCase();
   const tagsLower = caseData.tags.map((t) => t.toLowerCase());
-  for (const keyword of keywords) {
+  const caseContent = fs18.readFileSync(caseData.filePath, "utf-8").toLowerCase();
+  const searchableText = `${idLower} ${titleLower} ${problemTypeLower} ${tagsLower.join(" ")} ${caseContent}`;
+  for (const keyword of expandedKeywords) {
     const kw = keyword.toLowerCase();
     if (tagsLower.includes(kw)) {
       score += 20;
@@ -5559,26 +5628,29 @@ function calculateMatchScore(caseData, keywords, errorMessage) {
       score += 10;
     }
   }
-  for (const keyword of keywords) {
+  for (const keyword of expandedKeywords) {
     const kw = keyword.toLowerCase();
-    if (titleLower.includes(kw)) {
+    if (titleLower.includes(kw) || idLower.includes(kw)) {
       score += 15;
     }
   }
-  for (const keyword of keywords) {
+  for (const keyword of expandedKeywords) {
     const kw = keyword.toLowerCase();
     if (problemTypeLower.includes(kw)) {
       score += 8;
     }
   }
+  for (const keyword of expandedKeywords) {
+    const kw = keyword.toLowerCase();
+    if (searchableText.includes(kw)) {
+      score += 6;
+    }
+  }
   if (errorMessage && errorMessage.trim()) {
-    const errorLower = errorMessage.toLowerCase();
-    const caseContent = fs18.readFileSync(caseData.filePath, "utf-8").toLowerCase();
-    const errorKeywords = errorLower.match(/\b[\u4e00-\u9fa5a-z]{4,}\b/g) || [];
-    const uniqueKeywords = [...new Set(errorKeywords)];
+    const uniqueKeywords = extractErrorKeywords(errorMessage);
     let matches = 0;
     for (const kw of uniqueKeywords.slice(0, 10)) {
-      if (caseContent.includes(kw)) {
+      if (searchableText.includes(kw)) {
         matches++;
       }
     }
@@ -5586,8 +5658,8 @@ function calculateMatchScore(caseData, keywords, errorMessage) {
       score += Math.floor(matches / uniqueKeywords.length * 30);
     }
   }
-  for (const keyword of keywords) {
-    if (caseData.tags.includes(keyword)) {
+  for (const keyword of expandedKeywords) {
+    if (caseData.tags.map((tag) => tag.toLowerCase()).includes(keyword.toLowerCase())) {
       score += 15;
     }
   }
@@ -6219,9 +6291,12 @@ var OUTPUT_GUIDE = {
     "- **isIcon=true**: \u5DF2\u901A\u8FC7 5 \u7279\u5F81\u8BC4\u5206\u8BC6\u522B\u4E3A\u56FE\u6807\uFF0C\u5E94\u5BFC\u51FA SVG \u800C\u975E\u7528 Icons.xxx",
     "- **iconSvgMarkup**: \u63D2\u4EF6\u73B0\u5DF2\u76F4\u63A5\u8FD4\u56DE\u4ECE Sketch \u5BFC\u51FA\u7684\u771F\u5B9E SVG \u5B57\u7B26\u4E32\uFF0C\u4E0D\u518D\u53EA\u731C\u6D4B\u6587\u4EF6\u540D",
     "- **iconSvgMeta.colorStrategy**: preserve=\u4FDD\u6301\u539F\u8272\uFF08\u591A\u8272/\u6E10\u53D8/\u5185\u5D4C\u4F4D\u56FE\uFF09\uFF0Ctint=\u5355\u8272\u56FE\u6807\u53EF\u7528 colorFilter",
+    "- **\u5173\u952E\u89C4\u5219**: \u5F53 colorStrategy=preserve\uFF0C\u6216 SVG \u672C\u8EAB\u5E26 fill/fill-opacity/\u6E10\u53D8\u65F6\uFF0C**\u7981\u6B62**\u518D\u5957 ColorFilter\uFF0C\u5426\u5219\u4F1A\u51FA\u73B0\u989C\u8272\u53D1\u7070\u3001\u900F\u660E\u5EA6\u88AB\u4E8C\u6B21\u5904\u7406\u7684\u95EE\u9898",
     "- **flutterSvgCode**: \u53EF\u76F4\u63A5\u7C98\u8D34\u7684 SvgPicture.string(...) \u4EE3\u7801\uFF1B\u53EA\u6709\u5355\u8272\u56FE\u6807\u624D\u4F1A\u81EA\u52A8\u9644\u5E26 ColorFilter",
     "- **iconContentBounds**: \u56FE\u6807\u5185\u5BB9\u5B9E\u9645\u8FB9\u754C\uFF08vs \u5BB9\u5668\u5C3A\u5BF8\uFF09\uFF0C\u7528\u4E8E SizedBox \u7EA6\u675F",
     "- **iconExportPath/iconSvgFileName**: \u82E5\u9700\u8981\u843D\u76D8\u8D44\u6E90\uFF0C\u4F7F\u7528\u63D2\u4EF6\u5EFA\u8BAE\u6587\u4EF6\u540D\u4FDD\u5B58\u5230 assets/icons/",
+    "- **\u9875\u9762\u5C40\u90E8\u4FEE\u590D\u89C4\u5219**: \u82E5\u95EE\u9898\u53EA\u51FA\u5728\u67D0\u4E2A chevron/flag/badge/icon\uFF0C\u4F18\u5148\u91CD\u65B0\u9009\u4E2D\u8BE5\u56FE\u5C42\u6267\u884C cmd=svg \u6216\u5C40\u90E8\u5BFC\u51FA\uFF1B\u4E0D\u8981\u76F4\u63A5\u590D\u7528\u5176\u5B83\u9875\u9762\u7684\u540C\u540D\u5168\u5C40\u8D44\u4EA7",
+    "- **\u8D44\u6E90\u590D\u7528\u6821\u9A8C**: \u65E7\u8D44\u4EA7\u5728\u590D\u7528\u524D\uFF0C\u5FC5\u987B\u6838\u5BF9 viewBox\u3001containerSize/contentSize\u3001fill-opacity \u548C\u5F53\u524D\u9875\u9762\u56FE\u5C42\u6765\u6E90\u662F\u5426\u4E00\u81F4",
     "- \u8986\u76D6\u4FEE\u6B63: \u56DB\u8FB9\u8DDD\u22642pt \u6216\u5BBD\u9AD8\u2265\u7236\u5BB9\u566888% \u7684 ShapePath \u662F\u80CC\u666F\u5C42\uFF0C\u5DF2\u81EA\u52A8\u6392\u9664",
     "",
     "### ShapePath \u8BED\u4E49\uFF08v3.0.6 \u66F4\u65B0\uFF09",
@@ -6337,7 +6412,14 @@ var OUTPUT_GUIDE = {
     "- **ch**: \u5B50\u5143\u7D20\u6570\u7EC4\uFF08\u9012\u5F52\uFF09",
     "",
     "### \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"
+    "\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",
+    "",
+    "### \u8FD8\u539F\u540E\u5F3A\u5236\u590D\u67E5\u6E05\u5355",
+    "- \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",
+    "- \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")
 };
 function findFirst(paths) {
@@ -6427,7 +6509,27 @@ 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\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\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",
+        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",
+          "\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)
@@ -6435,6 +6537,330 @@ 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",
+      sourceType: "bitmap"
+    });
+  }
+  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 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;
+  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"
+      });
+    }
+  }
+  return {
+    passed: !findings.some((item) => item.severity === "error"),
+    requiredBlocks,
+    matchedBlocks,
+    findings
+  };
+}
+function buildAssetValidator(payload, codeContent) {
+  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"
+    });
+  }
+  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);
+  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 {
@@ -6444,6 +6870,20 @@ function wrapAsContent(data) {
     }]
   };
 }
+function extractTroubleshootingKeywords(problemText) {
+  const extractedKeywords = [];
+  const keywordPatterns = [
+    /\b(shadow|阴影|透出|transparency|clip|裁剪|layout|布局|spacing|间距|offset|偏移|animation|动画|color|颜色|colorfilter|fill-opacity|opacity|alpha|border|边框|svg|svgpicture|bitmap|png|icon|图标|chevron|arrow|箭头|input|输入|button|按钮|table|表格|form|表单|style|样式|viewbox|view box|design|设计稿|restore|restoration|还原)\b/gi,
+    /(发灰|发浅|模糊|颜色不对|旧资源|复用|不居中|不对齐|尺寸不对|图标过大|图标过粗)/g
+  ];
+  for (const pattern of keywordPatterns) {
+    const matches = problemText.match(pattern);
+    if (matches) {
+      extractedKeywords.push(...matches.map((m) => m.toLowerCase()));
+    }
+  }
+  return [...new Set(extractedKeywords)];
+}
 var skillDefinitions = [
   // ==================== 规范获取类 ====================
   {
@@ -6711,17 +7151,7 @@ var skillDefinitions = [
           detectedFramework = "react";
         }
       }
-      const extractedKeywords = [];
-      const keywordPatterns = [
-        /\b(shadow|阴影|透出|transparency|clip|裁剪|layout|布局|animation|动画|color|颜色|border|边框|svg|icon|图标|input|输入|button|按钮|table|表格|form|表单|style|样式)\b/gi
-      ];
-      for (const pattern of keywordPatterns) {
-        const matches = problemText.match(pattern);
-        if (matches) {
-          extractedKeywords.push(...matches.map((m) => m.toLowerCase()));
-        }
-      }
-      const uniqueKeywords = [...new Set(extractedKeywords)];
+      const uniqueKeywords = extractTroubleshootingKeywords(problemText);
       return wrapAsContent(await queryTroubleshootingCases({
         framework: detectedFramework,
         keywords: uniqueKeywords.length > 0 ? uniqueKeywords : void 0,
@@ -6781,6 +7211,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
+      }));
+    }
   }
 ];