mta-mcp 3.11.0 → 3.12.0

package/agents/flutter.agent.md

@@ -24,16 +24,23 @@
 
 触发词："设计稿"、"Sketch"、"还原"、"测量"、"间距"、"UI还原"
 
-### 自动流程
+### 自动流程（v4.6.0 统一入口）
 
 ```
 1. 检测设计稿意图 → 提醒用户在 Sketch 选中图层
-2. 调用 mcp_sketch_get_selection_as_image → 获取预览
-3. 调用 mcp_sketch_run_code → 执行 SketchMeasureHD 测量
-4. 基于测量数据生成 Flutter 代码
+2. 调用 mcp_mta_mta({ skill: "sketch_measure", params: { cmd: "measure" } })
+   → 获取已注入 _SKETCH_CMD 的完整脚本（sketch-tools.js v4.6.0）
+3. 将返回的 script 传入 mcp_sketch_run_code({ code: script })
+   → 执行测量，获取完整 Layout Intent JSON
+4. 基于测量数据中的 flutter* 字段精准生成代码
 ```
 
-### 测量数据关键字段
+**注意：**
+- 不要手动读取 artboard-measure.js（已废弃，合并进 sketch-tools.js）
+- 不要手动拼接 _SKETCH_CMD（由 sketch_measure skill 自动处理）
+- 测量结果中所有颜色均包含 `flutterColor: "Color(0xAARRGGBB)"` 格式，可直接使用
+
+### 测量数据关键字段（v4.6.0 新增带★标记）
 
 | 字段 | 用途 | Flutter 应用 |
 |------|------|-------------|
@@ -45,8 +52,15 @@
 | `iconContentBounds` | Icon 实际路径尺寸 | 渲染用 contentSize，占位用 containerSize |
 | `tagStyle` | Tag/标签容器样式 | background, padding, cornerRadius |
 | `siblingIconAlignment` | 同行 Icon 对齐 | 统一 SizedBox 插槽尺寸 |
+| ★`flutterColor` | Flutter 颜色格式 | 直接粘贴 `Color(0xAARRGGBB)` |
+| ★`flutterBoxShadow` | 完整阴影代码 | 直接粘贴 `BoxShadow(...)` |
+| ★`flutterBorder` | 完整边框代码 | 直接粘贴 `Border.all(...)` |
+| ★`flutterLinearGradient` | 完整渐变代码 | 直接粘贴 `LinearGradient(...)` |
+| ★`flutterHint` | FILL→double.infinity | 禁止硬编码宽度 |
+| ★`flutterSvgCode` | 完整 SVG 加载代码 | 直接粘贴 `SvgPicture.asset(...)` |
+| ★`iconFillColor` | 图标填充色 | 已含 Flutter Color 格式 |
 
-**禁止**：未测量就凭感觉还原、硬编码尺寸、忽略 layoutIntent
+**禁止**：未测量就凭感觉还原、硬编码尺寸、忽略 layoutIntent、手动拼接颜色十六进制
 
 ---
 
@@ -278,14 +292,14 @@ get_standard_by_id({ ids: ['flutter', 'flutter-ui-system'] })
 
 ### ⚠️ 强制流程（最高优先级）
 
-**在还原任何 Sketch 设计稿前，必须先调用 SketchMeasureHD 插件测量：**
+**在还原任何 Sketch 设计稿前，必须先调用 MTA 测量技能获取数据：**
 
 ```
 1. 用户提供 Sketch 文件 → 先提醒："需要先在 Sketch 中选中目标图层"
-2. 调用 @sketch mcp 工具
-3. 使用脚本：mcp-server/ui/sketch/sketch_measure_hd.js
-4. 获取完整测量数据（绝对坐标、内边距、布局意图）
-5. 基于测量数据精准还原 Flutter UI
+2. 调用 mcp_mta_mta({ skill: "sketch_measure", params: { cmd: "measure" } })
+3. 将返回的 script 传入 mcp_sketch_run_code 执行
+4. 基于测量数据中的 flutter* 字段精准还原（flutterColor、flutterBoxShadow、flutterSvgCode 等）
+5. FILL 类型尺寸使用 flutterHint 的 double.infinity，禁止硬编码宽度
 ```
 
 ### 测量数据必备字段
@@ -303,6 +317,13 @@ get_standard_by_id({ ids: ['flutter', 'flutter-ui-system'] })
 | `tagStyle` | Tag 容器完整样式 | bg/padding/cornerRadius 精确还原 |
 | `siblingIconAlignment` | 同行 Icon 统一尺寸 | maxSlotSize→统一 SizedBox |
 | `fontName` | PostScript 字体名 | 正确映射 FontWeight（防合成加粗） |
