apifox-workspace-mcp 1.0.0 → 1.1.0

package/dist/core/cache/interface-cache-manager.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 接口基础信息缓存管理器
+ *
+ * 按目录层级组织接口缓存，只缓存基础信息（id, name, method, path, description）
+ * 不缓存接口详情，确保详情始终是最新的
+ */
+/**
+ * 接口基础信息
+ */
+export interface InterfaceBasicInfo {
+    id: string;
+    name: string;
+    method: string;
+    path: string;
+    description?: string;
+}
+/**
+ * 缓存结构：按项目 ID -> 目录层级 -> 接口数组
+ *
+ * 示例：
+ * {
+ *   "202": {
+ *     "SFTP": {
+ *       "App api SFTP template": [
+ *         { id: "2385", name: "复制SFTP模板", method: "POST", path: "/api/sftp/template/copy", description: "..." }
+ *       ]
+ *     },
+ *     "": [  // 根目录的接口
+ *       { id: "62227", name: "获取用户信息", method: "GET", path: "/api/users/{id}" }
+ *     ]
+ *   }
+ * }
+ */
+export type InterfaceCache = Record<string, Record<string, unknown> | InterfaceBasicInfo[]>;
+/**
+ * 接口缓存管理器
+ */
+export declare class InterfaceCacheManager {
+    private cachePath;
+    private cache;
+    constructor(projectRoot: string);
+    /**
+     * 加载缓存文件
+     */
+    private loadCache;
+    /**
+     * 保存缓存到文件
+     */
+    private saveCache;
+    /**
+     * 解析目录路径为层级数组
+     *
+     * 例如：
+     * - "Invoice > Info" -> ["Invoice", "Info"]
+     * - "APP API company subscribe" -> ["APP API company subscribe"]
+     * - "" -> [""] (根目录)
+     *
+     * @param folderPath 目录路径，使用 " > " 分隔多级目录
+     * @returns 目录层级数组
+     */
+    private parseFolderPath;
+    /**
+     * 将接口添加到缓存
+     *
+     * @param projectId 项目 ID
+     * @param folderPath 目录路径（如 "Invoice > Info"）
+     * @param interfaceInfo 接口基础信息
+     */
+    addInterface(projectId: string, folderPath: string, interfaceInfo: InterfaceBasicInfo): void;
+    /**
+     * 批量添加接口到缓存
+     *
+     * @param projectId 项目 ID
+     * @param interfaces 接口列表（包含 folderPath）
+     */
+    addInterfaces(projectId: string, interfaces: Array<InterfaceBasicInfo & {
+        folderPath?: string;
+    }>): void;
+    /**
+     * 获取项目下所有缓存的接口（按目录层级组织）
+     *
+     * @param projectId 项目 ID
+     * @returns 按目录层级组织的接口结构，如果项目不存在则返回 undefined
+     */
+    getInterfacesByProject(projectId: string): Record<string, unknown> | undefined;
+    /**
+     * 将嵌套的接口结构扁平化为数组
+     *
+     * @param nested 嵌套的接口结构
+     * @returns 扁平化的接口数组（包含 folderPath）
+     */
+    flattenInterfaces(nested: Record<string, unknown>): Array<InterfaceBasicInfo & {
+        folderPath: string;
+    }>;
+    /**
+     * 检查对象是否为接口基础信息
+     */
+    private isInterfaceBasicInfo;
+    /**
+     * 根据接口 ID 查找接口基础信息
+     *
+     * @param projectId 项目 ID
+     * @param interfaceId 接口 ID
+     * @returns 接口基础信息，如果未找到则返回 null
+     */
+    findInterfaceById(projectId: string, interfaceId: string): InterfaceBasicInfo | null;
+    /**
+     * 清空项目的缓存
+     *
+     * @param projectId 项目 ID
+     */
+    clearProject(projectId: string): void;
+    /**
+     * 获取缓存文件路径
+     */
+    getCachePath(): string;
+}
+//# sourceMappingURL=interface-cache-manager.d.ts.map

