autosnippet 1.6.1 → 1.7.0

package/bin/dashboard/routes/search.js

@@ -3,6 +3,23 @@ function registerSearchRoutes(app, ctx) {
 	const Paths = require('../../../lib/infrastructure/config/Paths.js');
 	const { analyzeContext } = require('../../../lib/search/contextAnalyzer.js');
 
+	// ============================================================
+	// 调试工具
+	// ============================================================
+	const DEBUG = process.env.ASD_DEBUG_SEARCH === '1' || process.env.DEBUG?.includes('search');
+	
+	function debug(taskName, step, data) {
+		if (!DEBUG) return;
+		const timestamp = new Date().toISOString().split('T')[1];
+		console.log(`\n[${timestamp}] [Search:${taskName}] ${step}`, data ? JSON.stringify(data, null, 2) : '');
+	}
+
+	function debugError(taskName, step, error) {
+		if (!DEBUG) return;
+		const timestamp = new Date().toISOString().split('T')[1];
+		console.error(`\n[${timestamp}] [Search:${taskName}] ❌ ${step}`, error?.message || error);
+	}
+
 	// ============================================================
 	// 统一的搜索核心函数（共享给所有搜索 API）
 	// ============================================================
@@ -21,33 +38,57 @@ function registerSearchRoutes(app, ctx) {
 			throw new Error('keyword is required');
 		}
 
+		const taskId = `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+		debug(taskId, 'INIT', {
+			keyword,
+			targetName,
+			currentFile,
+			language,
+			limit,
+			hasFileContent: !!fileContent
+		});
+
 		const { getInstance } = require('../../../lib/context');
 		const recipeStats = require('../../../lib/recipe/recipeStats');
 		const service = getInstance(projectRoot);
 		const rootSpec = require(Paths.getProjectSpecPath(projectRoot));
 
 		// 1. 分析当前上下文（使用 analyzeContext 深度分析）
+		debug(taskId, '1️⃣ Context Analysis Start', { targetName, currentFile, language });
 		const contextInfo = await analyzeContext(projectRoot, { targetName, currentFile, language });
+		debug(taskId, '1️⃣ Context Analysis Complete', contextInfo);
 
 		let vectorResults = [];
 		let keywordResults = [];
 
 		// 2. 向量搜索
+		debug(taskId, '2️⃣ Vector Search Start', { keyword, limit: limit + 5 });
 		try {
 			const ai = await AiFactory.getProvider(projectRoot);
 			if (ai) {
 				vectorResults = await service.search(keyword, { limit: limit + 5, filter: { type: 'recipe' } });
 				vectorResults = vectorResults.map(r => ({ ...r, _vectorScore: r.similarity || 0 }));
+				debug(taskId, '2️⃣ Vector Search Complete', {
+					count: vectorResults.length,
+					topResults: vectorResults.slice(0, 3).map(r => ({
+						name: r.name,
+						score: r._vectorScore
+					}))
+				});
+			} else {
+				debug(taskId, '2️⃣ Vector Search Skipped', { reason: 'No AI provider' });
 			}
 		} catch (e) {
-			console.warn('[Unified Search] Vector search failed:', e.message);
+			debugError(taskId, '2️⃣ Vector Search Failed', e);
 		}
 
 		// 3. 关键词搜索
+		debug(taskId, '3️⃣ Keyword Search Start', { keyword });
 		try {
 			const recipesDir = Paths.getProjectRecipesPath(projectRoot, rootSpec);
 			if (fs.existsSync(recipesDir)) {
 				const keywordTerms = keyword.toLowerCase().split(/\s+/).filter(w => w.length > 1);
+				debug(taskId, '3️⃣ Keyword Terms', { keywordTerms });
 				
 				// 从 contextInfo 获取丰富的上下文术语
 				const contextTerms = [
@@ -106,15 +147,27 @@ function registerSearchRoutes(app, ctx) {
 							});
 						}
 					} catch (e) {
-						console.warn(`[Unified Search] Failed to read recipe ${recipePath}:`, e.message);
+						debugError(taskId, '3️⃣ Recipe Parse Error', { file: recipePath, error: e.message });
 					}
 				}
+				debug(taskId, '3️⃣ Keyword Search Complete', {
+					count: keywordResults.length,
+					topResults: keywordResults.slice(0, 3).map(r => ({
+						name: r.name,
+						score: r._keywordScore,
+						contextMatches: r._contextMatches
+					}))
+				});
 			}
 		} catch (e) {
-			console.warn('[Unified Search] Keyword search failed:', e.message);
+			debugError(taskId, '3️⃣ Keyword Search Failed', e);
 		}
 
 		// 4. 合并和评分
+		debug(taskId, '4️⃣ Merge & Score Start', {
+			vectorCount: vectorResults.length,
+			keywordCount: keywordResults.length
+		});
 		const mergedMap = new Map();
 		
 		for (const vr of vectorResults) {
@@ -161,10 +214,25 @@ function registerSearchRoutes(app, ctx) {
 		});
 
 		// 6. 权威分加权排序
+		debug(taskId, '5️⃣ Hybrid Score Calculation', {
+			count: results.length,
+			topResults: results.slice(0, 3).map(r => ({
+				name: r.name,
+				hybridScore: r._hybridScore,
+				vectorScore: r._vectorScore,
+				keywordScore: r._keywordScore,
+				isContextRelevant: r.isContextRelevant
+			}))
+		});
 		try {
 			const stats = recipeStats.getRecipeStats(projectRoot);
 			const byFileEntries = Object.values(stats.byFile || {});
 			
+			debug(taskId, '6️⃣ Authority Scoring Start', {
+				statsCount: Object.keys(stats.byFile || {}).length,
+				totalByFileEntries: byFileEntries.length
+			});
+
 			results = results.map(item => {
 				const key = path.basename(item.name);
 				const entry = (stats.byFile || {})[key];
@@ -225,22 +293,37 @@ Recipe: ${results[0]?.name || 'N/A'}
 						similarity: r.similarity * 0.7 + aiBoost * 0.3
 					}));
 
-					console.log(`[Unified Search] AI re-evaluated ${results.length} results, boost: ${aiBoost.toFixed(2)}`);
+					debug(taskId, '7️⃣ AI Evaluation Complete', {
+						aiScore,
+						aiBoost: aiBoost.toFixed(2),
+						topResultFinalScore: results[0]?.similarity
+					});
 				}
 			} catch (e) {
-				console.warn('[Unified Search] AI context evaluation failed:', e.message);
+				debugError(taskId, '7️⃣ AI Evaluation Failed', e);
 			}
 		}
 
 		// 8. 排序和限制
+		debug(taskId, '8️⃣ Sort & Filter Start', { beforeCount: results.length, minSimilarity: vectorResults.length > 0 ? 0.3 : 0.2 });
 		results.sort((a, b) => b.similarity - a.similarity);
 		
 		// 设置最小相似度阈值
 		const minSimilarity = vectorResults.length > 0 ? 0.3 : 0.2;
 		results = results.filter(r => r.similarity >= minSimilarity);
 		
+		debug(taskId, '8️⃣ After Filter', { afterCount: results.length, limit });
 		results = results.slice(0, limit);
 
+		debug(taskId, '✅ COMPLETE', {
+			finalCount: results.length,
+			topResults: results.slice(0, 3).map(r => ({
+				name: r.name,
+				similarity: r.similarity,
+				authority: r.authority
+			}))
+		});
+
 		return {
 			results,
 			contextInfo,
@@ -410,16 +493,58 @@ Recipe: ${results[0]?.name || 'N/A'}
 			console.log('[Trigger from Code] Search Results:', JSON.stringify(resultInfo, null, 2));
 
 			// 5. 清理结果为 Xcode 格式
-			const cleanResults = results.map(r => ({
-				name: r.name,
-				snippet: r.content ? r.content.substring(0, 300) : '',
-				similarity: Math.round(r.similarity * 100),
-				isContextRelevant: r.isContextRelevant,
-				authority: Math.round(r.authority * 100) / 100,
-				usageCount: r.usageCount,
-				stats: r.stats,
-				aiRelevanceScore: r._aiRelevanceScore ? Math.round(r._aiRelevanceScore) : undefined
-			}));
+			// 5.1. 使用 SearchServiceV2 为结果添加 Agent 评分
+			let agentScores = new Map();
+			try {
+				const SearchServiceV2 = require('../../../lib/application/services/SearchServiceV2');
+				const searchServiceV2 = new SearchServiceV2(projectRoot, {
+					enableIntelligentLayer: true,
+					enableLearning: false
+				});
+
+				// 生成 sessionId 和 userId
+				const sessionId = `xcode-${filePath || 'general'}-${Date.now()}`;
+				const userId = process.env.ASD_USER_ID || process.env.USER || process.env.USERNAME || 'unknown';
+
+				// 对前 5 个结果调用 SearchServiceV2 以获得 Agent 评分
+				const agentResults = await searchServiceV2.search(searchKeyword, {
+					limit: 5,
+					sessionId,
+					userId,
+					context: { source: 'dashboard-xcode-watch' }
+				});
+
+				// 构建 agentScores map
+				if (agentResults && Array.isArray(agentResults)) {
+					for (const agentResult of agentResults) {
+						if (agentResult.name && agentResult.qualityScore !== undefined) {
+							agentScores.set(agentResult.name, {
+								qualityScore: agentResult.qualityScore,
+								recommendReason: agentResult.recommendReason || undefined
+							});
+						}
+					}
+				}
+			} catch (e) {
+				console.warn('[Trigger from Code] Agent scoring failed, using defaults:', e.message);
+			}
+
+			// 5.2. 清理结果为 Xcode 格式
+			const cleanResults = results.map(r => {
+				const agentScore = agentScores.get(r.name);
+				return {
+					name: r.name,
+					snippet: r.content ? r.content.substring(0, 300) : '',
+					similarity: Math.round(r.similarity * 100),
+					isContextRelevant: r.isContextRelevant,
+					authority: Math.round(r.authority * 100) / 100,
+					usageCount: r.usageCount,
+					stats: r.stats,
+					aiRelevanceScore: r._aiRelevanceScore ? Math.round(r._aiRelevanceScore) : undefined,
+					qualityScore: agentScore?.qualityScore,
+					recommendReason: agentScore?.recommendReason
+				};
+			});
 
 			const requestId = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 			res.set('Cache-Control', 'no-cache, no-store, must-revalidate');
@@ -498,18 +623,60 @@ Recipe: ${results[0]?.name || 'N/A'}
 			console.log('[Context-Aware Search] Search Results:', JSON.stringify(resultInfo, null, 2));
 
 			// 格式化结果供 Dashboard 使用
-			const cleanResults = results.map(r => ({
-				name: r.name,
-				content: r.content,
-				similarity: Math.round(r.similarity * 100) / 100,
-				authority: r.authority,
-				usageCount: r.usageCount,
-				stats: r.stats,
-				isContextRelevant: r.isContextRelevant,
-				matchType: r._vectorScore > r._keywordScore ? 'semantic' : 'keyword',
-				metadata: r.metadata,
-				aiRelevanceScore: r.aiRelevanceScore // 多标记 AI 评分
-			}));
+			// 使用 SearchServiceV2 为结果添加 Agent 评分
+			let agentScores = new Map();
+			try {
+				const SearchServiceV2 = require('../../../lib/application/services/SearchServiceV2');
+				const searchServiceV2 = new SearchServiceV2(projectRoot, {
+					enableIntelligentLayer: true,
+					enableLearning: false
+				});
+
+				// 生成 sessionId 和 userId
+				const sessionId = `dashboard-${currentFile || 'general'}-${Date.now()}`;
+				const userId = process.env.ASD_USER_ID || process.env.USER || process.env.USERNAME || 'unknown';
+
+				// 对前 5 个结果调用 SearchServiceV2 以获得 Agent 评分
+				const agentResults = await searchServiceV2.search(keyword, {
+					limit: 5,
+					sessionId,
+					userId,
+					context: { source: 'dashboard-context-aware' }
+				});
+
+				// 构建 agentScores map
+				if (agentResults && Array.isArray(agentResults)) {
+					for (const agentResult of agentResults) {
+						if (agentResult.name && agentResult.qualityScore !== undefined) {
+							agentScores.set(agentResult.name, {
+								qualityScore: agentResult.qualityScore,
+								recommendReason: agentResult.recommendReason || undefined
+							});
+						}
+					}
+				}
+			} catch (e) {
+				console.warn('[Context-Aware Search] Agent scoring failed, using defaults:', e.message);
+			}
+
+			// 格式化结果供 Dashboard 使用
+			const cleanResults = results.map(r => {
+				const agentScore = agentScores.get(r.name);
+				return {
+					name: r.name,
+					content: r.content,
+					similarity: Math.round(r.similarity * 100) / 100,
+					authority: r.authority,
+					usageCount: r.usageCount,
+					stats: r.stats,
+					isContextRelevant: r.isContextRelevant,
+					matchType: r._vectorScore > r._keywordScore ? 'semantic' : 'keyword',
+					metadata: r.metadata,
+					aiRelevanceScore: r.aiRelevanceScore, // 多标记 AI 评分
+					qualityScore: agentScore?.qualityScore,
+					recommendReason: agentScore?.recommendReason
+				};
+			});
 
 			res.json({ 
 				results: cleanResults,

package/bin/dashboard/routes/snippets.js

@@ -101,6 +101,34 @@ function registerSnippetsRoutes(app, ctx) {
 			res.status(500).json({ error: err.message });
 		}
 	});
+
+	// API: 删除所有 Snippets
+	app.post('/api/snippets/delete-all', async (req, res) => {
+		try {
+			const probe = writeGuard.checkWritePermission(projectRoot);
+			if (!probe.ok) {
+				return res.status(403).json({ error: probe.error || '没权限', code: 'RECIPE_WRITE_FORBIDDEN' });
+			}
+			const rootSpecPath = Paths.getProjectSpecPath(projectRoot);
+			const spec = specRepository.readSpecFile(rootSpecPath);
+			const count = spec?.list?.length || 0;
+
+			if (count > 0) {
+				// 获取所有 snippet identifiers
+				const identifiers = spec.list.map(s => s.identifier);
+				
+				// 逐个删除（使用 deleteSnippet 确保清理分体文件和同步）
+				for (const identifier of identifiers) {
+					await specRepository.deleteSnippet(rootSpecPath, identifier, { syncRoot: true });
+				}
+			}
+
+			res.json({ success: true, count });
+		} catch (err) {
+			console.error('[API Error]', err);
+			res.status(500).json({ error: err.message });
+		}
+	});
 }
 
 module.exports = {

package/bin/dashboard/routes/spm.js

@@ -15,6 +15,7 @@ function registerSpmRoutes(app, ctx) {
 	// API: 获取项目 SPM 依赖关系图（优先读 spmmap 全解析结果，用于前端「依赖关系图」页展示）
 	app.get('/api/dep-graph', async (req, res) => {
 		try {
+			const level = String(req.query?.level || 'package');
 			const knowledgeDir = Paths.getProjectKnowledgePath(projectRoot);
 			const mapPath = path.join(knowledgeDir, 'AutoSnippet.spmmap.json');
 			let graph = null;
@@ -31,18 +32,48 @@ function registerSpmRoutes(app, ctx) {
 			if (!graph || !graph.packages) {
 				return res.json({ nodes: [], edges: [], projectRoot: null });
 			}
-			const nodes = Object.keys(graph.packages).map((id) => ({
-				id,
-				label: id,
-				type: 'package',
-				packageDir: graph.packages[id]?.packageDir,
-				packageSwift: graph.packages[id]?.packageSwift,
-				targets: graph.packages[id]?.targets,
-			}));
-			const edges = [];
-			for (const [from, tos] of Object.entries(graph.edges || {})) {
-				for (const to of tos || []) {
-					edges.push({ from, to });
+			let nodes = [];
+			let edges = [];
+
+			if (level === 'target') {
+				const nodeList = [];
+				const baseEdges = [];
+				for (const [pkgName, pkgInfo] of Object.entries(graph.packages)) {
+					const targetsInfo = pkgInfo?.targetsInfo || {};
+					for (const [targetName, info] of Object.entries(targetsInfo)) {
+						const id = `${pkgName}::${targetName}`;
+						nodeList.push({
+							id,
+							label: targetName,
+							type: 'target',
+							packageName: pkgName,
+						});
+						const deps = info?.dependencies || [];
+						for (const d of deps) {
+							const depName = d?.name;
+							if (!depName) continue;
+							const depPkg = d?.package || pkgName;
+							const toId = `${depPkg}::${depName}`;
+							baseEdges.push({ from: id, to: toId, source: 'base' });
+						}
+					}
+				}
+
+				nodes = nodeList;
+				edges = baseEdges;
+			} else {
+				nodes = Object.keys(graph.packages).map((id) => ({
+					id,
+					label: id,
+					type: 'package',
+					packageDir: graph.packages[id]?.packageDir,
+					packageSwift: graph.packages[id]?.packageSwift,
+					targets: graph.packages[id]?.targets,
+				}));
+				for (const [from, tos] of Object.entries(graph.edges || {})) {
+					for (const to of tos || []) {
+						edges.push({ from, to, source: 'base' });
+					}
 				}
 			}
 			res.json({
@@ -57,6 +88,7 @@ function registerSpmRoutes(app, ctx) {
 		}
 	});
 
+
 	// API: 获取 Target 将要扫描的文件列表（不调用 AI）。支持 body.target 或 body.targetName（按名称查 target）
 	app.post('/api/spm/target-files', async (req, res) => {
 		try {

package/bin/dashboard-server.js

@@ -130,12 +130,25 @@ async function launch(projectRoot, port = 3000, options = {}) {
 
 	const specRepository = new SpecRepositoryV2(projectRoot);
 	const forceBuild = options.forceBuild === true || process.env.ASD_UI_BUILD === '1' || process.env.ASD_UI_REBUILD === '1';
-	// 1. 在后台启动 Watcher
-	console.log(`[Dashboard] 正在后台启动项目监听器...`);
+	
+	// 1. 在后台启动 Watcher（支持调试模式）
+	const isDebugMode = process.env.ASD_DEBUG_WATCH === '1' || process.env.ASD_DEBUG_SEARCH === '1';
+	if (isDebugMode) {
+		console.log(`[Dashboard] 正在启动项目监听器（调试模式）...`);
+	} else {
+		console.log(`[Dashboard] 正在后台启动项目监听器...`);
+	}
+	
 	const rootSpecPath = Paths.getProjectSpecPath(projectRoot);
 	try {
-		watch.watchFileChange(rootSpecPath, projectRoot, { quiet: true });
-		console.log(`[Dashboard] ✅ 监听器已就绪`);
+		// 调试模式下不启用 quiet，以便看到详细日志
+		watch.watchFileChange(rootSpecPath, projectRoot, { quiet: !isDebugMode });
+		if (isDebugMode) {
+			console.log(`[Dashboard] ✅ 监听器已就绪（调试模式已启用）`);
+			console.log(`[Dashboard] 💡 在 Xcode 中使用 // as:s 将触发搜索`);
+		} else {
+			console.log(`[Dashboard] ✅ 监听器已就绪`);
+		}
 	} catch (err) {
 		console.error(`[Dashboard] ❌ 监听器启动失败: ${err.message}`);
 	}