+| `flutterColor` | Flutter 颜色格式 | 直接粘贴 Color(0xAARRGGBB) |
+| `flutterBoxShadow` | 完整阴影代码 | 直接粘贴 BoxShadow(...) |
+| `flutterBorder` | 完整边框代码 | 直接粘贴 Border.all(...) |
+| `flutterLinearGradient` | 完整渐变代码 | 直接粘贴 LinearGradient(...) |
+| `flutterHint` | 自适应宽度提示 | double.infinity + MediaQuery |
+| `flutterSvgCode` | 完整 SVG 代码 | 直接粘贴 SvgPicture.asset(...) + ColorFilter |
+| `iconFillColor` | 图标填充色 | 已含 flutterColor 格式 |
 
 ### 还原检查清单
 
@@ -319,6 +340,10 @@ get_standard_by_id({ ids: ['flutter', 'flutter-ui-system'] })
 - [ ] **Tag 容器使用测量的 padding/bg/cornerRadius**（防样式猜测）
 - [ ] **字体权重检查平台可用性**（PingFang≤w600, Helvetica≤w700）
 - [ ] **只还原测量数据中存在的元素**（防添加幽灵元素）
+- [ ] **优先使用 flutter* 字段**（flutterColor、flutterBoxShadow、flutterLinearGradient 等直接粘贴）
+- [ ] **图标使用 flutterSvgCode**（含精确颜色和尺寸，禁止用 Icons.xxx 替代自定义 SVG）
+- [ ] **FILL 类型尺寸使用 flutterHint**（double.infinity，禁止硬编码固定宽度）
+- [ ] **边框使用 flutterBorder**（禁止忽略 borders 数据）
 
 ### ⚠️ 常见陷阱（必读）
 

package/dist/index.js

@@ -6030,6 +6030,90 @@ function getSkillRegistry() {
   return globalRegistry;
 }
 
