autosnippet 3.0.0 → 3.0.2

package/lib/service/wiki/WikiGenerator.js

@@ -30,34 +30,35 @@
  * @module WikiGenerator
  */
 
+import { createHash } from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
-import { createHash } from 'node:crypto';
 import Logger from '../../infrastructure/logging/Logger.js';
+import { LanguageService } from '../../shared/LanguageService.js';
 
 const logger = Logger.getInstance();
 
 // ─── Wiki 生成阶段 ──────────────────────────────────────────
 
 export const WikiPhase = Object.freeze({
-  INIT:         'init',          // 初始化 & 自检
-  SCAN:         'scan',          // 扫描项目结构
-  AST_ANALYZE:  'ast-analyze',   // AST 深度分析
-  SPM_PARSE:    'spm-parse',     // SPM 依赖解析
-  KNOWLEDGE:    'knowledge',     // 整合已有 Recipes
-  GENERATE:     'generate',      // 生成 Markdown 骨架
-  AI_COMPOSE:   'ai-compose',    // AI 合成写作增强
-  SYNC_DOCS:    'sync-docs',     // 同步 Cursor 端 MD
-  DEDUP:        'dedup',         // 去重
-  FINALIZE:     'finalize',      // 写入 meta.json
+  INIT: 'init', // 初始化 & 自检
+  SCAN: 'scan', // 扫描项目结构
+  AST_ANALYZE: 'ast-analyze', // AST 深度分析
+  SPM_PARSE: 'spm-parse', // SPM 依赖解析
+  KNOWLEDGE: 'knowledge', // 整合已有 Recipes
+  GENERATE: 'generate', // 生成 Markdown 骨架
+  AI_COMPOSE: 'ai-compose', // AI 合成写作增强
+  SYNC_DOCS: 'sync-docs', // 同步 Cursor 端 MD
+  DEDUP: 'dedup', // 去重
+  FINALIZE: 'finalize', // 写入 meta.json
 });
 
 // ─── 默认配置 ────────────────────────────────────────────────
 
 const DEFAULTS = {
-  wikiDir:       'AutoSnippet/wiki',
-  language:      'zh',   // 'zh' | 'en'
-  maxFiles:      500,
+  wikiDir: 'AutoSnippet/wiki',
+  language: 'zh', // 'zh' | 'en'
+  maxFiles: 500,
   includeRecipes: true,
   includeDepGraph: true,
   includeComponents: true,
@@ -69,7 +70,8 @@ export class WikiGenerator {
   /**
    * @param {object} deps
    * @param {string} deps.projectRoot
-   * @param {import('../../service/spm/SpmService.js').SpmService} [deps.spmService]
+   * @param {import('../../service/module/ModuleService.js').ModuleService} [deps.moduleService]
+   * @param {import('../../platform/ios/spm/SpmService.js').SpmService} [deps.spmService] — 向后兼容
    * @param {import('../../service/knowledge/KnowledgeService.js').KnowledgeService} [deps.knowledgeService]
    * @param {import('../../core/ast/ProjectGraph.js').default} [deps.projectGraph]
    * @param {import('../../service/knowledge/CodeEntityGraph.js').CodeEntityGraph} [deps.codeEntityGraph]
@@ -78,14 +80,14 @@ export class WikiGenerator {
    * @param {object} [deps.options]
    */
   constructor(deps) {
-    this.projectRoot      = deps.projectRoot;
-    this.spmService       = deps.spmService || null;
+    this.projectRoot = deps.projectRoot;
+    this.moduleService = deps.moduleService || null;
     this.knowledgeService = deps.knowledgeService || null;
-    this.projectGraph     = deps.projectGraph || null;
-    this.codeEntityGraph  = deps.codeEntityGraph || null;
-    this.aiProvider       = deps.aiProvider || null;
-    this.onProgress       = deps.onProgress || (() => {});
-    this.options          = { ...DEFAULTS, ...deps.options };
+    this.projectGraph = deps.projectGraph || null;
+    this.codeEntityGraph = deps.codeEntityGraph || null;
+    this.aiProvider = deps.aiProvider || null;
+    this.onProgress = deps.onProgress || (() => {});
+    this.options = { ...DEFAULTS, ...deps.options };
 
     this.wikiDir = path.join(this.projectRoot, this.options.wikiDir);
     this.metaPath = path.join(this.wikiDir, 'meta.json');
@@ -111,39 +113,53 @@ export class WikiGenerator {
       // Phase 2: Scan project
       this._emit(WikiPhase.SCAN, 5, '扫描项目结构...');
       const projectInfo = await this._scanProject();
-      if (this._aborted) return this._abortedResult();
+      if (this._aborted) {
+        return this._abortedResult();
+      }
 
       // Phase 3: AST analyze
       this._emit(WikiPhase.AST_ANALYZE, 15, '执行 AST 深度分析...');
       const astInfo = await this._analyzeAST();
-      if (this._aborted) return this._abortedResult();
+      if (this._aborted) {
+        return this._abortedResult();
+      }
 
-      // Phase 4: SPM parse
-      this._emit(WikiPhase.SPM_PARSE, 30, '解析 SPM 依赖关系...');
+      // Phase 4: Module/SPM parse
+      this._emit(WikiPhase.SPM_PARSE, 30, '解析模块依赖关系...');
       const spmInfo = await this._parseSPM();
-      if (this._aborted) return this._abortedResult();
+      if (this._aborted) {
+        return this._abortedResult();
+      }
 
       // Phase 5: Knowledge integration
       this._emit(WikiPhase.KNOWLEDGE, 45, '整合知识库 Recipes...');
       const knowledgeInfo = await this._integrateKnowledge();
-      if (this._aborted) return this._abortedResult();
+      if (this._aborted) {
+        return this._abortedResult();
+      }
 
       // Phase 6: Content-driven topic discovery (V3)
       this._emit(WikiPhase.GENERATE, 50, '分析项目数据，发现文档主题...');
       const structuredData = { projectInfo, astInfo, spmInfo, knowledgeInfo };
       const topics = this._discoverTopics(projectInfo, astInfo, spmInfo, knowledgeInfo);
-      if (this._aborted) return this._abortedResult();
+      if (this._aborted) {
+        return this._abortedResult();
+      }
 
       // Phase 7: AI-first article composition (V3)
       this._emit(WikiPhase.AI_COMPOSE, 55, `撰写 ${topics.length} 篇文档...`);
       const files = await this._composeArticles(topics, structuredData);
-      if (this._aborted) return this._abortedResult();
+      if (this._aborted) {
+        return this._abortedResult();
+      }
 
       // Phase 8: Sync Cursor docs
       this._emit(WikiPhase.SYNC_DOCS, 80, '同步 Cursor 端文档...');
       const syncedFiles = this._syncCursorDocs();
       files.push(...syncedFiles);
-      if (this._aborted) return this._abortedResult();
+      if (this._aborted) {
+        return this._abortedResult();
+      }
 
       // Phase 9: Dedup
       this._emit(WikiPhase.DEDUP, 90, '去重检查...');
@@ -159,7 +175,7 @@ export class WikiGenerator {
       return {
         success: true,
         filesGenerated: files.length,
-        aiComposed: files.filter(f => f.polished).length,
+        aiComposed: files.filter((f) => f.polished).length,
         syncedDocs: syncedFiles.length,
         dedup: dedupResult,
         duration,
@@ -237,20 +253,34 @@ export class WikiGenerator {
     // 检测项目类型
     const entries = fs.readdirSync(this.projectRoot, { withFileTypes: true });
     for (const e of entries) {
-      if (e.name === 'Package.swift') info.hasPackageSwift = true;
-      if (e.name === 'Podfile')       info.hasPodfile = true;
-      if (e.name.endsWith('.xcodeproj') || e.name.endsWith('.xcworkspace')) info.hasXcodeproj = true;
+      if (e.name === 'Package.swift') {
+        info.hasPackageSwift = true;
+      }
+      if (e.name === 'Podfile') {
+        info.hasPodfile = true;
+      }
+      if (e.name.endsWith('.xcodeproj') || e.name.endsWith('.xcworkspace')) {
+        info.hasXcodeproj = true;
+      }
     }
 
     // 统计源文件
-    const extMap = { '.swift': 'Swift', '.m': 'Objective-C', '.h': 'Objective-C Header', '.mm': 'Objective-C++' };
-    this._walkDir(this.projectRoot, (filePath) => {
-      const ext = path.extname(filePath);
-      if (extMap[ext]) {
-        info.sourceFiles.push(path.relative(this.projectRoot, filePath));
-        info.languages[extMap[ext]] = (info.languages[extMap[ext]] || 0) + 1;
-      }
-    }, this.options.maxFiles);
+    const extMap = {};
+    for (const ext of LanguageService.sourceExts) {
+      extMap[ext] = LanguageService.displayNameFromExt(ext) || ext;
+    }
+    this._walkDir(
+      this.projectRoot,
+      (filePath) => {
+        const ext = path.extname(filePath);
+        if (extMap[ext]) {
+          info.sourceFiles.push(path.relative(this.projectRoot, filePath));
+          const displayLang = LanguageService.displayNameFromExt(ext);
+          info.languages[displayLang] = (info.languages[displayLang] || 0) + 1;
+        }
+      },
+      this.options.maxFiles
+    );
 
     // 按模块/Target 分组源文件 (SPM 约定: Sources/{ModuleName}/...)
     info.sourceFilesByModule = {};
@@ -266,7 +296,9 @@ export class WikiGenerator {
         mod = parts.length > 1 ? parts[0] : null;
       }
       if (mod) {
-        if (!info.sourceFilesByModule[mod]) info.sourceFilesByModule[mod] = [];
+        if (!info.sourceFilesByModule[mod]) {
+          info.sourceFilesByModule[mod] = [];
+        }
         info.sourceFilesByModule[mod].push(f);
       }
     }
@@ -293,7 +325,9 @@ export class WikiGenerator {
         if (info?.filePath) {
           const mod = this._inferModuleFromPath(info.filePath);
           if (mod) {
-            if (!classNamesByModule[mod]) classNamesByModule[mod] = [];
+            if (!classNamesByModule[mod]) {
+              classNamesByModule[mod] = [];
+            }
             classNamesByModule[mod].push(name);
           }
         }
@@ -304,13 +338,19 @@ export class WikiGenerator {
         if (info?.filePath) {
           const mod = this._inferModuleFromPath(info.filePath);
           if (mod) {
-            if (!protocolNamesByModule[mod]) protocolNamesByModule[mod] = [];
+            if (!protocolNamesByModule[mod]) {
+              protocolNamesByModule[mod] = [];
+            }
             protocolNamesByModule[mod].push(name);
           }
         }
       }
 
-      this._emit(WikiPhase.AST_ANALYZE, 25, `AST 分析: ${overview.totalClasses} 个类, ${overview.totalProtocols} 个协议`);
+      this._emit(
+        WikiPhase.AST_ANALYZE,
+        25,
+        `AST 分析: ${overview.totalClasses} 个类, ${overview.totalProtocols} 个协议`
+      );
       return {
         overview,
         classes: allClasses,
@@ -321,27 +361,40 @@ export class WikiGenerator {
     }
 
     // 没有现成的 ProjectGraph — 返回空壳（不阻塞生成）
-    return { overview: null, classes: [], protocols: [], classNamesByModule: {}, protocolNamesByModule: {} };
+    return {
+      overview: null,
+      classes: [],
+      protocols: [],
+      classNamesByModule: {},
+      protocolNamesByModule: {},
+    };
   }
 
   /**
-   * SPM 依赖解析
+   * 模块依赖解析
+   * 通过 moduleService 统一处理所有语言的模块扫描
    */
   async _parseSPM() {
-    if (!this.spmService) return { targets: [], depGraph: null };
+    if (!this.moduleService) {
+      return { targets: [], depGraph: null };
+    }
 
     try {
-      const targets = await this.spmService.listTargets();
+      await this.moduleService.load();
+      const targets = await this.moduleService.listTargets();
       let depGraph = null;
       if (this.options.includeDepGraph) {
         try {
-          depGraph = await this.spmService.getDependencyGraph({ level: 'target' });
-        } catch { /* non-critical */ }
+          depGraph = await this.moduleService.getDependencyGraph({ level: 'target' });
+        } catch {
+          /* non-critical */
+        }
       }
-      this._emit(WikiPhase.SPM_PARSE, 40, `SPM: ${targets.length} 个 Target`);
-      return { targets, depGraph };
+      const info = this.moduleService.getProjectInfo();
+      this._emit(WikiPhase.SPM_PARSE, 40, `模块: ${targets.length} 个 (${info.primaryLanguage})`);
+      return { targets, depGraph, projectInfo: info };
     } catch (err) {
-      logger.warn('[WikiGenerator] SPM parse failed', { error: err.message });
+      logger.warn('[WikiGenerator] ModuleService parse failed', { error: err.message });
       return { targets: [], depGraph: null };
     }
   }
@@ -361,7 +414,7 @@ export class WikiGenerator {
         offset: 0,
       });
       const recipes = result.items || result || [];
-      const stats = await this.knowledgeService.getStats?.() || null;
+      const stats = (await this.knowledgeService.getStats?.()) || null;
       this._emit(WikiPhase.KNOWLEDGE, 55, `知识库: ${recipes.length} 条活跃 Recipe`);
       return { recipes: Array.isArray(recipes) ? recipes : [], stats };
     } catch (err) {
@@ -411,7 +464,8 @@ export class WikiGenerator {
 
     // ── 3. 快速上手 (需要构建配置或入口点) ──
     const hasEntryPoints = (astInfo.overview?.entryPoints?.length || 0) > 0;
-    const hasBuildSystem = projectInfo.hasPackageSwift || projectInfo.hasPodfile || projectInfo.hasXcodeproj;
+    const hasBuildSystem =
+      projectInfo.hasPackageSwift || projectInfo.hasPodfile || projectInfo.hasXcodeproj;
 
     if (hasEntryPoints || hasBuildSystem) {
       topics.push({
@@ -434,7 +488,9 @@ export class WikiGenerator {
       const richness = moduleFiles.length + classCount * 2 + protoCount * 2 + depCount;
 
       // 跳过过于单薄的模块 (少于3分不值得独立文档)
-      if (richness < 3) continue;
+      if (richness < 3) {
+        continue;
+      }
 
       topics.push({
         id: `module-${_slug(target.name)}`,
@@ -452,7 +508,9 @@ export class WikiGenerator {
       for (const r of knowledgeInfo.recipes) {
         const json = r.toJSON ? r.toJSON() : r;
         const cat = json.category || 'Other';
-        if (!groups[cat]) groups[cat] = [];
+        if (!groups[cat]) {
+          groups[cat] = [];
+        }
         groups[cat].push(json);
       }
 
@@ -470,7 +528,9 @@ export class WikiGenerator {
       } else {
         // 按分类拆分为多篇
         for (const [cat, items] of catEntries) {
-          if (items.length < 2) continue;
+          if (items.length < 2) {
+            continue;
+          }
           topics.push({
             id: `pattern-${_slug(cat)}`,
             path: `patterns/${_slug(cat)}.md`,
@@ -497,7 +557,9 @@ export class WikiGenerator {
     // 按优先级排序
     topics.sort((a, b) => b.priority - a.priority);
 
-    logger.info(`[WikiGenerator] Discovered ${topics.length} topics: ${topics.map(t => t.id).join(', ')}`);
+    logger.info(
+      `[WikiGenerator] Discovered ${topics.length} topics: ${topics.map((t) => t.id).join(', ')}`
+    );
     this._emit(WikiPhase.GENERATE, 55, `发现 ${topics.length} 个文档主题`);
     return topics;
   }
@@ -521,20 +583,28 @@ export class WikiGenerator {
 
     // 确保必要的子目录存在
     this._ensureDir(this.wikiDir);
-    const needsModulesDir = topics.some(t => t.path.startsWith('modules/'));
-    const needsPatternsDir = topics.some(t => t.path.startsWith('patterns/'));
-    if (needsModulesDir) this._ensureDir(path.join(this.wikiDir, 'modules'));
-    if (needsPatternsDir) this._ensureDir(path.join(this.wikiDir, 'patterns'));
+    const needsModulesDir = topics.some((t) => t.path.startsWith('modules/'));
+    const needsPatternsDir = topics.some((t) => t.path.startsWith('patterns/'));
+    if (needsModulesDir) {
+      this._ensureDir(path.join(this.wikiDir, 'modules'));
+    }
+    if (needsPatternsDir) {
+      this._ensureDir(path.join(this.wikiDir, 'patterns'));
+    }
 
     let composed = 0;
     const systemPrompt = this._buildAiSystemPrompt(isZh);
 
     for (let i = 0; i < topics.length; i++) {
-      if (this._aborted) break;
+      if (this._aborted) {
+        break;
+      }
 
       const topic = topics[i];
       // 将全部主题列表注入 overview，用于生成导航
-      if (topic.type === 'overview') topic._allTopics = topics;
+      if (topic.type === 'overview') {
+        topic._allTopics = topics;
+      }
 
       const progress = 58 + Math.round((i / topics.length) * 22);
       this._emit(WikiPhase.AI_COMPOSE, progress, `撰写: ${topic.title}`);
@@ -547,7 +617,9 @@ export class WikiGenerator {
           const prompt = this._buildArticlePrompt(topic, structuredData, isZh);
           const aiResult = await Promise.race([
             this.aiProvider.chat(prompt, { systemPrompt, temperature: 0.3, maxTokens: 4096 }),
-            new Promise((_, reject) => setTimeout(() => reject(new Error('AI compose timeout')), 45_000)),
+            new Promise((_, reject) =>
+              setTimeout(() => reject(new Error('AI compose timeout')), 45_000)
+            ),
           ]);
 
           if (aiResult && typeof aiResult === 'string' && aiResult.length >= MIN_ARTICLE_CHARS) {
@@ -566,7 +638,9 @@ export class WikiGenerator {
 
       // === 3. 质量关卡 ===
       if (!content || content.length < MIN_ARTICLE_CHARS) {
-        logger.info(`[WikiGenerator] Skipping thin topic: ${topic.id} (${content?.length || 0} chars)`);
+        logger.info(
+          `[WikiGenerator] Skipping thin topic: ${topic.id} (${content?.length || 0} chars)`
+        );
         continue;
       }
 
@@ -579,7 +653,11 @@ export class WikiGenerator {
     }
 
     logger.info(`[WikiGenerator] Composed ${files.length} articles (${composed} AI-enhanced)`);
-    this._emit(WikiPhase.AI_COMPOSE, 80, `撰写完成: ${files.length} 篇文档 (${composed} 篇 AI 增强)`);
+    this._emit(
+      WikiPhase.AI_COMPOSE,
+      80,
+      `撰写完成: ${files.length} 篇文档 (${composed} 篇 AI 增强)`
+    );
     return files;
   }
 
@@ -596,9 +674,16 @@ export class WikiGenerator {
 
     // 公共项目上下文
     parts.push(`# 项目: ${projectInfo.name}`);
-    parts.push(`源文件数: ${projectInfo.sourceFiles.length}, SPM Targets: ${spmInfo.targets.length}, 活跃知识条目: ${knowledgeInfo.recipes.length}`);
+    parts.push(
+      `源文件数: ${projectInfo.sourceFiles.length}, SPM Targets: ${spmInfo.targets.length}, 活跃知识条目: ${knowledgeInfo.recipes.length}`
+    );
     if (projectInfo.languages) {
-      parts.push(`语言分布: ${Object.entries(projectInfo.languages).sort((a, b) => b[1] - a[1]).map(([l, c]) => `${l}(${c})`).join(', ')}`);
+      parts.push(
+        `语言分布: ${Object.entries(projectInfo.languages)
+          .sort((a, b) => b[1] - a[1])
+          .map(([l, c]) => `${l}(${c})`)
+          .join(', ')}`
+      );
     }
     parts.push('');
 
@@ -609,10 +694,18 @@ export class WikiGenerator {
 
         // 项目类型
         const types = [];
-        if (projectInfo.hasPackageSwift) types.push('SPM');
-        if (projectInfo.hasPodfile) types.push('CocoaPods');
-        if (projectInfo.hasXcodeproj) types.push('Xcode Project');
-        if (types.length > 0) parts.push(`构建系统: ${types.join(' + ')}`);
+        if (projectInfo.hasPackageSwift) {
+          types.push('SPM');
+        }
+        if (projectInfo.hasPodfile) {
+          types.push('CocoaPods');
+        }
+        if (projectInfo.hasXcodeproj) {
+          types.push('Xcode Project');
+        }
+        if (types.length > 0) {
+          parts.push(`构建系统: ${types.join(' + ')}`);
+        }
         parts.push('');
 
         // 模块结构
@@ -621,8 +714,12 @@ export class WikiGenerator {
           for (const t of spmInfo.targets) {
             const files = this._getModuleSourceFiles(t, projectInfo);
             const cls = astInfo.classNamesByModule?.[t.name]?.length || 0;
-            const deps = (t.dependencies || t.info?.dependencies || []).map(d => typeof d === 'string' ? d : d.name);
-            parts.push(`- ${t.name} (${t.type || 'target'}): ${files.length} 文件, ${cls} 个类型${deps.length > 0 ? `, 依赖: ${deps.join(', ')}` : ''}`);
+            const deps = (t.dependencies || t.info?.dependencies || []).map((d) =>
+              typeof d === 'string' ? d : d.name
+            );
+            parts.push(
+              `- ${t.name} (${t.type || 'target'}): ${files.length} 文件, ${cls} 个类型${deps.length > 0 ? `, 依赖: ${deps.join(', ')}` : ''}`
+            );
           }
           parts.push('');
         }
@@ -630,12 +727,14 @@ export class WikiGenerator {
         // AST 概况
         if (astInfo.overview) {
           parts.push('### 代码规模');
-          parts.push(`类/结构体: ${astInfo.overview.totalClasses || 0}, 协议: ${astInfo.overview.totalProtocols || 0}, 方法: ${astInfo.overview.totalMethods || 0}`);
+          parts.push(
+            `类/结构体: ${astInfo.overview.totalClasses || 0}, 协议: ${astInfo.overview.totalProtocols || 0}, 方法: ${astInfo.overview.totalMethods || 0}`
+          );
           parts.push('');
         }
 
         // 可用的其他文档（用于导航链接）
-        const otherTopics = (topic._allTopics || []).filter(t => t.type !== 'overview');
+        const otherTopics = (topic._allTopics || []).filter((t) => t.type !== 'overview');
         if (otherTopics.length > 0) {
           parts.push('### 需要包含的导航链接');
           for (const t of otherTopics) {
@@ -645,7 +744,9 @@ export class WikiGenerator {
         }
 
         parts.push('要求: 撰写完整的项目概述文档。');
-        parts.push('包含: 项目简介(解释项目做什么)、模块总览(表格形式)、技术栈分析、核心数据指标、文档导航索引。');
+        parts.push(
+          '包含: 项目简介(解释项目做什么)、模块总览(表格形式)、技术栈分析、核心数据指标、文档导航索引。'
+        );
         parts.push('不要只列数据 — 要解释项目的定位、各模块的职责和协作关系。');
         break;
       }
@@ -657,8 +758,12 @@ export class WikiGenerator {
         if (spmInfo.targets.length > 0) {
           parts.push('### 模块及依赖关系');
           for (const t of spmInfo.targets) {
-            const deps = (t.dependencies || t.info?.dependencies || []).map(d => typeof d === 'string' ? d : d.name);
-            parts.push(`- ${t.name} (${t.type || 'target'})${deps.length > 0 ? ` → 依赖: ${deps.join(', ')}` : ''}`);
+            const deps = (t.dependencies || t.info?.dependencies || []).map((d) =>
+              typeof d === 'string' ? d : d.name
+            );
+            parts.push(
+              `- ${t.name} (${t.type || 'target'})${deps.length > 0 ? ` → 依赖: ${deps.join(', ')}` : ''}`
+            );
           }
           parts.push('');
         }
@@ -687,7 +792,9 @@ export class WikiGenerator {
         }
 
         parts.push('要求: 撰写架构分析文档。');
-        parts.push('包含: 模块依赖图(使用 Mermaid graph TD 语法)、分层架构分析(解释每层的职责)、模块间协作关系、架构设计决策阐述。');
+        parts.push(
+          '包含: 模块依赖图(使用 Mermaid graph TD 语法)、分层架构分析(解释每层的职责)、模块间协作关系、架构设计决策阐述。'
+        );
         parts.push('用 Mermaid 绘制依赖关系图和继承层次图。分析为什么采用这种架构。');
         break;
       }
@@ -705,15 +812,21 @@ export class WikiGenerator {
         parts.push('### 模块基本信息');
         parts.push(`- 类型: ${target.type || 'target'}`);
         const tPath = target.path || target.info?.path;
-        if (tPath) parts.push(`- 路径: ${tPath}`);
-        if (target.packageName) parts.push(`- 所属包: ${target.packageName}`);
+        if (tPath) {
+          parts.push(`- 路径: ${tPath}`);
+        }
+        if (target.packageName) {
+          parts.push(`- 所属包: ${target.packageName}`);
+        }
         parts.push(`- 源文件: ${moduleFiles.length} 个`);
         parts.push(`- 类/结构体: ${moduleClasses.length} 个`);
         parts.push(`- 协议: ${moduleProtocols.length} 个`);
         parts.push('');
 
         if (deps.length > 0) {
-          parts.push(`### 依赖: ${deps.map(d => typeof d === 'string' ? d : d.name).join(', ')}`);
+          parts.push(
+            `### 依赖: ${deps.map((d) => (typeof d === 'string' ? d : d.name)).join(', ')}`
+          );
           parts.push('');
         }
 
@@ -729,28 +842,36 @@ export class WikiGenerator {
 
         // 关键源文件名（帮助 AI 推断模块功能）
         if (moduleFiles.length > 0) {
-          const keyFiles = moduleFiles.slice(0, 25).map(f => path.basename(f));
+          const keyFiles = moduleFiles.slice(0, 25).map((f) => path.basename(f));
           parts.push(`### 关键源文件: ${keyFiles.join(', ')}`);
           parts.push('');
         }
 
         // 相关 recipes
-        const related = knowledgeInfo.recipes.filter(r => {
+        const related = knowledgeInfo.recipes.filter((r) => {
           const json = r.toJSON ? r.toJSON() : r;
-          return json.moduleName === target.name || json.tags?.includes(target.name) || json.title?.includes(target.name);
+          return (
+            json.moduleName === target.name ||
+            json.tags?.includes(target.name) ||
+            json.title?.includes(target.name)
+          );
         });
         if (related.length > 0) {
           parts.push(`### 相关知识条目 (${related.length})`);
           for (const r of related.slice(0, 10)) {
             const json = r.toJSON ? r.toJSON() : r;
             parts.push(`- ${json.title}: ${json.description || ''}`);
-            if (json.reasoning?.whyStandard) parts.push(`  为什么: ${json.reasoning.whyStandard}`);
+            if (json.reasoning?.whyStandard) {
+              parts.push(`  为什么: ${json.reasoning.whyStandard}`);
+            }
           }
           parts.push('');
         }
 
         parts.push('要求: 撰写模块深度分析文档。');
-        parts.push('包含: 模块职责说明(从文件名和类名推断功能意图)、核心类型分析(不是简单罗列而是解释每个类的角色)、依赖关系分析、设计模式识别。');
+        parts.push(
+          '包含: 模块职责说明(从文件名和类名推断功能意图)、核心类型分析(不是简单罗列而是解释每个类的角色)、依赖关系分析、设计模式识别。'
+        );
         parts.push('如果能推断出数据流或协作关系，请用 Mermaid 图表展示。');
         break;
       }
@@ -759,16 +880,26 @@ export class WikiGenerator {
         parts.push('## 任务: 撰写快速上手指南');
         parts.push('');
 
-        if (projectInfo.hasPackageSwift) parts.push('构建系统: Swift Package Manager');
-        if (projectInfo.hasPodfile) parts.push('构建系统: CocoaPods');
-        if (projectInfo.hasXcodeproj) parts.push('构建系统: Xcode Project');
+        if (projectInfo.hasPackageSwift) {
+          parts.push('构建系统: Swift Package Manager');
+        }
+        if (projectInfo.hasPodfile) {
+          parts.push('构建系统: CocoaPods');
+        }
+        if (projectInfo.hasXcodeproj) {
+          parts.push('构建系统: Xcode Project');
+        }
         parts.push('');
 
         if (spmInfo.targets.length > 0) {
-          const mainTargets = spmInfo.targets.filter(t => t.type !== 'test');
-          const testTargets = spmInfo.targets.filter(t => t.type === 'test');
-          if (mainTargets.length > 0) parts.push(`主要 Target: ${mainTargets.map(t => t.name).join(', ')}`);
-          if (testTargets.length > 0) parts.push(`测试 Target: ${testTargets.map(t => t.name).join(', ')}`);
+          const mainTargets = spmInfo.targets.filter((t) => t.type !== 'test');
+          const testTargets = spmInfo.targets.filter((t) => t.type === 'test');
+          if (mainTargets.length > 0) {
+            parts.push(`主要 Target: ${mainTargets.map((t) => t.name).join(', ')}`);
+          }
+          if (testTargets.length > 0) {
+            parts.push(`测试 Target: ${testTargets.map((t) => t.name).join(', ')}`);
+          }
           parts.push('');
         }
 
@@ -778,7 +909,9 @@ export class WikiGenerator {
         }
 
         parts.push('要求: 撰写开发者快速上手指南。');
-        parts.push('包含: 环境要求、项目获取、依赖安装、构建步骤(具体命令)、运行测试、项目目录结构说明。');
+        parts.push(
+          '包含: 环境要求、项目获取、依赖安装、构建步骤(具体命令)、运行测试、项目目录结构说明。'
+        );
         parts.push('语句清晰，步骤明确，适合新人阅读。');
         break;
       }
@@ -791,7 +924,9 @@ export class WikiGenerator {
         for (const r of knowledgeInfo.recipes) {
           const json = r.toJSON ? r.toJSON() : r;
           const cat = json.category || 'Other';
-          if (!groups[cat]) groups[cat] = [];
+          if (!groups[cat]) {
+            groups[cat] = [];
+          }
           groups[cat].push(json);
         }
 
@@ -799,15 +934,23 @@ export class WikiGenerator {
           parts.push(`### ${cat} (${items.length} 条)`);
           for (const item of items.slice(0, 8)) {
             parts.push(`- ${item.title}: ${item.description || 'N/A'}`);
-            if (item.doClause) parts.push(`  应当: ${item.doClause}`);
-            if (item.dontClause) parts.push(`  避免: ${item.dontClause}`);
-            if (item.content?.pattern) parts.push(`  代码片段: ${item.content.pattern.slice(0, 200)}`);
+            if (item.doClause) {
+              parts.push(`  应当: ${item.doClause}`);
+            }
+            if (item.dontClause) {
+              parts.push(`  避免: ${item.dontClause}`);
+            }
+            if (item.content?.pattern) {
+              parts.push(`  代码片段: ${item.content.pattern.slice(0, 200)}`);
+            }
           }
           parts.push('');
         }
 
         parts.push('要求: 撰写代码模式文档。对每个分类进行总结分析，解释模式的意义和应用场景。');
-        parts.push('不要只列出条目 — 为每个分类写一段总结，解释该类模式的整体意图。附带代码示例(从数据中取)。');
+        parts.push(
+          '不要只列出条目 — 为每个分类写一段总结，解释该类模式的整体意图。附带代码示例(从数据中取)。'
+        );
         break;
       }
 
@@ -818,10 +961,18 @@ export class WikiGenerator {
 
         for (const item of pd.recipes) {
           parts.push(`### ${item.title}`);
-          if (item.description) parts.push(`描述: ${item.description}`);
-          if (item.doClause) parts.push(`应当: ${item.doClause}`);
-          if (item.dontClause) parts.push(`避免: ${item.dontClause}`);
-          if (item.reasoning?.whyStandard) parts.push(`原因: ${item.reasoning.whyStandard}`);
+          if (item.description) {
+            parts.push(`描述: ${item.description}`);
+          }
+          if (item.doClause) {
+            parts.push(`应当: ${item.doClause}`);
+          }
+          if (item.dontClause) {
+            parts.push(`避免: ${item.dontClause}`);
+          }
+          if (item.reasoning?.whyStandard) {
+            parts.push(`原因: ${item.reasoning.whyStandard}`);
+          }
           if (item.content?.pattern) {
             parts.push('代码:');
             parts.push('```');
@@ -832,7 +983,9 @@ export class WikiGenerator {
         }
 
         parts.push('要求: 撰写该分类的详细代码模式文档。');
-        parts.push('先写一段总结性概述，然后对每个模式做分析，解释为什么要遵循，给出正确和错误的对比示例。');
+        parts.push(
+          '先写一段总结性概述，然后对每个模式做分析，解释为什么要遵循，给出正确和错误的对比示例。'
+        );
         break;
       }
 
@@ -847,9 +1000,13 @@ export class WikiGenerator {
           }
         }
         parts.push('');
-        parts.push(`总计: ${astInfo.protocols.length} 个协议, ${astInfo.classes.length} 个类/结构体`);
+        parts.push(
+          `总计: ${astInfo.protocols.length} 个协议, ${astInfo.classes.length} 个类/结构体`
+        );
         parts.push('');
-        parts.push('要求: 撰写协议参考文档。按模块分组，分析每个协议的用途和意义，描述协议之间的关系和设计意图。');
+        parts.push(
+          '要求: 撰写协议参考文档。按模块分组，分析每个协议的用途和意义，描述协议之间的关系和设计意图。'
+        );
         break;
       }
     }
@@ -866,13 +1023,26 @@ export class WikiGenerator {
 
     switch (topic.type) {
       case 'overview':
-        return this._renderIndex(projectInfo, astInfo, spmInfo, knowledgeInfo, isZh, topic._allTopics);
+        return this._renderIndex(
+          projectInfo,
+          astInfo,
+          spmInfo,
+          knowledgeInfo,
+          isZh,
+          topic._allTopics
+        );
       case 'architecture':
         return this._renderArchitecture(projectInfo, astInfo, spmInfo, isZh);
       case 'getting-started':
         return this._renderGettingStarted(projectInfo, spmInfo, astInfo, isZh);
       case 'module':
-        return this._renderModule(topic._moduleData.target, astInfo, knowledgeInfo, isZh, projectInfo);
+        return this._renderModule(
+          topic._moduleData.target,
+          astInfo,
+          knowledgeInfo,
+          isZh,
+          projectInfo
+        );
       case 'patterns':
         return this._renderPatterns(knowledgeInfo, isZh);
       case 'pattern-category':
@@ -902,37 +1072,49 @@ export class WikiGenerator {
     lines.push('');
 
     const types = [];
-    if (project.hasPackageSwift) types.push('SPM (Swift Package Manager)');
-    if (project.hasPodfile)      types.push('CocoaPods');
-    if (project.hasXcodeproj)    types.push('Xcode Project');
+    if (project.hasPackageSwift) {
+      types.push('SPM (Swift Package Manager)');
+    }
+    if (project.hasPodfile) {
+      types.push('CocoaPods');
+    }
+    if (project.hasXcodeproj) {
+      types.push('Xcode Project');
+    }
 
     const overview = ast.overview || {};
-    const mainTargets = spm.targets.filter(t => t.type !== 'test');
-    const testTargets = spm.targets.filter(t => t.type === 'test');
+    const mainTargets = spm.targets.filter((t) => t.type !== 'test');
+    const testTargets = spm.targets.filter((t) => t.type === 'test');
 
     if (isZh) {
-      lines.push(`**${project.name}** 是一个 ${types.join(' + ') || 'iOS'} 项目，`
-        + `包含 ${project.sourceFiles.length} 个源文件`
-        + (overview.totalClasses ? `、${overview.totalClasses} 个类/结构体` : '')
-        + (overview.totalProtocols ? `、${overview.totalProtocols} 个协议` : '')
-        + `。`
+      lines.push(
+        `**${project.name}** 是一个 ${types.join(' + ') || 'iOS'} 项目，` +
+          `包含 ${project.sourceFiles.length} 个源文件` +
+          (overview.totalClasses ? `、${overview.totalClasses} 个类/结构体` : '') +
+          (overview.totalProtocols ? `、${overview.totalProtocols} 个协议` : '') +
+          `。`
       );
       if (mainTargets.length > 0) {
-        lines.push(`项目由 ${mainTargets.length} 个功能模块组成`
-          + (testTargets.length > 0 ? `，配备 ${testTargets.length} 个测试模块` : '')
-          + `。`);
+        lines.push(
+          `项目由 ${mainTargets.length} 个功能模块组成` +
+            (testTargets.length > 0 ? `，配备 ${testTargets.length} 个测试模块` : '') +
+            `。`
+        );
       }
     } else {
-      lines.push(`**${project.name}** is a ${types.join(' + ') || 'iOS'} project `
-        + `containing ${project.sourceFiles.length} source files`
-        + (overview.totalClasses ? `, ${overview.totalClasses} classes/structs` : '')
-        + (overview.totalProtocols ? `, ${overview.totalProtocols} protocols` : '')
-        + `.`
+      lines.push(
+        `**${project.name}** is a ${types.join(' + ') || 'iOS'} project ` +
+          `containing ${project.sourceFiles.length} source files` +
+          (overview.totalClasses ? `, ${overview.totalClasses} classes/structs` : '') +
+          (overview.totalProtocols ? `, ${overview.totalProtocols} protocols` : '') +
+          `.`
       );
       if (mainTargets.length > 0) {
-        lines.push(`The project consists of ${mainTargets.length} functional modules`
-          + (testTargets.length > 0 ? ` with ${testTargets.length} test modules` : '')
-          + `.`);
+        lines.push(
+          `The project consists of ${mainTargets.length} functional modules` +
+            (testTargets.length > 0 ? ` with ${testTargets.length} test modules` : '') +
+            `.`
+        );
       }
     }
     lines.push('');
@@ -941,15 +1123,21 @@ export class WikiGenerator {
     if (spm.targets.length > 0) {
       lines.push(`## ${isZh ? '模块总览' : 'Module Overview'}`);
       lines.push('');
-      lines.push(`| ${isZh ? '模块' : 'Module'} | ${isZh ? '类型' : 'Type'} | ${isZh ? '源文件' : 'Files'} | ${isZh ? '类数' : 'Classes'} | ${isZh ? '协议数' : 'Protocols'} |`);
+      lines.push(
+        `| ${isZh ? '模块' : 'Module'} | ${isZh ? '类型' : 'Type'} | ${isZh ? '源文件' : 'Files'} | ${isZh ? '类数' : 'Classes'} | ${isZh ? '协议数' : 'Protocols'} |`
+      );
       lines.push('|--------|------|--------|--------|----------|');
       for (const t of spm.targets) {
         const moduleFiles = this._getModuleSourceFiles(t, project);
         const classCount = ast.classNamesByModule?.[t.name]?.length || 0;
         const protoCount = ast.protocolNamesByModule?.[t.name]?.length || 0;
-        const hasDoc = allTopics?.some(tp => tp.type === 'module' && tp._moduleData?.target.name === t.name);
+        const hasDoc = allTopics?.some(
+          (tp) => tp.type === 'module' && tp._moduleData?.target.name === t.name
+        );
         const nameCol = hasDoc ? `[${t.name}](modules/${_slug(t.name)}.md)` : t.name;
-        lines.push(`| ${nameCol} | ${t.type || 'target'} | ${moduleFiles.length || '-'} | ${classCount || '-'} | ${protoCount || '-'} |`);
+        lines.push(
+          `| ${nameCol} | ${t.type || 'target'} | ${moduleFiles.length || '-'} | ${classCount || '-'} | ${protoCount || '-'} |`
+        );
       }
       lines.push('');
     }
@@ -958,7 +1146,9 @@ export class WikiGenerator {
     lines.push(`## ${isZh ? '技术栈' : 'Tech Stack'}`);
     lines.push('');
     if (project.languages && Object.keys(project.languages).length > 0) {
-      lines.push(`| ${isZh ? '语言' : 'Language'} | ${isZh ? '文件数' : 'Files'} | ${isZh ? '占比' : 'Share'} |`);
+      lines.push(
+        `| ${isZh ? '语言' : 'Language'} | ${isZh ? '文件数' : 'Files'} | ${isZh ? '占比' : 'Share'} |`
+      );
       lines.push('|--------|-------|------|');
       const total = Object.values(project.languages).reduce((a, b) => a + b, 0);
       for (const [lang, count] of Object.entries(project.languages).sort((a, b) => b[1] - a[1])) {
@@ -974,15 +1164,25 @@ export class WikiGenerator {
     lines.push(`| ${isZh ? '指标' : 'Metric'} | ${isZh ? '数量' : 'Count'} |`);
     lines.push('|--------|-------|');
     lines.push(`| ${isZh ? '源文件数' : 'Source Files'} | ${project.sourceFiles.length} |`);
-    if (overview.totalClasses)   lines.push(`| ${isZh ? '类/结构体' : 'Classes/Structs'} | ${overview.totalClasses} |`);
-    if (overview.totalProtocols) lines.push(`| ${isZh ? '协议' : 'Protocols'} | ${overview.totalProtocols} |`);
-    if (overview.totalMethods)   lines.push(`| ${isZh ? '方法总数' : 'Methods'} | ${overview.totalMethods} |`);
-    if (spm.targets.length > 0)  lines.push(`| SPM Targets | ${spm.targets.length} |`);
-    if (knowledge.recipes.length > 0) lines.push(`| ${isZh ? '知识库条目' : 'KB Recipes'} | ${knowledge.recipes.length} |`);
+    if (overview.totalClasses) {
+      lines.push(`| ${isZh ? '类/结构体' : 'Classes/Structs'} | ${overview.totalClasses} |`);
+    }
+    if (overview.totalProtocols) {
+      lines.push(`| ${isZh ? '协议' : 'Protocols'} | ${overview.totalProtocols} |`);
+    }
+    if (overview.totalMethods) {
+      lines.push(`| ${isZh ? '方法总数' : 'Methods'} | ${overview.totalMethods} |`);
+    }
+    if (spm.targets.length > 0) {
+      lines.push(`| SPM Targets | ${spm.targets.length} |`);
+    }
+    if (knowledge.recipes.length > 0) {
+      lines.push(`| ${isZh ? '知识库条目' : 'KB Recipes'} | ${knowledge.recipes.length} |`);
+    }
     lines.push('');
 
     // ── 文档导航 (动态，基于实际生成的主题) ──
-    const navTopics = (allTopics || []).filter(t => t.type !== 'overview');
+    const navTopics = (allTopics || []).filter((t) => t.type !== 'overview');
     if (navTopics.length > 0) {
       lines.push('---');
       lines.push('');
@@ -1017,7 +1217,10 @@ export class WikiGenerator {
       for (const target of spm.targets) {
         const sid = _mermaidId(target.name);
         if (!rendered.has(sid)) {
-          const shape = target.type === 'test' ? `${sid}[["${target.name} (Test)"]]` : `${sid}["${target.name}"]`;
+          const shape =
+            target.type === 'test'
+              ? `${sid}[["${target.name} (Test)"]]`
+              : `${sid}["${target.name}"]`;
           lines.push(`    ${shape}`);
           rendered.add(sid);
         }
@@ -1083,7 +1286,9 @@ export class WikiGenerator {
           lines.push('```');
           lines.push('');
         }
-      } catch { /* non-critical */ }
+      } catch {
+        /* non-critical */
+      }
     }
 
     lines.push(`[← ${isZh ? '返回概述' : 'Back to Overview'}](index.md)`);
@@ -1110,16 +1315,23 @@ export class WikiGenerator {
     lines.push('');
 
     // 推断模块功能 (基于名称和内容)
-    const purpose = this._inferModulePurpose(target.name, moduleClasses, moduleProtocols, moduleFiles);
+    const purpose = this._inferModulePurpose(
+      target.name,
+      moduleClasses,
+      moduleProtocols,
+      moduleFiles
+    );
     if (purpose) {
-      lines.push(isZh
-        ? `**${target.name}** ${purpose.zh}，包含 ${moduleFiles.length} 个源文件、${moduleClasses.length} 个类/结构体${moduleProtocols.length > 0 ? `、${moduleProtocols.length} 个协议` : ''}。`
-        : `**${target.name}** ${purpose.en}, containing ${moduleFiles.length} source files, ${moduleClasses.length} classes/structs${moduleProtocols.length > 0 ? `, ${moduleProtocols.length} protocols` : ''}.`
+      lines.push(
+        isZh
+          ? `**${target.name}** ${purpose.zh}，包含 ${moduleFiles.length} 个源文件、${moduleClasses.length} 个类/结构体${moduleProtocols.length > 0 ? `、${moduleProtocols.length} 个协议` : ''}。`
+          : `**${target.name}** ${purpose.en}, containing ${moduleFiles.length} source files, ${moduleClasses.length} classes/structs${moduleProtocols.length > 0 ? `, ${moduleProtocols.length} protocols` : ''}.`
       );
     } else {
-      lines.push(isZh
-        ? `**${target.name}** 是项目中的一个 ${target.type || 'target'} 模块，包含 ${moduleFiles.length} 个源文件、${moduleClasses.length} 个类/结构体。`
-        : `**${target.name}** is a ${target.type || 'target'} module in the project, containing ${moduleFiles.length} source files and ${moduleClasses.length} classes/structs.`
+      lines.push(
+        isZh
+          ? `**${target.name}** 是项目中的一个 ${target.type || 'target'} 模块，包含 ${moduleFiles.length} 个源文件、${moduleClasses.length} 个类/结构体。`
+          : `**${target.name}** is a ${target.type || 'target'} module in the project, containing ${moduleFiles.length} source files and ${moduleClasses.length} classes/structs.`
       );
     }
     lines.push('');
@@ -1128,21 +1340,34 @@ export class WikiGenerator {
     lines.push(`| ${isZh ? '属性' : 'Property'} | ${isZh ? '值' : 'Value'} |`);
     lines.push('|--------|------|');
     lines.push(`| ${isZh ? '类型' : 'Type'} | ${target.type || 'target'} |`);
-    if (target.packageName)               lines.push(`| ${isZh ? '所属包' : 'Package'} | ${target.packageName} |`);
-    if (target.path || target.info?.path) lines.push(`| ${isZh ? '路径' : 'Path'} | \`${target.path || target.info.path}\` |`);
-    if (moduleFiles.length > 0)           lines.push(`| ${isZh ? '源文件数' : 'Source Files'} | ${moduleFiles.length} |`);
-    if (moduleClasses.length > 0)         lines.push(`| ${isZh ? '类/结构体' : 'Classes/Structs'} | ${moduleClasses.length} |`);
-    if (moduleProtocols.length > 0)       lines.push(`| ${isZh ? '协议' : 'Protocols'} | ${moduleProtocols.length} |`);
-    if (deps.length > 0)                  lines.push(`| ${isZh ? '依赖数' : 'Dependencies'} | ${deps.length} |`);
+    if (target.packageName) {
+      lines.push(`| ${isZh ? '所属包' : 'Package'} | ${target.packageName} |`);
+    }
+    if (target.path || target.info?.path) {
+      lines.push(`| ${isZh ? '路径' : 'Path'} | \`${target.path || target.info.path}\` |`);
+    }
+    if (moduleFiles.length > 0) {
+      lines.push(`| ${isZh ? '源文件数' : 'Source Files'} | ${moduleFiles.length} |`);
+    }
+    if (moduleClasses.length > 0) {
+      lines.push(`| ${isZh ? '类/结构体' : 'Classes/Structs'} | ${moduleClasses.length} |`);
+    }
+    if (moduleProtocols.length > 0) {
+      lines.push(`| ${isZh ? '协议' : 'Protocols'} | ${moduleProtocols.length} |`);
+    }
+    if (deps.length > 0) {
+      lines.push(`| ${isZh ? '依赖数' : 'Dependencies'} | ${deps.length} |`);
+    }
     lines.push('');
 
     // ── 依赖 ──
     if (deps.length > 0) {
       lines.push(`## ${isZh ? '依赖关系' : 'Dependencies'}`);
       lines.push('');
-      lines.push(isZh
-        ? `${target.name} 依赖以下 ${deps.length} 个模块:`
-        : `${target.name} depends on ${deps.length} module(s):`
+      lines.push(
+        isZh
+          ? `${target.name} 依赖以下 ${deps.length} 个模块:`
+          : `${target.name} depends on ${deps.length} module(s):`
       );
       lines.push('');
       for (const dep of deps) {
@@ -1160,9 +1385,10 @@ export class WikiGenerator {
       if (moduleProtocols.length > 0) {
         lines.push(`### ${isZh ? '协议' : 'Protocols'} (${moduleProtocols.length})`);
         lines.push('');
-        lines.push(isZh
-          ? `${target.name} 定义了 ${moduleProtocols.length} 个协议，用于规范模块的接口边界:`
-          : `${target.name} defines ${moduleProtocols.length} protocols establishing the module's interface contracts:`
+        lines.push(
+          isZh
+            ? `${target.name} 定义了 ${moduleProtocols.length} 个协议，用于规范模块的接口边界:`
+            : `${target.name} defines ${moduleProtocols.length} protocols establishing the module's interface contracts:`
         );
         lines.push('');
         const sorted = [...moduleProtocols].sort();
@@ -1170,7 +1396,9 @@ export class WikiGenerator {
           lines.push(`- \`${p}\``);
         }
         if (sorted.length > 20) {
-          lines.push(`- ... ${isZh ? `还有 ${sorted.length - 20} 个` : `and ${sorted.length - 20} more`}`);
+          lines.push(
+            `- ... ${isZh ? `还有 ${sorted.length - 20} 个` : `and ${sorted.length - 20} more`}`
+          );
         }
         lines.push('');
       }
@@ -1183,7 +1411,9 @@ export class WikiGenerator {
           lines.push(`- \`${c}\``);
         }
         if (sorted.length > 30) {
-          lines.push(`- ... ${isZh ? `还有 ${sorted.length - 30} 个` : `and ${sorted.length - 30} more`}`);
+          lines.push(
+            `- ... ${isZh ? `还有 ${sorted.length - 30} 个` : `and ${sorted.length - 30} more`}`
+          );
         }
         lines.push('');
       }
@@ -1198,7 +1428,7 @@ export class WikiGenerator {
       const langCount = {};
       for (const f of moduleFiles) {
         const ext = path.extname(f);
-        const lang = { '.swift': 'Swift', '.m': 'ObjC', '.h': 'Header', '.mm': 'ObjC++' }[ext] || ext;
+        const lang = LanguageService.displayNameFromExt(ext);
         langCount[lang] = (langCount[lang] || 0) + 1;
       }
 
@@ -1212,27 +1442,36 @@ export class WikiGenerator {
 
     // ── 该模块相关的 Recipes ──
     if (knowledge.recipes.length > 0) {
-      const related = knowledge.recipes.filter(r => {
+      const related = knowledge.recipes.filter((r) => {
         const json = r.toJSON ? r.toJSON() : r;
-        return json.moduleName === target.name ||
-               json.tags?.includes(target.name) ||
-               json.title?.includes(target.name);
+        return (
+          json.moduleName === target.name ||
+          json.tags?.includes(target.name) ||
+          json.title?.includes(target.name)
+        );
       });
       if (related.length > 0) {
         lines.push(`## ${isZh ? '相关知识条目' : 'Related Recipes'}`);
         lines.push('');
-        lines.push(isZh
-          ? `团队知识库中有 ${related.length} 条与 ${target.name} 相关的条目:`
-          : `The team knowledge base contains ${related.length} entries related to ${target.name}:`
+        lines.push(
+          isZh
+            ? `团队知识库中有 ${related.length} 条与 ${target.name} 相关的条目:`
+            : `The team knowledge base contains ${related.length} entries related to ${target.name}:`
         );
         lines.push('');
         for (const r of related) {
           const json = r.toJSON ? r.toJSON() : r;
           lines.push(`### ${json.title}`);
           lines.push('');
-          if (json.description) lines.push(json.description);
-          if (json.doClause) lines.push(`\n**${isZh ? '✅ 应当' : '✅ Do'}**: ${json.doClause}`);
-          if (json.dontClause) lines.push(`**${isZh ? '❌ 避免' : "❌ Don't"}**: ${json.dontClause}`);
+          if (json.description) {
+            lines.push(json.description);
+          }
+          if (json.doClause) {
+            lines.push(`\n**${isZh ? '✅ 应当' : '✅ Do'}**: ${json.doClause}`);
+          }
+          if (json.dontClause) {
+            lines.push(`**${isZh ? '❌ 避免' : "❌ Don't"}**: ${json.dontClause}`);
+          }
           lines.push('');
         }
       }
@@ -1249,33 +1488,81 @@ export class WikiGenerator {
    */
   _inferModulePurpose(name, classes, protocols, files) {
     const lower = name.toLowerCase();
-    const fileNames = files.map(f => path.basename(f).toLowerCase());
+    const _fileNames = files.map((f) => path.basename(f).toLowerCase());
 
     // 常见模块功能推断规则
     const rules = [
-      { match: /network|http|api|client|request|fetch/i, zh: '负责网络通信和 API 调用', en: 'handles network communication and API calls' },
-      { match: /ui|view|component|widget|screen|page/i, zh: '提供用户界面组件', en: 'provides user interface components' },
-      { match: /model|entity|domain|data/i, zh: '定义数据模型和领域实体', en: 'defines data models and domain entities' },
-      { match: /storage|database|cache|persist|core\s*data|realm/i, zh: '负责数据持久化和存储', en: 'manages data persistence and storage' },
-      { match: /auth|login|session|token|credential/i, zh: '处理认证授权和会话管理', en: 'handles authentication and session management' },
-      { match: /util|helper|extension|common|shared|foundation/i, zh: '提供公共工具类和扩展方法', en: 'provides common utilities and extensions' },
+      {
+        match: /network|http|api|client|request|fetch/i,
+        zh: '负责网络通信和 API 调用',
+        en: 'handles network communication and API calls',
+      },
+      {
+        match: /ui|view|component|widget|screen|page/i,
+        zh: '提供用户界面组件',
+        en: 'provides user interface components',
+      },
+      {
+        match: /model|entity|domain|data/i,
+        zh: '定义数据模型和领域实体',
+        en: 'defines data models and domain entities',
+      },
+      {
+        match: /storage|database|cache|persist|core\s*data|realm/i,
+        zh: '负责数据持久化和存储',
+        en: 'manages data persistence and storage',
+      },
+      {
+        match: /auth|login|session|token|credential/i,
+        zh: '处理认证授权和会话管理',
+        en: 'handles authentication and session management',
+      },
+      {
+        match: /util|helper|extension|common|shared|foundation/i,
+        zh: '提供公共工具类和扩展方法',
+        en: 'provides common utilities and extensions',
+      },
       { match: /test|spec|mock/i, zh: '包含单元测试和 Mock', en: 'contains unit tests and mocks' },
-      { match: /router|navigation|coordinator|flow/i, zh: '管理页面路由和导航流', en: 'manages page routing and navigation flow' },
-      { match: /config|setting|preference|env/i, zh: '管理应用配置和环境设置', en: 'manages app configuration and environment settings' },
-      { match: /log|analytics|track|monitor/i, zh: '提供日志记录和数据分析能力', en: 'provides logging and analytics capabilities' },
-      { match: /media|image|video|audio|player/i, zh: '处理多媒体资源', en: 'handles multimedia resources' },
-      { match: /service|manager|provider/i, zh: '提供核心业务服务', en: 'provides core business services' },
+      {
+        match: /router|navigation|coordinator|flow/i,
+        zh: '管理页面路由和导航流',
+        en: 'manages page routing and navigation flow',
+      },
+      {
+        match: /config|setting|preference|env/i,
+        zh: '管理应用配置和环境设置',
+        en: 'manages app configuration and environment settings',
+      },
+      {
+        match: /log|analytics|track|monitor/i,
+        zh: '提供日志记录和数据分析能力',
+        en: 'provides logging and analytics capabilities',
+      },
+      {
+        match: /media|image|video|audio|player/i,
+        zh: '处理多媒体资源',
+        en: 'handles multimedia resources',
+      },
+      {
+        match: /service|manager|provider/i,
+        zh: '提供核心业务服务',
+        en: 'provides core business services',
+      },
     ];
 
     // 先按模块名匹配
     for (const rule of rules) {
-      if (rule.match.test(lower)) return rule;
+      if (rule.match.test(lower)) {
+        return rule;
+      }
     }
 
     // 再按类名匹配
     const classStr = classes.join(' ');
     for (const rule of rules) {
-      if (rule.match.test(classStr)) return rule;
+      if (rule.match.test(classStr)) {
+        return rule;
+      }
     }
 
     return null;
@@ -1296,16 +1583,19 @@ export class WikiGenerator {
     for (const r of knowledge.recipes) {
       const json = r.toJSON ? r.toJSON() : r;
       const cat = json.category || 'Other';
-      if (!groups[cat]) groups[cat] = [];
+      if (!groups[cat]) {
+        groups[cat] = [];
+      }
       groups[cat].push(json);
     }
 
     // 总结
     const totalRecipes = knowledge.recipes.length;
     const catCount = Object.keys(groups).length;
-    lines.push(isZh
-      ? `本项目团队在 ${catCount} 个分类下共沉淀了 **${totalRecipes}** 条代码模式和最佳实践。以下按分类进行展示和分析。`
-      : `The team has accumulated **${totalRecipes}** code patterns across ${catCount} categories. Below they are organized and analyzed by category.`
+    lines.push(
+      isZh
+        ? `本项目团队在 ${catCount} 个分类下共沉淀了 **${totalRecipes}** 条代码模式和最佳实践。以下按分类进行展示和分析。`
+        : `The team has accumulated **${totalRecipes}** code patterns across ${catCount} categories. Below they are organized and analyzed by category.`
     );
     lines.push('');
 
@@ -1314,9 +1604,10 @@ export class WikiGenerator {
       lines.push('');
 
       // 分类概述
-      lines.push(isZh
-        ? `${cat} 分类包含 ${items.length} 条规则，覆盖了该领域的核心规范。`
-        : `The ${cat} category contains ${items.length} rules covering core conventions in this area.`
+      lines.push(
+        isZh
+          ? `${cat} 分类包含 ${items.length} 条规则，覆盖了该领域的核心规范。`
+          : `The ${cat} category contains ${items.length} rules covering core conventions in this area.`
       );
       lines.push('');
 
@@ -1328,7 +1619,7 @@ export class WikiGenerator {
           lines.push('');
         }
         if (item.content?.pattern) {
-          lines.push('```' + (item.language || 'swift'));
+          lines.push(`\`\`\`${item.language || 'swift'}`);
           lines.push(item.content.pattern);
           lines.push('```');
           lines.push('');
@@ -1387,12 +1678,13 @@ export class WikiGenerator {
     lines.push('```');
     lines.push(`${project.name}/`);
     if (spm.targets.length > 0) {
-      const mainTargets = spm.targets.filter(t => t.type !== 'test');
-      const testTargets = spm.targets.filter(t => t.type === 'test');
+      const mainTargets = spm.targets.filter((t) => t.type !== 'test');
+      const testTargets = spm.targets.filter((t) => t.type === 'test');
       if (mainTargets.length > 0) {
         lines.push('├── Sources/');
         for (let i = 0; i < mainTargets.length; i++) {
-          const prefix = i === mainTargets.length - 1 && testTargets.length === 0 ? '│   └──' : '│   ├──';
+          const prefix =
+            i === mainTargets.length - 1 && testTargets.length === 0 ? '│   └──' : '│   ├──';
           lines.push(`${prefix} ${mainTargets[i].name}/`);
         }
       }
@@ -1404,8 +1696,12 @@ export class WikiGenerator {
         }
       }
     }
-    if (project.hasPackageSwift) lines.push('├── Package.swift');
-    if (project.hasPodfile) lines.push('├── Podfile');
+    if (project.hasPackageSwift) {
+      lines.push('├── Package.swift');
+    }
+    if (project.hasPodfile) {
+      lines.push('├── Podfile');
+    }
     lines.push('```');
     lines.push('');
 
@@ -1443,15 +1739,22 @@ export class WikiGenerator {
 
     // 模块说明
     if (spm.targets.length > 0) {
-      const mainTargets = spm.targets.filter(t => t.type !== 'test');
+      const mainTargets = spm.targets.filter((t) => t.type !== 'test');
       if (mainTargets.length > 0) {
         lines.push(`## ${isZh ? '核心模块' : 'Core Modules'}`);
         lines.push('');
-        lines.push(`| ${isZh ? '模块' : 'Module'} | ${isZh ? '类型' : 'Type'} | ${isZh ? '类型数' : 'Types'} | ${isZh ? '说明' : 'Description'} |`);
+        lines.push(
+          `| ${isZh ? '模块' : 'Module'} | ${isZh ? '类型' : 'Type'} | ${isZh ? '类型数' : 'Types'} | ${isZh ? '说明' : 'Description'} |`
+        );
         lines.push('|--------|------|--------|------|');
         for (const t of mainTargets) {
           const cls = (ast.classNamesByModule?.[t.name] || []).length;
-          const purpose = this._inferModulePurpose(t.name, ast.classNamesByModule?.[t.name] || [], ast.protocolNamesByModule?.[t.name] || [], []);
+          const purpose = this._inferModulePurpose(
+            t.name,
+            ast.classNamesByModule?.[t.name] || [],
+            ast.protocolNamesByModule?.[t.name] || [],
+            []
+          );
           const desc = purpose ? (isZh ? purpose.zh : purpose.en) : '-';
           lines.push(`| ${t.name} | ${t.type || 'library'} | ${cls} | ${desc} |`);
         }
@@ -1477,9 +1780,10 @@ export class WikiGenerator {
     ];
 
     // 分类概述
-    lines.push(isZh
-      ? `本文档收录了 ${category} 分类下的 ${recipes.length} 条代码模式和规范，这些规则由团队在开发实践中总结沉淀。`
-      : `This document covers ${recipes.length} code patterns and conventions in the ${category} category, distilled from team development practices.`
+    lines.push(
+      isZh
+        ? `本文档收录了 ${category} 分类下的 ${recipes.length} 条代码模式和规范，这些规则由团队在开发实践中总结沉淀。`
+        : `This document covers ${recipes.length} code patterns and conventions in the ${category} category, distilled from team development practices.`
     );
     lines.push('');
 
@@ -1499,7 +1803,7 @@ export class WikiGenerator {
         lines.push('');
       }
       if (item.content?.pattern) {
-        lines.push('```' + (item.language || 'swift'));
+        lines.push(`\`\`\`${item.language || 'text'}`);
         lines.push(item.content.pattern);
         lines.push('```');
         lines.push('');
@@ -1526,9 +1830,10 @@ export class WikiGenerator {
       '',
     ];
 
-    lines.push(isZh
-      ? `协议（Protocol）定义了类型需要遵循的接口契约。本项目共定义了 ${ast.protocols.length} 个协议，以下按模块分组展示。`
-      : `Protocols define interface contracts that types must conform to. This project defines ${ast.protocols.length} protocols, organized by module below.`
+    lines.push(
+      isZh
+        ? `协议（Protocol）定义了类型需要遵循的接口契约。本项目共定义了 ${ast.protocols.length} 个协议，以下按模块分组展示。`
+        : `Protocols define interface contracts that types must conform to. This project defines ${ast.protocols.length} protocols, organized by module below.`
     );
     lines.push('');
 
@@ -1537,12 +1842,15 @@ export class WikiGenerator {
     const grouped = new Set();
 
     for (const [mod, protos] of Object.entries(protoByModule).sort()) {
-      if (protos.length === 0) continue;
+      if (protos.length === 0) {
+        continue;
+      }
       lines.push(`## ${mod}`);
       lines.push('');
-      lines.push(isZh
-        ? `${mod} 模块定义了 ${protos.length} 个协议:`
-        : `${mod} module defines ${protos.length} protocols:`
+      lines.push(
+        isZh
+          ? `${mod} 模块定义了 ${protos.length} 个协议:`
+          : `${mod} module defines ${protos.length} protocols:`
       );
       lines.push('');
       for (const p of protos.sort()) {
@@ -1553,7 +1861,7 @@ export class WikiGenerator {
     }
 
     // 未分组的协议
-    const ungrouped = ast.protocols.filter(p => !grouped.has(p));
+    const ungrouped = ast.protocols.filter((p) => !grouped.has(p));
     if (ungrouped.length > 0) {
       lines.push(`## ${isZh ? '其他协议' : 'Other Protocols'}`);
       lines.push('');
@@ -1627,10 +1935,16 @@ export class WikiGenerator {
     const isZh = this.options.language === 'zh';
 
     // ── Source 1: Channel D devdocs ──
-    const devdocsDir = path.join(this.projectRoot, '.cursor', 'skills', 'autosnippet-devdocs', 'references');
+    const devdocsDir = path.join(
+      this.projectRoot,
+      '.cursor',
+      'skills',
+      'autosnippet-devdocs',
+      'references'
+    );
     if (fs.existsSync(devdocsDir)) {
       this._ensureDir(path.join(this.wikiDir, 'documents'));
-      const files = fs.readdirSync(devdocsDir).filter(f => f.endsWith('.md'));
+      const files = fs.readdirSync(devdocsDir).filter((f) => f.endsWith('.md'));
       for (const file of files) {
         try {
           const content = fs.readFileSync(path.join(devdocsDir, file), 'utf-8');
@@ -1638,7 +1952,9 @@ export class WikiGenerator {
           const result = this._writeFile(`documents/${file}`, header + content);
           result.source = 'cursor-devdocs';
           synced.push(result);
-        } catch { /* skip */ }
+        } catch {
+          /* skip */
+        }
       }
     }
 
@@ -1654,7 +1970,7 @@ export class WikiGenerator {
    * 为同步目录生成索引页
    */
   _generateSyncIndex(synced, isZh) {
-    const docFiles = synced.filter(f => f.path.startsWith('documents/'));
+    const docFiles = synced.filter((f) => f.path.startsWith('documents/'));
 
     if (docFiles.length > 0) {
       const lines = [
@@ -1697,9 +2013,15 @@ export class WikiGenerator {
         // 完全相同 hash → 移除后来的
         if (existing.hash === file.hash) {
           const fullPath = path.join(this.wikiDir, file.path);
-          try { fs.unlinkSync(fullPath); } catch { /* skip */ }
+          try {
+            fs.unlinkSync(fullPath);
+          } catch {
+            /* skip */
+          }
           removed.push(file.path);
-          logger.info(`[WikiGenerator] Dedup: removed ${file.path} (same hash as ${existing.path})`);
+          logger.info(
+            `[WikiGenerator] Dedup: removed ${file.path} (same hash as ${existing.path})`
+          );
         }
         // hash 不同 → 保留两个（不同目录允许同名）
       } else {
@@ -1710,19 +2032,28 @@ export class WikiGenerator {
     // Layer 2: content hash 碰撞（不同文件名但内容相同）
     const hashMap = new Map(); // hash → first file path
     for (const file of files) {
-      if (removed.includes(file.path)) continue;
+      if (removed.includes(file.path)) {
+        continue;
+      }
       if (hashMap.has(file.hash)) {
         const firstPath = hashMap.get(file.hash);
         // 优先保留代码生成的（非 synced）
         const isFirstSynced = firstPath.startsWith('documents/') || firstPath.startsWith('skills/');
-        const isCurrentSynced = file.path.startsWith('documents/') || file.path.startsWith('skills/');
+        const isCurrentSynced =
+          file.path.startsWith('documents/') || file.path.startsWith('skills/');
 
         if (isCurrentSynced && !isFirstSynced) {
           // 当前是 synced，first 是 codegen → 删除 synced
           const fullPath = path.join(this.wikiDir, file.path);
-          try { fs.unlinkSync(fullPath); } catch { /* skip */ }
+          try {
+            fs.unlinkSync(fullPath);
+          } catch {
+            /* skip */
+          }
           removed.push(file.path);
-          logger.info(`[WikiGenerator] Dedup: removed synced ${file.path} (same content as ${firstPath})`);
+          logger.info(
+            `[WikiGenerator] Dedup: removed synced ${file.path} (same content as ${firstPath})`
+          );
         }
         // 其他情况保留两个
       } else {
@@ -1750,16 +2081,21 @@ export class WikiGenerator {
 
   /** 从 CodeEntityGraph 提取继承根节点 */
   _getInheritanceRoots() {
-    if (!this.codeEntityGraph) return [];
+    if (!this.codeEntityGraph) {
+      return [];
+    }
     try {
       // 尝试查询继承关系
-      const entities = this.codeEntityGraph.queryEntities?.({ entityType: 'class', limit: 50 }) || [];
+      const entities =
+        this.codeEntityGraph.queryEntities?.({ entityType: 'class', limit: 50 }) || [];
       const roots = [];
       for (const e of entities) {
-        const parents = this.codeEntityGraph.queryEdges?.({ toId: e.entityId, relation: 'inherits' }) || [];
-        const children = this.codeEntityGraph.queryEdges?.({ fromId: e.entityId, relation: 'inherits' }) || [];
+        const _parents =
+          this.codeEntityGraph.queryEdges?.({ toId: e.entityId, relation: 'inherits' }) || [];
+        const children =
+          this.codeEntityGraph.queryEdges?.({ fromId: e.entityId, relation: 'inherits' }) || [];
         if (children.length > 0) {
-          roots.push({ name: e.name, children: children.map(c => c.toId || c.to_id) });
+          roots.push({ name: e.name, children: children.map((c) => c.toId || c.to_id) });
         }
       }
       return roots.sort((a, b) => (b.children?.length || 0) - (a.children?.length || 0));
@@ -1771,7 +2107,9 @@ export class WikiGenerator {
   _emit(phase, progress, message) {
     try {
       this.onProgress(phase, progress, message);
-    } catch { /* non-critical */ }
+    } catch {
+      /* non-critical */
+    }
   }
 
   _ensureDir(dir) {
@@ -1797,7 +2135,7 @@ export class WikiGenerator {
       duration: Date.now() - startTime,
       projectRoot: this.projectRoot,
       language: this.options.language,
-      files: files.map(f => ({
+      files: files.map((f) => ({
         path: f.path,
         hash: f.hash,
         size: f.size,
@@ -1813,7 +2151,9 @@ export class WikiGenerator {
 
   _readMeta() {
     try {
-      if (!fs.existsSync(this.metaPath)) return null;
+      if (!fs.existsSync(this.metaPath)) {
+        return null;
+      }
       return JSON.parse(fs.readFileSync(this.metaPath, 'utf-8'));
     } catch {
       return null;
@@ -1822,27 +2162,33 @@ export class WikiGenerator {
 
   /** 检测源码是否有变更（简化：对比 sourceHash） */
   _detectChanges(meta) {
-    if (!meta?.sourceHash) return true;
+    if (!meta?.sourceHash) {
+      return true;
+    }
     return meta.sourceHash !== this._computeSourceHash();
   }
 
   /** 计算项目源文件的简易 hash（基于文件名列表 + 总大小） */
   _computeSourceHash() {
     try {
-      const extSet = new Set(['.swift', '.m', '.h', '.mm']);
+      const extSet = LanguageService.sourceExts;
       let totalSize = 0;
       const names = [];
-      this._walkDir(this.projectRoot, (filePath) => {
-        const ext = path.extname(filePath);
-        if (extSet.has(ext)) {
-          const stat = fs.statSync(filePath);
-          totalSize += stat.size;
-          names.push(path.relative(this.projectRoot, filePath));
-        }
-      }, 2000);
+      this._walkDir(
+        this.projectRoot,
+        (filePath) => {
+          const ext = path.extname(filePath);
+          if (extSet.has(ext)) {
+            const stat = fs.statSync(filePath);
+            totalSize += stat.size;
+            names.push(path.relative(this.projectRoot, filePath));
+          }
+        },
+        2000
+      );
 
       names.sort();
-      const payload = names.join('\n') + '\n' + totalSize;
+      const payload = `${names.join('\n')}\n${totalSize}`;
       return createHash('sha256').update(payload).digest('hex').slice(0, 16);
     } catch {
       return 'unknown';
@@ -1854,20 +2200,42 @@ export class WikiGenerator {
    */
   _walkDir(dir, callback, maxFiles = 500) {
     const excludeNames = new Set([
-      'Pods', 'Carthage', 'node_modules', '.build', 'build', 'DerivedData',
-      'vendor', '.git', '__tests__', 'Tests', 'AutoSnippet', '.cursor',
+      'Pods',
+      'Carthage',
+      'node_modules',
+      '.build',
+      'build',
+      'DerivedData',
+      'vendor',
+      '.git',
+      '__tests__',
+      'Tests',
+      'AutoSnippet',
+      '.cursor',
     ]);
     let count = 0;
 
     const walk = (d) => {
-      if (count >= maxFiles) return;
+      if (count >= maxFiles) {
+        return;
+      }
       let entries;
-      try { entries = fs.readdirSync(d, { withFileTypes: true }); } catch { return; }
+      try {
+        entries = fs.readdirSync(d, { withFileTypes: true });
+      } catch {
+        return;
+      }
 
       for (const entry of entries) {
-        if (count >= maxFiles) return;
-        if (excludeNames.has(entry.name)) continue;
-        if (entry.name.startsWith('.')) continue;
+        if (count >= maxFiles) {
+          return;
+        }
+        if (excludeNames.has(entry.name)) {
+          continue;
+        }
+        if (entry.name.startsWith('.')) {
+          continue;
+        }
 
         const fullPath = path.join(d, entry.name);
         if (entry.isDirectory()) {
@@ -1909,21 +2277,27 @@ export class WikiGenerator {
     const name = target.name;
 
     // 1. 按模块名直接匹配（最常见: Sources/{name}/ 解析出的 key）
-    if (sfm[name]?.length > 0) return sfm[name];
+    if (sfm[name]?.length > 0) {
+      return sfm[name];
+    }
 
     // 2. 通过 target.path 或 target.info.path 匹配
     const targetPath = target.path || target.info?.path;
     if (targetPath) {
-      const matched = (projectInfo.sourceFiles || []).filter(f =>
-        f.startsWith(targetPath + '/') || f.startsWith(targetPath + path.sep)
+      const matched = (projectInfo.sourceFiles || []).filter(
+        (f) => f.startsWith(`${targetPath}/`) || f.startsWith(targetPath + path.sep)
       );
-      if (matched.length > 0) return matched;
+      if (matched.length > 0) {
+        return matched;
+      }
     }
 
     // 3. 大小写不敏感模糊匹配
     const lower = name.toLowerCase();
     for (const [key, files] of Object.entries(sfm)) {
-      if (key.toLowerCase() === lower) return files;
+      if (key.toLowerCase() === lower) {
+        return files;
+      }
     }
 
     return [];