package/dist/core/cache/interface-cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-cache-manager.d.ts","sourceRoot":"","sources":["../../../src/core/cache/interface-cache-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,EAAE,CAAC,CAAC;AAE5F;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAiB;gBAElB,WAAW,EAAE,MAAM;IAM/B;;OAEG;IACH,OAAO,CAAC,SAAS;IAajB;;OAEG;IACH,OAAO,CAAC,SAAS;IAYjB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,eAAe;IAWvB;;;;;;OAMG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,GAAG,IAAI;IA4C5F;;;;;OAKG;IACH,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,KAAK,CAAC,kBAAkB,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAC9D,IAAI;IAaP;;;;;OAKG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAI9E;;;;;OAKG;IACH,iBAAiB,CACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,KAAK,CAAC,kBAAkB,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA2BrD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;;;;;OAMG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IA0BpF;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKrC;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB"}

package/dist/core/cache/interface-cache-manager.js

@@ -0,0 +1,236 @@
+/**
+ * 接口基础信息缓存管理器
+ *
+ * 按目录层级组织接口缓存，只缓存基础信息（id, name, method, path, description）
+ * 不缓存接口详情，确保详情始终是最新的
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+/**
+ * 接口缓存管理器
+ */
+export class InterfaceCacheManager {
+    cachePath;
+    cache;
+    constructor(projectRoot) {
+        const cacheDir = join(projectRoot, '.cursor', 'tmp');
+        this.cachePath = join(cacheDir, 'apifox-interfaces-cache.json');
+        this.cache = this.loadCache();
+    }
+    /**
+     * 加载缓存文件
+     */
+    loadCache() {
+        if (!existsSync(this.cachePath)) {
+            return {};
+        }
+        try {
+            const content = readFileSync(this.cachePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            console.error('加载接口缓存失败:', error);
+            return {};
+        }
+    }
+    /**
+     * 保存缓存到文件
+     */
+    saveCache() {
+        try {
+            const dir = dirname(this.cachePath);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            writeFileSync(this.cachePath, JSON.stringify(this.cache, null, 2), 'utf-8');
+        }
+        catch (error) {
+            console.error('保存接口缓存失败:', error);
+        }
+    }
+    /**
+     * 解析目录路径为层级数组
+     *
+     * 例如：
+     * - "Invoice > Info" -> ["Invoice", "Info"]
+     * - "APP API company subscribe" -> ["APP API company subscribe"]
+     * - "" -> [""] (根目录)
+     *
+     * @param folderPath 目录路径，使用 " > " 分隔多级目录
+     * @returns 目录层级数组
+     */
+    parseFolderPath(folderPath) {
+        if (!folderPath || folderPath.trim() === '') {
+            return ['']; // 根目录
+        }
+        // 使用 " > " 分隔多级目录
+        return folderPath
+            .split(' > ')
+            .map((s) => s.trim())
+            .filter((s) => s !== '');
+    }
+    /**
+     * 将接口添加到缓存
+     *
+     * @param projectId 项目 ID
+     * @param folderPath 目录路径（如 "Invoice > Info"）
+     * @param interfaceInfo 接口基础信息
+     */
+    addInterface(projectId, folderPath, interfaceInfo) {
+        if (!this.cache[projectId]) {
+            this.cache[projectId] = {};
+        }
+        const folders = this.parseFolderPath(folderPath);
+        let current = this.cache[projectId];
+        // 构建嵌套结构
+        for (let i = 0; i < folders.length; i++) {
+            const folder = folders[i];
+            if (i === folders.length - 1) {
+                // 最后一层，存储接口数组
+                if (!current[folder] || !Array.isArray(current[folder])) {
+                    current[folder] = [];
+                }
+                const interfaces = current[folder];
+                // 检查是否已存在（避免重复）
+                const existingIndex = interfaces.findIndex((i) => i.id === interfaceInfo.id);
+                if (existingIndex >= 0) {
+                    // 更新现有接口信息
+                    interfaces[existingIndex] = interfaceInfo;
+                }
+                else {
+                    // 添加新接口
+                    interfaces.push(interfaceInfo);
+                }
+            }
+            else {
+                // 中间层，创建嵌套对象
+                if (!current[folder] ||
+                    typeof current[folder] !== 'object' ||
+                    Array.isArray(current[folder])) {
+                    current[folder] = {};
+                }
+                current = current[folder];
+            }
+        }
+        this.saveCache();
+    }
+    /**
+     * 批量添加接口到缓存
+     *
+     * @param projectId 项目 ID
+     * @param interfaces 接口列表（包含 folderPath）
+     */
+    addInterfaces(projectId, interfaces) {
+        for (const iface of interfaces) {
+            const folderPath = iface.folderPath || '';
+            this.addInterface(projectId, folderPath, {
+                id: iface.id,
+                name: iface.name,
+                method: iface.method,
+                path: iface.path,
+                description: iface.description,
+            });
+        }
+    }
+    /**
+     * 获取项目下所有缓存的接口（按目录层级组织）
+     *
+     * @param projectId 项目 ID
+     * @returns 按目录层级组织的接口结构，如果项目不存在则返回 undefined
+     */
+    getInterfacesByProject(projectId) {
+        return this.cache[projectId];
+    }
+    /**
+     * 将嵌套的接口结构扁平化为数组
+     *
+     * @param nested 嵌套的接口结构
+     * @returns 扁平化的接口数组（包含 folderPath）
+     */
+    flattenInterfaces(nested) {
+        const result = [];
+        const traverse = (obj, currentPath = []) => {
+            if (Array.isArray(obj)) {
+                // 找到接口数组
+                const folderPath = currentPath.join(' > ');
+                for (const iface of obj) {
+                    if (this.isInterfaceBasicInfo(iface)) {
+                        result.push({
+                            ...iface,
+                            folderPath,
+                        });
+                    }
+                }
+            }
+            else if (typeof obj === 'object' && obj !== null) {
+                // 继续遍历嵌套对象
+                for (const [key, value] of Object.entries(obj)) {
+                    traverse(value, [...currentPath, key]);
+                }
+            }
+        };
+        traverse(nested);
+        return result;
+    }
+    /**
+     * 检查对象是否为接口基础信息
+     */
+    isInterfaceBasicInfo(obj) {
+        return (typeof obj === 'object' &&
+            obj !== null &&
+            'id' in obj &&
+            'name' in obj &&
+            'method' in obj &&
+            'path' in obj &&
+            typeof obj.id === 'string' &&
+            typeof obj.name === 'string' &&
+            typeof obj.method === 'string' &&
+            typeof obj.path === 'string');
+    }
+    /**
+     * 根据接口 ID 查找接口基础信息
+     *
+     * @param projectId 项目 ID
+     * @param interfaceId 接口 ID
+     * @returns 接口基础信息，如果未找到则返回 null
+     */
+    findInterfaceById(projectId, interfaceId) {
+        const projectCache = this.cache[projectId];
+        if (!projectCache) {
+            return null;
+        }
+        // 递归查找
+        const search = (obj) => {
+            if (Array.isArray(obj)) {
+                const found = obj.find((i) => this.isInterfaceBasicInfo(i) && i.id === interfaceId);
+                return found || null;
+            }
+            if (typeof obj === 'object' && obj !== null) {
+                for (const value of Object.values(obj)) {
+                    const result = search(value);
+                    if (result) {
+                        return result;
+                    }
+                }
+            }
+            return null;
+        };
+        return search(projectCache);
+    }
+    /**
+     * 清空项目的缓存
+     *
+     * @param projectId 项目 ID
+     */
+    clearProject(projectId) {
+        delete this.cache[projectId];
+        this.saveCache();
+    }
+    /**
+     * 获取缓存文件路径
+     */
+    getCachePath() {
+        return this.cachePath;
+    }
+}
+//# sourceMappingURL=interface-cache-manager.js.map

package/dist/core/cache/interface-cache-manager.js.map

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

package/dist/core/cache/unified-cache-manager.d.ts

@@ -0,0 +1,139 @@
+/**
+ * 统一缓存管理器
+ *
+ * 管理项目元数据和接口缓存，所有数据存储在 apifox-interfaces-cache.json
+ * 接口只缓存基础信息（id, name, folderPath, docUrl, version），不缓存 method, path, description
+ *
+ * 优化特性：
+ * - 内存缓存：减少 I/O 操作，提升查询性能
+ * - 延迟保存：只在必要时保存，批量更新时只保存一次
+ * - 文件锁：防止并发写入导致的数据损坏
+ * - 索引优化：使用 Map 建立索引，查找时间复杂度 O(1)
+ * - 错误恢复：自动备份损坏的文件
+ */
+/**
+ * 缓存的接口信息（只包含从 llms.txt 解析的基础信息）
+ * 注意：不包含 method, path, description，这些信息每次查询详情时都重新获取
+ */
+export interface CachedInterface {
+    id: string;
+    name: string;
+    folderPath: string;
+    docUrl: string;
+    version?: string;
+}
+/**
+ * 项目缓存对象
+ */
+export interface ProjectCache {
+    /** 项目名称 */
+    projectName: string;
+    /** 项目 ID（单个字符串） */
+    projectIds: string;
+    /** llms.txt URL */
+    llmsUrls: string;
+    /** 接口列表（扁平数组） */
+    interfaces: CachedInterface[];
+}
+/**
+ * 统一缓存文件结构
+ */
+export type UnifiedCache = ProjectCache[];
+/**
+ * 统一缓存管理器
+ */
+export declare class UnifiedCacheManager {
+    private cachePath;
+    private cache;
+    private cacheDirty;
+    private lastLoadTime;
+    private projectNameIndex;
+    private projectIdIndex;
+    private interfaceIndex;
+    constructor(projectRoot: string);
+    /**
+     * 构建索引
+     */
+    private buildIndexes;
+    /**
+     * 加载缓存文件（带类型验证）
+     */
+    private loadCache;
+    /**
+     * 标记缓存为已修改
+     */
+    private markDirty;
+    /**
+     * 检查并清理过期的锁文件
+     */
+    private checkAndCleanExpiredLock;
+    /**
+     * 保存缓存到文件（带文件锁）
+     * 使用 fs.openSync 的排他模式实现简单的文件锁
+     */
+    private saveCache;
+    /**
+     * 同步保存缓存（用于需要立即保存的场景）
+     */
+    private saveCacheSync;
+    /**
+     * 通过项目名称查找项目（使用索引，O(1) 时间复杂度）
+     */
+    findProjectByName(projectName: string): ProjectCache | null;
+    /**
+     * 通过项目 ID 查找项目（使用索引，O(1) 时间复杂度）
+     */
+    findProjectById(projectId: string): ProjectCache | null;
+    /**
+     * 获取项目的 llmsUrl
+     */
+    getLlmsUrl(projectName: string): string | null;
+    /**
+     * 查找接口基础信息（使用索引，O(1) 时间复杂度）
+     */
+    findInterface(projectName: string, interfaceId: string): CachedInterface | null;
+    /**
+     * 获取项目的接口列表
+     */
+    getInterfaces(projectName: string, keyword?: string): CachedInterface[];
+    /**
+     * 添加或更新项目元数据
+     */
+    upsertProjectMetadata(projectName: string, projectId: string, llmsUrl: string): void;
+    /**
+     * 更新项目的接口列表（从 llms.txt 解析）
+     * 支持增量更新：只更新变化的接口
+     */
+    updateInterfacesFromLlms(projectName: string, parsedInterfaces: Array<{
+        id: string;
+        name: string;
+        folderPath: string;
+        docUrl: string;
+        version?: string;
+    }>): void;
+    /**
+     * 列出所有项目
+     */
+    listProjects(): Array<{
+        name: string;
+        id: string;
+    }>;
+    /**
+     * 获取缓存文件路径
+     */
+    getCachePath(): string;
+    /**
+     * 获取缓存统计信息
+     */
+    getCacheStats(): {
+        projectCount: number;
+        totalInterfaces: number;
+        cacheSize: number;
+        lastUpdated: Date | null;
+    };
+    /**
+     * 强制保存缓存（用于需要立即保存的场景）
+     */
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=unified-cache-manager.d.ts.map

package/dist/core/cache/unified-cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-cache-manager.d.ts","sourceRoot":"","sources":["../../../src/core/cache/unified-cache-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgBH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,EAAE,CAAC;AAiC1C;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,YAAY,CAAa;IAGjC,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,cAAc,CAA+C;gBAEzD,WAAW,EAAE,MAAM;IAQ/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,SAAS;IA6CjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA6BhC;;;OAGG;YACW,SAAS;IA0EvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAK3D;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKvD;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK9C;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAY/E;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE;IAmBvE;;OAEG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA0DpF;;;OAGG;IACH,wBAAwB,CACtB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,KAAK,CAAC;QACtB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,GACD,IAAI;IA2CP;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAOnD;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,aAAa,IAAI;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;KAC1B;IAqBD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}