apifox-workspace-mcp 1.0.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/README.md +40 -8
  2. package/dist/__tests__/intent.test.d.ts +2 -0
  3. package/dist/__tests__/intent.test.d.ts.map +1 -0
  4. package/dist/__tests__/intent.test.js +62 -0
  5. package/dist/__tests__/intent.test.js.map +1 -0
  6. package/dist/__tests__/llms-parser.test.d.ts +5 -0
  7. package/dist/__tests__/llms-parser.test.d.ts.map +1 -0
  8. package/dist/__tests__/llms-parser.test.js +57 -0
  9. package/dist/__tests__/llms-parser.test.js.map +1 -0
  10. package/dist/__tests__/select-interfaces.test.d.ts +2 -0
  11. package/dist/__tests__/select-interfaces.test.d.ts.map +1 -0
  12. package/dist/__tests__/select-interfaces.test.js +127 -0
  13. package/dist/__tests__/select-interfaces.test.js.map +1 -0
  14. package/dist/__tests__/unified-cache-manager.test.d.ts +5 -0
  15. package/dist/__tests__/unified-cache-manager.test.d.ts.map +1 -0
  16. package/dist/__tests__/unified-cache-manager.test.js +158 -0
  17. package/dist/__tests__/unified-cache-manager.test.js.map +1 -0
  18. package/dist/core/cache/index.d.ts +8 -0
  19. package/dist/core/cache/index.d.ts.map +1 -0
  20. package/dist/core/cache/index.js +7 -0
  21. package/dist/core/cache/index.js.map +1 -0
  22. package/dist/core/cache/interface-cache-manager.d.ts +118 -0
  23. package/dist/core/cache/interface-cache-manager.d.ts.map +1 -0
  24. package/dist/core/cache/interface-cache-manager.js +236 -0
  25. package/dist/core/cache/interface-cache-manager.js.map +1 -0
  26. package/dist/core/cache/unified-cache-manager.d.ts +139 -0
  27. package/dist/core/cache/unified-cache-manager.d.ts.map +1 -0
  28. package/dist/core/cache/unified-cache-manager.js +446 -0
  29. package/dist/core/cache/unified-cache-manager.js.map +1 -0
  30. package/dist/core/client/mcp-bridge.d.ts +14 -10
  31. package/dist/core/client/mcp-bridge.d.ts.map +1 -1
  32. package/dist/core/client/mcp-bridge.js +64 -94
  33. package/dist/core/client/mcp-bridge.js.map +1 -1
  34. package/dist/core/config/manager.d.ts +6 -0
  35. package/dist/core/config/manager.d.ts.map +1 -1
  36. package/dist/core/config/manager.js +13 -0
  37. package/dist/core/config/manager.js.map +1 -1
  38. package/dist/core/index.d.ts +2 -0
  39. package/dist/core/index.d.ts.map +1 -1
  40. package/dist/core/index.js +2 -0
  41. package/dist/core/index.js.map +1 -1
  42. package/dist/core/intent.d.ts +11 -1
  43. package/dist/core/intent.d.ts.map +1 -1
  44. package/dist/core/intent.js +121 -12
  45. package/dist/core/intent.js.map +1 -1
  46. package/dist/core/parser/index.d.ts +2 -0
  47. package/dist/core/parser/index.d.ts.map +1 -1
  48. package/dist/core/parser/index.js +1 -0
  49. package/dist/core/parser/index.js.map +1 -1
  50. package/dist/core/parser/llms.d.ts +37 -0
  51. package/dist/core/parser/llms.d.ts.map +1 -0
  52. package/dist/core/parser/llms.js +83 -0
  53. package/dist/core/parser/llms.js.map +1 -0
  54. package/dist/server/handlers/assistant.d.ts.map +1 -1
  55. package/dist/server/handlers/assistant.js +11 -5
  56. package/dist/server/handlers/assistant.js.map +1 -1
  57. package/dist/server/handlers/generate-artifacts.d.ts.map +1 -1
  58. package/dist/server/handlers/generate-artifacts.js +3 -3
  59. package/dist/server/handlers/generate-artifacts.js.map +1 -1
  60. package/dist/server/handlers/get-interface-detail.d.ts +1 -0
  61. package/dist/server/handlers/get-interface-detail.d.ts.map +1 -1
  62. package/dist/server/handlers/get-interface-detail.js +3 -3
  63. package/dist/server/handlers/get-interface-detail.js.map +1 -1
  64. package/dist/server/handlers/index.d.ts +1 -0
  65. package/dist/server/handlers/index.d.ts.map +1 -1
  66. package/dist/server/handlers/index.js +1 -0
  67. package/dist/server/handlers/index.js.map +1 -1
  68. package/dist/server/handlers/list-projects.d.ts +1 -2
  69. package/dist/server/handlers/list-projects.d.ts.map +1 -1
  70. package/dist/server/handlers/list-projects.js +6 -28
  71. package/dist/server/handlers/list-projects.js.map +1 -1
  72. package/dist/server/handlers/parse-and-add-project.d.ts.map +1 -1
  73. package/dist/server/handlers/parse-and-add-project.js +33 -10
  74. package/dist/server/handlers/parse-and-add-project.js.map +1 -1
  75. package/dist/server/handlers/query-interfaces.d.ts +1 -0
  76. package/dist/server/handlers/query-interfaces.d.ts.map +1 -1
  77. package/dist/server/handlers/query-interfaces.js +31 -12
  78. package/dist/server/handlers/query-interfaces.js.map +1 -1
  79. package/dist/server/handlers/select-interfaces.d.ts +23 -0
  80. package/dist/server/handlers/select-interfaces.d.ts.map +1 -0
  81. package/dist/server/handlers/select-interfaces.js +106 -0
  82. package/dist/server/handlers/select-interfaces.js.map +1 -0
  83. package/dist/server/handlers/utils.d.ts +3 -3
  84. package/dist/server/handlers/utils.d.ts.map +1 -1
  85. package/dist/server/handlers/utils.js +9 -6
  86. package/dist/server/handlers/utils.js.map +1 -1
  87. package/dist/server/index.js +25 -4
  88. package/dist/server/index.js.map +1 -1
  89. package/package.json +6 -2