+// src/tools/sketchMeasure.ts
+import * as fs19 from "fs";
+import * as path19 from "path";
+import { fileURLToPath as fileURLToPath8 } from "url";
+var __filename8 = fileURLToPath8(import.meta.url);
+var __dirname8 = path19.dirname(__filename8);
+var SKETCH_TOOLS_PATHS = [
+  path19.resolve(__dirname8, "../ui/sketch/sketch-tools.js"),
+  path19.resolve(__dirname8, "../../ui/sketch/sketch-tools.js")
+];
+var VALID_CMDS = ["measure", "layout", "style", "svg", "auto"];
+function findSketchTools() {
+  for (const p of SKETCH_TOOLS_PATHS) {
+    if (fs19.existsSync(p)) {
+      return p;
+    }
+  }
+  return null;
+}
+async function sketchMeasure(args) {
+  const cmd = args.cmd || "measure";
+  if (!VALID_CMDS.includes(cmd)) {
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          error: `\u65E0\u6548\u7684 cmd \u53C2\u6570: "${cmd}"`,
+          validValues: VALID_CMDS,
+          usage: 'mcp_mta_mta({ skill: "sketch_measure", params: { cmd: "measure" } })'
+        }, null, 2)
+      }]
+    };
+  }
+  const toolPath = findSketchTools();
+  if (!toolPath) {
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          error: "sketch-tools.js \u6587\u4EF6\u672A\u627E\u5230",
+          searchedPaths: SKETCH_TOOLS_PATHS,
+          solution: "\u8BF7\u786E\u8BA4 mcp-server/ui/sketch/sketch-tools.js \u6587\u4EF6\u5B58\u5728"
+        }, null, 2)
+      }]
+    };
+  }
+  const scriptContent = fs19.readFileSync(toolPath, "utf-8");
+  const versionMatch = scriptContent.match(/@version\s+([\d.]+)/);
+  const version = versionMatch ? versionMatch[1] : "unknown";
+  const cmdLine = `var _SKETCH_CMD = '${cmd}';`;
+  const fullScript = cmdLine + "\n" + scriptContent;
+  return {
+    content: [{
+      type: "text",
+      text: JSON.stringify({
+        status: "ready",
+        version,
+        cmd,
+        scriptLength: fullScript.length,
+        instruction: "\u5C06 script \u5B57\u6BB5\u7684\u5185\u5BB9\u4F20\u5165 mcp_sketch_run_code({ code: script }) \u6267\u884C\u3002\u6267\u884C\u524D\u8BF7\u786E\u8BA4\u7528\u6237\u5DF2\u5728 Sketch \u4E2D\u9009\u4E2D\u4E86\u76EE\u6807\u753B\u677F/\u56FE\u5C42\u3002",
+        cmdDescription: {
+          measure: "\u5B8C\u6574\u753B\u677F\u6D4B\u91CF - \u83B7\u53D6\u6240\u6709\u56FE\u5C42\u6837\u5F0F\u3001\u5C3A\u5BF8\u3001\u95F4\u8DDD\u3001\u989C\u8272\uFF08\u9009\u4E2D\u753B\u677F/Frame\uFF09",
+          layout: "\u5E03\u5C40\u5206\u6790 - \u5206\u6790\u5BB9\u5668\u5B50\u5143\u7D20\u6392\u5217\uFF0C\u6216\u4E24\u4E2A\u56FE\u5C42\u7684\u76F8\u5BF9\u4F4D\u7F6E",
+          style: "\u6837\u5F0F\u5FEB\u68C0 - \u5FEB\u901F\u68C0\u67E5\u9009\u4E2D\u7EC4\u4EF6\u7684\u586B\u5145\u8272\u3001\u9634\u5F71\u3001\u6587\u5B57\u6837\u5F0F",
+          svg: "\u56FE\u6807\u5BFC\u51FA - \u5BFC\u51FA\u9009\u4E2D\u7684\u77E2\u91CF\u56FE\u4E3A SVG",
+          auto: "\u81EA\u52A8\u6A21\u5F0F - \u6839\u636E\u9009\u4E2D\u5185\u5BB9\u81EA\u52A8\u9009\u62E9\u6D4B\u91CF\u6216\u6837\u5F0F\u6A21\u5F0F"
+        }[cmd],
+        v460Features: [
+          "flutterColor - \u6240\u6709\u989C\u8272\u8F93\u51FA Flutter Color(0xAARRGGBB) \u683C\u5F0F\uFF0C\u53EF\u76F4\u63A5\u7C98\u8D34",
+          "flutterBoxShadow - \u9634\u5F71\u8F93\u51FA\u5B8C\u6574 BoxShadow(...) \u4EE3\u7801",
+          "flutterBorder - \u8FB9\u6846\u8F93\u51FA\u5B8C\u6574 Border.all(...) \u4EE3\u7801",
+          "flutterLinearGradient - \u6E10\u53D8\u8F93\u51FA\u5B8C\u6574 LinearGradient(...) \u4EE3\u7801",
+          "flutterHint - FILL/MATCH_PARENT \u5C3A\u5BF8\u8F93\u51FA double.infinity \u63D0\u793A",
+          "flutterSvgCode - \u56FE\u6807\u8F93\u51FA\u5B8C\u6574 SvgPicture.asset(...) \u4EE3\u7801\uFF0C\u542B\u7CBE\u786E\u7684\u989C\u8272\u548C\u5C3A\u5BF8",
+          "\u5168\u8986\u76D6\u5F62\u72B6\u6392\u9664 - \u80CC\u666F\u5706\u89D2\u77E9\u5F62\u4E0D\u518D\u88AB\u8BEF\u5224\u4E3A\u56FE\u6807"
+        ]
+      }, null, 2)
+    }, {
+      type: "text",
+      text: fullScript
+    }]
+  };
+}
+
 // src/tools/skillDefinitions.ts
 function wrapAsContent(data) {
   return {
@@ -6360,6 +6444,22 @@ var skillDefinitions = [
           return wrapAsContent(await listTroubleshootingCases(params.framework));
       }
     }
+  },
+  // ==================== Sketch 设计稿工具类 ====================
+  {
+    name: "sketch_measure",
+    category: "sketch",
+    description: "\u83B7\u53D6 Sketch \u6D4B\u91CF\u811A\u672C\uFF08sketch-tools.js v4.6.0\uFF09\u3002\u8FD4\u56DE\u5DF2\u6CE8\u5165 _SKETCH_CMD \u7684\u5B8C\u6574\u811A\u672C\uFF0C\u53EF\u76F4\u63A5\u4F20\u5165 mcp_sketch_run_code \u6267\u884C\u3002\u652F\u6301 measure(\u5B8C\u6574\u753B\u677F\u6D4B\u91CF)\u3001layout(\u5E03\u5C40\u5206\u6790)\u3001style(\u6837\u5F0F\u5FEB\u68C0)\u3001svg(\u56FE\u6807\u5BFC\u51FA)\u3001auto(\u81EA\u52A8\u6A21\u5F0F)",
+    paramHints: [
+      { name: "cmd", type: "string", description: "\u6267\u884C\u6A21\u5F0F: measure(\u9ED8\u8BA4\uFF0C\u5B8C\u6574\u753B\u677F) / layout(\u5E03\u5C40\u5206\u6790) / style(\u6837\u5F0F\u68C0\u67E5) / svg(\u56FE\u6807\u5BFC\u51FA) / auto(\u81EA\u52A8\u5224\u65AD)" },
+      { name: "outputPath", type: "string", description: "SVG \u8F93\u51FA\u8DEF\u5F84\uFF08\u4EC5 cmd=svg \u65F6\u4F7F\u7528\uFF09" }
+    ],
+    handler: async (params) => {
+      return sketchMeasure({
+        cmd: params.cmd,
+        outputPath: params.outputPath
+      });
+    }
   }
 ];