figma-to-code-agent 0.5.0 → 0.7.0

package/dist/agent/ExecutionOrchestrator.js

@@ -0,0 +1,360 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionOrchestrator = void 0;
+/**
+ * 执行编排器
+ * 协调工具调用和处理结果
+ */
+class ExecutionOrchestrator {
+    constructor(tools) {
+        this.tools = tools;
+        this.executionStartTime = 0;
+        this.totalTokensUsed = 0;
+        this.totalApiCalls = 0;
+        this.toolsInvoked = [];
+    }
+    /**
+     * 执行策略
+     */
+    async executeStrategy(strategy, context) {
+        this.executionStartTime = Date.now();
+        this.totalTokensUsed = 0;
+        this.totalApiCalls = 0;
+        this.toolsInvoked = [];
+        const artifacts = [];
+        const errors = [];
+        try {
+            // 保存初始检查点
+            this.saveCheckpoint(context, 'strategy_start', {
+                strategyId: strategy.id,
+                step: 0,
+            });
+            // 更新任务状态
+            context.taskState.phase = 'executing';
+            context.taskState.currentStep = strategy.name;
+            context.taskState.progress = 0;
+            // 执行每个步骤
+            for (let i = 0; i < strategy.steps.length; i++) {
+                const step = strategy.steps[i];
+                // 更新进度
+                context.taskState.progress = Math.floor(((i + 1) / strategy.steps.length) * 100);
+                context.taskState.currentStep = `执行步骤 ${i + 1}/${strategy.steps.length}: ${step.action}`;
+                try {
+                    // 调用工具
+                    const result = await this.invokeToolWithRetry(step, context);
+                    // 处理结果
+                    if (result.success) {
+                        // 如果结果包含生成的文件，添加到 artifacts
+                        if (result.data?.files) {
+                            for (const file of result.data.files) {
+                                artifacts.push({
+                                    id: `${Date.now()}-${file.path}`,
+                                    type: 'code',
+                                    path: file.path,
+                                    content: file.content,
+                                    version: 1,
+                                    timestamp: Date.now(),
+                                });
+                            }
+                        }
+                        // 累计指标
+                        this.totalApiCalls++;
+                        if (result.metadata.tokensUsed) {
+                            this.totalTokensUsed += result.metadata.tokensUsed;
+                        }
+                        this.toolsInvoked.push(result.metadata.toolName);
+                        // 保存检查点
+                        this.saveCheckpoint(context, `step_${i}_complete`, {
+                            step: i,
+                            result: result.data,
+                        });
+                    }
+                    else {
+                        // 工具执行失败
+                        errors.push({
+                            type: 'tool_execution_failed',
+                            message: `工具 ${step.tool} 执行失败: ${result.error?.message}`,
+                            context: { step: i, tool: step.tool },
+                            recoverable: !!step.fallbackTool,
+                        });
+                        // 如果错误不可恢复，停止执行
+                        if (!step.fallbackTool) {
+                            break;
+                        }
+                    }
+                }
+                catch (error) {
+                    // 捕获未预期的错误
+                    errors.push({
+                        type: 'unexpected_error',
+                        message: error instanceof Error ? error.message : String(error),
+                        context: { step: i, tool: step.tool },
+                        recoverable: false,
+                    });
+                    break;
+                }
+            }
+            // 更新最终状态
+            context.taskState.progress = 100;
+            context.taskState.phase = errors.length > 0 ? 'reviewing' : 'completed';
+            // 分析执行结果并决定下一步
+            const nextAction = this.analyzeResults(artifacts, errors, context);
+            return {
+                success: errors.length === 0,
+                artifacts,
+                errors,
+                metrics: this.getMetrics(),
+                nextAction,
+            };
+        }
+        catch (error) {
+            // 顶层错误处理
+            errors.push({
+                type: 'orchestrator_error',
+                message: error instanceof Error ? error.message : String(error),
+                context: { strategy: strategy.id },
+                recoverable: false,
+            });
+            return {
+                success: false,
+                artifacts,
+                errors,
+                metrics: this.getMetrics(),
+                nextAction: 'ask_user',
+            };
+        }
+    }
+    /**
+     * 调用工具（带重试和回退）
+     */
+    async invokeToolWithRetry(step, context) {
+        const tool = this.tools.get(step.tool);
+        if (!tool) {
+            // 工具不存在，尝试回退
+            if (step.fallbackTool) {
+                return this.invokeFallbackTool(step, context);
+            }
+            return {
+                success: false,
+                data: null,
+                error: new Error(`工具 ${step.tool} 不存在`),
+                metadata: {
+                    duration: 0,
+                    toolName: step.tool,
+                },
+            };
+        }
+        try {
+            // 检查工具是否可用
+            const isAvailable = await tool.isAvailable();
+            if (!isAvailable) {
+                // 工具不可用，尝试回退
+                if (step.fallbackTool) {
+                    return this.invokeFallbackTool(step, context);
+                }
+                return {
+                    success: false,
+                    data: null,
+                    error: new Error(`工具 ${step.tool} 不可用`),
+                    metadata: {
+                        duration: 0,
+                        toolName: step.tool,
+                    },
+                };
+            }
+            // 执行工具
+            return await this.invokeTool(tool, step.inputs);
+        }
+        catch (error) {
+            // 工具执行失败，尝试回退
+            if (step.fallbackTool) {
+                return this.invokeFallbackTool(step, context);
+            }
+            return {
+                success: false,
+                data: null,
+                error: error instanceof Error ? error : new Error(String(error)),
+                metadata: {
+                    duration: 0,
+                    toolName: step.tool,
+                },
+            };
+        }
+    }
+    /**
+     * 调用回退工具
+     */
+    async invokeFallbackTool(step, _context) {
+        if (!step.fallbackTool) {
+            return {
+                success: false,
+                data: null,
+                error: new Error('没有可用的回退工具'),
+                metadata: {
+                    duration: 0,
+                    toolName: step.tool,
+                },
+            };
+        }
+        const fallbackTool = this.tools.get(step.fallbackTool);
+        if (!fallbackTool) {
+            return {
+                success: false,
+                data: null,
+                error: new Error(`回退工具 ${step.fallbackTool} 不存在`),
+                metadata: {
+                    duration: 0,
+                    toolName: step.fallbackTool,
+                },
+            };
+        }
+        try {
+            return await this.invokeTool(fallbackTool, step.inputs);
+        }
+        catch (error) {
+            return {
+                success: false,
+                data: null,
+                error: error instanceof Error ? error : new Error(String(error)),
+                metadata: {
+                    duration: 0,
+                    toolName: step.fallbackTool,
+                },
+            };
+        }
+    }
+    /**
+     * 调用工具
+     */
+    async invokeTool(tool, inputs) {
+        const startTime = Date.now();
+        try {
+            const result = await tool.execute(inputs);
+            const duration = Date.now() - startTime;
+            return {
+                success: true,
+                data: result,
+                metadata: {
+                    duration,
+                    toolName: tool.name,
+                },
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            return {
+                success: false,
+                data: null,
+                error: error instanceof Error ? error : new Error(String(error)),
+                metadata: {
+                    duration,
+                    toolName: tool.name,
+                },
+            };
+        }
+    }
+    /**
+     * 处理工具失败
+     */
+    async handleToolFailure(tool, error, fallback) {
+        // 记录错误
+        console.error(`工具 ${tool.name} 执行失败:`, error);
+        // 如果有回退工具，尝试使用
+        if (fallback) {
+            try {
+                return await this.invokeTool(fallback, {});
+            }
+            catch (fallbackError) {
+                return {
+                    success: false,
+                    data: null,
+                    error: fallbackError instanceof Error ? fallbackError : new Error(String(fallbackError)),
+                    metadata: {
+                        duration: 0,
+                        toolName: fallback.name,
+                    },
+                };
+            }
+        }
+        return {
+            success: false,
+            data: null,
+            error,
+            metadata: {
+                duration: 0,
+                toolName: tool.name,
+            },
+        };
+    }
+    /**
+     * 保存检查点
+     */
+    saveCheckpoint(context, checkpointId, data) {
+        const checkpoint = {
+            id: checkpointId,
+            timestamp: Date.now(),
+            phase: context.taskState.phase,
+            data,
+        };
+        context.taskState.checkpoints.push(checkpoint);
+    }
+    /**
+     * 从检查点恢复
+     */
+    async restoreFromCheckpoint(context, checkpointId) {
+        const checkpoint = context.taskState.checkpoints.find((cp) => cp.id === checkpointId);
+        if (!checkpoint) {
+            return false;
+        }
+        // 恢复任务状态
+        context.taskState.phase = checkpoint.phase;
+        // 恢复执行数据
+        // 这里可以根据 checkpoint.data 恢复具体的执行状态
+        return true;
+    }
+    /**
+     * 分析执行结果并决定下一步
+     */
+    analyzeResults(artifacts, errors, context) {
+        // 如果有不可恢复的错误，询问用户
+        if (errors.some((e) => !e.recoverable)) {
+            return 'ask_user';
+        }
+        // 如果没有生成任何产物，询问用户
+        if (artifacts.length === 0) {
+            return 'ask_user';
+        }
+        // 如果有可恢复的错误，建议迭代
+        if (errors.length > 0) {
+            return 'iterate';
+        }
+        // 如果用户偏好是详细模式，询问是否需要改进
+        if (context.userPreferences.verbosity === 'detailed') {
+            return 'ask_user';
+        }
+        // 否则完成
+        return 'complete';
+    }
+    /**
+     * 获取执行指标
+     */
+    getMetrics() {
+        return {
+            totalDuration: Date.now() - this.executionStartTime,
+            tokensUsed: this.totalTokensUsed,
+            apiCalls: this.totalApiCalls,
+            toolsInvoked: [...this.toolsInvoked],
+        };
+    }
+    /**
+     * 重置指标
+     */
+    resetMetrics() {
+        this.executionStartTime = 0;
+        this.totalTokensUsed = 0;
+        this.totalApiCalls = 0;
+        this.toolsInvoked = [];
+    }
+}
+exports.ExecutionOrchestrator = ExecutionOrchestrator;
+//# sourceMappingURL=ExecutionOrchestrator.js.map

package/dist/agent/ExecutionOrchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionOrchestrator.js","sourceRoot":"","sources":["../../src/agent/ExecutionOrchestrator.ts"],"names":[],"mappings":"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"}

package/dist/agent/IntentUnderstandingEngine.d.ts

@@ -0,0 +1,43 @@
+import type { LLMProvider } from '../llm/types';
+import type { Intent, ConversationContext } from './types';
+/**
+ * 意图理解引擎
+ * 解析用户输入并识别意图
+ */
+export declare class IntentUnderstandingEngine {
+    private llm?;
+    constructor(llm?: LLMProvider | undefined);
+    /**
+     * 分析用户输入并提取意图
+     */
+    analyzeInput(input: string, context: ConversationContext): Promise<Intent>;
+    /**
+     * 提取 Figma URL 中的文件 ID 和节点 ID
+     */
+    private extractFigmaInput;
+    /**
+     * 使用 LLM 分析意图
+     */
+    private analyzeWithLLM;
+    /**
+     * 构建 LLM prompt
+     */
+    private buildLLMPrompt;
+    /**
+     * 解析 LLM 响应
+     */
+    private parseLLMResponse;
+    /**
+     * 使用基于规则的分析
+     */
+    private analyzeWithRules;
+    /**
+     * 识别缺失的信息
+     */
+    identifyMissingInfo(intent: Intent): string[];
+    /**
+     * 生成澄清问题
+     */
+    generateClarificationQuestions(missingInfo: string[]): string[];
+}
+//# sourceMappingURL=IntentUnderstandingEngine.d.ts.map

package/dist/agent/IntentUnderstandingEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentUnderstandingEngine.d.ts","sourceRoot":"","sources":["../../src/agent/IntentUnderstandingEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAc,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEvE;;;GAGG;AACH,qBAAa,yBAAyB;IACxB,OAAO,CAAC,GAAG,CAAC;gBAAJ,GAAG,CAAC,EAAE,WAAW,YAAA;IAErC;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAahF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuCzB;;OAEG;YACW,cAAc;IAuB5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAyCtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwExB;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAkB7C;;OAEG;IACH,8BAA8B,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAqBhE"}

package/dist/agent/IntentUnderstandingEngine.js

@@ -0,0 +1,261 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntentUnderstandingEngine = void 0;
+/**
+ * 意图理解引擎
+ * 解析用户输入并识别意图
+ */
+class IntentUnderstandingEngine {
+    constructor(llm) {
+        this.llm = llm;
+    }
+    /**
+     * 分析用户输入并提取意图
+     */
+    async analyzeInput(input, context) {
+        // 首先尝试提取 Figma 输入
+        const figmaInput = this.extractFigmaInput(input);
+        // 如果有 LLM，使用 LLM 进行深度分析
+        if (this.llm) {
+            return this.analyzeWithLLM(input, figmaInput, context);
+        }
+        // 否则使用基于规则的分析
+        return this.analyzeWithRules(input, figmaInput, context);
+    }
+    /**
+     * 提取 Figma URL 中的文件 ID 和节点 ID
+     */
+    extractFigmaInput(input) {
+        // 匹配 Figma URL 格式
+        // https://www.figma.com/file/{fileKey}/{title}?node-id={nodeId}
+        // https://www.figma.com/design/{fileKey}/{title}?node-id={nodeId}
+        const urlPattern = /https?:\/\/(?:www\.)?figma\.com\/(?:file|design)\/([a-zA-Z0-9]+)(?:\/[^?]*)?(?:\?.*node-id=([^&]+))?/;
+        const match = input.match(urlPattern);
+        if (match) {
+            const fileKey = match[1];
+            const nodeId = match[2]?.replace(/-/g, ':'); // Convert node-id format
+            return {
+                type: 'url',
+                url: match[0],
+                fileKey,
+                nodeIds: nodeId ? [nodeId] : undefined,
+            };
+        }
+        // 检查是否直接提供了文件 ID
+        const fileIdPattern = /\b([a-zA-Z0-9]{22,})\b/;
+        const fileIdMatch = input.match(fileIdPattern);
+        if (fileIdMatch) {
+            return {
+                type: 'file_id',
+                fileKey: fileIdMatch[1],
+            };
+        }
+        // 检查是否要求使用当前打开的文件（MCP）
+        if (input.includes('当前') || input.includes('current') || input.includes('opened')) {
+            return {
+                type: 'mcp_current',
+            };
+        }
+        return null;
+    }
+    /**
+     * 使用 LLM 分析意图
+     */
+    async analyzeWithLLM(input, figmaInput, context) {
+        const prompt = this.buildLLMPrompt(input, figmaInput, context);
+        try {
+            const response = await this.llm.chat([
+                {
+                    role: 'user',
+                    content: prompt,
+                },
+            ]);
+            // 解析 LLM 响应
+            return this.parseLLMResponse(response.content, figmaInput);
+        }
+        catch (error) {
+            console.warn('LLM analysis failed, falling back to rules:', error);
+            return this.analyzeWithRules(input, figmaInput, context);
+        }
+    }
+    /**
+     * 构建 LLM prompt
+     */
+    buildLLMPrompt(input, figmaInput, context) {
+        const historyContext = context.history
+            .slice(-5) // 最近 5 条消息
+            .map((m) => `${m.role}: ${m.content}`)
+            .join('\n');
+        return `你是一个 Figma 设计转代码的 AI Agent。分析用户的意图并提取关键信息。
+
+用户输入：${input}
+
+${figmaInput ? `检测到 Figma 输入：${JSON.stringify(figmaInput)}` : ''}
+
+${historyContext ? `对话历史：\n${historyContext}` : ''}
+
+请分析用户意图并以 JSON 格式返回：
+{
+  "type": "generate_new" | "update_existing" | "optimize" | "analyze",
+  "targetFramework": "react" | "vue" | null,
+  "styleMode": "css-modules" | "tailwind" | "css" | null,
+  "qualityMode": "fast" | "balanced" | "high" | null,
+  "additionalRequirements": ["requirement1", "requirement2"]
+}
+
+规则：
+- 如果用户说"生成"、"创建"、"转换"，type 为 "generate_new"
+- 如果用户说"更新"、"修改"、"改进"，type 为 "update_existing"
+- 如果用户说"优化"、"提升性能"，type 为 "optimize"
+- 如果用户说"分析"、"检查"、"查看"，type 为 "analyze"
+- 如果提到 React/Vue，设置 targetFramework
+- 如果提到 Tailwind/CSS Modules/CSS，设置 styleMode
+- 如果提到"快速"、"原型"，qualityMode 为 "fast"
+- 如果提到"高质量"、"生产"，qualityMode 为 "high"
+- 提取其他特殊要求到 additionalRequirements
+
+只返回 JSON，不要其他解释。`;
+    }
+    /**
+     * 解析 LLM 响应
+     */
+    parseLLMResponse(response, figmaInput) {
+        try {
+            // 提取 JSON 部分
+            const jsonMatch = response.match(/\{[\s\S]*\}/);
+            if (!jsonMatch) {
+                throw new Error('No JSON found in response');
+            }
+            const parsed = JSON.parse(jsonMatch[0]);
+            return {
+                type: parsed.type || 'generate_new',
+                figmaInput: figmaInput || { type: 'url' },
+                targetFramework: parsed.targetFramework || undefined,
+                styleMode: parsed.styleMode || undefined,
+                qualityMode: parsed.qualityMode || 'balanced',
+                additionalRequirements: parsed.additionalRequirements || [],
+            };
+        }
+        catch (error) {
+            console.warn('Failed to parse LLM response:', error);
+            // 返回默认意图
+            return {
+                type: 'generate_new',
+                figmaInput: figmaInput || { type: 'url' },
+                additionalRequirements: [],
+            };
+        }
+    }
+    /**
+     * 使用基于规则的分析
+     */
+    analyzeWithRules(input, figmaInput, context) {
+        const lowerInput = input.toLowerCase();
+        // 确定意图类型
+        let type = 'generate_new';
+        if (lowerInput.includes('更新') || lowerInput.includes('修改') || lowerInput.includes('update') || lowerInput.includes('modify')) {
+            type = 'update_existing';
+        }
+        else if (lowerInput.includes('优化') || lowerInput.includes('optimize') || lowerInput.includes('improve')) {
+            type = 'optimize';
+        }
+        else if (lowerInput.includes('分析') || lowerInput.includes('analyze') || lowerInput.includes('check')) {
+            type = 'analyze';
+        }
+        // 提取框架
+        let targetFramework;
+        if (lowerInput.includes('react')) {
+            targetFramework = 'react';
+        }
+        else if (lowerInput.includes('vue')) {
+            targetFramework = 'vue';
+        }
+        else if (context.userPreferences.defaultFramework) {
+            targetFramework = context.userPreferences.defaultFramework;
+        }
+        // 提取样式模式
+        let styleMode;
+        if (lowerInput.includes('tailwind')) {
+            styleMode = 'tailwind';
+        }
+        else if (lowerInput.includes('css module') || lowerInput.includes('css-module')) {
+            styleMode = 'css-modules';
+        }
+        else if (lowerInput.includes('css')) {
+            styleMode = 'css';
+        }
+        else if (context.userPreferences.defaultStyleMode) {
+            styleMode = context.userPreferences.defaultStyleMode;
+        }
+        // 提取质量模式
+        let qualityMode = 'balanced';
+        if (lowerInput.includes('快速') || lowerInput.includes('fast') || lowerInput.includes('quick') || lowerInput.includes('原型') || lowerInput.includes('prototype')) {
+            qualityMode = 'fast';
+        }
+        else if (lowerInput.includes('高质量') || lowerInput.includes('high quality') || lowerInput.includes('生产') || lowerInput.includes('production')) {
+            qualityMode = 'high';
+        }
+        // 提取额外要求
+        const additionalRequirements = [];
+        if (lowerInput.includes('typescript') || lowerInput.includes('ts')) {
+            additionalRequirements.push('typescript');
+        }
+        if (lowerInput.includes('响应式') || lowerInput.includes('responsive')) {
+            additionalRequirements.push('responsive');
+        }
+        if (lowerInput.includes('暗色模式') || lowerInput.includes('dark mode')) {
+            additionalRequirements.push('dark_mode');
+        }
+        if (lowerInput.includes('无障碍') || lowerInput.includes('accessibility') || lowerInput.includes('a11y')) {
+            additionalRequirements.push('accessibility');
+        }
+        return {
+            type,
+            figmaInput: figmaInput || { type: 'url' },
+            targetFramework,
+            styleMode,
+            qualityMode,
+            additionalRequirements,
+        };
+    }
+    /**
+     * 识别缺失的信息
+     */
+    identifyMissingInfo(intent) {
+        const missing = [];
+        if (!intent.figmaInput || (!intent.figmaInput.url && !intent.figmaInput.fileKey)) {
+            missing.push('figma_input');
+        }
+        if (!intent.targetFramework) {
+            missing.push('target_framework');
+        }
+        if (!intent.styleMode) {
+            missing.push('style_mode');
+        }
+        return missing;
+    }
+    /**
+     * 生成澄清问题
+     */
+    generateClarificationQuestions(missingInfo) {
+        const questions = [];
+        for (const info of missingInfo) {
+            switch (info) {
+                case 'figma_input':
+                    questions.push('请提供 Figma 设计链接或文件 ID');
+                    break;
+                case 'target_framework':
+                    questions.push('您希望生成 React 还是 Vue 组件？');
+                    break;
+                case 'style_mode':
+                    questions.push('您希望使用哪种样式方案？(CSS Modules / Tailwind / 纯 CSS)');
+                    break;
+                default:
+                    questions.push(`请提供 ${info}`);
+            }
+        }
+        return questions;
+    }
+}
+exports.IntentUnderstandingEngine = IntentUnderstandingEngine;
+//# sourceMappingURL=IntentUnderstandingEngine.js.map