package/README.md CHANGED
@@ -9,22 +9,26 @@
9
9
  ## ✨ 核心特性
10
10
 
11
11
  ### 🗂️ 多项目管理
12
+
12
13
  - 📋 统一管理工作空间中的所有 Apifox 项目
13
14
  - 🔗 一键解析分享链接,自动添加项目配置
14
15
  - 💾 智能维护项目配置文件(`apifox-mcp.json`)
15
16
 
16
17
  ### 🔍 智能接口查询
18
+
17
19
  - 🔎 关键词搜索,快速定位目标接口
18
20
  - 🏷️ 标签筛选,按模块分类查看
19
21
  - 📄 完整接口详情(请求参数、响应结构、示例代码)
20
22
 
21
23
  ### 🛠️ 代码自动生成
24
+
22
25
  - 📝 **TypeScript 类型定义** - 自动生成请求/响应类型
23
26
  - 🎭 **Mock 数据** - 基于接口规范生成测试数据
24
27
  - 🔌 **请求封装** - 生成类型安全的 API 调用函数
25
28
  - 🧪 **测试脚本** - 生成单元测试模板
26
29
 
27
30
  ### 🤖 自然语言助手
31
+
28
32
  - 💬 自然语言交互,无需记忆命令
29
33
  - 🧠 智能上下文记忆(项目、接口列表)
30
34
  - 🎯 意图识别,自动路由到正确的功能
@@ -126,6 +130,7 @@ npm run build
126
130
  3. ✅ MCP Server 启动并连接到 Cursor
127
131
 
128
132
  **无需操心**:
133
+
129
134
  - ❌ 克隆 Git 仓库
130
135
  - ❌ 安装 TypeScript 或构建工具
131
136
  - ❌ 运行 `npm run build`
@@ -173,6 +178,30 @@ npm run build
173
178
  @apifox 生成类型并保存到 src/api/types.ts
174
179
  ```
175
180
 
181
+ ### 5️⃣ 可视化选择接口(可选)
182
+
183
+ 当你需要跨目录选择多个接口时,可以使用浏览器可视化选择:
184
+
185
+ ```bash
186
+ # 安装 playwright(首次使用需要)
187
+ npm install playwright
188
+
189
+ # 打开浏览器选择接口
190
+ npm run apifox-enhance -- --url=https://apifox.advai.net/apidoc/shared/xxx
191
+ ```
192
+
193
+ 在浏览器中:
194
+
195
+ - ✅ 勾选需要的接口(支持跨目录选择)
196
+ - 📋 点击"确认选择"保存选择结果
197
+ - 🔄 回到 Cursor,直接说"生成这些接口的类型"即可
198
+
199
+ **优化说明**:
200
+
201
+ - Playwright 已改为**可选依赖**,不会增加主包体积
202
+ - 仅在使用浏览器选择功能时才需要安装
203
+ - 首次安装会自动下载 Chromium(约 150MB,仅一次)
204
+
176
205
  更多示例:[📗 docs/usage.md](docs/usage.md)
177
206
 
178
207
  ## 🏗️ 项目架构
@@ -281,18 +310,21 @@ npm run test -- --coverage
281
310
  ```
