@xiehuan123/figma-mcp-server 1.0.1 → 1.0.2

package/README.md

@@ -126,14 +126,18 @@ Figma → Settings → Personal Access Tokens → 创建 token
 
 ```
 .figma-temp/
-  logs/    # API 日志
-  svg/     # 导出的 SVG 文件
+  raw/       # Figma API 原始响应数据
+  optimized/ # 优化后的 AI 友好数据
+  svg/       # 导出的 SVG 文件
+  icons/     # 图标索引 (index.json)
+  logs/      # API 调用日志
 ```
 
 **生命周期规则：**
 - MCP Server 启动时自动清空上一次的 `.figma-temp/` 目录
-- 重新创建空的 `logs/` 和 `svg/` 子目录
+- 重新创建完整的子目录结构（raw/、optimized/、svg/、icons/、logs/）
 - 会话期间的所有数据保留到下次启动
+- 每次会话完全隔离，不会跨会话保留任何数据
 
 ## 核心特性
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiehuan123/figma-mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Figma MCP Server - 将 Figma API 数据处理成 AI 友好格式",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -81,6 +81,9 @@ server.tool(
     const nodeData = data.nodes[normalizedId];
     if (!nodeData) return { content: [{ type: "text", text: `节点 ${normalizedId} 不存在` }] };
 
+    // 存储原始数据
+    tempManager.writeRaw(fileKey, normalizedId, nodeData);
+
     const simplified = simplifyNode(nodeData.document, 0, depth);
     const summary = generateSummary(simplified);
 
