apifox-workspace-mcp 1.1.2 → 1.1.4

package/dist/core/parser/md-parser.js

@@ -0,0 +1,100 @@
+/**
+ * Markdown 接口文档解析器
+ * 从接口的 md 文件中解析接口详情
+ */
+import axios from 'axios';
+/**
+ * 从接口 md 文件读取接口详情
+ * @param docUrl 接口 md 文件的 URL
+ * @returns 接口详情
+ */
+export async function parseInterfaceFromMd(docUrl) {
+    try {
+        // 确保 URL 以 .md 结尾
+        const normalizedUrl = docUrl.endsWith('.md') ? docUrl : `${docUrl}.md`;
+        // 获取 md 文件内容
+        const response = await axios.get(normalizedUrl, { timeout: 10000 });
+        const content = typeof response.data === 'string' ? response.data : String(response.data);
+        // 解析接口详情
+        const detail = parseMdContent(content, normalizedUrl);
+        return detail;
+    }
+    catch (error) {
+        throw new Error(`从 md 文件读取接口详情失败: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * 解析 md 文件内容，提取接口详情
+ * @param content md 文件内容
+ * @param docUrl md 文件 URL（用于提取接口 ID）
+ * @returns 接口详情
+ */
+function parseMdContent(content, docUrl) {
+    // 从 URL 中提取接口 ID
+    const idMatch = docUrl.match(/api-(\d+)\.md/);
+    const interfaceId = idMatch ? idMatch[1] : '';
+    // 提取接口名称（从标题或第一个 # 标题）
+    const titleMatch = content.match(/^#+\s+(.+)$/m);
+    const name = titleMatch ? titleMatch[1].trim() : '未命名接口';
+    // 提取方法（从 x-run-in-apifox 或路径中）
+    let method = 'GET';
+    const methodMatch = content.match(/method:\s*(\w+)/i) ||
+        content.match(/(?:GET|POST|PUT|DELETE|PATCH|OPTIONS|HEAD)\s+/i);
+    if (methodMatch) {
+        method = methodMatch[1]?.toUpperCase() || methodMatch[0].trim().toUpperCase();
+    }
+    // 提取路径
+    let path = '/';
+    const pathMatch = content.match(/path:\s*(.+)/i) || content.match(/\/api\/[^\s\)]+/);
+    if (pathMatch) {
+        path = pathMatch[1]?.trim() || pathMatch[0].trim();
+    }
+    // 提取描述（从第一个段落或 description 字段）
+    let description;
+    const descMatch = content.match(/description:\s*(.+)/i) || content.match(/^([^#\n]+)/m);
+    if (descMatch) {
+        description = descMatch[1]?.trim();
+    }
+    // 提取请求参数（从 request 部分或 JSON Schema）
+    let request;
+    const requestMatch = content.match(/##\s+请求[参数]*[\s\S]*?```(?:json|typescript)?\s*([\s\S]*?)```/i);
+    if (requestMatch) {
+        try {
+            const requestData = JSON.parse(requestMatch[1]);
+            request = {
+                body: {
+                    json: requestData,
+                },
+            };
+        }
+        catch {
+            // 解析失败，忽略
+        }
+    }
+    // 提取响应参数（从 response 部分或 JSON Schema）
+    let response;
+    const responseMatch = content.match(/##\s+响应[示例]*[\s\S]*?```(?:json|typescript)?\s*([\s\S]*?)```/i);
+    if (responseMatch) {
+        try {
+            const responseData = JSON.parse(responseMatch[1]);
+            response = {
+                body: {
+                    json: responseData,
+                },
+            };
+        }
+        catch {
+            // 解析失败，忽略
+        }
+    }
+    return {
+        id: interfaceId,
+        name,
+        method,
+        path,
+        description,
+        request,
+        response,
+    };
+}
+//# sourceMappingURL=md-parser.js.map

package/dist/core/parser/md-parser.js.map

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

package/dist/server/handlers/assistant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/assistant.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,SAAS,EACT,YAAY,EAGb,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,gBAAgB;;;;;GAgF/E"}
+{"version":3,"file":"assistant.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/assistant.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,SAAS,EACT,YAAY,EAGb,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,gBAAgB;;;;;GAmF/E"}

package/dist/server/handlers/assistant.js

@@ -35,7 +35,10 @@ export async function handleAssistant(args, ctx) {
             }
             return handleGetInterfaceDetail({
                 projectName: intent.projectName ?? lastProject?.projectName,
+                projectId: intent.projectId,
+                shareId: intent.shareId,
                 interfaceId: targetId,
+                url: intent.url,
             }, { projectRoot, configManager, mcpBridge, contextStore });
         }
         case 'generateArtifacts': {

package/dist/server/handlers/assistant.js.map

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

package/dist/server/handlers/get-interface-detail.d.ts

@@ -2,7 +2,9 @@ import { ConfigManager, McpBridge, ContextStore } from '../../core/index.js';
 export interface GetInterfaceDetailArgs {
     projectName?: string;
     projectId?: string;
+    shareId?: string;
     interfaceId: string;
+    url?: string;
 }
 export interface GetInterfaceDetailContext {
     projectRoot: string;

package/dist/server/handlers/get-interface-detail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-interface-detail.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/get-interface-detail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AAS/F,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,sBAAsB,EAC5B,GAAG,EAAE,yBAAyB;;;;;;;;;;;;GAyE/B"}
+{"version":3,"file":"get-interface-detail.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/get-interface-detail.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,SAAS,EACT,YAAY,EAMb,MAAM,qBAAqB,CAAC;AAS7B,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,sBAAsB,EAC5B,GAAG,EAAE,yBAAyB;;;;;;;;;;;;GA8K/B"}

package/dist/server/handlers/get-interface-detail.js

@@ -1,14 +1,95 @@
-import { generateArtifact } from '../../core/index.js';
+import { generateArtifact, UnifiedCacheManager, parseApifoxUrl, parseInterfaceFromMd, fetchAndParseLlms, } from '../../core/index.js';
 import { resolveProjectInfo, buildTextResponse, buildMissingTokenResponse, buildCurlSnippet, buildFetchSnippet, } from './utils.js';
 /**
  * 处理获取接口详情请求
  */
 export async function handleGetInterfaceDetail(args, ctx) {
     const { projectRoot, configManager, mcpBridge, contextStore } = ctx;
-    const projectInfo = resolveProjectInfo(projectRoot, contextStore, args.projectName, args.projectId);
+    const cacheManager = new UnifiedCacheManager(projectRoot);
+    let projectInfo = resolveProjectInfo(projectRoot, contextStore, args.projectName, args.projectId, args.shareId);
+    // 如果提供了 URL，尝试从 URL 解析项目信息
+    if (!projectInfo && args.url) {
+        const parsed = await parseApifoxUrl(args.url);
+        if (parsed && parsed.interfaceId === args.interfaceId) {
+            // 检查缓存中是否有该 shareId 对应的项目
+            let cachedProject = parsed.shareId ? cacheManager.findProjectByShareId(parsed.shareId) : null;
+            if (!cachedProject && parsed.llmsUrl) {
+                // 如果缓存中没有，从 llms.txt 解析并缓存
+                try {
+                    const interfaces = await fetchAndParseLlms(parsed.llmsUrl);
+                    // 如果无法获取真实项目名称，使用 ${shareId}-${projectId} 作为后备
+                    const projectName = parsed.projectName ||
+                        (parsed.shareId ? `${parsed.shareId}-${parsed.projectId}` : parsed.projectId);
+                    // 保存项目元数据和接口列表
+                    cacheManager.upsertProjectMetadata(projectName, parsed.projectId, parsed.llmsUrl, parsed.shareId);
+                    cacheManager.updateInterfacesFromLlms(projectName, interfaces);
+                    cachedProject = cacheManager.findProjectByShareId(parsed.shareId) || null;
+                }
+                catch (error) {
+                    return buildTextResponse(`解析项目信息失败: ${error instanceof Error ? error.message : String(error)}`, true);
+                }
+            }
+            if (cachedProject) {
+                projectInfo = {
+                    projectId: cachedProject.projectId,
+                    projectName: cachedProject.projectName,
+                };
+            }
+            else if (parsed.projectId) {
+                // 如果无法获取真实项目名称，使用 ${shareId}-${projectId} 作为后备
+                const projectName = parsed.projectName ||
+                    (parsed.shareId ? `${parsed.shareId}-${parsed.projectId}` : parsed.projectId);
+                projectInfo = {
+                    projectId: parsed.projectId,
+                    projectName,
+                };
+            }
+        }
+    }
     if (!projectInfo) {
         return buildTextResponse('我需要知道项目名称或 ID 才能查看接口详情。');
     }
+    // 优先从缓存的 md 文件读取接口详情
+    const cachedInterface = cacheManager.findInterface(projectInfo.projectName, args.interfaceId);
+    if (cachedInterface && cachedInterface.docUrl) {
+        try {
+            const detail = await parseInterfaceFromMd(cachedInterface.docUrl);
+            if (detail) {
+                contextStore.setLastProject(projectInfo.projectName, projectInfo.projectId);
+                const requestJson = JSON.stringify(detail.request || {}, null, 2);
+                const responseJson = JSON.stringify(detail.response || {}, null, 2);
+                const tsArtifact = generateArtifact('ts_types', {
+                    interfaceDetail: detail,
+                });
+                const curlSnippet = buildCurlSnippet(detail);
+                const fetchSnippet = buildFetchSnippet(detail);
+                const description = detail.description ? `\n- 描述: ${detail.description}` : '';
+                const text = `**${detail.name || '未命名接口'}**\n` +
+                    `- 方法: ${detail.method || 'N/A'}\n` +
+                    `- 路径: ${detail.path || 'N/A'}\n` +
+                    `- ID: ${detail.id}\n` +
+                    `${description}\n\n` +
+                    `### 请求参数\n\`\`\`json\n${requestJson}\n\`\`\`\n\n` +
+                    `### 响应示例\n\`\`\`json\n${responseJson}\n\`\`\`\n\n` +
+                    `### curl 示例\n\`\`\`bash\n${curlSnippet}\n\`\`\`\n\n` +
+                    `### fetch 示例\n\`\`\`ts\n${fetchSnippet}\n\`\`\`\n\n` +
+                    `### TypeScript 类型草稿\n\`\`\`ts\n${tsArtifact.content}\n\`\`\`\n\n` +
+                    `如果需要，我还能继续为你生成 Mock 数据或请求封装。`;
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text,
+                        },
+                    ],
+                };
+            }
+        }
+        catch {
+            // 如果从 md 文件读取失败，继续使用 API 方式
+        }
+    }
+    // Fallback: 使用 API 方式获取接口详情
     const accessToken = configManager.getAccessToken();
     if (!accessToken) {
         return buildMissingTokenResponse();

package/dist/server/handlers/get-interface-detail.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-interface-detail.js","sourceRoot":"","sources":["../../../src/server/handlers/get-interface-detail.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAepB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAA4B,EAC5B,GAA8B;IAE9B,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC;IAEpE,MAAM,WAAW,GAAG,kBAAkB,CACpC,WAAW,EACX,YAAY,EACZ,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,SAAS,CACf,CAAC;IAEF,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,iBAAiB,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC,cAAc,EAAE,CAAC;IACnD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,yBAAyB,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,wBAAwB,CACrD,WAAW,EACX,WAAW,CAAC,WAAW,EACvB,WAAW,CAAC,SAAS,EACrB,IAAI,CAAC,WAAW,CACjB,CAAC;QAEF,YAAY,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;QAE5E,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACpE,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,EAAE;YAC9C,eAAe,EAAE,MAAM;SACxB,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAE/C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE9E,MAAM,IAAI,GACR,KAAK,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM;YACjC,SAAS,MAAM,CAAC,MAAM,IAAI,KAAK,IAAI;YACnC,SAAS,MAAM,CAAC,IAAI,IAAI,KAAK,IAAI;YACjC,SAAS,MAAM,CAAC,EAAE,IAAI;YACtB,GAAG,WAAW,MAAM;YACpB,yBAAyB,WAAW,cAAc;YAClD,yBAAyB,YAAY,cAAc;YACnD,4BAA4B,WAAW,cAAc;YACrD,2BAA2B,YAAY,cAAc;YACrD,kCAAkC,UAAU,CAAC,OAAO,cAAc;YAClE,8BAA8B,CAAC;QAEjC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI;iBACL;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBAC5E;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"get-interface-detail.js","sourceRoot":"","sources":["../../../src/server/handlers/get-interface-detail.ts"],"names":[],"mappings":"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"}