282
311
 
283
312
  **当前测试状态**:
284
- - ✅ 11/11 测试通过
285
- - ✅ 3 个测试文件
286
- - ✅ 覆盖 logger、types、url-parser 模块
313
+
314
+ - ✅ **40/40 测试通过** (100% 通过率)
315
+ - ✅ **7 个测试文件**
316
+ - ✅ 覆盖核心模块:logger、types、url-parser、intent、select-interfaces、unified-cache-manager、llms-parser
317
+ - ✅ 包含自然语言选择功能的完整测试覆盖
287
318
 
288
319
  ## 📊 项目指标
289
320
 
290
321
  | 指标 | 数值 |
291
322
  |------|------|
292
- | **TypeScript 文件** | 30 个 |
323
+ | **TypeScript 文件** | 30+ 个 |
293
324
  | **主入口行数** | 309 行(精简 68%)|
294
325
  | **模块数量** | 27 个 |
295
- | **单元测试** | 11 个(100% 通过)|
326
+ | **单元测试** | 40 个(100% 通过)|
327
+ | **测试文件** | 7 个 |
296
328
  | **类型安全** | 零 `any` 类型 |
297
329
  | **代码规范** | ESLint + Prettier |
298
330
 
@@ -304,7 +336,7 @@ npm run test -- --coverage
304
336
  - **HTTP 客户端**: Axios 1.7+
305
337
  - **测试框架**: Vitest 2.1+
306
338
  - **代码规范**: ESLint 9+ + Prettier 3+
307
- - **UI 增强**: Playwright 1.57+
339
+ - **UI 增强**: Playwright 1.57+ (可选依赖,仅在使用浏览器选择功能时需要)
308
340
 
309
341
  ## 📖 完整文档
310
342
 
@@ -312,7 +344,8 @@ npm run test -- --coverage
312
344
  - 📗 [使用指南](docs/usage.md) - 各种使用场景和示例
313
345
  - 📙 [架构设计](docs/architecture.md) - 项目架构和设计原则
314
346
  - 📕 [发布指南](docs/publishing.md) - npm 发布流程
315
- - 🧪 [测试文档](tests/README.md) - 测试说明和测试用例
347
+ - 🔍 [接口选择策略](docs/interface-selection-strategy.md) - 接口选择的详细说明和优化方案
348
+ - 🎯 [功能详细介绍](docs/features.md) - 完整的功能介绍、逻辑流程和使用方式
316
349
 
317
350
  ## 🤝 贡献指南
318
351
 
@@ -352,7 +385,6 @@ npm run test -- --coverage
352
385
 
