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.
- package/README.md +40 -8
- package/dist/__tests__/intent.test.d.ts +2 -0
- package/dist/__tests__/intent.test.d.ts.map +1 -0
- package/dist/__tests__/intent.test.js +62 -0
- package/dist/__tests__/intent.test.js.map +1 -0
- package/dist/__tests__/llms-parser.test.d.ts +5 -0
- package/dist/__tests__/llms-parser.test.d.ts.map +1 -0
- package/dist/__tests__/llms-parser.test.js +57 -0
- package/dist/__tests__/llms-parser.test.js.map +1 -0
- package/dist/__tests__/select-interfaces.test.d.ts +2 -0
- package/dist/__tests__/select-interfaces.test.d.ts.map +1 -0
- package/dist/__tests__/select-interfaces.test.js +127 -0
- package/dist/__tests__/select-interfaces.test.js.map +1 -0
- package/dist/__tests__/unified-cache-manager.test.d.ts +5 -0
- package/dist/__tests__/unified-cache-manager.test.d.ts.map +1 -0
- package/dist/__tests__/unified-cache-manager.test.js +158 -0
- package/dist/__tests__/unified-cache-manager.test.js.map +1 -0
- package/dist/core/cache/index.d.ts +8 -0
- package/dist/core/cache/index.d.ts.map +1 -0
- package/dist/core/cache/index.js +7 -0
- package/dist/core/cache/index.js.map +1 -0
- package/dist/core/cache/interface-cache-manager.d.ts +118 -0
- package/dist/core/cache/interface-cache-manager.d.ts.map +1 -0
- package/dist/core/cache/interface-cache-manager.js +236 -0
- package/dist/core/cache/interface-cache-manager.js.map +1 -0
- package/dist/core/cache/unified-cache-manager.d.ts +139 -0
- package/dist/core/cache/unified-cache-manager.d.ts.map +1 -0
- package/dist/core/cache/unified-cache-manager.js +446 -0
- package/dist/core/cache/unified-cache-manager.js.map +1 -0
- package/dist/core/client/mcp-bridge.d.ts +14 -10
- package/dist/core/client/mcp-bridge.d.ts.map +1 -1
- package/dist/core/client/mcp-bridge.js +64 -94
- package/dist/core/client/mcp-bridge.js.map +1 -1
- package/dist/core/config/manager.d.ts +6 -0
- package/dist/core/config/manager.d.ts.map +1 -1
- package/dist/core/config/manager.js +13 -0
- package/dist/core/config/manager.js.map +1 -1
- package/dist/core/index.d.ts +2 -0
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +2 -0
- package/dist/core/index.js.map +1 -1
- package/dist/core/intent.d.ts +11 -1
- package/dist/core/intent.d.ts.map +1 -1
- package/dist/core/intent.js +121 -12
- package/dist/core/intent.js.map +1 -1
- package/dist/core/parser/index.d.ts +2 -0
- package/dist/core/parser/index.d.ts.map +1 -1
- package/dist/core/parser/index.js +1 -0
- package/dist/core/parser/index.js.map +1 -1
- package/dist/core/parser/llms.d.ts +37 -0
- package/dist/core/parser/llms.d.ts.map +1 -0
- package/dist/core/parser/llms.js +83 -0
- package/dist/core/parser/llms.js.map +1 -0
- package/dist/server/handlers/assistant.d.ts.map +1 -1
- package/dist/server/handlers/assistant.js +11 -5
- package/dist/server/handlers/assistant.js.map +1 -1
- package/dist/server/handlers/generate-artifacts.d.ts.map +1 -1
- package/dist/server/handlers/generate-artifacts.js +3 -3
- package/dist/server/handlers/generate-artifacts.js.map +1 -1
- package/dist/server/handlers/get-interface-detail.d.ts +1 -0
- package/dist/server/handlers/get-interface-detail.d.ts.map +1 -1
- package/dist/server/handlers/get-interface-detail.js +3 -3
- package/dist/server/handlers/get-interface-detail.js.map +1 -1
- package/dist/server/handlers/index.d.ts +1 -0
- package/dist/server/handlers/index.d.ts.map +1 -1
- package/dist/server/handlers/index.js +1 -0
- package/dist/server/handlers/index.js.map +1 -1
- package/dist/server/handlers/list-projects.d.ts +1 -2
- package/dist/server/handlers/list-projects.d.ts.map +1 -1
- package/dist/server/handlers/list-projects.js +6 -28
- package/dist/server/handlers/list-projects.js.map +1 -1
- package/dist/server/handlers/parse-and-add-project.d.ts.map +1 -1
- package/dist/server/handlers/parse-and-add-project.js +33 -10
- package/dist/server/handlers/parse-and-add-project.js.map +1 -1
- package/dist/server/handlers/query-interfaces.d.ts +1 -0
- package/dist/server/handlers/query-interfaces.d.ts.map +1 -1
- package/dist/server/handlers/query-interfaces.js +31 -12
- package/dist/server/handlers/query-interfaces.js.map +1 -1
- package/dist/server/handlers/select-interfaces.d.ts +23 -0
- package/dist/server/handlers/select-interfaces.d.ts.map +1 -0
- package/dist/server/handlers/select-interfaces.js +106 -0
- package/dist/server/handlers/select-interfaces.js.map +1 -0
- package/dist/server/handlers/utils.d.ts +3 -3
- package/dist/server/handlers/utils.d.ts.map +1 -1
- package/dist/server/handlers/utils.js +9 -6
- package/dist/server/handlers/utils.js.map +1 -1
- package/dist/server/index.js +25 -4
- package/dist/server/index.js.map +1 -1
- package/package.json +6 -2
|
@@ -0,0 +1,446 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 统一缓存管理器
|
|
3
|
+
*
|
|
4
|
+
* 管理项目元数据和接口缓存,所有数据存储在 apifox-interfaces-cache.json
|
|
5
|
+
* 接口只缓存基础信息(id, name, folderPath, docUrl, version),不缓存 method, path, description
|
|
6
|
+
*
|
|
7
|
+
* 优化特性:
|
|
8
|
+
* - 内存缓存:减少 I/O 操作,提升查询性能
|
|
9
|
+
* - 延迟保存:只在必要时保存,批量更新时只保存一次
|
|
10
|
+
* - 文件锁:防止并发写入导致的数据损坏
|
|
11
|
+
* - 索引优化:使用 Map 建立索引,查找时间复杂度 O(1)
|
|
12
|
+
* - 错误恢复:自动备份损坏的文件
|
|
13
|
+
*/
|
|
14
|
+
import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, statSync, openSync, closeSync, unlinkSync, constants, } from 'fs';
|
|
15
|
+
import { dirname, join } from 'path';
|
|
16
|
+
/**
|
|
17
|
+
* 运行时类型验证函数(简化版本,不依赖外部库)
|
|
18
|
+
*/
|
|
19
|
+
function validateCachedInterface(obj) {
|
|
20
|
+
if (typeof obj !== 'object' || obj === null)
|
|
21
|
+
return false;
|
|
22
|
+
const iface = obj;
|
|
23
|
+
return (typeof iface.id === 'string' &&
|
|
24
|
+
typeof iface.name === 'string' &&
|
|
25
|
+
typeof iface.folderPath === 'string' &&
|
|
26
|
+
typeof iface.docUrl === 'string' &&
|
|
27
|
+
(iface.version === undefined || typeof iface.version === 'string'));
|
|
28
|
+
}
|
|
29
|
+
function validateProjectCache(obj) {
|
|
30
|
+
if (typeof obj !== 'object' || obj === null)
|
|
31
|
+
return false;
|
|
32
|
+
const project = obj;
|
|
33
|
+
return (typeof project.projectName === 'string' &&
|
|
34
|
+
typeof project.projectIds === 'string' &&
|
|
35
|
+
typeof project.llmsUrls === 'string' &&
|
|
36
|
+
Array.isArray(project.interfaces) &&
|
|
37
|
+
project.interfaces.every(validateCachedInterface));
|
|
38
|
+
}
|
|
39
|
+
function validateUnifiedCache(obj) {
|
|
40
|
+
return Array.isArray(obj) && obj.every(validateProjectCache);
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* 统一缓存管理器
|
|
44
|
+
*/
|
|
45
|
+
export class UnifiedCacheManager {
|
|
46
|
+
cachePath;
|
|
47
|
+
cache;
|
|
48
|
+
cacheDirty = false; // 标记缓存是否被修改
|
|
49
|
+
lastLoadTime = 0; // 上次加载时间
|
|
50
|
+
// 索引:提升查找性能
|
|
51
|
+
projectNameIndex = new Map();
|
|
52
|
+
projectIdIndex = new Map();
|
|
53
|
+
interfaceIndex = new Map(); // projectName -> interfaceId -> index
|
|
54
|
+
constructor(projectRoot) {
|
|
55
|
+
const cacheDir = join(projectRoot, '.cursor', 'tmp');
|
|
56
|
+
this.cachePath = join(cacheDir, 'apifox-interfaces-cache.json');
|
|
57
|
+
this.cache = this.loadCache();
|
|
58
|
+
this.lastLoadTime = Date.now();
|
|
59
|
+
this.buildIndexes();
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* 构建索引
|
|
63
|
+
*/
|
|
64
|
+
buildIndexes() {
|
|
65
|
+
this.projectNameIndex.clear();
|
|
66
|
+
this.projectIdIndex.clear();
|
|
67
|
+
this.interfaceIndex.clear();
|
|
68
|
+
this.cache.forEach((project, projectIndex) => {
|
|
69
|
+
this.projectNameIndex.set(project.projectName, projectIndex);
|
|
70
|
+
this.projectIdIndex.set(project.projectIds, projectIndex);
|
|
71
|
+
const interfaceMap = new Map();
|
|
72
|
+
project.interfaces.forEach((iface, ifaceIndex) => {
|
|
73
|
+
interfaceMap.set(iface.id, ifaceIndex);
|
|
74
|
+
});
|
|
75
|
+
this.interfaceIndex.set(project.projectName, interfaceMap);
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* 加载缓存文件(带类型验证)
|
|
80
|
+
*/
|
|
81
|
+
loadCache() {
|
|
82
|
+
if (!existsSync(this.cachePath)) {
|
|
83
|
+
return [];
|
|
84
|
+
}
|
|
85
|
+
try {
|
|
86
|
+
const content = readFileSync(this.cachePath, 'utf-8');
|
|
87
|
+
const parsed = JSON.parse(content);
|
|
88
|
+
// 使用运行时类型验证
|
|
89
|
+
if (!validateUnifiedCache(parsed)) {
|
|
90
|
+
console.error('缓存文件格式验证失败:数据结构不符合预期');
|
|
91
|
+
console.error('期望格式:数组,每个元素包含 projectName, projectIds, llmsUrls, interfaces');
|
|
92
|
+
throw new Error('缓存文件格式验证失败,请检查文件内容');
|
|
93
|
+
}
|
|
94
|
+
return parsed;
|
|
95
|
+
}
|
|
96
|
+
catch (error) {
|
|
97
|
+
// 区分错误类型
|
|
98
|
+
if (error instanceof SyntaxError) {
|
|
99
|
+
console.error('缓存文件 JSON 解析错误,文件可能已损坏');
|
|
100
|
+
}
|
|
101
|
+
else if (error.code === 'ENOENT') {
|
|
102
|
+
// 文件不存在 - 正常情况,返回空数组
|
|
103
|
+
return [];
|
|
104
|
+
}
|
|
105
|
+
else if (error.message?.includes('格式验证失败')) {
|
|
106
|
+
console.error('缓存文件格式验证失败:', error.message);
|
|
107
|
+
}
|
|
108
|
+
else {
|
|
109
|
+
console.error('加载统一缓存失败:', error);
|
|
110
|
+
}
|
|
111
|
+
// 备份损坏的文件
|
|
112
|
+
try {
|
|
113
|
+
if (existsSync(this.cachePath)) {
|
|
114
|
+
const backupPath = `${this.cachePath}.backup.${Date.now()}`;
|
|
115
|
+
copyFileSync(this.cachePath, backupPath);
|
|
116
|
+
console.log(`已备份损坏的缓存文件到: ${backupPath}`);
|
|
117
|
+
console.log('建议检查备份文件,修复后可以恢复数据');
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
catch (backupError) {
|
|
121
|
+
console.error('备份失败:', backupError);
|
|
122
|
+
}
|
|
123
|
+
return [];
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
/**
|
|
127
|
+
* 标记缓存为已修改
|
|
128
|
+
*/
|
|
129
|
+
markDirty() {
|
|
130
|
+
this.cacheDirty = true;
|
|
131
|
+
}
|
|
132
|
+
/**
|
|
133
|
+
* 检查并清理过期的锁文件
|
|
134
|
+
*/
|
|
135
|
+
checkAndCleanExpiredLock(lockPath, maxAge = 5 * 60 * 1000) {
|
|
136
|
+
if (!existsSync(lockPath)) {
|
|
137
|
+
return;
|
|
138
|
+
}
|
|
139
|
+
try {
|
|
140
|
+
const stats = statSync(lockPath);
|
|
141
|
+
const age = Date.now() - stats.mtime.getTime();
|
|
142
|
+
if (age > maxAge) {
|
|
143
|
+
console.warn(`检测到过期的锁文件(${Math.round(age / 1000)}秒前创建),正在清理...`);
|
|
144
|
+
try {
|
|
145
|
+
unlinkSync(lockPath);
|
|
146
|
+
console.log('已清理过期的锁文件');
|
|
147
|
+
}
|
|
148
|
+
catch (error) {
|
|
149
|
+
console.warn('清理过期锁文件失败:', error);
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
catch (error) {
|
|
154
|
+
// 如果无法读取锁文件信息,尝试删除
|
|
155
|
+
console.warn('无法读取锁文件信息,尝试删除:', error);
|
|
156
|
+
try {
|
|
157
|
+
unlinkSync(lockPath);
|
|
158
|
+
}
|
|
159
|
+
catch {
|
|
160
|
+
// 忽略删除错误
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
/**
|
|
165
|
+
* 保存缓存到文件(带文件锁)
|
|
166
|
+
* 使用 fs.openSync 的排他模式实现简单的文件锁
|
|
167
|
+
*/
|
|
168
|
+
async saveCache() {
|
|
169
|
+
if (!this.cacheDirty) {
|
|
170
|
+
return; // 没有修改,不需要保存
|
|
171
|
+
}
|
|
172
|
+
let fd = null;
|
|
173
|
+
try {
|
|
174
|
+
const dir = dirname(this.cachePath);
|
|
175
|
+
if (!existsSync(dir)) {
|
|
176
|
+
mkdirSync(dir, { recursive: true });
|
|
177
|
+
}
|
|
178
|
+
// 尝试以排他模式打开文件(实现简单的文件锁)
|
|
179
|
+
// 如果文件被其他进程占用,会抛出错误
|
|
180
|
+
const lockPath = `${this.cachePath}.lock`;
|
|
181
|
+
// 检查并清理过期的锁文件(超过 5 分钟)
|
|
182
|
+
this.checkAndCleanExpiredLock(lockPath);
|
|
183
|
+
let retries = 3;
|
|
184
|
+
let locked = false;
|
|
185
|
+
while (retries > 0 && !locked) {
|
|
186
|
+
try {
|
|
187
|
+
// 尝试创建锁文件(排他模式)
|
|
188
|
+
fd = openSync(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY);
|
|
189
|
+
locked = true;
|
|
190
|
+
}
|
|
191
|
+
catch (error) {
|
|
192
|
+
if (error.code === 'EEXIST') {
|
|
193
|
+
// 锁文件已存在,检查是否过期
|
|
194
|
+
this.checkAndCleanExpiredLock(lockPath);
|
|
195
|
+
// 等待后重试
|
|
196
|
+
retries--;
|
|
197
|
+
if (retries > 0) {
|
|
198
|
+
await new Promise((resolve) => setTimeout(resolve, 100));
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
else {
|
|
202
|
+
throw error;
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
if (!locked) {
|
|
207
|
+
console.warn('获取文件锁失败,继续尝试写入');
|
|
208
|
+
}
|
|
209
|
+
// 写入文件
|
|
210
|
+
writeFileSync(this.cachePath, JSON.stringify(this.cache, null, 2), 'utf-8');
|
|
211
|
+
this.cacheDirty = false;
|
|
212
|
+
}
|
|
213
|
+
catch (error) {
|
|
214
|
+
console.error('保存统一缓存失败:', error);
|
|
215
|
+
throw error;
|
|
216
|
+
}
|
|
217
|
+
finally {
|
|
218
|
+
// 释放文件锁
|
|
219
|
+
if (fd !== null) {
|
|
220
|
+
try {
|
|
221
|
+
closeSync(fd);
|
|
222
|
+
const lockPath = `${this.cachePath}.lock`;
|
|
223
|
+
if (existsSync(lockPath)) {
|
|
224
|
+
// 删除锁文件
|
|
225
|
+
try {
|
|
226
|
+
unlinkSync(lockPath); // 使用 unlinkSync 删除文件,而不是清空
|
|
227
|
+
}
|
|
228
|
+
catch {
|
|
229
|
+
// 忽略错误
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
catch (unlockError) {
|
|
234
|
+
console.warn('释放文件锁失败:', unlockError);
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* 同步保存缓存(用于需要立即保存的场景)
|
|
241
|
+
*/
|
|
242
|
+
saveCacheSync() {
|
|
243
|
+
if (!this.cacheDirty) {
|
|
244
|
+
return;
|
|
245
|
+
}
|
|
246
|
+
try {
|
|
247
|
+
const dir = dirname(this.cachePath);
|
|
248
|
+
if (!existsSync(dir)) {
|
|
249
|
+
mkdirSync(dir, { recursive: true });
|
|
250
|
+
}
|
|
251
|
+
writeFileSync(this.cachePath, JSON.stringify(this.cache, null, 2), 'utf-8');
|
|
252
|
+
this.cacheDirty = false;
|
|
253
|
+
}
|
|
254
|
+
catch (error) {
|
|
255
|
+
console.error('保存统一缓存失败:', error);
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
* 通过项目名称查找项目(使用索引,O(1) 时间复杂度)
|
|
260
|
+
*/
|
|
261
|
+
findProjectByName(projectName) {
|
|
262
|
+
const index = this.projectNameIndex.get(projectName);
|
|
263
|
+
return index !== undefined ? this.cache[index] || null : null;
|
|
264
|
+
}
|
|
265
|
+
/**
|
|
266
|
+
* 通过项目 ID 查找项目(使用索引,O(1) 时间复杂度)
|
|
267
|
+
*/
|
|
268
|
+
findProjectById(projectId) {
|
|
269
|
+
const index = this.projectIdIndex.get(projectId);
|
|
270
|
+
return index !== undefined ? this.cache[index] || null : null;
|
|
271
|
+
}
|
|
272
|
+
/**
|
|
273
|
+
* 获取项目的 llmsUrl
|
|
274
|
+
*/
|
|
275
|
+
getLlmsUrl(projectName) {
|
|
276
|
+
const project = this.findProjectByName(projectName);
|
|
277
|
+
return project?.llmsUrls || null;
|
|
278
|
+
}
|
|
279
|
+
/**
|
|
280
|
+
* 查找接口基础信息(使用索引,O(1) 时间复杂度)
|
|
281
|
+
*/
|
|
282
|
+
findInterface(projectName, interfaceId) {
|
|
283
|
+
const projectIndex = this.projectNameIndex.get(projectName);
|
|
284
|
+
if (projectIndex === undefined)
|
|
285
|
+
return null;
|
|
286
|
+
const project = this.cache[projectIndex];
|
|
287
|
+
const interfaceMap = this.interfaceIndex.get(projectName);
|
|
288
|
+
if (!interfaceMap)
|
|
289
|
+
return null;
|
|
290
|
+
const ifaceIndex = interfaceMap.get(interfaceId);
|
|
291
|
+
return ifaceIndex !== undefined ? project.interfaces[ifaceIndex] || null : null;
|
|
292
|
+
}
|
|
293
|
+
/**
|
|
294
|
+
* 获取项目的接口列表
|
|
295
|
+
*/
|
|
296
|
+
getInterfaces(projectName, keyword) {
|
|
297
|
+
const project = this.findProjectByName(projectName);
|
|
298
|
+
if (!project)
|
|
299
|
+
return [];
|
|
300
|
+
let interfaces = project.interfaces;
|
|
301
|
+
// 如果有关键词,进行过滤
|
|
302
|
+
if (keyword) {
|
|
303
|
+
const lowerKeyword = keyword.toLowerCase();
|
|
304
|
+
interfaces = interfaces.filter((i) => i.name.toLowerCase().includes(lowerKeyword) ||
|
|
305
|
+
i.folderPath.toLowerCase().includes(lowerKeyword));
|
|
306
|
+
}
|
|
307
|
+
return interfaces;
|
|
308
|
+
}
|
|
309
|
+
/**
|
|
310
|
+
* 添加或更新项目元数据
|
|
311
|
+
*/
|
|
312
|
+
upsertProjectMetadata(projectName, projectId, llmsUrl) {
|
|
313
|
+
let project = this.findProjectByName(projectName) || this.findProjectById(projectId);
|
|
314
|
+
if (!project) {
|
|
315
|
+
// 创建新项目
|
|
316
|
+
project = {
|
|
317
|
+
projectName,
|
|
318
|
+
projectIds: projectId,
|
|
319
|
+
llmsUrls: llmsUrl,
|
|
320
|
+
interfaces: [],
|
|
321
|
+
};
|
|
322
|
+
this.cache.push(project);
|
|
323
|
+
// 更新索引
|
|
324
|
+
const newIndex = this.cache.length - 1;
|
|
325
|
+
this.projectNameIndex.set(projectName, newIndex);
|
|
326
|
+
this.projectIdIndex.set(projectId, newIndex);
|
|
327
|
+
this.interfaceIndex.set(projectName, new Map());
|
|
328
|
+
}
|
|
329
|
+
else {
|
|
330
|
+
// 更新现有项目
|
|
331
|
+
const oldProjectName = project.projectName;
|
|
332
|
+
const oldProjectId = project.projectIds;
|
|
333
|
+
project.projectName = projectName;
|
|
334
|
+
project.projectIds = projectId;
|
|
335
|
+
project.llmsUrls = llmsUrl;
|
|
336
|
+
// 更新索引
|
|
337
|
+
if (oldProjectName !== projectName) {
|
|
338
|
+
const projectIndex = this.projectNameIndex.get(oldProjectName);
|
|
339
|
+
if (projectIndex !== undefined) {
|
|
340
|
+
this.projectNameIndex.delete(oldProjectName);
|
|
341
|
+
this.projectNameIndex.set(projectName, projectIndex);
|
|
342
|
+
// 更新接口索引的 key
|
|
343
|
+
const interfaceMap = this.interfaceIndex.get(oldProjectName);
|
|
344
|
+
if (interfaceMap) {
|
|
345
|
+
this.interfaceIndex.delete(oldProjectName);
|
|
346
|
+
this.interfaceIndex.set(projectName, interfaceMap);
|
|
347
|
+
}
|
|
348
|
+
}
|
|
349
|
+
}
|
|
350
|
+
if (oldProjectId !== projectId) {
|
|
351
|
+
const projectIndex = this.projectIdIndex.get(oldProjectId);
|
|
352
|
+
if (projectIndex !== undefined) {
|
|
353
|
+
this.projectIdIndex.delete(oldProjectId);
|
|
354
|
+
this.projectIdIndex.set(projectId, projectIndex);
|
|
355
|
+
}
|
|
356
|
+
}
|
|
357
|
+
}
|
|
358
|
+
this.markDirty();
|
|
359
|
+
// 注意:同步保存不使用文件锁,但可以确保数据立即持久化
|
|
360
|
+
// 如果需要文件锁保护,应该使用异步的 saveCache(),但需要调用者处理 Promise
|
|
361
|
+
this.saveCacheSync();
|
|
362
|
+
}
|
|
363
|
+
/**
|
|
364
|
+
* 更新项目的接口列表(从 llms.txt 解析)
|
|
365
|
+
* 支持增量更新:只更新变化的接口
|
|
366
|
+
*/
|
|
367
|
+
updateInterfacesFromLlms(projectName, parsedInterfaces) {
|
|
368
|
+
const project = this.findProjectByName(projectName);
|
|
369
|
+
if (!project) {
|
|
370
|
+
throw new Error(`项目 ${projectName} 不存在`);
|
|
371
|
+
}
|
|
372
|
+
// 增量更新:只更新变化的接口
|
|
373
|
+
const existingMap = new Map(project.interfaces.map((iface) => [iface.id, iface]));
|
|
374
|
+
const newInterfaces = parsedInterfaces.map((parsed) => {
|
|
375
|
+
const existing = existingMap.get(parsed.id);
|
|
376
|
+
// 如果接口已存在且未变化,保留原有对象(避免不必要的更新)
|
|
377
|
+
if (existing &&
|
|
378
|
+
existing.name === parsed.name &&
|
|
379
|
+
existing.folderPath === parsed.folderPath &&
|
|
380
|
+
existing.docUrl === parsed.docUrl &&
|
|
381
|
+
existing.version === parsed.version) {
|
|
382
|
+
return existing;
|
|
383
|
+
}
|
|
384
|
+
return {
|
|
385
|
+
id: parsed.id,
|
|
386
|
+
name: parsed.name,
|
|
387
|
+
folderPath: parsed.folderPath,
|
|
388
|
+
docUrl: parsed.docUrl,
|
|
389
|
+
version: parsed.version,
|
|
390
|
+
};
|
|
391
|
+
});
|
|
392
|
+
project.interfaces = newInterfaces;
|
|
393
|
+
// 重建接口索引
|
|
394
|
+
const interfaceMap = new Map();
|
|
395
|
+
newInterfaces.forEach((iface, index) => {
|
|
396
|
+
interfaceMap.set(iface.id, index);
|
|
397
|
+
});
|
|
398
|
+
this.interfaceIndex.set(projectName, interfaceMap);
|
|
399
|
+
this.markDirty();
|
|
400
|
+
this.saveCacheSync(); // 同步保存,确保数据持久化
|
|
401
|
+
}
|
|
402
|
+
/**
|
|
403
|
+
* 列出所有项目
|
|
404
|
+
*/
|
|
405
|
+
listProjects() {
|
|
406
|
+
return this.cache.map((p) => ({
|
|
407
|
+
name: p.projectName,
|
|
408
|
+
id: p.projectIds,
|
|
409
|
+
}));
|
|
410
|
+
}
|
|
411
|
+
/**
|
|
412
|
+
* 获取缓存文件路径
|
|
413
|
+
*/
|
|
414
|
+
getCachePath() {
|
|
415
|
+
return this.cachePath;
|
|
416
|
+
}
|
|
417
|
+
/**
|
|
418
|
+
* 获取缓存统计信息
|
|
419
|
+
*/
|
|
420
|
+
getCacheStats() {
|
|
421
|
+
const totalInterfaces = this.cache.reduce((sum, project) => sum + project.interfaces.length, 0);
|
|
422
|
+
let lastUpdated = null;
|
|
423
|
+
if (existsSync(this.cachePath)) {
|
|
424
|
+
try {
|
|
425
|
+
const stats = statSync(this.cachePath);
|
|
426
|
+
lastUpdated = new Date(stats.mtime);
|
|
427
|
+
}
|
|
428
|
+
catch (error) {
|
|
429
|
+
// 忽略错误
|
|
430
|
+
}
|
|
431
|
+
}
|
|
432
|
+
return {
|
|
433
|
+
projectCount: this.cache.length,
|
|
434
|
+
totalInterfaces,
|
|
435
|
+
cacheSize: JSON.stringify(this.cache).length,
|
|
436
|
+
lastUpdated,
|
|
437
|
+
};
|
|
438
|
+
}
|
|
439
|
+
/**
|
|
440
|
+
* 强制保存缓存(用于需要立即保存的场景)
|
|
441
|
+
*/
|
|
442
|
+
async flush() {
|
|
443
|
+
await this.saveCache();
|
|
444
|
+
}
|
|
445
|
+
}
|
|
446
|
+
//# sourceMappingURL=unified-cache-manager.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"unified-cache-manager.js","sourceRoot":"","sources":["../../../src/core/cache/unified-cache-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,GACV,MAAM,IAAI,CAAC;AACZ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAiCrC;;GAEG;AACH,SAAS,uBAAuB,CAAC,GAAY;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,KAAK,GAAG,GAA8B,CAAC;IAC7C,OAAO,CACL,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QACpC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CACnE,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAY;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,OAAO,GAAG,GAA8B,CAAC;IAC/C,OAAO,CACL,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QACvC,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;QACtC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;QACpC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;QACjC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAClD,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAY;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACtB,SAAS,CAAS;IAClB,KAAK,CAAe;IACpB,UAAU,GAAY,KAAK,CAAC,CAAC,YAAY;IACzC,YAAY,GAAW,CAAC,CAAC,CAAC,SAAS;IAE3C,YAAY;IACJ,gBAAgB,GAAwB,IAAI,GAAG,EAAE,CAAC;IAClD,cAAc,GAAwB,IAAI,GAAG,EAAE,CAAC;IAChD,cAAc,GAAqC,IAAI,GAAG,EAAE,CAAC,CAAC,sCAAsC;IAE5G,YAAY,WAAmB;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,8BAA8B,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,YAAY;QAClB,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAE5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE;YAC3C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YAC7D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YAE1D,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;YAC/C,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE;gBAC/C,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,SAAS;QACf,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEnC,YAAY;YACZ,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;gBACtC,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;gBAC9E,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACxC,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,SAAS;YACT,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;gBACjC,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC1C,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnC,qBAAqB;gBACrB,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7C,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;YAED,UAAU;YACV,IAAI,CAAC;gBACH,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC/B,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,SAAS,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;oBAC5D,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;oBACzC,OAAO,CAAC,GAAG,CAAC,gBAAgB,UAAU,EAAE,CAAC,CAAC;oBAC1C,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;YAAC,OAAO,WAAW,EAAE,CAAC;gBACrB,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACtC,CAAC;YAED,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,SAAS;QACf,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,wBAAwB,CAAC,QAAgB,EAAE,SAAiB,CAAC,GAAG,EAAE,GAAG,IAAI;QAC/E,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAE/C,IAAI,GAAG,GAAG,MAAM,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;gBACjE,IAAI,CAAC;oBACH,UAAU,CAAC,QAAQ,CAAC,CAAC;oBACrB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC3B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mBAAmB;YACnB,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC;gBACH,UAAU,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,SAAS;QACrB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,CAAC,aAAa;QACvB,CAAC;QAED,IAAI,EAAE,GAAkB,IAAI,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACpC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;YAED,wBAAwB;YACxB,oBAAoB;YACpB,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,SAAS,OAAO,CAAC;YAE1C,uBAAuB;YACvB,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;YAExC,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,MAAM,GAAG,KAAK,CAAC;YAEnB,OAAO,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC9B,IAAI,CAAC;oBACH,gBAAgB;oBAChB,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;oBACnF,MAAM,GAAG,IAAI,CAAC;gBAChB,CAAC;gBAAC,OAAO,KAAU,EAAE,CAAC;oBACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAC5B,gBAAgB;wBAChB,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;wBAExC,QAAQ;wBACR,OAAO,EAAE,CAAC;wBACV,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;4BAChB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;wBAC3D,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACjC,CAAC;YAED,OAAO;YACP,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5E,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAClC,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,QAAQ;YACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChB,IAAI,CAAC;oBACH,SAAS,CAAC,EAAE,CAAC,CAAC;oBACd,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,SAAS,OAAO,CAAC;oBAC1C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACzB,QAAQ;wBACR,IAAI,CAAC;4BACH,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,2BAA2B;wBACnD,CAAC;wBAAC,MAAM,CAAC;4BACP,OAAO;wBACT,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,OAAO,WAAW,EAAE,CAAC;oBACrB,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,aAAa;QACnB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACpC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5E,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,WAAmB;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACrD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,SAAiB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,WAAmB;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACpD,OAAO,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,WAAmB,EAAE,WAAmB;QACpD,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5D,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAE5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC1D,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAE/B,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACjD,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,WAAmB,EAAE,OAAgB;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAExB,IAAI,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAEpC,cAAc;QACd,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAC3C,UAAU,GAAG,UAAU,CAAC,MAAM,CAC5B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAC3C,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CACpD,CAAC;QACJ,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,WAAmB,EAAE,SAAiB,EAAE,OAAe;QAC3E,IAAI,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAErF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,QAAQ;YACR,OAAO,GAAG;gBACR,WAAW;gBACX,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,OAAO;gBACjB,UAAU,EAAE,EAAE;aACf,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEzB,OAAO;YACP,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACvC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACjD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC7C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,SAAS;YACT,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;YAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;YAExC,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;YAClC,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;YAC/B,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC;YAE3B,OAAO;YACP,IAAI,cAAc,KAAK,WAAW,EAAE,CAAC;gBACnC,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAC/D,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBAC/B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;oBAC7C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;oBAErD,cAAc;oBACd,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;oBAC7D,IAAI,YAAY,EAAE,CAAC;wBACjB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;wBAC3C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBAC3D,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBAC/B,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;oBACzC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,6BAA6B;QAC7B,iDAAiD;QACjD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,wBAAwB,CACtB,WAAmB,EACnB,gBAME;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,MAAM,WAAW,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,gBAAgB;QAChB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAElF,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACpD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC5C,+BAA+B;YAC/B,IACE,QAAQ;gBACR,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;gBAC7B,QAAQ,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU;gBACzC,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;gBACjC,QAAQ,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,EACnC,CAAC;gBACD,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,UAAU,GAAG,aAAa,CAAC;QAEnC,SAAS;QACT,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC/C,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACrC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAEnD,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,eAAe;IACvC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,CAAC,CAAC,WAAW;YACnB,EAAE,EAAE,CAAC,CAAC,UAAU;SACjB,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,aAAa;QAMX,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAEhG,IAAI,WAAW,GAAgB,IAAI,CAAC;QACpC,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACvC,WAAW,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;YACT,CAAC;QACH,CAAC;QAED,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YAC/B,eAAe;YACf,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;YAC5C,WAAW;SACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;IACzB,CAAC;CACF"}
|
|
@@ -4,6 +4,9 @@ import { ApiRequestSpec, ApiResponseSpec, ProjectInfo } from '../../types/index.
|
|
|
4
4
|
* 动态创建和调用 Apifox 官方 MCP Server 获取接口文档信息
|
|
5
5
|
*/
|
|
6
6
|
export declare class McpBridge {
|
|
7
|
+
private cacheManager?;
|
|
8
|
+
private projectRoot?;
|
|
9
|
+
constructor(projectRoot?: string);
|
|
7
10
|
/**
|
|
8
11
|
* 从环境变量中获取自定义的 Apifox API Base URL
|
|
9
12
|
*/
|
|
@@ -20,29 +23,30 @@ export declare class McpBridge {
|
|
|
20
23
|
*/
|
|
21
24
|
getProjectInfoViaMcp(accessToken: string, projectId: string): Promise<ProjectInfo>;
|
|
22
25
|
/**
|
|
23
|
-
*
|
|
24
|
-
* @param
|
|
25
|
-
* @param projectId 项目 ID
|
|
26
|
+
* 通过统一缓存获取接口列表(不调用 API)
|
|
27
|
+
* @param projectName 项目名称
|
|
28
|
+
* @param projectId 项目 ID(用于查找项目)
|
|
26
29
|
* @param keyword 搜索关键词(可选)
|
|
27
30
|
* @param executionSteps 执行步骤数组(用于记录过程)
|
|
28
|
-
* @returns
|
|
31
|
+
* @returns 接口列表(只包含基础信息:id, name, folderPath, docUrl, version)
|
|
29
32
|
*/
|
|
30
|
-
getInterfacesViaMcp(
|
|
33
|
+
getInterfacesViaMcp(projectName: string, projectId: string, keyword?: string, executionSteps?: string[]): Promise<Array<{
|
|
31
34
|
id: string;
|
|
32
35
|
name: string;
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
+
folderPath: string;
|
|
37
|
+
docUrl: string;
|
|
38
|
+
version?: string;
|
|
36
39
|
}>>;
|
|
37
40
|
/**
|
|
38
|
-
* 通过 Apifox 官方 MCP Server
|
|
41
|
+
* 通过 Apifox 官方 MCP Server 获取接口详情(不缓存接口信息)
|
|
39
42
|
* @param accessToken Access token
|
|
43
|
+
* @param projectName 项目名称
|
|
40
44
|
* @param projectId 项目 ID
|
|
41
45
|
* @param interfaceId 接口 ID
|
|
42
46
|
* @param executionSteps 执行步骤数组(用于记录过程)
|
|
43
47
|
* @returns 接口详情
|
|
44
48
|
*/
|
|
45
|
-
getInterfaceDetailViaMcp(accessToken: string, projectId: string, interfaceId: string, executionSteps?: string[]): Promise<{
|
|
49
|
+
getInterfaceDetailViaMcp(accessToken: string, projectName: string, projectId: string, interfaceId: string, executionSteps?: string[]): Promise<{
|
|
46
50
|
id: string;
|
|
47
51
|
name?: string;
|
|
48
52
|
method?: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mcp-bridge.d.ts","sourceRoot":"","sources":["../../../src/core/client/mcp-bridge.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"mcp-bridge.d.ts","sourceRoot":"","sources":["../../../src/core/client/mcp-bridge.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAInG;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAC,CAAsB;IAC3C,OAAO,CAAC,WAAW,CAAC,CAAS;gBAEjB,WAAW,CAAC,EAAE,MAAM;IAMhC;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;OAKG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA+HxF;;;;;;;OAOG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,OAAO,CACR,KAAK,CAAC;QACJ,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,CACH;IAwBD;;;;;;;;OAQG;IACG,wBAAwB,CAC5B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC;QACT,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,cAAc,CAAC;QACzB,QAAQ,CAAC,EAAE,eAAe,CAAC;KAC5B,CAAC;CA2JH"}
|