package/checksums.json

@@ -1,8 +1,8 @@
 {
-  "bin/asd-cli.js": "a208a8204fe637bfa23f15e1b4893d286647e8cd575590b70ebadb441c1e1404",
-  "bin/dashboard-server.js": "e62032f5d92de0f672a19b678b8c446e75fa4cb258fcb1ac2545084e1c435f72",
-  "lib/writeGuard.js": "0a2b0f894d37d0efeea756ed49ffe3a5af51c1eeb18e19ca9e45b9b916f39b64",
-  "lib/rateLimit.js": "418dc1bf0ada5c511f7444e18ac22864b22f8ff8685f3757045716268a9219e0",
+  "bin/asd-cli.js": "1e62f7b8792dbb0919deaa1db2b2d5e1282f535b220508685d8caff9a79e5d21",
+  "bin/dashboard-server.js": "6bcbfffae8fbdba8472653f934177077e8c4e25d95d8c5ae3080698239c3a513",
+  "lib/writeGuard.js": "2ec5b4fa958b013702ba4023b1d1d51d93db3e0be1921e814ef2abb032b45775",
+  "lib/rateLimit.js": "ad55cc15b3dc01efa6847c405db9cc7cfab1719a4ca9bc2fb183d4d9c8f51baf",
   "lib/services/context/ContextService.js": "e1e87506b1c66da274a068ca078491fdf09e1eea4ffbc22c3409f6f0f2e40a8e",
   "lib/application/services/ContextServiceV2.js": "d42a572e8bea9e002714f23935c6370ed1975904b8ecbc1e18ffad98f99bb79a",
   "lib/context/adapters/MilvusAdapter.js": "b7c11e95c64f8b57f9edf2380b1038e89438fbe2d87d3d831aee9dbeae2afcbd",