@@ -91,6 +94,18 @@ server.tool(
       try {
         const svgResults = await svgExporter.exportAndDownload(fileKey, exportableNodes);
         svgSection = svgExporter.formatExportResults(svgResults);
+        // 记录图标到汇总索引
+        const iconEntries = [];
+        for (const [nodeIdKey, svgInfo] of svgResults.entries()) {
+          iconEntries.push({
+            fileKey,
+            nodeId: nodeIdKey,
+            name: svgInfo.filename || nodeIdKey,
+            svgPath: svgInfo.path || null,
+            source: "get_node",
+          });
+        }
+        if (iconEntries.length > 0) tempManager.addIcons(iconEntries);
       } catch (e) {
         svgSection = `\n\n# SVG Export Error\n${e.message}`;
       }
@@ -125,6 +140,9 @@ server.tool(
         varSection = `\n\n# CSS 变量 (从节点绑定提取)\n:root {\n${varLines.join("\n")}\n}`;
       }
 
+      // 存储优化后数据
+      tempManager.writeOptimized(fileKey, normalizedId, { summary, condensed, variables: nodeVarMap });
+
       return {
         content: [{
           type: "text",
@@ -140,6 +158,9 @@ server.tool(
       variables = nodeVarMap;
     }
 
+    // 存储优化后数据
+    tempManager.writeOptimized(fileKey, normalizedId, { summary, tree: simplified, variables });
+
     // 日志记录
     logger.logOptimized("get_node", { fileKey, nodeId: normalizedId, format }, { summary, variables });
 
@@ -320,6 +341,19 @@ server.tool(
       }
 
       const output = svgExporter.formatExportResults(results);
+      // 记录图标到汇总索引
+      const iconEntries = [];
+      for (const [nodeIdKey, svgInfo] of results.entries()) {
+        iconEntries.push({
+          fileKey,
+          nodeId: nodeIdKey,
+          name: svgInfo.filename || nodeIdKey,
+          svgPath: svgInfo.path || null,
+          source: "export_svg",
+        });
+      }
+      if (iconEntries.length > 0) tempManager.addIcons(iconEntries);
+
       logger.logOptimized("export_svg", { fileKey, nodeIds: ids }, { exportedCount: results.size });
       return { content: [{ type: "text", text: output }] };
     } catch (e) {
@@ -424,6 +458,9 @@ server.tool(
     const nodeData = nodeResult.nodes[normalizedId];
     if (!nodeData) return { content: [{ type: "text", text: `节点 ${normalizedId} 不存在` }] };
 
+    // 存储原始数据
+    tempManager.writeRaw(fileKey, normalizedId, nodeData);
+
     const node = nodeData.document;
 
     // 构建 variable 映射
@@ -490,11 +527,34 @@ server.tool(
         const svgResults = await svgExporter.exportAndDownload(fileKey, exportableNodes);
         const svgSection = svgExporter.formatExportResults(svgResults);
         if (svgSection) output.push(svgSection);
+        // 记录图标到汇总索引
+        const iconEntries = [];
+        for (const [nodeIdKey, svgInfo] of svgResults.entries()) {
+          iconEntries.push({
+            fileKey,
+            nodeId: nodeIdKey,
+            name: svgInfo.filename || nodeIdKey,
+            svgPath: svgInfo.path || null,
+            source: "get_page_for_codegen",
+          });
+        }
+        if (iconEntries.length > 0) tempManager.addIcons(iconEntries);
       } catch (e) {
         output.push(`\n## SVG Export Error\n${e.message}`);
       }
     }
 
+    // 存储优化后数据
+    tempManager.writeOptimized(fileKey, normalizedId, {
+      nodeName: node.name,
+      nodeType: node.type,
+      structure,
+      colors: [...colors],
+      fonts: [...fonts],
+      components,
+      tokens: tokensSummary || null,
+    });
+
     // 日志记录
     logger.logOptimized("get_page_for_codegen", { fileKey, nodeId: normalizedId }, { nodeType: node.type, nodeName: node.name });
 

package/src/svg-exporter.js

@@ -55,12 +55,12 @@ export class SvgExporter {
    * @returns {string|null} 角色名或 null
    */
   _shouldExport(node) {
-    // VECTOR 类型节点
-    if (VECTOR_TYPES.has(node.type)) {
-      return "vector";
+    // 跳过组件实例内部的子节点（ID 含分号表示是实例内部节点）
+    if (node.id && node.id.includes(";")) {
+      return null;
     }
 
-    // 名称匹配图标模式
+    // 名称匹配图标模式（优先级最高）
     if (ICON_PATTERN.test(node.name)) {
       return "icon";
     }
@@ -70,6 +70,11 @@ export class SvgExporter {
       return "icon";
     }
 
+    // 顶层 VECTOR 类型节点（非嵌套在 frame 深处的装饰性向量）
+    if (VECTOR_TYPES.has(node.type)) {
+      return "vector";
+    }
+
     // 包含 IMAGE fill
     if (this._hasImageFill(node)) {
       return "image";
@@ -120,6 +125,11 @@ export class SvgExporter {
         }
 
         const svgContent = await response.text();
+        if (!svgContent || svgContent.trim().length === 0) {
+          console.error(`[svg-exporter] Empty SVG content for ${nodeId}, skipping`);
+          return;
+        }
+
         const nodeInfo = nodeMap.get(nodeId);
         const filename = this._buildFilename(nodeInfo);
 
@@ -151,7 +161,7 @@ export class SvgExporter {
       .replace(/-+/g, "-")
       .replace(/^-|-$/g, "")
       .slice(0, 40);
-    const id = nodeInfo.id.replace(":", "-");
+    const id = nodeInfo.id.replace(/[:.;]/g, "-");
     return `${role}-${name}_${id}.svg`;
   }
 

package/src/temp-manager.js

@@ -15,6 +15,10 @@ export class TempManager {
     this.tempDir = path.join(projectRoot, ".figma-temp");
     this.logsDir = path.join(this.tempDir, "logs");
     this.svgDir = path.join(this.tempDir, "svg");
+    this.rawDir = path.join(this.tempDir, "raw");
+    this.optimizedDir = path.join(this.tempDir, "optimized");
+    this.iconsDir = path.join(this.tempDir, "icons");
+    this.iconsIndexPath = path.join(this.iconsDir, "index.json");
   }
 
   /** 初始化：清空旧数据，创建新目录 */
@@ -24,6 +28,11 @@ export class TempManager {
     }
     fs.mkdirSync(this.logsDir, { recursive: true });
     fs.mkdirSync(this.svgDir, { recursive: true });
+    fs.mkdirSync(this.rawDir, { recursive: true });
+    fs.mkdirSync(this.optimizedDir, { recursive: true });
+    fs.mkdirSync(this.iconsDir, { recursive: true });
+    // 初始化图标索引
+    fs.writeFileSync(this.iconsIndexPath, JSON.stringify({ icons: [] }, null, 2), "utf-8");
   }
 
   getTempDir() {
@@ -38,6 +47,18 @@ export class TempManager {
     return this.svgDir;
   }
 
+  getRawDir() {
+    return this.rawDir;
+  }
+
+  getOptimizedDir() {
+    return this.optimizedDir;
+  }
+
+  getIconsDir() {
+    return this.iconsDir;
+  }
+
   /** 写入 SVG 文件，返回完整路径 */
   writeSvg(filename, content) {
     const filePath = path.join(this.svgDir, filename);
@@ -45,6 +66,70 @@ export class TempManager {
     return filePath;
   }
 
+  /** 写入原始 Figma API 数据 */
+  writeRaw(fileKey, nodeId, data) {
+    const safeNodeId = nodeId.replace(/:/g, "-");
+    const filename = `${fileKey}_${safeNodeId}.json`;
+    const filePath = path.join(this.rawDir, filename);
+    const content = JSON.stringify(data, null, 2);
+    fs.writeFileSync(filePath, content, "utf-8");
+    return filePath;
+  }
+
+  /** 写入优化后的数据 */
+  writeOptimized(fileKey, nodeId, data) {
+    const safeNodeId = nodeId.replace(/:/g, "-");
+    const filename = `${fileKey}_${safeNodeId}.json`;
+    const filePath = path.join(this.optimizedDir, filename);
+    const content = JSON.stringify(data, null, 2);
+    fs.writeFileSync(filePath, content, "utf-8");
+    return filePath;
+  }
+
+  /** 添加图标到汇总索引 */
+  addIcon(entry) {
+    const index = this._readIconsIndex();
+    const existing = index.icons.findIndex(
+      (i) => i.nodeId === entry.nodeId && i.fileKey === entry.fileKey
+    );
+    if (existing >= 0) {
+      index.icons[existing] = { ...index.icons[existing], ...entry, updatedAt: new Date().toISOString() };
+    } else {
+      index.icons.push({ ...entry, createdAt: new Date().toISOString() });
+    }
+    fs.writeFileSync(this.iconsIndexPath, JSON.stringify(index, null, 2), "utf-8");
+  }
+
+  /** 批量添加图标 */
+  addIcons(entries) {
+    const index = this._readIconsIndex();
+    for (const entry of entries) {
+      const existing = index.icons.findIndex(
+        (i) => i.nodeId === entry.nodeId && i.fileKey === entry.fileKey
+      );
+      if (existing >= 0) {
+        index.icons[existing] = { ...index.icons[existing], ...entry, updatedAt: new Date().toISOString() };
+      } else {
+        index.icons.push({ ...entry, createdAt: new Date().toISOString() });
+      }
+    }
+    fs.writeFileSync(this.iconsIndexPath, JSON.stringify(index, null, 2), "utf-8");
+  }
+
+  /** 获取图标索引 */
+  getIconsIndex() {
+    return this._readIconsIndex();
+  }
+
+  _readIconsIndex() {
+    try {
+      const content = fs.readFileSync(this.iconsIndexPath, "utf-8");
+      return JSON.parse(content);
+    } catch {
+      return { icons: [] };
+    }
+  }
+
   /** 写入日志文件（非阻塞） */
   writeLog(toolName, type, data) {
     const timestamp = new Date().toISOString().replace(/[:.]/g, "-");