package/dist/server/handlers/list-projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-projects.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/list-projects.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM;;;;;;GAY3D"}
+{"version":3,"file":"list-projects.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/list-projects.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM;;;;;;GAY3D"}

package/dist/server/handlers/list-projects.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-projects.js","sourceRoot":"","sources":["../../../src/server/handlers/list-projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAC1D,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,EAAE,CAAC;IAE7C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,kBAAkB,CACvB,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,OAAO,kBAAkB,CAAC,WAAW,QAAQ,CAAC,MAAM,oBAAoB,WAAW,EAAE,CAAC,CAAC;AACzF,CAAC"}
+{"version":3,"file":"list-projects.js","sourceRoot":"","sources":["../../../src/server/handlers/list-projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAC1D,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,EAAE,CAAC;IAE7C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,kBAAkB,CACvB,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,OAAO,kBAAkB,CAAC,WAAW,QAAQ,CAAC,MAAM,oBAAoB,WAAW,EAAE,CAAC,CAAC;AACzF,CAAC"}

package/dist/server/handlers/parse-and-add-project.d.ts

@@ -7,7 +7,6 @@ export interface ParseAndAddProjectContext {
     configManager: ConfigManager;
     mcpBridge: McpBridge;
     contextStore: ContextStore;
-    getApiBaseUrl: () => string | null;
 }
 /**
  * 处理解析并添加项目请求

package/dist/server/handlers/parse-and-add-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-and-add-project.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/parse-and-add-project.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,SAAS,EAKT,YAAY,EAGb,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,sBAAsB,EAC5B,GAAG,EAAE,yBAAyB;;;;;;;;;;;;GA+Q/B"}
+{"version":3,"file":"parse-and-add-project.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/parse-and-add-project.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,SAAS,EAKT,YAAY,EAGb,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,sBAAsB,EAC5B,GAAG,EAAE,yBAAyB;;;;;;;;;;;;GAmP/B"}

package/dist/server/handlers/parse-and-add-project.js

@@ -4,38 +4,32 @@ import { ApifoxClient, isValidApifoxUrl, parseApifoxUrl, ShareLinkType, UnifiedC
  */
 export async function handleParseAndAddProject(args, ctx) {
     const { url } = args;
-    const { projectRoot, configManager, mcpBridge, contextStore, getApiBaseUrl } = ctx;
+    const { projectRoot, configManager, mcpBridge, contextStore } = ctx;
     const steps = [];
     const errors = [];
-    let projectId;
     let projectName;
     let fullProjectInfo = null;
     let interfaceDetail = null;
-    // 步骤 1: 先检查并创建配置文件
-    steps.push('📋 步骤 1: 检查配置文件');
+    // 步骤 1: 检查访问令牌
+    steps.push('📋 步骤 1: 检查访问令牌');
     steps.push(`   📂 项目根目录: ${projectRoot}`);
-    steps.push(`   📄 配置文件路径: ${configManager.getApifoxConfigPath()}`);
-    const configStatus = configManager.checkConfigStatus();
-    if (!configStatus.apifoxConfigExists) {
-        steps.push('   ⚠️ 配置文件不存在，尝试创建...');
-        const initResult = configManager.initializeConfig();
-        if (initResult.apifoxConfigCreated) {
-            steps.push(`   ✅ 已创建 apifox-mcp.json 文件`);
-            steps.push(`   📍 文件位置: ${initResult.configPath}`);
-        }
-        else if (!initResult.apifoxConfigExists) {
-            errors.push('   ❌ 无法创建 apifox-mcp.json 文件');
-            errors.push(`   📂 项目根目录: ${initResult.projectRoot}`);
-            errors.push(`   📄 配置文件路径: ${initResult.configPath}`);
-        }
-        if (initResult.errors.length > 0) {
-            errors.push(...initResult.errors.map((e) => `   - ${e}`));
-        }
-    }
-    else {
-        steps.push('   ✅ apifox-mcp.json 文件存在');
-        steps.push(`   📍 文件位置: ${configManager.getApifoxConfigPath()}`);
+    const accessToken = configManager.getAccessToken();
+    if (!accessToken) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `❌ 未找到 APIFOX_ACCESS_TOKEN\n\n` +
+                        `${steps.join('\n')}\n\n` +
+                        `请在 MCP 配置的 env 中配置 APIFOX_ACCESS_TOKEN：\n\n` +
+                        `在 ~/.cursor/mcp.json 或项目根目录的 .cursor/mcp.json 中添加：\n\n` +
+                        `\`\`\`json\n{\n  "mcpServers": {\n    "apifox-workspace-mcp": {\n      "command": "node",\n      "args": ["/path/to/dist/server/index.js"],\n      "env": {\n        "APIFOX_ACCESS_TOKEN": "your_token_here"\n      }\n    }\n  }\n}\n\`\`\``,
+                },
+            ],
+            isError: true,
+        };
     }
