mta-mcp 1.0.3 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mta-mcp",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "MTA - 智能项目分析与编码规范管理 MCP 服务器",
   "type": "module",
   "main": "./dist/index.js",

package/standards/mcp-tools/sketch-mcp.md

@@ -52,7 +52,148 @@ function getLayerColor(layer) {
 }
 ```
 
-### 问题 2：Symbol 内部样式读取
+### 问题 2：fontWeight 数值不准确（重要）
+
+**严重程度**: 🔴 高
+
+**现象**：`layer.style.fontWeight` 返回的数值（如 8）不能直接映射到 Flutter/CSS 字重。
+
+```javascript
+// ❌ 错误方式 - fontWeight 值不可靠
+layer.style.fontWeight  // 返回 8，但实际可能是 Semibold(w600) 而非 ExtraBold(w800)
+```
+
+**原因**：Sketch API 的 `fontWeight` 属性返回的是内部权重值，不是标准的 100-900 字重值。
+
+**解决方案**：通过 `sketchObject.font()` 获取真实的 PostScript 字体名称：
+
+```javascript
+function getTextFontInfo(textLayer) {
+  const result = {
+    fontSize: textLayer.style.fontSize,
+    fontFamily: textLayer.style.fontFamily,
+    fontWeight: textLayer.style.fontWeight,  // 仅供参考
+    fontName: null,  // 关键：真实字体名称
+    displayName: null
+  };
+  
+  // 获取真实字体名称
+  if (textLayer.sketchObject && textLayer.sketchObject.font) {
+    const font = textLayer.sketchObject.font();
+    if (font) {
+      result.fontName = String(font.fontName());      // 如 "PingFangSC-Semibold"
+      result.displayName = String(font.displayName()); // 如 "苹方-简 中粗体"
+      result.familyName = String(font.familyName());   // 如 "PingFang SC"
+    }
+  }
+  
+  return result;
+}
+```
+
+**PostScript 字体名到 Flutter FontWeight 映射**：
+
+| PostScript 后缀 | 中文名 | Flutter | CSS |
+|----------------|--------|---------|-----|
+| `-Thin` | 极细 | w100 | 100 |
+| `-Ultralight` | 纤细 | w200 | 200 |
+| `-Light` | 细体 | w300 | 300 |
+| `-Regular` | 常规 | w400 | 400 |
+| `-Medium` | 中等 | w500 | 500 |
+| `-Semibold` | 中粗体 | w600 | 600 |
+| `-Bold` | 粗体 | w700 | 700 |
+| `-Heavy` | 特粗 | w800 | 800 |
+| `-Black` | 黑体 | w900 | 900 |
+
+### 问题 3：图标必须从设计稿导出
+
+**严重程度**: 🔴 高
+
+**现象**：AI 可能会自己生成图标 SVG，而不是从设计稿中提取。
+
+**正确做法**：使用 `sketch.export` API 导出设计稿中的图标：
+
+```javascript
+const sketch = require('sketch');
+
+function exportIconAsSVG(layer) {
+  // 导出为 Buffer
+  const buffer = sketch.export(layer, {
+    formats: 'svg',
+    output: false,  // 关键：返回 Buffer 而非写文件
+    scales: '1'
+  });
+  
+  // Buffer 转字符串
+  const svgString = buffer.toString('utf-8');
+  
+  // 清理 SVG（移除 Sketch 生成的多余属性）
+  return svgString
+    .replace(/id="[^"]*"/g, '')
+    .replace(/sketch:type="[^"]*"/g, '')
+    .replace(/xmlns:sketch="[^"]*"/g, '')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+```
+
+**在 Flutter 中使用导出的 SVG**：
+
+```dart
+// 方式1：内联 SVG（推荐小图标）
+SvgPicture.string(
+  '''<svg>...</svg>''',
+  width: 24,
+  height: 24,
+)
+
+// 方式2：保存为文件（推荐大图标）
+// 将导出的 SVG 保存到 assets/icons/ 目录
+SvgPicture.asset('assets/icons/notification.svg')
+```
+
+### 问题 4：列表项间距测量
+
+**严重程度**: 🔴 高
+
+**现象**：列表中多个同类元素的间距可能不一致，需要逐个测量。
+
+**测量脚本**：
+
+```javascript
+function measureListSpacing(container) {
+  const children = container.layers;
+  const spacings = [];
+  
+  for (let i = 0; i < children.length - 1; i++) {
+    const current = children[i];
+    const next = children[i + 1];
+    
+    // 垂直间距 = 下一个元素的 y - (当前元素的 y + 高度)
+    const spacing = next.frame.y - (current.frame.y + current.frame.height);
+    
+    spacings.push({
+      between: `${current.name} → ${next.name}`,
+      spacing: Math.round(spacing)
+    });
+  }
+  
+  // 检查是否一致
+  const uniqueSpacings = [...new Set(spacings.map(s => s.spacing))];
+  
+  return {
+    spacings,
+    isConsistent: uniqueSpacings.length === 1,
+    recommendedSpacing: uniqueSpacings.length === 1 
+      ? uniqueSpacings[0] 
+      : Math.round(spacings.reduce((a, b) => a + b.spacing, 0) / spacings.length)
+  };
+}
+```
+
+**注意**：如果设计稿中间距不一致，应与设计师确认是故意还是误差。代码中应使用统一间距。
+
+### 问题 5：Symbol 内部样式读取
 
 **严重程度**: 🟡 中
 
@@ -69,7 +210,7 @@ if (layer.type === 'SymbolInstance') {
 }
 ```
 
-### 问题 3：阴影数组顺序
+### 问题 6：阴影数组顺序
 
 **严重程度**: 🟢 低
 
@@ -346,4 +487,11 @@ function convertGradient(gradient, framework) {
 
 **维护者**: MTA工作室  
 **创建日期**: 2026-01-20  
-**最后更新**: 2026-01-20
+**最后更新**: 2026-01-21
+
+### 更新日志
+
+| 版本 | 日期 | 更新内容 |
+|------|------|---------|
+| v1.0 | 2026-01-20 | 初始版本 |
+| v1.1 | 2026-01-21 | 新增：fontWeight不可靠问题及fontName获取方案、图标导出规范、列表间距测量脚本 |

package/standards/workflows/design-restoration.md

@@ -83,16 +83,53 @@ color: "#1C2B45"    // 丢失透明度
 
 设计稿中的字重名称需要映射为数值：
 
-| 设计稿名称 | 数值 | Flutter | CSS |
-|-----------|------|---------|-----|
-| Thin | 100 | FontWeight.w100 | font-weight: 100 |
-| Light | 300 | FontWeight.w300 | font-weight: 300 |
-| Regular | 400 | FontWeight.w400 | font-weight: 400 |
-| Medium | 500 | FontWeight.w500 | font-weight: 500 |
-| SemiBold | 600 | FontWeight.w600 | font-weight: 600 |
-| Bold | 700 | FontWeight.w700 | font-weight: 700 |
+| 设计稿名称 | PostScript 后缀 | 数值 | Flutter | CSS |
+|-----------|----------------|------|---------|-----|
+| Thin | -Thin | 100 | FontWeight.w100 | font-weight: 100 |
+| Ultralight | -Ultralight | 200 | FontWeight.w200 | font-weight: 200 |
+| Light | -Light | 300 | FontWeight.w300 | font-weight: 300 |
+| Regular | -Regular | 400 | FontWeight.w400 | font-weight: 400 |
+| Medium | -Medium | 500 | FontWeight.w500 | font-weight: 500 |
+| SemiBold | -Semibold | 600 | FontWeight.w600 | font-weight: 600 |
+| Bold | -Bold | 700 | FontWeight.w700 | font-weight: 700 |
+| Heavy/ExtraBold | -Heavy | 800 | FontWeight.w800 | font-weight: 800 |
+| Black | -Black | 900 | FontWeight.w900 | font-weight: 900 |
 
-#### 4. 行高计算差异
+> ⚠️ **重要**：Sketch API 的 `fontWeight` 属性返回的数值（如 8）不可靠！必须通过 `sketchObject.font().fontName()` 获取真实的 PostScript 字体名称（如 `PingFangSC-Semibold`），然后根据后缀映射。
+
+#### 4. 图标必须从设计稿导出
+
+**绝对禁止**：AI 自己生成图标 SVG
+
+**正确做法**：使用设计工具 API 导出设计稿中的图标
+
+```javascript
+// Sketch 导出示例
+const buffer = sketch.export(iconLayer, {
+  formats: 'svg',
+  output: false,
+  scales: '1'
+});
+const svgString = buffer.toString('utf-8');
+```
+
+**原因**：
+- 设计师精心调整过图标的线条粗细、比例、细节
+- AI 生成的图标风格可能与设计稿不一致
+- 图标是品牌视觉的重要组成部分
+
+#### 5. 列表间距必须逐个测量
+
+**问题**：同一列表中的元素间距可能不完全一致
+
+**正确做法**：测量每对相邻元素的间距，取多数值或与设计师确认
+
+```javascript
+// 间距计算公式
+spacing = nextElement.y - (currentElement.y + currentElement.height)
+```
+
+#### 6. 行高计算差异
 
 不同框架对行高的处理不同：
 
@@ -356,6 +393,7 @@ function getFigmaColor(paint) {
 | 版本 | 日期 | 更新内容 |
 |------|------|---------|
 | v1.0 | 2026-01-20 | 初始版本，包含渐变色读取问题解决方案 |
+| v1.1 | 2026-01-21 | 新增：字重映射完整表（含PostScript后缀）、图标导出强制要求、列表间距测量规范 |
 
 ---