353
386
  1. [常见问题](docs/setup.md#常见问题)
354
387
  2. [Issues](https://github.com/apifox/apifox-workspace-mcp/issues)
355
- 3. [测试文档](tests/README.md)
356
388
 
357
389
  ## 📄 许可证
358
390
 
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=intent.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"intent.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/intent.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,62 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { parseIntent } from '../core/intent.js';
3
+ describe('intent parser', () => {
4
+ describe('parseIntent - 选择功能', () => {
5
+ it('应该识别编号选择意图', () => {
6
+ const result = parseIntent('选择接口 1, 3, 5');
7
+ expect(result.action).toBe('selectInterfaces');
8
+ expect(result.selectionCriteria?.indices).toEqual([1, 3, 5]);
9
+ });
10
+ it('应该识别范围选择意图', () => {
11
+ const result = parseIntent('选择接口 1-5');
12
+ expect(result.action).toBe('selectInterfaces');
13
+ expect(result.selectionCriteria?.ranges).toEqual([{ start: 1, end: 5 }]);
14
+ });
15
+ it('应该识别混合选择意图', () => {
16
+ const result = parseIntent('选择接口 1, 3, 5-10');
17
+ expect(result.action).toBe('selectInterfaces');
18
+ expect(result.selectionCriteria?.indices).toEqual([1, 3]);
19
+ expect(result.selectionCriteria?.ranges).toEqual([{ start: 5, end: 10 }]);
20
+ });
21
+ it('应该识别关键词选择意图', () => {
22
+ const result = parseIntent('选择包含"支付"的接口');
23
+ expect(result.action).toBe('selectInterfaces');
24
+ expect(result.selectionCriteria?.keywords).toContain('支付');
25
+ });
26
+ it('应该识别多个关键词选择意图', () => {
27
+ const result = parseIntent('选择包含"支付"和"退款"的接口');
28
+ expect(result.action).toBe('selectInterfaces');
29
+ expect(result.selectionCriteria?.keywords).toContain('支付');
30
+ });
31
+ it('应该识别接口名称选择意图', () => {
32
+ const candidates = ['退款接口', '支付接口', '查询接口'];
33
+ const result = parseIntent('选择"退款接口"和"支付接口"', {
34
+ lastInterfaceListNames: candidates,
35
+ });
36
+ expect(result.action).toBe('selectInterfaces');
37
+ expect(result.selectionCriteria?.names).toContain('退款接口');
38
+ expect(result.selectionCriteria?.names).toContain('支付接口');
39
+ });
40
+ });
41
+ describe('parseIntent - 其他功能', () => {
42
+ it('应该识别查询意图', () => {
43
+ const result = parseIntent('查询支付接口');
44
+ expect(result.action).toBe('searchInterfaces');
45
+ expect(result.keyword).toBe('支付接口');
46
+ });
47
+ it('应该识别生成意图', () => {
48
+ const result = parseIntent('生成退款接口的类型');
49
+ expect(result.action).toBe('generateArtifacts');
50
+ expect(result.artifactType).toBe('ts_types');
51
+ });
52
+ it('应该识别浏览器打开意图', () => {
53
+ const result = parseIntent('打开浏览器');
54
+ expect(result.action).toBe('openBrowser');
55
+ });
56
+ it('应该识别列表项目意图', () => {
57
+ const result = parseIntent('项目');
58
+ expect(result.action).toBe('listProjects');
59
+ });
60
+ });
61
+ });
62
+ //# sourceMappingURL=intent.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"intent.test.js","sourceRoot":"","sources":["../../src/__tests__/intent.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * llms.txt 解析器单元测试
3
+ */
4
+ export {};
5
+ //# sourceMappingURL=llms-parser.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"llms-parser.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/llms-parser.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}
@@ -0,0 +1,57 @@
1
+ /**
2
+ * llms.txt 解析器单元测试
3
+ */
4
+ import { describe, it, expect } from 'vitest';
5
+ import { parseLlmsContent } from '../core/parser/llms.js';
6
+ describe('parseLlmsContent', () => {
7
+ it('应该能够解析基本的 llms.txt 内容', () => {
8
+ const content = `
9
+ - APP API company subscribe [Subscribe company](https://apifox.advai.net/apidoc/shared/3fe93a62-4f68-45ac-b263-e078e1928dfc/api-2404.md):
10
+ - Invoice > Info [Create Invoice Info](https://apifox.advai.net/apidoc/shared/3fe93a62-4f68-45ac-b263-e078e1928dfc/api-2406.md): v2.28
11
+ `;
12
+ const result = parseLlmsContent(content);
13
+ expect(result.length).toBe(2);
14
+ expect(result[0].id).toBe('2404');
15
+ expect(result[0].name).toBe('Subscribe company');
16
+ expect(result[0].folderPath).toBe('APP API company subscribe');
17
+ expect(result[0].version).toBeUndefined();
18
+ expect(result[1].id).toBe('2406');
19
+ expect(result[1].name).toBe('Create Invoice Info');
20
+ expect(result[1].folderPath).toBe('Invoice > Info');
21
+ expect(result[1].version).toBe('v2.28');
22
+ });
23
+ it('应该能够处理根目录的接口', () => {
24
+ const content = `
25
+ - [Root Interface](https://apifox.advai.net/apidoc/shared/xxx/api-1234.md):
26
+ `;
27
+ const result = parseLlmsContent(content);
28
+ expect(result.length).toBe(1);
29
+ expect(result[0].id).toBe('1234');
30
+ expect(result[0].name).toBe('Root Interface');
31
+ expect(result[0].folderPath).toBe('');
32
+ });
33
+ it('应该能够处理多级目录', () => {
34
+ const content = `
35
+ - Level1 > Level2 > Level3 [Deep Interface](https://apifox.advai.net/apidoc/shared/xxx/api-5678.md):
36
+ `;
37
+ const result = parseLlmsContent(content);
38
+ expect(result.length).toBe(1);
39
+ expect(result[0].folderPath).toBe('Level1 > Level2 > Level3');
40
+ });
41
+ it('应该忽略无效的行', () => {
42
+ const content = `
43
+ - Valid [Interface](https://apifox.advai.net/apidoc/shared/xxx/api-1234.md):
44
+ Invalid line without link
45
+ - Another [Valid](https://apifox.advai.net/apidoc/shared/xxx/api-5678.md):
46
+ `;
47
+ const result = parseLlmsContent(content);
48
+ expect(result.length).toBe(2);
49
+ expect(result[0].id).toBe('1234');
50
+ expect(result[1].id).toBe('5678');
51
+ });
52
+ it('应该能够处理空内容', () => {
53
+ const result = parseLlmsContent('');
54
+ expect(result.length).toBe(0);
55
+ });
56
+ });
57
+ //# sourceMappingURL=llms-parser.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"llms-parser.test.js","sourceRoot":"","sources":["../../src/__tests__/llms-parser.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=select-interfaces.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"select-interfaces.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/select-interfaces.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,127 @@
1
+ import { describe, it, expect, beforeEach, vi } from 'vitest';
2
+ import { handleSelectInterfaces } from '../server/handlers/select-interfaces.js';
3
+ // Mock utils
4
+ vi.mock('../server/handlers/utils.js', () => ({
5
+ resolveProjectInfo: vi.fn((projectRoot, contextStore, projectName, projectId) => {
6
+ if (projectName || projectId) {
7
+ return {
8
+ projectId: 'test-project-id',
9
+ projectName: 'test-project',
10
+ };
11
+ }
12
+ return null;
13
+ }),
14
+ buildTextResponse: vi.fn((text) => ({
15
+ content: [{ type: 'text', text }],
16
+ })),
17
+ buildMissingTokenResponse: vi.fn(() => ({
18
+ content: [{ type: 'text', text: 'Missing token' }],
19
+ })),
20
+ }));
21
+ describe('select-interfaces handler', () => {
22
+ let mockConfigManager;
23
+ let mockContextStore;
24
+ let mockProjectRoot;
25
+ beforeEach(() => {
26
+ mockProjectRoot = '/test/project';
27
+ mockConfigManager = {
28
+ getAccessToken: vi.fn().mockReturnValue('test-token'),
29
+ };
30
+ mockContextStore = {
31
+ getLastInterfaceList: vi.fn().mockReturnValue({
32
+ projectId: 'test-project-id',
33
+ projectName: 'test-project',
34
+ list: [
35
+ { id: '1', name: '接口1', description: '描述1' },
36
+ { id: '2', name: '接口2', description: '描述2' },
37
+ { id: '3', name: '支付接口', description: '支付相关' },
38
+ { id: '4', name: '退款接口', description: '退款相关' },
39
+ { id: '5', name: '查询接口', description: '查询相关' },
40
+ ],
41
+ savedAt: new Date().toISOString(),
42
+ }),
43
+ saveSelections: vi.fn(),
44
+ getLastProject: vi.fn().mockReturnValue({
45
+ projectId: 'test-project-id',
46
+ projectName: 'test-project',
47
+ }),
48
+ };
49
+ });
50
+ describe('编号选择', () => {
51
+ it('应该根据编号选择接口', async () => {
52
+ const criteria = {
53
+ indices: [1, 3, 5],
54
+ };
55
+ const result = await handleSelectInterfaces({
56
+ projectName: 'test-project',
57
+ selectionCriteria: criteria,
58
+ }, {
59
+ projectRoot: mockProjectRoot,
60
+ configManager: mockConfigManager,
61
+ contextStore: mockContextStore,
62
+ });
63
+ expect(result.content[0].text).toContain('已选择 3 个接口');
64
+ expect(mockContextStore.saveSelections).toHaveBeenCalled();
65
+ });
66
+ it('应该处理范围选择', async () => {
67
+ const criteria = {
68
+ ranges: [{ start: 1, end: 3 }],
69
+ };
70
+ const result = await handleSelectInterfaces({
71
+ projectName: 'test-project',
72
+ selectionCriteria: criteria,
73
+ }, {
74
+ projectRoot: mockProjectRoot,
75
+ configManager: mockConfigManager,
76
+ contextStore: mockContextStore,
77
+ });
78
+ expect(result.content[0].text).toContain('已选择');
79
+ });
80
+ });
81
+ describe('关键词选择', () => {
82
+ it('应该根据关键词选择接口', async () => {
83
+ const criteria = {
84
+ keywords: ['支付'],
85
+ };
86
+ const result = await handleSelectInterfaces({
87
+ projectName: 'test-project',
88
+ selectionCriteria: criteria,
89
+ }, {
90
+ projectRoot: mockProjectRoot,
91
+ configManager: mockConfigManager,
92
+ contextStore: mockContextStore,
93
+ });
94
+ expect(result.content[0].text).toContain('已选择');
95
+ expect(result.content[0].text).toContain('支付接口');
96
+ });
97
+ });
98
+ describe('错误处理', () => {
99
+ it('应该处理没有接口列表的情况', async () => {
100
+ mockContextStore.getLastInterfaceList.mockReturnValue(null);
101
+ const result = await handleSelectInterfaces({
102
+ projectName: 'test-project',
103
+ selectionCriteria: { indices: [1] },
104
+ }, {
105
+ projectRoot: mockProjectRoot,
106
+ configManager: mockConfigManager,
107
+ contextStore: mockContextStore,
108
+ });
109
+ expect(result.content[0].text).toContain('请先查询接口列表');
110
+ });
111
+ it('应该处理没有匹配接口的情况', async () => {
112
+ const criteria = {
113
+ indices: [999], // 不存在的编号
114
+ };
115
+ const result = await handleSelectInterfaces({
116
+ projectName: 'test-project',
117
+ selectionCriteria: criteria,
118
+ }, {
119
+ projectRoot: mockProjectRoot,
120
+ configManager: mockConfigManager,
121
+ contextStore: mockContextStore,
122
+ });
123
+ expect(result.content[0].text).toContain('没有找到匹配的接口');
124
+ });
125
+ });
126
+ });
127
+ //# sourceMappingURL=select-interfaces.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"select-interfaces.test.js","sourceRoot":"","sources":["../../src/__tests__/select-interfaces.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAGjF,aAAa;AACb,EAAE,CAAC,IAAI,CAAC,6BAA6B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5C,kBAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE;QAC9E,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;YAC7B,OAAO;gBACL,SAAS,EAAE,iBAAiB;gBAC5B,WAAW,EAAE,cAAc;aAC5B,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,iBAAiB,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;QAC1C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAClC,CAAC,CAAC;IACH,yBAAyB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QACtC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;KACnD,CAAC,CAAC;CACJ,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,IAAI,iBAAsB,CAAC;IAC3B,IAAI,gBAAqB,CAAC;IAC1B,IAAI,eAAuB,CAAC;IAE5B,UAAU,CAAC,GAAG,EAAE;QACd,eAAe,GAAG,eAAe,CAAC;QAClC,iBAAiB,GAAG;YAClB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,YAAY,CAAC;SACtD,CAAC;QACF,gBAAgB,GAAG;YACjB,oBAAoB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;gBAC5C,SAAS,EAAE,iBAAiB;gBAC5B,WAAW,EAAE,cAAc;gBAC3B,IAAI,EAAE;oBACJ,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE;oBAC5C,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE;oBAC5C,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;oBAC9C,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;oBAC9C,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;iBAC/C;gBACD,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAClC,CAAC;YACF,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;YACvB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;gBACtC,SAAS,EAAE,iBAAiB;gBAC5B,WAAW,EAAE,cAAc;aAC5B,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,EAAE,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;YAC1B,MAAM,QAAQ,GAAsB;gBAClC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;aACnB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC;gBACE,WAAW,EAAE,cAAc;gBAC3B,iBAAiB,EAAE,QAAQ;aAC5B,EACD;gBACE,WAAW,EAAE,eAAe;gBAC5B,aAAa,EAAE,iBAAiB;gBAChC,YAAY,EAAE,gBAAgB;aAC/B,CACF,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACtD,MAAM,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;YACxB,MAAM,QAAQ,GAAsB;gBAClC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;aAC/B,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC;gBACE,WAAW,EAAE,cAAc;gBAC3B,iBAAiB,EAAE,QAAQ;aAC5B,EACD;gBACE,WAAW,EAAE,eAAe;gBAC5B,aAAa,EAAE,iBAAiB;gBAChC,YAAY,EAAE,gBAAgB;aAC/B,CACF,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,EAAE,CAAC,aAAa,EAAE,KAAK,IAAI,EAAE;YAC3B,MAAM,QAAQ,GAAsB;gBAClC,QAAQ,EAAE,CAAC,IAAI,CAAC;aACjB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC;gBACE,WAAW,EAAE,cAAc;gBAC3B,iBAAiB,EAAE,QAAQ;aAC5B,EACD;gBACE,WAAW,EAAE,eAAe;gBAC5B,aAAa,EAAE,iBAAiB;gBAChC,YAAY,EAAE,gBAAgB;aAC/B,CACF,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,EAAE,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;YAC7B,gBAAgB,CAAC,oBAAoB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAE5D,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC;gBACE,WAAW,EAAE,cAAc;gBAC3B,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;aACpC,EACD;gBACE,WAAW,EAAE,eAAe;gBAC5B,aAAa,EAAE,iBAAiB;gBAChC,YAAY,EAAE,gBAAgB;aAC/B,CACF,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;YAC7B,MAAM,QAAQ,GAAsB;gBAClC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,SAAS;aAC1B,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC;gBACE,WAAW,EAAE,cAAc;gBAC3B,iBAAiB,EAAE,QAAQ;aAC5B,EACD;gBACE,WAAW,EAAE,eAAe;gBAC5B,aAAa,EAAE,iBAAiB;gBAChC,YAAY,EAAE,gBAAgB;aAC/B,CACF,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * UnifiedCacheManager 单元测试
3
+ */
4
+ export {};
5
+ //# sourceMappingURL=unified-cache-manager.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unified-cache-manager.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/unified-cache-manager.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}
@@ -0,0 +1,158 @@
1
+ /**
2
+ * UnifiedCacheManager 单元测试
3
+ */
4
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
5
+ import { existsSync, unlinkSync, mkdirSync } from 'fs';
6
+ import { join } from 'path';
7
+ import { tmpdir } from 'os';
8
+ import { UnifiedCacheManager, } from '../core/cache/unified-cache-manager.js';
9
+ describe('UnifiedCacheManager', () => {
10
+ let testProjectRoot;
11
+ let cacheManager;
12
+ beforeEach(() => {
13
+ // 使用临时目录作为测试项目根目录
14
+ testProjectRoot = join(tmpdir(), `apifox-test-${Date.now()}`);
15
+ mkdirSync(testProjectRoot, { recursive: true });
16
+ mkdirSync(join(testProjectRoot, '.cursor', 'tmp'), { recursive: true });
17
+ cacheManager = new UnifiedCacheManager(testProjectRoot);
18
+ });
19
+ afterEach(() => {
20
+ // 清理测试文件
21
+ const cachePath = join(testProjectRoot, '.cursor', 'tmp', 'apifox-interfaces-cache.json');
22
+ if (existsSync(cachePath)) {
23
+ unlinkSync(cachePath);
24
+ }
25
+ });
26
+ describe('项目元数据管理', () => {
27
+ it('应该能够添加新项目', () => {
28
+ cacheManager.upsertProjectMetadata('test-project', '123', 'https://example.com/llms.txt');
29
+ const project = cacheManager.findProjectByName('test-project');
30
+ expect(project).not.toBeNull();
31
+ expect(project?.projectName).toBe('test-project');
32
+ expect(project?.projectIds).toBe('123');
33
+ expect(project?.llmsUrls).toBe('https://example.com/llms.txt');
34
+ });
35
+ it('应该能够更新现有项目', () => {
36
+ cacheManager.upsertProjectMetadata('test-project', '123', 'https://example.com/llms.txt');
37
+ cacheManager.upsertProjectMetadata('test-project', '123', 'https://example.com/llms-v2.txt');
38
+ const project = cacheManager.findProjectByName('test-project');
39
+ expect(project?.llmsUrls).toBe('https://example.com/llms-v2.txt');
40
+ });
41
+ it('应该能够通过项目 ID 查找项目', () => {
42
+ cacheManager.upsertProjectMetadata('test-project', '123', 'https://example.com/llms.txt');
43
+ const project = cacheManager.findProjectById('123');
44
+ expect(project).not.toBeNull();
45
+ expect(project?.projectName).toBe('test-project');
46
+ });
47
+ it('应该能够列出所有项目', () => {
48
+ cacheManager.upsertProjectMetadata('project-1', '123', 'https://example.com/llms1.txt');
49
+ cacheManager.upsertProjectMetadata('project-2', '456', 'https://example.com/llms2.txt');
50
+ const projects = cacheManager.listProjects();
51
+ expect(projects.length).toBe(2);
52
+ expect(projects.find((p) => p.name === 'project-1')).toBeDefined();
53
+ expect(projects.find((p) => p.name === 'project-2')).toBeDefined();
54
+ });
55
+ });
56
+ describe('接口列表管理', () => {
57
+ beforeEach(() => {
58
+ cacheManager.upsertProjectMetadata('test-project', '123', 'https://example.com/llms.txt');
59
+ });
60
+ it('应该能够更新接口列表', () => {
61
+ const interfaces = [
62
+ {
63
+ id: '1',
64
+ name: '接口1',
65
+ folderPath: '目录1',
66
+ docUrl: 'https://example.com/api-1.md',
67
+ version: 'v1.0',
68
+ },
69
+ {
70
+ id: '2',
71
+ name: '接口2',
72
+ folderPath: '目录1 > 子目录',
73
+ docUrl: 'https://example.com/api-2.md',
74
+ },
75
+ ];
76
+ cacheManager.updateInterfacesFromLlms('test-project', interfaces);
77
+ const project = cacheManager.findProjectByName('test-project');
78
+ expect(project?.interfaces.length).toBe(2);
79
+ expect(project?.interfaces[0].id).toBe('1');
80
+ expect(project?.interfaces[1].id).toBe('2');
81
+ });
82
+ it('应该能够查找接口', () => {
83
+ const interfaces = [
84
+ {
85
+ id: '1',
86
+ name: '接口1',
87
+ folderPath: '目录1',
88
+ docUrl: 'https://example.com/api-1.md',
89
+ },
90
+ ];
91
+ cacheManager.updateInterfacesFromLlms('test-project', interfaces);
92
+ const found = cacheManager.findInterface('test-project', '1');
93
+ expect(found).not.toBeNull();
94
+ expect(found?.name).toBe('接口1');
95
+ });
96
+ it('应该能够获取接口列表', () => {
97
+ const interfaces = [
98
+ {
99
+ id: '1',
100
+ name: '用户接口',
101
+ folderPath: '用户管理',
102
+ docUrl: 'https://example.com/api-1.md',
103
+ },
104
+ {
105
+ id: '2',
106
+ name: '订单接口',
107
+ folderPath: '订单管理',
108
+ docUrl: 'https://example.com/api-2.md',
109
+ },
110
+ ];
111
+ cacheManager.updateInterfacesFromLlms('test-project', interfaces);
112
+ const allInterfaces = cacheManager.getInterfaces('test-project');
113
+ expect(allInterfaces.length).toBe(2);
114
+ const filtered = cacheManager.getInterfaces('test-project', '用户');
115
+ expect(filtered.length).toBe(1);
116
+ expect(filtered[0].name).toBe('用户接口');
117
+ });
118
+ it('应该支持关键词过滤', () => {
119
+ const interfaces = [
120
+ {
121
+ id: '1',
122
+ name: '创建用户',
123
+ folderPath: '用户管理',
124
+ docUrl: 'https://example.com/api-1.md',
125
+ },
126
+ {
127
+ id: '2',
128
+ name: '创建订单',
129
+ folderPath: '订单管理',
130
+ docUrl: 'https://example.com/api-2.md',
131
+ },
132
+ ];
133
+ cacheManager.updateInterfacesFromLlms('test-project', interfaces);
134
+ const filtered = cacheManager.getInterfaces('test-project', '订单');
135
+ expect(filtered.length).toBe(1);
136
+ expect(filtered[0].name).toBe('创建订单');
137
+ });
138
+ });
139
+ describe('持久化', () => {
140
+ it('应该能够持久化到文件', () => {
141
+ cacheManager.upsertProjectMetadata('test-project', '123', 'https://example.com/llms.txt');
142
+ cacheManager.updateInterfacesFromLlms('test-project', [
143
+ {
144
+ id: '1',
145
+ name: '接口1',
146
+ folderPath: '目录1',
147
+ docUrl: 'https://example.com/api-1.md',
148
+ },
149
+ ]);
150
+ // 创建新的管理器实例,应该能够加载之前保存的数据
151
+ const newManager = new UnifiedCacheManager(testProjectRoot);
152
+ const project = newManager.findProjectByName('test-project');
153
+ expect(project).not.toBeNull();
154
+ expect(project?.interfaces.length).toBe(1);
155
+ });
156
+ });
157
+ });
158
+ //# sourceMappingURL=unified-cache-manager.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unified-cache-manager.test.js","sourceRoot":"","sources":["../../src/__tests__/unified-cache-manager.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * 缓存模块
3
+ */
4
+ export { InterfaceCacheManager } from './interface-cache-manager.js';
5
+ export type { InterfaceBasicInfo, InterfaceCache } from './interface-cache-manager.js';
6
+ export { UnifiedCacheManager } from './unified-cache-manager.js';
7
+ export type { CachedInterface, ProjectCache, UnifiedCache } from './unified-cache-manager.js';
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * 缓存模块
3
+ */
4
+ export { InterfaceCacheManager } from './interface-cache-manager.js';
5
+ // 统一缓存管理器
6
+ export { UnifiedCacheManager } from './unified-cache-manager.js';
7
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGrE,UAAU;AACV,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}