autosnippet 3.0.1 → 3.0.2

package/lib/service/automation/handlers/GuardHandler.js

@@ -9,19 +9,15 @@
  *   // as:a <keyword> — 检查当前文件 + 搜索相关规范
  */
 
-import { basename, join, extname, dirname } from 'node:path';
 import { readFile } from 'node:fs/promises';
+import { dirname, extname, join } from 'node:path';
+import { LanguageService } from '../../../shared/LanguageService.js';
 
 /** 已知的 scope 关键词 */
 const SCOPE_KEYWORDS = new Set(['file', 'target', 'project', 'all']);
 
-/** 支持审计的源文件扩展名 */
-const SOURCE_EXTS = new Set([
-  '.m', '.mm', '.h', '.swift',
-  '.c', '.cpp', '.cc', '.cxx', '.hpp',
-  '.js', '.ts', '.jsx', '.tsx',
-  '.java', '.kt', '.py', '.rb', '.go', '.rs',
-]);
+/** 支持审计的源文件扩展名 — 委托给 LanguageService */
+const SOURCE_EXTS = LanguageService.sourceExts;
 
 /**
  * 递归收集目录下所有源文件路径
@@ -32,9 +28,18 @@ async function collectSourceFiles(dir) {
 
   // 跳过的目录
   const SKIP_DIRS = new Set([
-    'node_modules', '.git', 'build', 'DerivedData',
-    'Pods', '.build', 'vendor', 'dist', '.next',
-    'Carthage', 'xcuserdata', '__pycache__',
+    'node_modules',
+    '.git',
+    'build',
+    'DerivedData',
+    'Pods',
+    '.build',
+    'vendor',
+    'dist',
+    '.next',
+    'Carthage',
+    'xcuserdata',
+    '__pycache__',
   ]);
 
   async function walk(currentDir) {
@@ -45,7 +50,9 @@ async function collectSourceFiles(dir) {
       return; // 权限不足等情况跳过
     }
     for (const entry of entries) {
-      if (entry.name.startsWith('.') && entry.name !== '.') continue;
+      if (entry.name.startsWith('.') && entry.name !== '.') {
+        continue;
+      }
       const fullPath = join(currentDir, entry.name);
       if (entry.isDirectory()) {
         if (!SKIP_DIRS.has(entry.name)) {
@@ -72,10 +79,14 @@ export async function handleGuard(watcher, fullPath, code, guardLine) {
   const scopeArg = rest.toLowerCase();
   const isScope = SCOPE_KEYWORDS.has(scopeArg);
   // 确定 scope：无参数或 'file' → file；'target' → target；'project'/'all' → project
-  const scope = !rest || scopeArg === 'file' ? 'file'
-    : scopeArg === 'target' ? 'target'
-    : (scopeArg === 'project' || scopeArg === 'all') ? 'project'
-    : 'file'; // 非 scope 关键词回退到 file
+  const scope =
+    !rest || scopeArg === 'file'
+      ? 'file'
+      : scopeArg === 'target'
+        ? 'target'
+        : scopeArg === 'project' || scopeArg === 'all'
+          ? 'project'
+          : 'file'; // 非 scope 关键词回退到 file
 
   try {
     const { detectLanguage } = await import('../../guard/GuardCheckEngine.js');
@@ -95,18 +106,19 @@ export async function handleGuard(watcher, fullPath, code, guardLine) {
 
       if (!scanRoot) {
         console.warn('  ⚠️ 无法确定扫描根目录，回退到单文件检查');
-        return _auditSingleFile(engine, fullPath, code, detectLanguage, 'file');
+        return _auditSingleFile(watcher, engine, fullPath, code, detectLanguage, 'file');
       }
 
       const scopeLabel = scope === 'project' ? '整个项目' : '当前目录';
-      console.log(`\n🛡️  [Guard] 正在扫描${scopeLabel}: ${scanRoot}`);
+      console.log(`\n🔍 Guard 审计 — ${scopeLabel} (${scanRoot})`);
       const sourcePaths = await collectSourceFiles(scanRoot);
-      console.log(`  📁 找到 ${sourcePaths.length} 个源文件`);
 
       if (sourcePaths.length === 0) {
-        console.log('  ✅ 未找到源文件');
+        console.log('  ℹ️ 未找到可审计的源文件');
+        watcher._notify?.('未找到可审计的源文件');
         return;
       }
+      console.log(`  📁 扫描到 ${sourcePaths.length} 个源文件`);
 
       // 读取所有文件内容
       const fileEntries = [];
@@ -120,7 +132,7 @@ export async function handleGuard(watcher, fullPath, code, guardLine) {
         }
       }
       if (readErrors > 0) {
-        console.log(`  ⚠️ ${readErrors} 个文件无法读取，已跳过`);
+        console.warn(`  ⚠️ ${readErrors} 个文件读取失败，已跳过`);
       }
 
       // 批量审计（传递 scope 以启用对应维度规则）
@@ -128,63 +140,66 @@ export async function handleGuard(watcher, fullPath, code, guardLine) {
       const { summary } = report;
 
       if (summary.totalViolations === 0) {
-        console.log(`  ✅ ${summary.filesChecked} 个文件全部通过，无违规`);
+        console.log(`\n  ✅ 审计通过 — ${fileEntries.length} 个文件，无违规`);
+        watcher._notify?.(`${scopeLabel}审计通过 ✅ ${fileEntries.length} 个文件，无违规`);
       } else {
-        console.log(`  🛡️ 扫描 ${summary.filesChecked} 个文件:`);
-        console.log(`     ${summary.totalErrors} errors, ${summary.totalViolations - summary.totalErrors} warnings`);
-        console.log(`     ${summary.filesWithViolations} 个文件存在问题\n`);
-
         // 按文件输出详情（限制输出前 10 个有问题的文件）
-        const filesWithIssues = report.files.filter(f => f.summary.total > 0);
+        console.log(`\n  ❌ 审计发现 ${summary.totalViolations} 个问题 (${summary.errors ?? 0} 错误, ${summary.warnings ?? 0} 警告)`);
+        watcher._notify?.(`${scopeLabel}审计: ${summary.totalViolations} 个问题 (${summary.errors ?? 0} 错误, ${summary.warnings ?? 0} 警告)`);
+        const filesWithIssues = report.files.filter((f) => f.summary.total > 0);
         for (const file of filesWithIssues.slice(0, 10)) {
-          const rel = file.filePath.replace(scanRoot + '/', '');
-          console.log(`  📄 ${rel}  (${file.summary.errors}E / ${file.summary.warnings}W)`);
-          const errors = file.violations.filter(v => v.severity === 'error');
-          const warnings = file.violations.filter(v => v.severity === 'warning');
+          const rel = file.filePath.replace(`${scanRoot}/`, '');
+          const errors = file.violations.filter((v) => v.severity === 'error');
+          const warnings = file.violations.filter((v) => v.severity === 'warning');
+          console.log(`\n  📄 ${rel} (${errors.length} 错误, ${warnings.length} 警告)`);
           for (const v of errors.slice(0, 5)) {
-            console.log(`     ❌ L${v.line} [${v.ruleId}] ${v.message}`);
+            console.log(`    🔴 [${v.ruleId || 'unknown'}] ${v.message}${v.line ? ` (行 ${v.line})` : ''}`);
+          }
+          if (errors.length > 5) {
+            console.log(`    ... 还有 ${errors.length - 5} 个错误`);
           }
-          if (errors.length > 5) console.log(`     ... 还有 ${errors.length - 5} 个 errors`);
           for (const v of warnings.slice(0, 3)) {
-            console.log(`     ⚠️  L${v.line} [${v.ruleId}] ${v.message}`);
+            console.log(`    🟡 [${v.ruleId || 'unknown'}] ${v.message}${v.line ? ` (行 ${v.line})` : ''}`);
+          }
+          if (warnings.length > 3) {
+            console.log(`    ... 还有 ${warnings.length - 3} 个警告`);
           }
-          if (warnings.length > 3) console.log(`     ... 还有 ${warnings.length - 3} 个 warnings`);
         }
         if (filesWithIssues.length > 10) {
-          console.log(`\n  ... 还有 ${filesWithIssues.length - 10} 个文件有问题，已省略`);
+          console.log(`\n  ... 还有 ${filesWithIssues.length - 10} 个文件有问题`);
         }
 
         // 跨文件问题汇总
         if (report.crossFileViolations?.length > 0) {
-          console.log(`\n  🔗 跨文件问题 (${report.crossFileViolations.length}):`);
+          console.log(`\n  🔗 跨文件问题 (${report.crossFileViolations.length} 个):`);
           for (const v of report.crossFileViolations.slice(0, 10)) {
-            console.log(`     ⚠️  [${v.ruleId}] ${v.message}`);
+            console.log(`    ⚠️ [${v.ruleId || 'cross-file'}] ${v.message}`);
             if (v.locations) {
               for (const loc of v.locations.slice(0, 5)) {
-                const relLoc = loc.filePath.replace(scanRoot + '/', '');
-                console.log(`        📄 ${relLoc}:L${loc.line}`);
+                const relLoc = loc.filePath.replace(`${scanRoot}/`, '');
+                console.log(`      📍 ${relLoc}${loc.line ? `:${loc.line}` : ''}`);
+              }
+              if (v.locations.length > 5) {
+                console.log(`      ... 还有 ${v.locations.length - 5} 个位置`);
               }
-              if (v.locations.length > 5) console.log(`        ... 还有 ${v.locations.length - 5} 处`);
             }
           }
         }
       }
       return;
     }
-
-    /* ── 单文件审计 (file scope) ── */
-    console.log(`\n🛡️  [Guard] 正在检查文件: ${basename(fullPath)}`);
-    _auditSingleFile(engine, fullPath, code, detectLanguage, scope);
+    _auditSingleFile(watcher, engine, fullPath, code, detectLanguage, scope);
 
     // 如果有非 scope 关键词，也做语义搜索
     if (rest && !isScope) {
       try {
         const searchEngine = container.get('searchEngine');
         const results = await searchEngine.search(rest, { limit: 3, mode: 'keyword' });
-        if (results.length > 0) {
-          console.log(`  🧠 相关规范 (${results.length}条):`);
-          for (const r of results) {
-            console.log(`     - ${r.title || r.id}`);
+        const items = Array.isArray(results) ? results : results.items || [];
+        if (items.length > 0) {
+          console.log(`\n  📚 相关规范 ("${rest}"):`);
+          for (const r of items) {
+            console.log(`    • ${r.title || r.name || r.id}`);
           }
         }
       } catch {
@@ -199,32 +214,47 @@ export async function handleGuard(watcher, fullPath, code, guardLine) {
 /**
  * 检查单个文件并打印结果
  */
-function _auditSingleFile(engine, fullPath, code, detectLanguage, scope = 'file') {
+function _auditSingleFile(watcher, engine, fullPath, code, detectLanguage, scope = 'file') {
   const language = detectLanguage(fullPath);
   const violations = engine.checkCode(code, language, { scope });
 
   if (violations.length === 0) {
-    console.log(`  ✅ 无违规`);
+    console.log(`\n  ✅ Guard 审计通过 — 无违规 (${fullPath.split('/').pop()})`);
+    watcher._notify?.('审计通过 ✅ 无违规');
   } else {
     const errors = violations.filter((v) => v.severity === 'error');
     const warnings = violations.filter((v) => v.severity === 'warning');
-    console.log(`  🛡️ ${errors.length} errors, ${warnings.length} warnings`);
+    console.log(`\n  ❌ 发现 ${violations.length} 个问题 (${errors.length} 错误, ${warnings.length} 警告)`);
+    watcher._notify?.(`审计: ${violations.length} 个问题 (${errors.length} 错误, ${warnings.length} 警告)`);
     for (const v of errors) {
-      console.log(`  ❌ L${v.line} [${v.ruleId}] ${v.message}`);
-      if (v.fixSuggestion) console.log(`     🔧 修复建议: ${v.fixSuggestion}`);
+      console.log(`    🔴 [${v.ruleId || 'unknown'}] ${v.message}${v.line ? ` (行 ${v.line})` : ''}`);
+      if (v.fixSuggestion) {
+        console.log(`       💡 建议: ${v.fixSuggestion}`);
+      }
     }
     for (const v of warnings.slice(0, 5)) {
-      console.log(`  ⚠️  L${v.line} [${v.ruleId}] ${v.message}`);
-      if (v.fixSuggestion) console.log(`     🔧 修复建议: ${v.fixSuggestion}`);
+      console.log(`    🟡 [${v.ruleId || 'unknown'}] ${v.message}${v.line ? ` (行 ${v.line})` : ''}`);
+      if (v.fixSuggestion) {
+        console.log(`       💡 建议: ${v.fixSuggestion}`);
+      }
+    }
+    if (warnings.length > 5) {
+      console.log(`    ... 还有 ${warnings.length - 5} 个警告`);
     }
   }
 
   // Guard ↔ Recipe 闭环：检测修复并自动确认使用（fire-and-forget）
-  import('../../../injection/ServiceContainer.js').then(({ ServiceContainer }) => {
-    try {
-      const container = ServiceContainer.getInstance();
-      const feedbackLoop = container.get('guardFeedbackLoop');
-      feedbackLoop.processFixDetection({ violations }, fullPath);
-    } catch { /* guardFeedbackLoop not available */ }
-  }).catch(() => { /* ignored */ });
+  import('../../../injection/ServiceContainer.js')
+    .then(({ ServiceContainer }) => {
+      try {
+        const container = ServiceContainer.getInstance();
+        const feedbackLoop = container.get('guardFeedbackLoop');
+        feedbackLoop.processFixDetection({ violations }, fullPath);
+      } catch {
+        /* guardFeedbackLoop not available */
+      }
+    })
+    .catch(() => {
+      /* ignored */
+    });
 }

package/lib/service/automation/handlers/HeaderHandler.js

@@ -18,12 +18,9 @@ export async function handleHeader(watcher, fullPath, headerLine, importArray, i
     const parsed = HeaderResolver.parseImportLine(headerLine);
 
     if (!parsed) {
-      console.log(`[Header] 无法解析指令: ${headerLine}`);
       return;
     }
 
-    console.log(`\n📦 [Header] ${isSwift ? 'import' : '#import'} ${parsed.moduleName || parsed.headerName || headerLine}`);
-
     const resolved = await HeaderResolver.resolveHeadersForText(
       watcher.projectRoot,
       basename(fullPath),
@@ -31,11 +28,10 @@ export async function handleHeader(watcher, fullPath, headerLine, importArray, i
     );
 
     if (!resolved || !resolved.headers || resolved.headers.length === 0) {
-      console.log(`  ℹ️  未找到需要添加的头文件`);
       return;
     }
 
-    const { insertHeaders } = await import('../XcodeIntegration.js');
+    const { insertHeaders } = await import('../../../platform/ios/xcode/XcodeIntegration.js');
     const result = await insertHeaders(watcher, fullPath, resolved.headers, {
       isSwift,
       moduleName: resolved.moduleName || null,
@@ -45,7 +41,6 @@ export async function handleHeader(watcher, fullPath, headerLine, importArray, i
       return;
     }
     if (result.inserted.length === 0 && result.skipped.length > 0) {
-      console.log(`  ✅ 头文件已全部导入`);
     }
   } catch (err) {
     console.warn(`  ⚠️ Header 处理失败: ${err.message}`);

package/lib/service/automation/handlers/SearchHandler.js

@@ -9,17 +9,12 @@
  * @param {string} searchLine
  */
 export async function handleSearch(watcher, fullPath, relativePath, searchLine) {
-  const query = searchLine
-    .replace(/^\/\/\s*(?:autosnippet|as):(?:search|s)\s*/, '')
-    .trim();
+  const query = searchLine.replace(/^\/\/\s*(?:autosnippet|as):(?:search|s)\s*/, '').trim();
 
   if (!query) {
-    console.log(`[as:search] 请在指令后写搜索关键词，如 // as:s 网络请求`);
     return;
   }
 
-  console.log(`\n🔍 [Search] "${query}" ...`);
-
   let results = [];
   try {
     const { ServiceContainer } = await import('../../../injection/ServiceContainer.js');
@@ -30,16 +25,16 @@ export async function handleSearch(watcher, fullPath, relativePath, searchLine)
     searchEngine.ensureIndex();
     const stats = searchEngine.getStats();
     if (stats.totalDocuments === 0) {
-      console.log(`  ⚠️  知识库为空（索引 0 条记录），请先通过 asd setup / Dashboard 添加知识条目`);
     } else {
-      console.log(`  📊 索引 ${stats.totalDocuments} 条知识`);
     }
 
     // auto (BM25+semantic 融合 + Ranking Pipeline) → keyword (SQL LIKE) 降级链
     // Xcode/IDE 场景: 传递 generate intent，让排序器使用代码生成权重
     try {
       results = await searchEngine.search(query, {
-        limit: 10, mode: 'auto', rank: true,
+        limit: 10,
+        mode: 'auto',
+        rank: true,
         context: { intent: 'generate' },
       });
       // auto 零结果 → keyword (SQL LIKE) 兆底
@@ -49,11 +44,12 @@ export async function handleSearch(watcher, fullPath, relativePath, searchLine)
     } catch {
       try {
         results = await searchEngine.search(query, { limit: 10, mode: 'keyword' });
-      } catch { /* 全部失败 */ }
+      } catch {
+        /* 全部失败 */
+      }
     }
   } catch (err) {
     console.warn(`  ⚠️ 搜索失败: ${err.message}`);
-    console.log(`  ℹ️  未找到「${query}」的相关结果`);
     watcher._notify(`搜索「${query}」失败: ${err.message}`);
     return;
   }
@@ -68,24 +64,19 @@ export async function handleSearch(watcher, fullPath, relativePath, searchLine)
   });
 
   if (items.length === 0) {
-    console.log(`  ℹ️  未找到「${query}」的相关结果`);
     watcher._notify(`未找到「${query}」的相关结果`);
     return;
   }
 
-  console.log(`  📋 找到 ${items.length} 条结果`);
-
   // NativeUI 交互选择
   const NU = await import('../../../infrastructure/external/NativeUi.js');
   const selectedIndex = NU.showCombinedWindow(items, query);
 
   if (selectedIndex < 0 || selectedIndex >= items.length) {
-    console.log(`  ℹ️  用户取消选择`);
     return;
   }
 
   const selected = items[selectedIndex];
-  console.log(`  ✅ 选中: ${selected.title}`);
 
   // 如果 selected 没有 moduleName，尝试从当前文件路径推断
   if (!selected.moduleName && selected.headers && selected.headers.length > 0) {
@@ -96,14 +87,16 @@ export async function handleSearch(watcher, fullPath, relativePath, searchLine)
         relativePath,
         (await import('node:fs')).readFileSync(fullPath, 'utf8')
       );
-      if (resolved && resolved.moduleName) {
+      if (resolved?.moduleName) {
         selected.moduleName = resolved.moduleName;
       }
-    } catch { /* 解析失败不阻塞 */ }
+    } catch {
+      /* 解析失败不阻塞 */
+    }
   }
 
-  // 自动插入代码到 Xcode
-  const { insertCodeToXcode } = await import('../XcodeIntegration.js');
+  // Xcode 代码自动插入（osascript 跳转 + 粘贴）
+  const { insertCodeToXcode } = await import('../../../platform/ios/xcode/XcodeIntegration.js');
   await insertCodeToXcode(watcher, fullPath, selected, searchLine);
 }
 
@@ -111,81 +104,103 @@ export async function handleSearch(watcher, fullPath, relativePath, searchLine)
  * 将搜索结果标准化为 NativeUI 可展示格式
  */
 export function normalizeSearchResults(results) {
-  if (!results) return [];
-  const arr = Array.isArray(results) ? results : (results.items || []);
-
-  return arr.map(r => {
-    let code = '';
-    let explanation = '';
-    let headers = [];
-    if (r.content) {
-      try {
-        const content = typeof r.content === 'string' ? JSON.parse(r.content) : r.content;
-        code = content.code || content.pattern || content.markdown
-          || content.content || content.body || content.snippet
-          || content.solution || content.example || '';
-        explanation = content.rationale || content.description
-          || content.summary || content.explanation || '';
-        if (Array.isArray(content.headers) && content.headers.length > 0) {
-          headers = content.headers;
-        }
-        // 如果主字段为空，尝试从 Markdown 内容提取代码块
-        if (!code && content.markdown) {
-          const fenced = content.markdown.match(/```[\w]*\n([\s\S]*?)```/);
-          if (fenced) code = fenced[1].trim();
+  if (!results) {
+    return [];
+  }
+  const arr = Array.isArray(results) ? results : results.items || [];
+
+  return arr
+    .map((r) => {
+      let code = '';
+      let explanation = '';
+      let headers = [];
+      if (r.content) {
+        try {
+          const content = typeof r.content === 'string' ? JSON.parse(r.content) : r.content;
+          // 注意: 不直接使用 content.markdown —— markdown 是完整文档，不是纯代码
+          code =
+            content.code ||
+            content.pattern ||
+            content.content ||
+            content.body ||
+            content.snippet ||
+            content.solution ||
+            content.example ||
+            '';
+          explanation =
+            content.rationale ||
+            content.description ||
+            content.summary ||
+            content.explanation ||
+            '';
+          if (Array.isArray(content.headers) && content.headers.length > 0) {
+            headers = content.headers;
+          }
+          // 如果主字段为空，尝试从 Markdown 内容提取代码块
+          if (!code && content.markdown) {
+            code = _extractCodeFromMarkdown(content.markdown);
+            // 若 markdown 中提取不出代码，且 explanation 为空，用 markdown 生成摘要
+            if (!code && !explanation) {
+              explanation = _stripMarkdownFormatting(content.markdown).substring(0, 500);
+            }
+          }
+        } catch {
+          // content 不是 JSON，可能是纯文本/代码 — 直接使用
+          if (typeof r.content === 'string' && r.content.length > 10) {
+            code = r.content.substring(0, 2000);
+          }
         }
-      } catch {
-        // content 不是 JSON，可能是纯文本/代码 — 直接使用
-        if (typeof r.content === 'string' && r.content.length > 10) {
-          code = r.content.substring(0, 2000);
+      }
+      // 如果 Ranking Pipeline 已提取 code 字段，优先使用
+      if (!code && r.code && r.code.length > 5) {
+        code = r.code;
+      }
+      // V3: headers 是独立 JSON 列（字符串），优先解析
+      if (headers.length === 0 && r.headers) {
+        try {
+          const parsed = typeof r.headers === 'string' ? JSON.parse(r.headers) : r.headers;
+          if (Array.isArray(parsed) && parsed.length > 0) {
+            headers = parsed;
+          }
+        } catch {
+          /* ignore */
         }
       }
-    }
-    // 如果 Ranking Pipeline 已提取 code 字段，优先使用
-    if (!code && r.code && r.code.length > 5) {
-      code = r.code;
-    }
-    // V3: headers 是独立 JSON 列（字符串），优先解析
-    if (headers.length === 0 && r.headers) {
-      try {
-        const parsed = typeof r.headers === 'string' ? JSON.parse(r.headers) : r.headers;
-        if (Array.isArray(parsed) && parsed.length > 0) {
-          headers = parsed;
+      // moduleName: 优先从独立列取
+      let moduleName = r.moduleName || null;
+      if (!moduleName && r.content) {
+        try {
+          const content = typeof r.content === 'string' ? JSON.parse(r.content) : r.content;
+          moduleName = content.moduleName || null;
+        } catch {
+          /* ignore */
         }
-      } catch { /* ignore */ }
-    }
-    // moduleName: 优先从独立列取
-    let moduleName = r.moduleName || null;
-    if (!moduleName && r.content) {
-      try {
-        const content = typeof r.content === 'string' ? JSON.parse(r.content) : r.content;
-        moduleName = content.moduleName || null;
-      } catch { /* ignore */ }
-    }
-    if (!moduleName) {
-      moduleName = r.moduleName || null;
-    }
+      }
+      if (!moduleName) {
+        moduleName = r.moduleName || null;
+      }
 
-    // ── 从 code 中分离 #import / @import / import 行，归入 headers ──
-    const finalCode = code || r.code || r.description || r.trigger || '(无预览内容)';
-    const { cleanedCode, extractedHeaders } = _separateImportsFromCode(finalCode);
-    if (extractedHeaders.length > 0) {
-      for (const h of extractedHeaders) {
-        if (!headers.some(existing => existing.trim() === h.trim())) {
-          headers.push(h);
+      // ── 从 code 中分离 #import / @import / import 行，归入 headers ──
+      const finalCode = code || r.code || r.description || r.trigger || '(无预览内容)';
+      const { cleanedCode, extractedHeaders } = _separateImportsFromCode(finalCode);
+      if (extractedHeaders.length > 0) {
+        for (const h of extractedHeaders) {
+          if (!headers.some((existing) => existing.trim() === h.trim())) {
+            headers.push(h);
+          }
         }
       }
-    }
 
-    return {
-      title: r.title || r.name || r.id || 'Recipe',
-      code: cleanedCode || '(无预览内容)',
-      explanation: explanation || r.summary || r.description || '',
-      headers,
-      moduleName,
-      trigger: r.trigger || r.completionKey || '',
-    };
-  }).filter(item => item.title);
+      return {
+        title: r.title || r.name || r.id || 'Recipe',
+        code: cleanedCode || '(无预览内容)',
+        explanation: explanation || r.summary || r.description || '',
+        headers,
+        moduleName,
+        trigger: r.trigger || r.completionKey || '',
+      };
+    })
+    .filter((item) => item.title);
 }
 
 /**
@@ -210,7 +225,9 @@ function _separateImportsFromCode(code) {
     const trimmed = lines[i].trim();
     if (!trimmed) {
       // 空行：如果前面已有 import，继续扫描
-      if (lastImportIdx >= 0) continue;
+      if (lastImportIdx >= 0) {
+        continue;
+      }
       // 前面没 import，遇到前导空行也继续
       continue;
     }
@@ -236,3 +253,53 @@ function _separateImportsFromCode(code) {
   const cleanedCode = remaining.join('\n').trim();
   return { cleanedCode, extractedHeaders };
 }
+
+/**
+ * 从 Markdown 文本中提取所有 fenced code blocks，合并为纯代码
+ *
+ * 支持 ```lang\n...\n``` 格式，提取多个代码块并用空行分隔。
+ * 如果没有找到代码块，返回空字符串。
+ *
+ * @param {string} md - Markdown 文本
+ * @returns {string} 提取出的纯代码，或空字符串
+ */
+function _extractCodeFromMarkdown(md) {
+  if (!md) {
+    return '';
+  }
+  const fencedRe = /```[\w]*\n([\s\S]*?)```/g;
+  const blocks = [];
+  let match;
+  while ((match = fencedRe.exec(md)) !== null) {
+    const block = match[1].trim();
+    if (block) {
+      blocks.push(block);
+    }
+  }
+  return blocks.join('\n\n');
+}
+
+/**
+ * 移除 Markdown 格式标记，返回纯文本摘要
+ *
+ * 用于在无法提取代码时，从 markdown 生成 explanation 文本。
+ *
+ * @param {string} md - Markdown 文本
+ * @returns {string} 纯文本
+ */
+function _stripMarkdownFormatting(md) {
+  if (!md) {
+    return '';
+  }
+  return md
+    .replace(/```[\w]*\n[\s\S]*?```/g, '')   // 移除代码块
+    .replace(/^#{1,6}\s+/gm, '')              // 移除标题标记
+    .replace(/\*\*([^*]+)\*\*/g, '$1')        // 移除粗体
+    .replace(/\*([^*]+)\*/g, '$1')            // 移除斜体
+    .replace(/`([^`]+)`/g, '$1')              // 移除行内代码
+    .replace(/^\s*[-*+]\s+/gm, '')            // 移除列表标记
+    .replace(/^\s*\d+\.\s+/gm, '')            // 移除有序列表
+    .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')  // 移除链接，保留文字
+    .replace(/\n{3,}/g, '\n\n')               // 压缩多余空行
+    .trim();
+}