+    steps.push('   ✅ Access Token 已配置');
     // 步骤 2: 验证和解析 URL
     steps.push('\n🔗 步骤 2: 验证和解析 URL');
     if (!isValidApifoxUrl(url)) {
@@ -63,7 +57,7 @@ export async function handleParseAndAddProject(args, ctx) {
             isError: true,
         };
     }
-    projectId = parsed.projectId;
+    const projectId = parsed.projectId;
     projectName = parsed.projectName;
     const linkType = parsed.linkType;
     const llmsUrl = parsed.llmsUrl;
@@ -79,34 +73,22 @@ export async function handleParseAndAddProject(args, ctx) {
         steps.push(`   - 接口 ID: ${parsed.interfaceId}`);
     }
     steps.push(`   - llms.txt URL: ${llmsUrl}`);
-    // 步骤 3: 检查 access token
-    steps.push('\n🔑 步骤 3: 检查 Access Token');
-    const accessToken = configManager.getAccessToken();
-    if (!accessToken) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `❌ 未找到 APIFOX_ACCESS_TOKEN\n\n` +
-                        `${steps.join('\n')}\n\n` +
-                        `请在 MCP 配置的 env 中配置 APIFOX_ACCESS_TOKEN：\n\n` +
-                        `在 ~/.cursor/mcp.json 或项目根目录的 .cursor/mcp.json 中添加：\n\n` +
-                        `\`\`\`json\n{\n  "mcpServers": {\n    "apifox-workspace-mcp": {\n      "command": "node",\n      "args": ["/path/to/dist/server/index.js"],\n      "env": {\n        "APIFOX_ACCESS_TOKEN": "your_token_here"\n      }\n    }\n  }\n}\n\`\`\``,
-                },
-            ],
-            isError: true,
-        };
-    }
-    steps.push('   ✅ Access Token 已配置');
-    // 步骤 4: 检查项目是否已存在
+    // 步骤 3: 检查项目是否已存在
     steps.push('\n🔍 步骤 4: 检查项目是否已存在');
