mta-mcp 3.16.0 → 3.16.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mta-mcp",
-  "version": "3.16.0",
+  "version": "3.16.2",
   "description": "MTA - 智能编码助手 MCP 服务器（规范 + 技能 + 诊断 + 模板 + 记忆 + 思考）",
   "type": "module",
   "main": "./dist/index.js",

package/troubleshooting/flutter/component-/351/200/232/347/224/250/345/214/226/346/217/220/345/217/226.md

@@ -116,7 +116,7 @@ class TipCardConfig {
     titleColor: Color(0xFFFF9800),
     contentColor: Color(0xFFB45309),
     buttonShadowColor: Color(0x40FF9800),
-    iconPath: 'assets/icons/warning_icon.svg',
+    iconPath: '<asset-dir>/warning_icon.svg',
   );
 
   /// Error: #f4433614 (8%透明), border #ffcacaff
@@ -126,7 +126,7 @@ class TipCardConfig {
     titleColor: Color(0xFFF44336),
     contentColor: Color(0xFFCA4F57),
     buttonShadowColor: Color(0x40D0121B),
-    iconPath: 'assets/icons/error_icon.svg',
+    iconPath: '<asset-dir>/error_icon.svg',
   );
 
   static TipCardConfig fromType(TipCardType type) {

package/troubleshooting/flutter/sketch-/345/233/276/346/240/207/345/260/272/345/257/270.md

@@ -83,14 +83,14 @@ extractIconInternalSize('Frame Name');
 ```dart
 // ✅ 使用内部图形的实际尺寸
 SvgPicture.asset(
-  'assets/icons/recipient.svg',
+  '<asset-dir>/recipient.svg',
   width: 15.0,  // 14.7 取整
   height: 15.0,
 )
 
 // ❌ 错误：使用外层 Group 尺寸
 SvgPicture.asset(
-  'assets/icons/recipient.svg',
+  '<asset-dir>/recipient.svg',
   width: 22.0,  // 这是 Group 尺寸，图标会偏大
   height: 22.0,
 )

package/troubleshooting/flutter/svg-/345/220/253/350/203/214/346/231/257/350/267/257/345/276/204.md

@@ -111,13 +111,13 @@ selection.forEach(layer => {
 
 ```bash
 # 1. 查看文件大小：纯图标通常 < 3KB
-ls -lh assets/icons/ic_face_id.svg
+ls -lh <asset-dir>/ic_face_id.svg
 
 # 2. 搜索是否含圆形元素
-grep -c "<circle\|fill-opacity" assets/icons/ic_face_id.svg
+grep -c "<circle\|fill-opacity" <asset-dir>/ic_face_id.svg
 
 # 3. 检查 viewBox 是否等于图标本身尺寸（如 60×60）
-grep "viewBox" assets/icons/ic_face_id.svg
+grep "viewBox" <asset-dir>/ic_face_id.svg
 ```
 
 ### Flutter 代码中的正确用法
@@ -134,7 +134,7 @@ Container(
   child: Center(
     // SVG 只含纯图标路径，不含圆形背景
     child: SvgPicture.asset(
-      'assets/icons/ic_face_id.svg',
+      '<asset-dir>/ic_face_id.svg',
       width: 60,
       height: 60,
     ),
@@ -142,6 +142,8 @@ Container(
 )
 ```
 
+其中 <asset-dir> 表示当前项目的实际素材目录。
+
 ---
 
 ## 📝 验证检查清单

package/troubleshooting/flutter/svg-/346/234/252/345/261/205/344/270/255.md

@@ -91,7 +91,7 @@ SizedBox(
   height: 16,
   child: Center(
     child: SvgPicture.asset(
-      'assets/icons/recipient_chevron_right.svg',
+      '<asset-dir>/recipient_chevron_right.svg',
       width: 6,
       height: 8,
     ),
@@ -99,7 +99,7 @@ SizedBox(
 )
 
 // ❌ 错误 - 直接把 6×8 箭头按 16×16 渲染，视觉会偏大
-SvgPicture.asset('assets/icons/recipient_chevron_right.svg', width: 16, height: 16)
+SvgPicture.asset('<asset-dir>/recipient_chevron_right.svg', width: 16, height: 16)
 ```
 
 ---
@@ -113,7 +113,7 @@ SvgPicture.asset('assets/icons/recipient_chevron_right.svg', width: 16, height:
 2. **验证导出的 viewBox**
    ```bash
    # 检查 SVG 文件的 viewBox
-   head -3 assets/icons/arrow.svg
+  head -3 <asset-dir>/arrow.svg
    # 应该看到 viewBox="0 0 12 12" 而非 viewBox="0 0 6 3"
    ```
 

package/troubleshooting/flutter/svg-/351/242/234/350/211/262/345/274/202/345/270/270.md

@@ -53,7 +53,7 @@ SvgPicture.asset(
 ```dart
 // ✅ 不使用 colorFilter，保留 SVG 原有颜色和透明度
 SvgPicture.asset(
-  'assets/icons/dropdown_arrow.svg',
+  '<asset-dir>/dropdown_arrow.svg',
   width: 12,
   height: 12,
   // 不传 colorFilter
@@ -65,14 +65,14 @@ SvgPicture.asset(
 ```dart
 // ✅ sketch_measure 已判定保留原色
 SvgPicture.asset(
-  'assets/icons/recipient_chevron_right.svg',
+  '<asset-dir>/recipient_chevron_right.svg',
   width: 6,
   height: 8,
 )
 
 // ❌ 错误 - preserve 模式又二次染色
 SvgPicture.asset(
-  'assets/icons/recipient_chevron_right.svg',
+  '<asset-dir>/recipient_chevron_right.svg',
   width: 6,
   height: 8,
   colorFilter: ColorFilter.mode(AppColors.textDarkTertiary, BlendMode.srcIn),

package/ui/sketch/mta-measure.sketchplugin/Contents/Sketch/measure.js

@@ -2500,17 +2500,33 @@ function buildManualExportedBitmapAssetCandidates(layer) {
   var rawName = String(layer && layer.name ? layer.name : '').trim();
   if (rawName) {
     var exactName = rawName.replace(/[\\/]/g, '-').replace(/\s+/g, ' ').trim();
-    if (exactName) pushUniqueAssetCandidate(candidates, exactName + '_icon@4x.png');
+    if (exactName) {
+      pushUniqueAssetCandidate(candidates, exactName + '@4x.png');
+      pushUniqueAssetCandidate(candidates, exactName + '_icon@4x.png');
+      pushUniqueAssetCandidate(candidates, exactName + '.png');
+    }
   }
 
   var sanitizedName = buildLayerAssetBaseName(layer, 'image');
   if (sanitizedName) {
+    pushUniqueAssetCandidate(candidates, sanitizedName + '@4x.png');
     pushUniqueAssetCandidate(candidates, sanitizedName + '_icon@4x.png');
+    pushUniqueAssetCandidate(candidates, sanitizedName + '.png');
   }
 
   return candidates;
 }
 
+function buildBitmapLookupCandidates(layer, sharedBitmapName) {
+  var candidates = buildManualExportedBitmapAssetCandidates(layer);
+  if (sharedBitmapName) {
+    pushUniqueAssetCandidate(candidates, sharedBitmapName + '.png');
+    pushUniqueAssetCandidate(candidates, sharedBitmapName + '@4x.png');
+    pushUniqueAssetCandidate(candidates, sharedBitmapName + '_icon@4x.png');
+  }
+  return candidates;
+}
+
 function normalizeSharedAssetName(name) {
   return String(name || '')
     .toLowerCase()
@@ -2803,7 +2819,7 @@ function measureRecursively(layer, depth, parentFrame, siblings) {
 
   if (element.isIcon) {
     element.iconAssetFileName = buildLayerAssetFileName(layer, 'icon', 'svg');
-    element.iconExportPath = 'icons/' + element.iconAssetFileName;
+    element.iconExportPath = element.iconAssetFileName;
     element.iconSketchName = layer.name;
     if (looksLikeSvgExportCandidate(layer)) {
       var svgExport = exportLayerToSvgMarkup(layer, element.iconAssetFileName);
@@ -2819,7 +2835,7 @@ function measureRecursively(layer, depth, parentFrame, siblings) {
       element.iconSvgExportSkipped = '该图层包含常规文本或位图，不适合作为纯 SVG 图标导出';
     }
     element.iconPathWarning = '优先使用插件返回的真实 SVG（iconSvgMarkup/flutterSvgCode）。' +
-      '若需要落盘文件，建议保存为 assets/icons/' + element.iconAssetFileName + '。禁止用 Icons.xxx 替代——SVG 不存在时必须报错，不得静默降级。';
+      '若需要落盘文件，请放入项目现有素材目录并保留建议文件名 ' + element.iconAssetFileName + '。禁止用 Icons.xxx 替代——SVG 不存在时必须报错，不得静默降级。';
     // 提取 Icon 内容边界 (区分容器尺寸 vs 内容尺寸)
     if (layer.type === 'Group' && layer.layers) {
       var bounds = extractIconContentBounds(layer);
@@ -2868,7 +2884,7 @@ function measureRecursively(layer, depth, parentFrame, siblings) {
             effectiveColor
           );
         } else {
-          element.flutterSvgCode = 'SvgPicture.asset(\'assets/' + element.iconExportPath + '\' /* TODO: 若插件未返回 iconSvgMarkup，请将 Sketch 导出的真实 SVG 落盘到该路径 */, width: ' + iw + ', height: ' + ih + ', colorFilter: ColorFilter.mode(' + effectiveColor + ', BlendMode.srcIn),)';
+          element.flutterSvgCode = 'SvgPicture.asset(\'<asset-path>/' + element.iconAssetFileName + '\' /* TODO: 将真实 SVG 放入项目素材目录并替换占位路径 */, width: ' + iw + ', height: ' + ih + ', colorFilter: ColorFilter.mode(' + effectiveColor + ', BlendMode.srcIn),)';
         }
       }
     } else if (element.iconSvgMarkup) {
@@ -2979,38 +2995,40 @@ function measureRecursively(layer, depth, parentFrame, siblings) {
     if (nativeImgFills && nativeImgFills[0] && nativeImgFills[0].hex) {
       element.imageInfo.nativeTint = formatNativeColor(nativeImgFills[0]);
     }
-    element.imageInfo.note = '此图层为嵌入式位图(Bitmap)。若它是 icon/button/arrow 等图标类位图，先去 assets/icons/ 查找用户手工导出的 *_icon@4x.png；找到即直接用 Image.asset 复用。只有明确缺失时才补导 PNG，禁止再把 Bitmap 伪装成 SVG。';
+    element.imageInfo.note = '此图层为嵌入式位图(Bitmap)。若它是 icon/button/arrow 等图标类位图，先在项目素材目录中按图层文件名主体查找现有高倍率 PNG（例如 xxx@4x.png）；找到即直接复用。只有明确缺失时才补导 PNG，禁止再把 Bitmap 伪装成 SVG。';
     // 生成 Image.asset 代码片段，开发者直接复制使用
     var bitmapW = Math.round(layer.frame.width);
     var bitmapH = Math.round(layer.frame.height);
-    var manualBitmapCandidates = element.isIcon ? buildManualExportedBitmapAssetCandidates(layer) : [];
+    var manualBitmapCandidates = buildManualExportedBitmapAssetCandidates(layer);
     var manualBitmapName = manualBitmapCandidates.length > 0 ? manualBitmapCandidates[0] : null;
-    var sharedBitmapName = element.isIcon ? null : resolveSharedBitmapAssetBaseName(layer);
+    var sharedBitmapName = resolveSharedBitmapAssetBaseName(layer);
+    var bitmapLookupCandidates = buildBitmapLookupCandidates(layer, sharedBitmapName);
     var bitmapName = sharedBitmapName || buildLayerAssetBaseName(layer, 'image');
     var bitmapFileName = manualBitmapName || (bitmapName + '.png');
     element.imageInfo.reuseMode = element.isIcon
-      ? 'assets-icons-search-first'
+      ? 'project-asset-search-first'
       : (sharedBitmapName ? 'shared-canonical' : 'page-local');
     if (sharedBitmapName && !element.isIcon) {
       element.imageInfo.reuseKey = sharedBitmapName;
     }
     element.imageInfo.bitmapFileName = bitmapFileName;
-    element.imageInfo.bitmapExportPath = 'icons/' + bitmapFileName;
+    element.imageInfo.bitmapExportPath = bitmapFileName;
     element.imageInfo.exportScaleVariants = element.isIcon ? ['@4x'] : ['1.0x', '2.0x', '3.0x'];
+    if (bitmapLookupCandidates.length > 0) {
+      element.imageInfo.lookupCandidates = bitmapLookupCandidates;
+    }
     if (element.isIcon) {
-      element.imageInfo.lookupDir = 'assets/icons/';
-      element.imageInfo.lookupCandidates = manualBitmapCandidates;
-      element.imageInfo.pathWarning = '先在 assets/icons/ 中按设计稿图层名查找用户手工导出的 @4x PNG。优先候选: ' + manualBitmapCandidates.join(' / ') + '。找到即直接复用，不要再推导 SVG 或继续生成新的 page-local PNG。';
-      element.imageInfo.exportHint = '若 assets/icons/ 中缺少对应图标，请由用户手动从设计稿导出 PNG 到 assets/icons/，文件名优先使用 ' + bitmapFileName + '。';
+      element.imageInfo.pathWarning = '先在项目素材目录中按设计稿图层名主体查找用户手工导出的高倍率 PNG。优先候选: ' + manualBitmapCandidates.join(' / ') + '。文件名匹配重点看 xxx 主体，@4x 只是倍率后缀。找到即直接复用，不要再推导 SVG 或继续生成新的 page-local PNG。';
+      element.imageInfo.exportHint = '若项目素材目录中缺少对应图标，请由用户手动从设计稿导出 PNG，并沿用建议文件名主体 ' + bitmapName + '（例如 ' + bitmapName + '.png 或 ' + bitmapName + '@4x.png）。';
     } else {
       element.imageInfo.pathWarning = sharedBitmapName
-        ? '检测到重复出现的共享位图图标，优先复用 canonical 资产 assets/icons/' + bitmapName + '.png；禁止再按页面重复缓存同义 PNG。'
+        ? '检测到重复出现的共享位图图标。先按设计稿图层原名或文件名主体查找现有资源（优先候选: ' + bitmapLookupCandidates.join(' / ') + '）；若项目已做运行时规范化，再复用 canonical 文件名 ' + bitmapName + '.png。禁止把 Help / Customer Service 等语义相近位图互换。'
         : '⚠️ 位图资源必须从当前画板局部导出并使用 page-local 文件名，禁止继续复用其它页面的旧 PNG。';
       element.imageInfo.exportHint = sharedBitmapName
-        ? 'Sketch 导出命令: File > Export Layers > 选择此图层 > 格式 PNG @1x/@2x/@3x，并统一覆盖 assets/icons/' + bitmapName + '.png 及其 2.0x/3.0x 变体。'
-        : 'Sketch 导出命令: File > Export Layers > 选择此图层 > 格式 PNG @1x/@2x/@3x, 分别放入 assets/icons/、assets/icons/2.0x/、assets/icons/3.0x/';
+        ? 'Sketch 导出命令: 先确认项目素材目录中是否已存在设计稿原名或同主体导出文件；若需要生成运行时稳定路径，可复制为 ' + bitmapName + '.png，并保持像素内容与设计导出一致。'
+        : 'Sketch 导出命令: File > Export Layers > 选择此图层 > 格式 PNG；输出目录遵循当前项目约定，若仍走多倍率目录流程再补齐同目录 2.0x/3.0x。';
     }
-    element.flutterImageCode = 'Image.asset(\'assets/' + element.imageInfo.bitmapExportPath + '\', width: ' + bitmapW + ', height: ' + bitmapH + ', filterQuality: FilterQuality.high, isAntiAlias: true,)';
+    element.flutterImageCode = 'Image.asset(\'<asset-path>/' + bitmapFileName + '\', width: ' + bitmapW + ', height: ' + bitmapH + ', filterQuality: FilterQuality.high, isAntiAlias: true,)';
   }
 
   // Symbol Instance — override 真实值