-    configManager.getProjectName(projectId); // 检查是否存在
+    const cacheManager = new UnifiedCacheManager(projectRoot);
+    const existingProject = cacheManager.findProjectById(projectId);
+    if (existingProject) {
+        steps.push(`   ℹ️ 项目已存在: ${existingProject.projectName} (${projectId})`);
+    }
+    else {
+        steps.push(`   ✅ 项目不存在，将创建新项目`);
+    }
     // 步骤 5: 如果是接口分享链接，获取接口详情
     if (linkType === ShareLinkType.INTERFACE && parsed.interfaceId) {
         steps.push('\n📡 步骤 5: 获取接口详情');
         steps.push(`   🔄 正在获取接口 ${parsed.interfaceId} 的详细信息...`);
         try {
-            const apifoxClient = new ApifoxClient(accessToken, getApiBaseUrl() ?? undefined);
+            const apifoxClient = new ApifoxClient(accessToken, configManager.getApiBaseUrl() ?? undefined);
             interfaceDetail = await apifoxClient.getInterfaceDetail(projectId, parsed.interfaceId);
             steps.push('   ✅ 成功获取接口详情');
         }
@@ -114,29 +96,34 @@ export async function handleParseAndAddProject(args, ctx) {
             steps.push(`   ⚠️ 获取接口详情失败: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
-    // 步骤 6: 获取项目信息（通过 Apifox 官方 MCP Server，可选）
-    steps.push('\n📡 步骤 6: 获取项目信息（可选）');
+    // 步骤 5: 获取项目信息（通过 Apifox 官方 MCP Server，可选）
+    steps.push('\n📡 步骤 5: 获取项目信息（可选）');
     if (!projectName) {
         steps.push('   🔄 通过 Apifox 官方 MCP Server 获取项目信息...');
         try {
             const mcpResult = await mcpBridge.getProjectInfoViaMcp(accessToken, projectId);
             fullProjectInfo = mcpResult;
-            projectName = mcpResult.name || `project-${projectId.substring(0, 8)}`;
-            steps.push('   ✅ 通过 MCP Server 成功获取项目信息');
+            projectName = mcpResult.name;
+            if (projectName) {
+                steps.push('   ✅ 通过 MCP Server 成功获取项目信息');
+            }
+            else {
+                steps.push('   ⚠️ MCP Server 未返回项目名称');
+            }
         }
         catch (mcpError) {
             steps.push(`   ⚠️ MCP Server 调用失败: ${mcpError instanceof Error ? mcpError.message : String(mcpError)}`);
-            projectName = projectName || `project-${projectId.substring(0, 8)}`;
-            steps.push(`   ⚠️ 使用默认项目名称: ${projectName}`);
         }
     }
     else {
         steps.push('   ℹ️ 已从页面标题获取项目名称，跳过 MCP Server 调用');
     }
-    // 步骤 7: 保存或更新项目信息到统一缓存
-    steps.push('\n💾 步骤 7: 保存项目信息到统一缓存');
+    // 步骤 6: 保存或更新项目信息到统一缓存
+    steps.push('\n💾 步骤 6: 保存项目信息到统一缓存');
+    // 如果无法获取真实项目名称，使用 ${shareId}-${projectId} 作为后备
     if (!projectName) {
-        projectName = `project-${projectId.substring(0, 8)}`;
+        projectName = shareId ? `${shareId}-${projectId}` : projectId;
+        steps.push(`   ⚠️ 使用后备项目名称: ${projectName}`);
     }
     if (!llmsUrl) {
         return {
@@ -150,9 +137,8 @@ export async function handleParseAndAddProject(args, ctx) {
         };
     }
     // 使用统一缓存管理器
-    const cacheManager = new UnifiedCacheManager(projectRoot);
-    // 保存项目元数据
-    cacheManager.upsertProjectMetadata(projectName, projectId, llmsUrl);
+    // 保存项目元数据（包含 shareId）
+    cacheManager.upsertProjectMetadata(projectName, projectId, llmsUrl, shareId);
     steps.push('   ✅ 已保存项目元数据到统一缓存');
     // 从 llms.txt 解析接口列表
     steps.push('   🔄 正在从 llms.txt 解析接口列表...');
@@ -167,81 +153,67 @@ export async function handleParseAndAddProject(args, ctx) {
         steps.push(`   ⚠️ 解析 llms.txt 失败: ${error instanceof Error ? error.message : String(error)}`);
         errors.push(`解析 llms.txt 失败: ${error instanceof Error ? error.message : String(error)}`);
     }
-    // 同时保存到旧的 apifox-mcp.json（向后兼容）
-    const upsertResult = configManager.upsertProject(projectName, {
-        id: projectId,
-        shareUrl: url,
-        llmsUrl: llmsUrl,
-    });
-    if (upsertResult.success) {
-        contextStore.setLastProject(projectName, projectId);
-        steps.push('   ✅ 项目信息已保存到 apifox-mcp.json');
-        // 构建返回信息
-        let responseText = '';
-        // 根据链接类型和是否为新项目，构造不同的提示语
-        if (linkType === ShareLinkType.PROJECT) {
-            responseText = upsertResult.isNew ? `✅ 项目配置已添加！\n\n` : `✅ 项目配置已更新！\n\n`;
-        }
-        else {
-            responseText = upsertResult.isNew
-                ? `✅ 该接口对应项目配置已添加！\n\n`
-                : `✅ 该接口对应项目配置已存在！\n\n`;
-        }
-        responseText += `**保存的信息：**\n`;
-        responseText += `- 项目 ID: ${projectId}\n`;
-        responseText += `- 项目名称: ${projectName}\n`;
-        responseText += `- 分享 ID: ${shareId}\n`;
-        if (llmsUrl) {
-            responseText += `- llms.txt URL: ${llmsUrl}\n`;
-        }
-        if (parsed.interfaceId) {
-            responseText += `- 接口 ID: ${parsed.interfaceId}\n`;
+    // 设置最后操作的项目
+    contextStore.setLastProject(projectName, projectId);
+    // 构建返回信息
+    let responseText = '';
+    // 检查是否为新项目
+    const isNewProject = !existingProject;
+    // 根据链接类型和是否为新项目，构造不同的提示语
+    if (linkType === ShareLinkType.PROJECT) {
+        responseText = isNewProject ? `✅ 项目配置已添加！\n\n` : `✅ 项目配置已更新！\n\n`;
+    }
+    else {
+        responseText = isNewProject
+            ? `✅ 该接口对应项目配置已添加！\n\n`
+            : `✅ 该接口对应项目配置已存在！\n\n`;
+    }
+    responseText += `**保存的信息：**\n`;
+    responseText += `- 项目 ID: ${projectId}\n`;
+    responseText += `- 项目名称: ${projectName}\n`;
+    responseText += `- 分享 ID: ${shareId}\n`;
+    if (llmsUrl) {
+        responseText += `- llms.txt URL: ${llmsUrl}\n`;
+    }
+    if (parsed.interfaceId) {
+        responseText += `- 接口 ID: ${parsed.interfaceId}\n`;
+    }
+    responseText += `\n`;
+    // 如果是接口分享链接，输出接口详情
+    if (linkType === ShareLinkType.INTERFACE && interfaceDetail) {
+        responseText += `**当前接口信息：**\n`;
+        responseText += `- 接口名称: ${interfaceDetail.name || '未命名'}\n`;
+        responseText += `- 请求方法: ${interfaceDetail.method || 'UNKNOWN'}\n`;
+        responseText += `- 接口路径: ${interfaceDetail.path || '/'}\n`;
+        if (interfaceDetail.description) {
+            responseText += `- 描述: ${interfaceDetail.description}\n`;
         }
         responseText += `\n`;
-        // 如果是接口分享链接，输出接口详情
-        if (linkType === ShareLinkType.INTERFACE && interfaceDetail) {
-            responseText += `**当前接口信息：**\n`;
-            responseText += `- 接口名称: ${interfaceDetail.name || '未命名'}\n`;
-            responseText += `- 请求方法: ${interfaceDetail.method || 'UNKNOWN'}\n`;
-            responseText += `- 接口路径: ${interfaceDetail.path || '/'}\n`;
-            if (interfaceDetail.description) {
-                responseText += `- 描述: ${interfaceDetail.description}\n`;
-            }
-            responseText += `\n`;
-            responseText += `**完整接口详情：**\n`;
-            responseText += `\`\`\`json\n${JSON.stringify(interfaceDetail, null, 2)}\n\`\`\`\n\n`;
-        }
-        if (fullProjectInfo) {
-            responseText += `**项目完整信息：**\n`;
-            responseText += `\`\`\`json\n${JSON.stringify(fullProjectInfo, null, 2)}\n\`\`\`\n\n`;
-        }
-        // 根据链接类型询问用户下一步
-        if (linkType === ShareLinkType.PROJECT) {
-            responseText += `现在想要了解该项目的哪些信息？\n`;
-        }
-        else {
-            responseText += `现在需要我帮助您做什么？\n`;
-        }
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: responseText,
-                },
-            ],
-        };
+        responseText += `**完整接口详情：**\n`;
+        responseText += `\`\`\`json\n${JSON.stringify(interfaceDetail, null, 2)}\n\`\`\`\n\n`;
     }
-    else {
-        errors.push(upsertResult.message);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `❌ ${upsertResult.message}\n\n**执行过程：**\n${steps.join('\n')}\n\n**错误：**\n${errors.join('\n')}`,
-                },
-            ],
-            isError: true,
-        };
+    if (fullProjectInfo) {
+        responseText += `**项目完整信息：**\n`;
+        responseText += `\`\`\`json\n${JSON.stringify(fullProjectInfo, null, 2)}\n\`\`\`\n\n`;
     }
+    // 根据链接类型询问用户下一步
+    if (linkType === ShareLinkType.PROJECT) {
+        responseText += `现在想要了解该项目的哪些信息？\n`;
+    }
+    else {
+        responseText += `现在需要我帮助您做什么？\n`;
+    }
+    // 如果有错误，添加错误信息
+    if (errors.length > 0) {
+        responseText += `\n**警告：**\n${errors.join('\n')}\n`;
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: responseText,
+            },
+        ],
+    };
 }
 //# sourceMappingURL=parse-and-add-project.js.map