autosnippet 3.0.10 → 3.0.13

package/lib/service/wiki/WikiGenerator.js

@@ -35,6 +35,22 @@ import fs from 'node:fs';
 import path from 'node:path';
 import Logger from '../../infrastructure/logging/Logger.js';
 import { LanguageService } from '../../shared/LanguageService.js';
+import {
+  slug,
+  walkDir,
+  inferModuleFromPath,
+  getModuleSourceFiles,
+  getInheritanceRoots,
+  dedup,
+  detectBuildSystems,
+  getLangTerms,
+  profileFolders,
+} from './WikiUtils.js';
+import {
+  buildArticlePrompt,
+  buildFallbackArticle,
+  buildAiSystemPrompt,
+} from './WikiRenderers.js';
 
 const logger = Logger.getInstance();
 
@@ -126,7 +142,7 @@ export class WikiGenerator {
 
       // Phase 4: Module/SPM parse
       this._emit(WikiPhase.SPM_PARSE, 30, '解析模块依赖关系...');
-      const spmInfo = await this._parseSPM();
+      const moduleInfo = await this._parseModules();
       if (this._aborted) {
         return this._abortedResult();
       }
@@ -140,8 +156,8 @@ export class WikiGenerator {
 
       // 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);
+      const structuredData = { projectInfo, astInfo, moduleInfo, knowledgeInfo };
+      const topics = this._discoverTopics(projectInfo, astInfo, moduleInfo, knowledgeInfo);
       if (this._aborted) {
         return this._abortedResult();
       }
@@ -163,7 +179,7 @@ export class WikiGenerator {
 
       // Phase 9: Dedup
       this._emit(WikiPhase.DEDUP, 90, '去重检查...');
-      const dedupResult = this._dedup(files);
+      const dedupResult = dedup(files, this.wikiDir, this._emit.bind(this));
 
       // Phase 10: Finalize
       this._emit(WikiPhase.FINALIZE, 95, '写入元数据...');
@@ -243,15 +259,26 @@ export class WikiGenerator {
     const info = {
       name: path.basename(this.projectRoot),
       root: this.projectRoot,
+      // 通用构建系统检测（替代硬编码 iOS 三件套）
+      buildSystems: [],   // [{eco, buildTool}]
+      sourceFiles: [],
+      languages: {},
+      langProfile: null,  // LanguageService.detectProfile() 结果
+      primaryLanguage: 'unknown',
+      // 保留向后兼容字段
       hasPackageSwift: false,
       hasPodfile: false,
       hasXcodeproj: false,
-      sourceFiles: [],
-      languages: {},
     };
 
     // 检测项目类型
     const entries = fs.readdirSync(this.projectRoot, { withFileTypes: true });
+    const entryNames = entries.map((e) => e.name);
+
+    // 通用构建系统检测 (支持一级子目录 monorepo)
+    info.buildSystems = detectBuildSystems(entryNames, this.projectRoot);
+
+    // 向后兼容三字段
     for (const e of entries) {
       if (e.name === 'Package.swift') {
         info.hasPackageSwift = true;
@@ -269,7 +296,7 @@ export class WikiGenerator {
     for (const ext of LanguageService.sourceExts) {
       extMap[ext] = LanguageService.displayNameFromExt(ext) || ext;
     }
-    this._walkDir(
+    walkDir(
       this.projectRoot,
       (filePath) => {
         const ext = path.extname(filePath);
@@ -292,8 +319,8 @@ export class WikiGenerator {
         // SPM 标准结构: Sources/{ModuleName}/...
         mod = parts[sourcesIdx + 1];
       } else {
-        // 非 SPM: 取第一级目录名
-        mod = parts.length > 1 ? parts[0] : null;
+        // 通用: 使用多语言路径推断
+        mod = inferModuleFromPath(f);
       }
       if (mod) {
         if (!info.sourceFilesByModule[mod]) {
@@ -303,7 +330,18 @@ export class WikiGenerator {
       }
     }
 
-    this._emit(WikiPhase.SCAN, 12, `发现 ${info.sourceFiles.length} 个源文件`);
+    // 利用 LanguageService.detectProfile() 获取多语言画像
+    const bareStats = {};
+    for (const f of info.sourceFiles) {
+      const ext = path.extname(f).replace('.', '');
+      if (ext) {
+        bareStats[ext] = (bareStats[ext] || 0) + 1;
+      }
+    }
+    info.langProfile = LanguageService.detectProfile(bareStats);
+    info.primaryLanguage = info.langProfile.primary;
+
+    this._emit(WikiPhase.SCAN, 12, `发现 ${info.sourceFiles.length} 个源文件 (${LanguageService.displayName(info.primaryLanguage)})`);
     return info;
   }
 
@@ -323,7 +361,7 @@ export class WikiGenerator {
       for (const name of allClasses) {
         const info = this.projectGraph.getClassInfo(name);
         if (info?.filePath) {
-          const mod = this._inferModuleFromPath(info.filePath);
+          const mod = inferModuleFromPath(info.filePath);
           if (mod) {
             if (!classNamesByModule[mod]) {
               classNamesByModule[mod] = [];
@@ -336,7 +374,7 @@ export class WikiGenerator {
       for (const name of allProtocols) {
         const info = this.projectGraph.getProtocolInfo(name);
         if (info?.filePath) {
-          const mod = this._inferModuleFromPath(info.filePath);
+          const mod = inferModuleFromPath(info.filePath);
           if (mod) {
             if (!protocolNamesByModule[mod]) {
               protocolNamesByModule[mod] = [];
@@ -374,7 +412,7 @@ export class WikiGenerator {
    * 模块依赖解析
    * 通过 moduleService 统一处理所有语言的模块扫描
    */
-  async _parseSPM() {
+  async _parseModules() {
     if (!this.moduleService) {
       return { targets: [], depGraph: null };
     }
@@ -433,9 +471,10 @@ export class WikiGenerator {
    *
    * @returns {Array<{id: string, path: string, title: string, type: string, priority: number}>}
    */
-  _discoverTopics(projectInfo, astInfo, spmInfo, knowledgeInfo) {
+  _discoverTopics(projectInfo, astInfo, moduleInfo, knowledgeInfo) {
     const topics = [];
     const isZh = this.options.language === 'zh';
+    const langTerms = getLangTerms(projectInfo.primaryLanguage);
 
     // ── 1. 项目概览 (始终生成) ──
     topics.push({
@@ -448,8 +487,9 @@ export class WikiGenerator {
 
     // ── 2. 架构概览 (需要模块/依赖关系) ──
     const moduleKeys = Object.keys(astInfo.classNamesByModule || {});
-    const hasMultiModule = spmInfo.targets.length >= 2 || moduleKeys.length >= 2;
-    const hasDepGraph = spmInfo.depGraph != null;
+    const sourceModuleKeys = Object.keys(projectInfo.sourceFilesByModule || {});
+    const hasMultiModule = moduleInfo.targets.length >= 2 || moduleKeys.length >= 2 || sourceModuleKeys.length >= 2;
+    const hasDepGraph = moduleInfo.depGraph != null;
     const hasInheritance = this.codeEntityGraph != null;
 
     if (hasMultiModule || hasDepGraph || hasInheritance) {
@@ -465,6 +505,7 @@ export class WikiGenerator {
     // ── 3. 快速上手 (需要构建配置或入口点) ──
     const hasEntryPoints = (astInfo.overview?.entryPoints?.length || 0) > 0;
     const hasBuildSystem =
+      projectInfo.buildSystems.length > 0 ||
       projectInfo.hasPackageSwift || projectInfo.hasPodfile || projectInfo.hasXcodeproj;
 
     if (hasEntryPoints || hasBuildSystem) {
@@ -478,28 +519,66 @@ export class WikiGenerator {
     }
 
     // ── 4. 模块深度文档 (仅对实质性模块生成) ──
-    for (const target of spmInfo.targets) {
-      const moduleFiles = this._getModuleSourceFiles(target, projectInfo);
-      const classCount = (astInfo.classNamesByModule?.[target.name] || []).length;
-      const protoCount = (astInfo.protocolNamesByModule?.[target.name] || []).length;
-      const depCount = (target.dependencies || target.info?.dependencies || []).length;
-
-      // 丰富度评分: 文件数 + 类数×2 + 协议数×2 + 依赖数
-      const richness = moduleFiles.length + classCount * 2 + protoCount * 2 + depCount;
+    const discoverers = moduleInfo.projectInfo?.discoverers || [];
+    const genericOnlyDiscovery =
+      discoverers.length === 1 && discoverers[0]?.id === 'generic';
+    const monolithSingleTarget =
+      moduleInfo.targets.length === 1 &&
+      (moduleInfo.targets[0]?.path === projectInfo.root ||
+        moduleInfo.targets[0]?.name === projectInfo.name);
+    const shouldUseInferredModules =
+      sourceModuleKeys.length >= 2 &&
+      (moduleInfo.targets.length === 0 || (genericOnlyDiscovery && monolithSingleTarget));
+
+    if (moduleInfo.targets.length > 0 && !shouldUseInferredModules) {
+      // 使用 moduleService 发现的 targets
+      for (const target of moduleInfo.targets) {
+        const moduleFiles = getModuleSourceFiles(target, projectInfo);
+        const classCount = (astInfo.classNamesByModule?.[target.name] || []).length;
+        const protoCount = (astInfo.protocolNamesByModule?.[target.name] || []).length;
+        const depCount = (target.dependencies || target.info?.dependencies || []).length;
+
+        // 丰富度评分: 文件数 + 类数×2 + 协议数×2 + 依赖数
+        const richness = moduleFiles.length + classCount * 2 + protoCount * 2 + depCount;
+
+        // 跳过过于单薄的模块 (少于3分不值得独立文档)
+        if (richness < 3) {
+          continue;
+        }
 
-      // 跳过过于单薄的模块 (少于3分不值得独立文档)
-      if (richness < 3) {
-        continue;
+        topics.push({
+          id: `module-${slug(target.name)}`,
+          path: `modules/${slug(target.name)}.md`,
+          title: target.name,
+          type: 'module',
+          priority: 50 + Math.min(richness, 30),
+          _moduleData: { target, moduleFiles, classCount, protoCount },
+        });
+      }
+    } else if (shouldUseInferredModules) {
+      // 无有效模块边界(无 targets 或 generic 单 target) → 从 sourceFilesByModule 推断模块
+      const sfm = projectInfo.sourceFilesByModule || {};
+      const sorted = Object.entries(sfm).sort((a, b) => b[1].length - a[1].length);
+      for (const [modName, modFiles] of sorted) {
+        if (modFiles.length < 2) continue;
+        const classCount = (astInfo.classNamesByModule?.[modName] || []).length;
+        const protoCount = (astInfo.protocolNamesByModule?.[modName] || []).length;
+        const richness = modFiles.length + classCount * 2 + protoCount * 2;
+        if (richness < 3) continue;
+        topics.push({
+          id: `module-${slug(modName)}`,
+          path: `modules/${slug(modName)}.md`,
+          title: modName,
+          type: 'module',
+          priority: 50 + Math.min(richness, 30),
+          _moduleData: {
+            target: { name: modName, type: 'inferred' },
+            moduleFiles: modFiles,
+            classCount,
+            protoCount,
+          },
+        });
       }
-
-      topics.push({
-        id: `module-${_slug(target.name)}`,
-        path: `modules/${_slug(target.name)}.md`,
-        title: target.name,
-        type: 'module',
-        priority: 50 + Math.min(richness, 30),
-        _moduleData: { target, moduleFiles, classCount, protoCount },
-      });
     }
 
     // ── 5. 代码模式/最佳实践 (来自知识库 Recipes) ──
@@ -532,8 +611,8 @@ export class WikiGenerator {
             continue;
           }
           topics.push({
-            id: `pattern-${_slug(cat)}`,
-            path: `patterns/${_slug(cat)}.md`,
+            id: `pattern-${slug(cat)}`,
+            path: `patterns/${slug(cat)}.md`,
             title: isZh ? `${cat} 模式` : `${cat} Patterns`,
             type: 'pattern-category',
             priority: 30 + items.length,
@@ -543,17 +622,92 @@ export class WikiGenerator {
       }
     }
 
-    // ── 6. 协议参考 (协议数量足够多时) ──
+    // ── 6. 协议/接口参考 (数量足够多时) ──
     if (astInfo.protocols.length >= 8) {
+      const ifaceLabel = isZh ? langTerms.interfaceLabel.zh : langTerms.interfaceLabel.en;
       topics.push({
         id: 'protocols',
         path: 'protocols.md',
-        title: isZh ? '协议参考' : 'Protocol Reference',
+        title: isZh ? `${ifaceLabel}参考` : `${ifaceLabel} Reference`,
         type: 'reference',
         priority: 35,
       });
     }
 
+    // ── 7. 文件夹画像文档 (AST 稀疏项目的降级策略) ──
+    //   当 AST 无法提取足够的 类/函数/协议 时，转为文件夹级分析
+    const astEntityCount = (astInfo.classes?.length || 0) + (astInfo.protocols?.length || 0);
+    const hasModuleDocs = topics.some(t => t.type === 'module');
+    const astSparse = astEntityCount < 5 && !hasModuleDocs;
+    const shouldProfileForGenericMonolith =
+      genericOnlyDiscovery && monolithSingleTarget && sourceModuleKeys.length >= 2;
+    const shouldEnableFolderProfiling = astSparse || shouldProfileForGenericMonolith;
+
+    if (shouldEnableFolderProfiling) {
+      const rawFolderProfiles = profileFolders(projectInfo, {
+        minFiles: 3,
+        maxFolders: 15,
+      });
+
+      // 按 relPath 去重，避免同一路径重复产出同名文档
+      const folderProfiles = [];
+      const seenFolderRelPath = new Set();
+      for (const fp of rawFolderProfiles) {
+        if (seenFolderRelPath.has(fp.relPath)) {
+          continue;
+        }
+        seenFolderRelPath.add(fp.relPath);
+        folderProfiles.push(fp);
+      }
+
+      if (folderProfiles.length > 0) {
+        // 总览文档: 文件夹结构分析
+        topics.push({
+          id: 'folder-overview',
+          path: 'folder-structure.md',
+          title: isZh ? '项目结构分析' : 'Project Structure Analysis',
+          type: 'folder-overview',
+          priority: 80,
+          _folderProfiles: folderProfiles,
+        });
+
+        // 为每个重要文件夹生成独立文档 (仅 fileCount ≥ 5 的大文件夹)
+        // 限制最多 10 个 folder-profile 文档，避免碎片化
+        const MAX_FOLDER_DOCS = 10;
+        let folderDocCount = 0;
+        for (const fp of folderProfiles) {
+          if (folderDocCount >= MAX_FOLDER_DOCS) break;
+          if (fp.fileCount < 5) continue;
+          const folderDocSlug = slug(fp.relPath.replaceAll('/', '-'));
+          // 文件夹丰富度评分: 文件数 + 入口点×3 + 命名模式数×2 + imports数 + headerComments数×2 + (有README +5)
+          const richness = fp.fileCount
+            + fp.entryPoints.length * 3
+            + fp.namingPatterns.length * 2
+            + fp.imports.length
+            + fp.headerComments.length * 2
+            + (fp.readme ? 5 : 0);
+
+          if (richness < 10) continue; // 过于单薄的文件夹不值得独立文档
+
+          topics.push({
+            id: `folder-${folderDocSlug}`,
+            path: `folders/${folderDocSlug}.md`,
+            title: fp.relPath,
+            type: 'folder-profile',
+            priority: 45 + Math.min(richness, 25),
+            _folderProfile: fp,
+          });
+          folderDocCount++;
+        }
+
+        const folderProfileReason = astSparse ? 'AST sparse' : 'generic monolith';
+        logger.info(
+          `[WikiGenerator] Folder profiling (${folderProfileReason}): ${folderProfiles.length} folders analyzed, ` +
+            `${topics.filter(t => t.type === 'folder-profile').length} folder docs planned`
+        );
+      }
+    }
+
     // 按优先级排序
     topics.sort((a, b) => b.priority - a.priority);
 
@@ -573,7 +727,7 @@ export class WikiGenerator {
    *   3. 质量关卡: 最终内容不足 MIN_ARTICLE_CHARS 则跳过
    *
    * @param {Array} topics - _discoverTopics() 的输出
-   * @param {object} structuredData - { projectInfo, astInfo, spmInfo, knowledgeInfo }
+   * @param {object} structuredData - { projectInfo, astInfo, moduleInfo, knowledgeInfo }
    * @returns {Array<{path: string, hash: string, size: number}>}
    */
   async _composeArticles(topics, structuredData) {
@@ -585,15 +739,23 @@ 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/'));
+    const needsFoldersDir = topics.some((t) => t.path.startsWith('folders/'));
     if (needsModulesDir) {
       this._ensureDir(path.join(this.wikiDir, 'modules'));
     }
     if (needsPatternsDir) {
       this._ensureDir(path.join(this.wikiDir, 'patterns'));
     }
+    if (needsFoldersDir) {
+      this._ensureDir(path.join(this.wikiDir, 'folders'));
+    }
 
     let composed = 0;
-    const systemPrompt = this._buildAiSystemPrompt(isZh);
+    const systemPrompt = buildAiSystemPrompt(isZh);
+
+    // 跟踪实际写入的主题 (用于 overview 导航)
+    const writtenTopics = [];
+    let overviewTopicIdx = -1;
 
     for (let i = 0; i < topics.length; i++) {
       if (this._aborted) {
@@ -601,8 +763,9 @@ export class WikiGenerator {
       }
 
       const topic = topics[i];
-      // 将全部主题列表注入 overview，用于生成导航
       if (topic.type === 'overview') {
+        overviewTopicIdx = i;
+        // 先用全部主题作为占位，最后回写
         topic._allTopics = topics;
       }
 
@@ -614,7 +777,7 @@ export class WikiGenerator {
       // === 1. 尝试 AI 撰写完整文章 ===
       if (this.aiProvider) {
         try {
-          const prompt = this._buildArticlePrompt(topic, structuredData, isZh);
+          const prompt = buildArticlePrompt(topic, structuredData, isZh, this.codeEntityGraph);
           const aiResult = await Promise.race([
             this.aiProvider.chat(prompt, { systemPrompt, temperature: 0.3, maxTokens: 4096 }),
             new Promise((_, reject) =>
@@ -633,7 +796,7 @@ export class WikiGenerator {
 
       // === 2. 降级: 丰富的模板内容 ===
       if (!content) {
-        content = this._buildFallbackArticle(topic, structuredData, isZh);
+        content = buildFallbackArticle(topic, structuredData, isZh, this.codeEntityGraph);
       }
 
       // === 3. 质量关卡 ===
@@ -646,10 +809,26 @@ export class WikiGenerator {
 
       // 写入文件
       const fileInfo = this._writeFile(topic.path, content);
-      if (composed > 0 && content !== this._buildFallbackArticle(topic, structuredData, isZh)) {
+      if (composed > 0 && content !== buildFallbackArticle(topic, structuredData, isZh, this.codeEntityGraph)) {
         fileInfo.polished = true;
       }
       files.push(fileInfo);
+      writtenTopics.push(topic);
+    }
+
+    // 回写 overview: 只包含实际生成的页面导航 (避免断链)
+    if (overviewTopicIdx >= 0 && writtenTopics.length > 0) {
+      const overviewTopic = topics[overviewTopicIdx];
+      overviewTopic._allTopics = writtenTopics;
+      let overviewContent = null;
+      // overview 始终存在于 files 中（因为 priority 最高且始终生成）
+      // 重新用实际 writtenTopics 渲染
+      overviewContent = buildFallbackArticle(overviewTopic, structuredData, isZh, this.codeEntityGraph);
+      // 如果之前 AI compose 过 overview，保留 AI 版本（AI 版本已在初次写入时处理导航）
+      const overviewFile = files.find(f => f.path === overviewTopic.path);
+      if (overviewFile && !overviewFile.polished && overviewContent) {
+        this._writeFile(overviewTopic.path, overviewContent);
+      }
     }
 
     logger.info(`[WikiGenerator] Composed ${files.length} articles (${composed} AI-enhanced)`);
@@ -661,1265 +840,6 @@ export class WikiGenerator {
     return files;
   }
 
-  // ═══ AI Prompt 构建 ════════════════════════════════════════
-
-  /**
-   * 为特定主题构建 AI 撰写 prompt (V3 AI-first 核心)
-   *
-   * 关键区别: 不是润色骨架，而是提供丰富数据让 AI 写完整文章
-   */
-  _buildArticlePrompt(topic, data, isZh) {
-    const { projectInfo, astInfo, spmInfo, knowledgeInfo } = data;
-    const parts = [];
-
-    // 公共项目上下文
-    parts.push(`# 项目: ${projectInfo.name}`);
-    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('');
-
-    switch (topic.type) {
-      case 'overview': {
-        parts.push('## 任务: 撰写项目概述文档');
-        parts.push('');
-
-        // 项目类型
-        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(' + ')}`);
-        }
-        parts.push('');
-
-        // 模块结构
-        if (spmInfo.targets.length > 0) {
-          parts.push('### 模块列表');
-          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(', ')}` : ''}`
-            );
-          }
-          parts.push('');
-        }
-
-        // AST 概况
-        if (astInfo.overview) {
-          parts.push('### 代码规模');
-          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');
-        if (otherTopics.length > 0) {
-          parts.push('### 需要包含的导航链接');
-          for (const t of otherTopics) {
-            parts.push(`- [${t.title}](${t.path})`);
-          }
-          parts.push('');
-        }
-
-        parts.push('要求: 撰写完整的项目概述文档。');
-        parts.push(
-          '包含: 项目简介(解释项目做什么)、模块总览(表格形式)、技术栈分析、核心数据指标、文档导航索引。'
-        );
-        parts.push('不要只列数据 — 要解释项目的定位、各模块的职责和协作关系。');
-        break;
-      }
-
-      case 'architecture': {
-        parts.push('## 任务: 撰写架构分析文档');
-        parts.push('');
-
-        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(', ')}` : ''}`
-            );
-          }
-          parts.push('');
-        }
-
-        if (astInfo.overview?.topLevelModules?.length > 0) {
-          parts.push(`### 顶层模块: ${astInfo.overview.topLevelModules.join(', ')}`);
-          const cpm = astInfo.overview.classesPerModule || {};
-          for (const mod of astInfo.overview.topLevelModules) {
-            parts.push(`  ${mod}: ${cpm[mod] || 0} 个类`);
-          }
-          parts.push('');
-        }
-
-        if (astInfo.overview?.entryPoints?.length > 0) {
-          parts.push(`### 入口点: ${astInfo.overview.entryPoints.join(', ')}`);
-          parts.push('');
-        }
-
-        const roots = this._getInheritanceRoots();
-        if (roots.length > 0) {
-          parts.push('### 核心继承关系');
-          for (const r of roots.slice(0, 10)) {
-            parts.push(`- ${r.name} → ${(r.children || []).slice(0, 5).join(', ')}`);
-          }
-          parts.push('');
-        }
-
-        parts.push('要求: 撰写架构分析文档。');
-        parts.push(
-          '包含: 模块依赖图(使用 Mermaid graph TD 语法)、分层架构分析(解释每层的职责)、模块间协作关系、架构设计决策阐述。'
-        );
-        parts.push('用 Mermaid 绘制依赖关系图和继承层次图。分析为什么采用这种架构。');
-        break;
-      }
-
-      case 'module': {
-        const md = topic._moduleData;
-        const target = md.target;
-        const moduleFiles = md.moduleFiles;
-        const moduleClasses = astInfo.classNamesByModule?.[target.name] || [];
-        const moduleProtocols = astInfo.protocolNamesByModule?.[target.name] || [];
-        const deps = target.dependencies || target.info?.dependencies || [];
-
-        parts.push(`## 任务: 撰写 "${target.name}" 模块的深度文档`);
-        parts.push('');
-        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}`);
-        }
-        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('');
-        }
-
-        if (moduleClasses.length > 0) {
-          parts.push(`### 类型列表: ${moduleClasses.slice(0, 30).join(', ')}`);
-          parts.push('');
-        }
-
-        if (moduleProtocols.length > 0) {
-          parts.push(`### 协议列表: ${moduleProtocols.slice(0, 20).join(', ')}`);
-          parts.push('');
-        }
-
-        // 关键源文件名（帮助 AI 推断模块功能）
-        if (moduleFiles.length > 0) {
-          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 json = r.toJSON ? r.toJSON() : r;
-          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}`);
-            }
-          }
-          parts.push('');
-        }
-
-        parts.push('要求: 撰写模块深度分析文档。');
-        parts.push(
-          '包含: 模块职责说明(从文件名和类名推断功能意图)、核心类型分析(不是简单罗列而是解释每个类的角色)、依赖关系分析、设计模式识别。'
-        );
-        parts.push('如果能推断出数据流或协作关系，请用 Mermaid 图表展示。');
-        break;
-      }
-
-      case 'getting-started': {
-        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');
-        }
-        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(', ')}`);
-          }
-          parts.push('');
-        }
-
-        if (astInfo.overview?.entryPoints?.length > 0) {
-          parts.push(`入口点: ${astInfo.overview.entryPoints.join(', ')}`);
-          parts.push('');
-        }
-
-        parts.push('要求: 撰写开发者快速上手指南。');
-        parts.push(
-          '包含: 环境要求、项目获取、依赖安装、构建步骤(具体命令)、运行测试、项目目录结构说明。'
-        );
-        parts.push('语句清晰，步骤明确，适合新人阅读。');
-        break;
-      }
-
-      case 'patterns': {
-        parts.push('## 任务: 撰写代码模式与最佳实践文档');
-        parts.push('');
-
-        const groups = {};
-        for (const r of knowledgeInfo.recipes) {
-          const json = r.toJSON ? r.toJSON() : r;
-          const cat = json.category || 'Other';
-          if (!groups[cat]) {
-            groups[cat] = [];
-          }
-          groups[cat].push(json);
-        }
-
-        for (const [cat, items] of Object.entries(groups).sort()) {
-          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)}`);
-            }
-          }
-          parts.push('');
-        }
-
-        parts.push('要求: 撰写代码模式文档。对每个分类进行总结分析，解释模式的意义和应用场景。');
-        parts.push(
-          '不要只列出条目 — 为每个分类写一段总结，解释该类模式的整体意图。附带代码示例(从数据中取)。'
-        );
-        break;
-      }
-
-      case 'pattern-category': {
-        const pd = topic._patternData;
-        parts.push(`## 任务: 撰写 "${pd.category}" 分类的代码模式文档`);
-        parts.push('');
-
-        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.content?.pattern) {
-            parts.push('代码:');
-            parts.push('```');
-            parts.push(item.content.pattern.slice(0, 500));
-            parts.push('```');
-          }
-          parts.push('');
-        }
-
-        parts.push('要求: 撰写该分类的详细代码模式文档。');
-        parts.push(
-          '先写一段总结性概述，然后对每个模式做分析，解释为什么要遵循，给出正确和错误的对比示例。'
-        );
-        break;
-      }
-
-      case 'reference': {
-        parts.push('## 任务: 撰写协议参考文档');
-        parts.push('');
-
-        const protoByModule = astInfo.protocolNamesByModule || {};
-        for (const [mod, protos] of Object.entries(protoByModule).sort()) {
-          if (protos.length > 0) {
-            parts.push(`### ${mod} 模块: ${protos.join(', ')}`);
-          }
-        }
-        parts.push('');
-        parts.push(
-          `总计: ${astInfo.protocols.length} 个协议, ${astInfo.classes.length} 个类/结构体`
-        );
-        parts.push('');
-        parts.push(
-          '要求: 撰写协议参考文档。按模块分组，分析每个协议的用途和意义，描述协议之间的关系和设计意图。'
-        );
-        break;
-      }
-    }
-
-    return parts.join('\n');
-  }
-
-  /**
-   * 构建非 AI 降级的丰富模板内容
-   * 即使没有 AI，也要产出有意义的内容 (不是只有列表罗列)
-   */
-  _buildFallbackArticle(topic, data, isZh) {
-    const { projectInfo, astInfo, spmInfo, knowledgeInfo } = data;
-
-    switch (topic.type) {
-      case 'overview':
-        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
-        );
-      case 'patterns':
-        return this._renderPatterns(knowledgeInfo, isZh);
-      case 'pattern-category':
-        return this._renderPatternCategory(topic._patternData, isZh);
-      case 'reference':
-        return this._renderProtocolReference(astInfo, isZh);
-      default:
-        return '';
-    }
-  }
-
-  // ═══ Markdown 渲染器 ═══════════════════════════════════════
-
-  _renderIndex(project, ast, spm, knowledge, isZh, allTopics) {
-    const title = isZh ? '项目概述' : 'Project Overview';
-
-    const lines = [
-      `# ${project.name} — ${title}`,
-      '',
-      `> ${isZh ? '本文档由 AutoSnippet Repo Wiki 自动生成' : 'Auto-generated by AutoSnippet Repo Wiki'}`,
-      `> ${isZh ? '生成时间' : 'Generated at'}: ${new Date().toISOString()}`,
-      '',
-    ];
-
-    // ── 项目简介 ──
-    lines.push(`## ${isZh ? '简介' : 'Introduction'}`);
-    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');
-    }
-
-    const overview = ast.overview || {};
-    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} 个协议` : '') +
-          `。`
-      );
-      if (mainTargets.length > 0) {
-        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` : '') +
-          `.`
-      );
-      if (mainTargets.length > 0) {
-        lines.push(
-          `The project consists of ${mainTargets.length} functional modules` +
-            (testTargets.length > 0 ? ` with ${testTargets.length} test modules` : '') +
-            `.`
-        );
-      }
-    }
-    lines.push('');
-
-    // ── 模块总览 ──
-    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('|--------|------|--------|--------|----------|');
-      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 nameCol = hasDoc ? `[${t.name}](modules/${_slug(t.name)}.md)` : t.name;
-        lines.push(
-          `| ${nameCol} | ${t.type || 'target'} | ${moduleFiles.length || '-'} | ${classCount || '-'} | ${protoCount || '-'} |`
-        );
-      }
-      lines.push('');
-    }
-
-    // ── 技术栈 ──
-    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('|--------|-------|------|');
-      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])) {
-        const pct = total > 0 ? ((count / total) * 100).toFixed(1) : 0;
-        lines.push(`| ${lang} | ${count} | ${pct}% |`);
-      }
-      lines.push('');
-    }
-
-    // ── 核心数据 ──
-    lines.push(`## ${isZh ? '核心数据' : 'Key Metrics'}`);
-    lines.push('');
-    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} |`);
-    }
-    lines.push('');
-
-    // ── 文档导航 (动态，基于实际生成的主题) ──
-    const navTopics = (allTopics || []).filter((t) => t.type !== 'overview');
-    if (navTopics.length > 0) {
-      lines.push('---');
-      lines.push('');
-      lines.push(`## ${isZh ? '📖 文档导航' : '📖 Documentation'}`);
-      lines.push('');
-      for (const t of navTopics) {
-        lines.push(`- [${t.title}](${t.path})`);
-      }
-      lines.push('');
-    }
-
-    return lines.join('\n');
-  }
-
-  _renderArchitecture(project, ast, spm, isZh) {
-    const lines = [
-      `# ${isZh ? '架构总览' : 'Architecture Overview'}`,
-      '',
-      `> ${isZh ? '本文档由 AutoSnippet Repo Wiki 自动生成' : 'Auto-generated by AutoSnippet Repo Wiki'}`,
-      '',
-    ];
-
-    // 依赖图 (Mermaid)
-    if (spm.targets.length > 0) {
-      lines.push(`## ${isZh ? '模块依赖图' : 'Module Dependency Graph'}`);
-      lines.push('');
-      lines.push('```mermaid');
-      lines.push('graph TD');
-
-      // 渲染 target 节点和依赖边
-      const rendered = new Set();
-      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}"]`;
-          lines.push(`    ${shape}`);
-          rendered.add(sid);
-        }
-      }
-
-      // 如果有依赖图数据，渲染边
-      if (spm.depGraph) {
-        const edges = spm.depGraph.edges || [];
-        for (const edge of Array.isArray(edges) ? edges : []) {
-          if (edge.from && edge.to) {
-            const fromId = _mermaidId(edge.from.split('::').pop() || edge.from);
-            const toId = _mermaidId(edge.to.split('::').pop() || edge.to);
-            lines.push(`    ${fromId} --> ${toId}`);
-          }
-        }
-      }
-
-      lines.push('```');
-      lines.push('');
-    }
-
-    // 分层架构
-    if (ast.overview) {
-      const modules = ast.overview.topLevelModules || [];
-      if (modules.length > 0) {
-        lines.push(`## ${isZh ? '顶层模块' : 'Top-Level Modules'}`);
-        lines.push('');
-        lines.push(`| ${isZh ? '模块' : 'Module'} | ${isZh ? '类数量' : 'Classes'} |`);
-        lines.push('|--------|---------|');
-        const cpm = ast.overview.classesPerModule || {};
-        for (const mod of modules) {
-          lines.push(`| ${mod} | ${cpm[mod] || 0} |`);
-        }
-        lines.push('');
-      }
-
-      // 入口点
-      if (ast.overview.entryPoints?.length > 0) {
-        lines.push(`## ${isZh ? '入口点' : 'Entry Points'}`);
-        lines.push('');
-        for (const ep of ast.overview.entryPoints) {
-          lines.push(`- \`${ep}\``);
-        }
-        lines.push('');
-      }
-    }
-
-    // 继承层次 (from CodeEntityGraph)
-    if (this.codeEntityGraph) {
-      try {
-        const topClasses = this._getInheritanceRoots();
-        if (topClasses.length > 0) {
-          lines.push(`## ${isZh ? '核心继承层次' : 'Key Inheritance Hierarchy'}`);
-          lines.push('');
-          lines.push('```mermaid');
-          lines.push('classDiagram');
-          for (const root of topClasses.slice(0, 20)) {
-            lines.push(`    class ${_mermaidId(root.name)}`);
-            for (const child of root.children || []) {
-              lines.push(`    ${_mermaidId(root.name)} <|-- ${_mermaidId(child)}`);
-            }
-          }
-          lines.push('```');
-          lines.push('');
-        }
-      } catch {
-        /* non-critical */
-      }
-    }
-
-    lines.push(`[← ${isZh ? '返回概述' : 'Back to Overview'}](index.md)`);
-    lines.push('');
-    return lines.join('\n');
-  }
-
-  _renderModule(target, ast, knowledge, isZh, projectInfo) {
-    const lines = [
-      `# ${target.name}`,
-      '',
-      `> ${isZh ? '模块文档 — 由 AutoSnippet Repo Wiki 自动生成' : 'Module doc — Auto-generated by AutoSnippet Repo Wiki'}`,
-      '',
-    ];
-
-    // 收集模块数据
-    const moduleFiles = projectInfo ? this._getModuleSourceFiles(target, projectInfo) : [];
-    const moduleClasses = ast.classNamesByModule?.[target.name] || [];
-    const moduleProtocols = ast.protocolNamesByModule?.[target.name] || [];
-    const deps = target.dependencies || target.info?.dependencies || [];
-
-    // ── 模块概述 ──
-    lines.push(`## ${isZh ? '概述' : 'Overview'}`);
-    lines.push('');
-
-    // 推断模块功能 (基于名称和内容)
-    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` : ''}.`
-      );
-    } 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('');
-
-    // ── 模块信息表 ──
-    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} |`);
-    }
-    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('');
-      for (const dep of deps) {
-        const depName = typeof dep === 'string' ? dep : dep.name || String(dep);
-        lines.push(`- \`${depName}\``);
-      }
-      lines.push('');
-    }
-
-    // ── 核心类型分析 ──
-    if (moduleClasses.length > 0 || moduleProtocols.length > 0) {
-      lines.push(`## ${isZh ? '核心类型' : 'Core Types'}`);
-      lines.push('');
-
-      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('');
-        const sorted = [...moduleProtocols].sort();
-        for (const p of sorted.slice(0, 20)) {
-          lines.push(`- \`${p}\``);
-        }
-        if (sorted.length > 20) {
-          lines.push(
-            `- ... ${isZh ? `还有 ${sorted.length - 20} 个` : `and ${sorted.length - 20} more`}`
-          );
-        }
-        lines.push('');
-      }
-
-      if (moduleClasses.length > 0) {
-        lines.push(`### ${isZh ? '类/结构体' : 'Classes/Structs'} (${moduleClasses.length})`);
-        lines.push('');
-        const sorted = [...moduleClasses].sort();
-        for (const c of sorted.slice(0, 30)) {
-          lines.push(`- \`${c}\``);
-        }
-        if (sorted.length > 30) {
-          lines.push(
-            `- ... ${isZh ? `还有 ${sorted.length - 30} 个` : `and ${sorted.length - 30} more`}`
-          );
-        }
-        lines.push('');
-      }
-    }
-
-    // ── 源文件分布 ──
-    if (moduleFiles.length > 0) {
-      lines.push(`## ${isZh ? '源文件分布' : 'Source File Distribution'}`);
-      lines.push('');
-
-      // 按语言统计
-      const langCount = {};
-      for (const f of moduleFiles) {
-        const ext = path.extname(f);
-        const lang = LanguageService.displayNameFromExt(ext);
-        langCount[lang] = (langCount[lang] || 0) + 1;
-      }
-
-      lines.push(`| ${isZh ? '语言' : 'Language'} | ${isZh ? '文件数' : 'Files'} |`);
-      lines.push('|--------|-------|');
-      for (const [lang, count] of Object.entries(langCount).sort((a, b) => b - a)) {
-        lines.push(`| ${lang} | ${count} |`);
-      }
-      lines.push('');
-    }
-
-    // ── 该模块相关的 Recipes ──
-    if (knowledge.recipes.length > 0) {
-      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)
-        );
-      });
-      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('');
-        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}`);
-          }
-          lines.push('');
-        }
-      }
-    }
-
-    lines.push(`[← ${isZh ? '返回概述' : 'Back to Overview'}](../index.md)`);
-    lines.push('');
-    return lines.join('\n');
-  }
-
-  /**
-   * 基于模块名称和内容推断模块功能
-   * 对常见命名模式做智能推断
-   */
-  _inferModulePurpose(name, classes, protocols, files) {
-    const lower = name.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: /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',
-      },
-    ];
-
-    // 先按模块名匹配
-    for (const rule of rules) {
-      if (rule.match.test(lower)) {
-        return rule;
-      }
-    }
-
-    // 再按类名匹配
-    const classStr = classes.join(' ');
-    for (const rule of rules) {
-      if (rule.match.test(classStr)) {
-        return rule;
-      }
-    }
-
-    return null;
-  }
-
-  // _renderComponents removed in V3 — components are now part of module docs
-
-  _renderPatterns(knowledge, isZh) {
-    const lines = [
-      `# ${isZh ? '代码模式与最佳实践' : 'Code Patterns & Best Practices'}`,
-      '',
-      `> ${isZh ? '团队沉淀的代码模式与最佳实践（来自 AutoSnippet 知识库）' : 'Code patterns and best practices from AutoSnippet knowledge base'}`,
-      '',
-    ];
-
-    // 按 category 分组
-    const groups = {};
-    for (const r of knowledge.recipes) {
-      const json = r.toJSON ? r.toJSON() : r;
-      const cat = json.category || 'Other';
-      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('');
-
-    for (const [cat, items] of Object.entries(groups).sort()) {
-      lines.push(`## ${cat} (${items.length})`);
-      lines.push('');
-
-      // 分类概述
-      lines.push(
-        isZh
-          ? `${cat} 分类包含 ${items.length} 条规则，覆盖了该领域的核心规范。`
-          : `The ${cat} category contains ${items.length} rules covering core conventions in this area.`
-      );
-      lines.push('');
-
-      for (const item of items) {
-        lines.push(`### ${item.title}`);
-        lines.push('');
-        if (item.description) {
-          lines.push(item.description);
-          lines.push('');
-        }
-        if (item.content?.pattern) {
-          lines.push(`\`\`\`${item.language || 'swift'}`);
-          lines.push(item.content.pattern);
-          lines.push('```');
-          lines.push('');
-        }
-        if (item.doClause) {
-          lines.push(`**${isZh ? '✅ 应当' : '✅ Do'}**: ${item.doClause}`);
-          lines.push('');
-        }
-        if (item.dontClause) {
-          lines.push(`**${isZh ? '❌ 避免' : "❌ Don't"}**: ${item.dontClause}`);
-          lines.push('');
-        }
-        if (item.reasoning?.whyStandard) {
-          lines.push(`> ${isZh ? '💡 原因' : '💡 Rationale'}: ${item.reasoning.whyStandard}`);
-          lines.push('');
-        }
-      }
-    }
-
-    lines.push(`[← ${isZh ? '返回概述' : 'Back to Overview'}](index.md)`);
-    lines.push('');
-    return lines.join('\n');
-  }
-
-  // ═══ V3 新增渲染器 ════════════════════════════════════════
-
-  /**
-   * 快速上手指南 (非 AI 降级模板)
-   */
-  _renderGettingStarted(project, spm, ast, isZh) {
-    const lines = [
-      `# ${isZh ? '快速上手' : 'Getting Started'}`,
-      '',
-      `> ${isZh ? '本文档由 AutoSnippet Repo Wiki 自动生成' : 'Auto-generated by AutoSnippet Repo Wiki'}`,
-      '',
-    ];
-
-    // 环境要求
-    lines.push(`## ${isZh ? '环境要求' : 'Prerequisites'}`);
-    lines.push('');
-    if (project.hasPackageSwift) {
-      lines.push(isZh ? '- Swift 5.5+ (推荐 Swift 5.9+)' : '- Swift 5.5+ (Swift 5.9+ recommended)');
-      lines.push(isZh ? '- Xcode 14+' : '- Xcode 14+');
-    }
-    if (project.hasPodfile) {
-      lines.push(isZh ? '- CocoaPods 1.10+' : '- CocoaPods 1.10+');
-    }
-    if (project.hasXcodeproj) {
-      lines.push(isZh ? '- Xcode (最新稳定版)' : '- Xcode (latest stable version)');
-    }
-    lines.push('');
-
-    // 项目目录结构
-    lines.push(`## ${isZh ? '项目结构' : 'Project Structure'}`);
-    lines.push('');
-    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');
-      if (mainTargets.length > 0) {
-        lines.push('├── Sources/');
-        for (let i = 0; i < mainTargets.length; i++) {
-          const prefix =
-            i === mainTargets.length - 1 && testTargets.length === 0 ? '│   └──' : '│   ├──';
-          lines.push(`${prefix} ${mainTargets[i].name}/`);
-        }
-      }
-      if (testTargets.length > 0) {
-        lines.push('├── Tests/');
-        for (let i = 0; i < testTargets.length; i++) {
-          const prefix = i === testTargets.length - 1 ? '│   └──' : '│   ├──';
-          lines.push(`${prefix} ${testTargets[i].name}/`);
-        }
-      }
-    }
-    if (project.hasPackageSwift) {
-      lines.push('├── Package.swift');
-    }
-    if (project.hasPodfile) {
-      lines.push('├── Podfile');
-    }
-    lines.push('```');
-    lines.push('');
-
-    // 构建步骤
-    lines.push(`## ${isZh ? '构建与运行' : 'Build & Run'}`);
-    lines.push('');
-    if (project.hasPackageSwift) {
-      lines.push(isZh ? '### 使用 Swift Package Manager' : '### Using Swift Package Manager');
-      lines.push('');
-      lines.push('```bash');
-      lines.push(isZh ? '# 获取项目' : '# Clone the project');
-      lines.push(`git clone <repository-url>`);
-      lines.push(`cd ${project.name}`);
-      lines.push('');
-      lines.push(isZh ? '# 解析依赖' : '# Resolve dependencies');
-      lines.push('swift package resolve');
-      lines.push('');
-      lines.push(isZh ? '# 构建' : '# Build');
-      lines.push('swift build');
-      lines.push('');
-      lines.push(isZh ? '# 运行测试' : '# Run tests');
-      lines.push('swift test');
-      lines.push('```');
-      lines.push('');
-    }
-    if (project.hasPodfile) {
-      lines.push(isZh ? '### 使用 CocoaPods' : '### Using CocoaPods');
-      lines.push('');
-      lines.push('```bash');
-      lines.push('pod install');
-      lines.push('open *.xcworkspace');
-      lines.push('```');
-      lines.push('');
-    }
-
-    // 模块说明
-    if (spm.targets.length > 0) {
-      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('|--------|------|--------|------|');
-        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 desc = purpose ? (isZh ? purpose.zh : purpose.en) : '-';
-          lines.push(`| ${t.name} | ${t.type || 'library'} | ${cls} | ${desc} |`);
-        }
-        lines.push('');
-      }
-    }
-
-    lines.push(`[← ${isZh ? '返回概述' : 'Back to Overview'}](index.md)`);
-    lines.push('');
-    return lines.join('\n');
-  }
-
-  /**
-   * 按分类拆分的代码模式文档
-   */
-  _renderPatternCategory(patternData, isZh) {
-    const { category, recipes } = patternData;
-    const lines = [
-      `# ${category}`,
-      '',
-      `> ${isZh ? `${category} 分类下的 ${recipes.length} 条代码模式（来自 AutoSnippet 知识库）` : `${recipes.length} code patterns in ${category} category (from AutoSnippet KB)`}`,
-      '',
-    ];
-
-    // 分类概述
-    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('');
-
-    for (const item of recipes) {
-      lines.push(`## ${item.title}`);
-      lines.push('');
-      if (item.description) {
-        lines.push(item.description);
-        lines.push('');
-      }
-      if (item.doClause) {
-        lines.push(`**${isZh ? '✅ 应当' : '✅ Do'}**: ${item.doClause}`);
-        lines.push('');
-      }
-      if (item.dontClause) {
-        lines.push(`**${isZh ? '❌ 避免' : "❌ Don't"}**: ${item.dontClause}`);
-        lines.push('');
-      }
-      if (item.content?.pattern) {
-        lines.push(`\`\`\`${item.language || 'text'}`);
-        lines.push(item.content.pattern);
-        lines.push('```');
-        lines.push('');
-      }
-      if (item.reasoning?.whyStandard) {
-        lines.push(`> ${isZh ? '💡 原因' : '💡 Rationale'}: ${item.reasoning.whyStandard}`);
-        lines.push('');
-      }
-    }
-
-    lines.push(`[← ${isZh ? '返回概述' : 'Back to Overview'}](../index.md)`);
-    lines.push('');
-    return lines.join('\n');
-  }
-
-  /**
-   * 协议参考文档
-   */
-  _renderProtocolReference(ast, isZh) {
-    const lines = [
-      `# ${isZh ? '协议参考' : 'Protocol Reference'}`,
-      '',
-      `> ${isZh ? `项目中定义的 ${ast.protocols.length} 个协议` : `${ast.protocols.length} protocols defined in the project`}`,
-      '',
-    ];
-
-    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('');
-
-    // 按模块分组
-    const protoByModule = ast.protocolNamesByModule || {};
-    const grouped = new Set();
-
-    for (const [mod, protos] of Object.entries(protoByModule).sort()) {
-      if (protos.length === 0) {
-        continue;
-      }
-      lines.push(`## ${mod}`);
-      lines.push('');
-      lines.push(
-        isZh
-          ? `${mod} 模块定义了 ${protos.length} 个协议:`
-          : `${mod} module defines ${protos.length} protocols:`
-      );
-      lines.push('');
-      for (const p of protos.sort()) {
-        lines.push(`- \`${p}\``);
-        grouped.add(p);
-      }
-      lines.push('');
-    }
-
-    // 未分组的协议
-    const ungrouped = ast.protocols.filter((p) => !grouped.has(p));
-    if (ungrouped.length > 0) {
-      lines.push(`## ${isZh ? '其他协议' : 'Other Protocols'}`);
-      lines.push('');
-      for (const p of ungrouped.sort()) {
-        lines.push(`- \`${p}\``);
-      }
-      lines.push('');
-    }
-
-    lines.push(`[← ${isZh ? '返回概述' : 'Back to Overview'}](index.md)`);
-    lines.push('');
-    return lines.join('\n');
-  }
-
-  // ═══ V3 AI 系统 Prompt ═══════════════════════════════════
-
-  /**
-   * 构建 AI 系统 Prompt (V3 — 撰写完整文章，非润色骨架)
-   */
-  _buildAiSystemPrompt(isZh) {
-    if (isZh) {
-      return [
-        '你是 AutoSnippet Repo Wiki 文档撰写专家。',
-        '',
-        '任务: 基于代码分析数据，撰写高质量、有深度的项目文档。',
-        '',
-        '写作原则:',
-        '1. 所有类名、文件名、数字必须来自提供的数据，严禁编造',
-        '2. 不要简单罗列数据 — 要分析和解释，描述"为什么这样设计"、"模块的职责是什么"',
-        '3. 从文件名和类名推断功能意图，给出有见地的分析',
-        '4. 用自然语言连贯行文，包含过渡段落和总结性描述',
-        '5. 合理使用 Mermaid 图表（graph TD / classDiagram）、表格、代码块来辅助说明',
-        '6. 用中文撰写',
-        '7. 输出纯 Markdown，不要包裹在代码块中',
-        '8. 每篇文章以一级标题 (#) 开始，结构清晰',
-        '9. 篇幅适中：300-2000 字（根据主题复杂度调整）',
-        '10. 文末包含返回链接: [← 返回概述](index.md) 或 [← 返回概述](../index.md)',
-      ].join('\n');
-    }
-    return [
-      'You are the AutoSnippet Repo Wiki documentation expert.',
-      '',
-      'Task: Write high-quality, insightful project documentation based on code analysis data.',
-      '',
-      'Writing principles:',
-      '1. All class names, file names, and numbers must come from the provided data — never fabricate',
-      '2. Do not simply list data — analyze and explain: describe design rationale, module responsibilities',
-      '3. Infer functional intent from file names and class names, provide insightful analysis',
-      '4. Write coherent prose with transition paragraphs and summaries',
-      '5. Use Mermaid diagrams (graph TD / classDiagram), tables, and code blocks judiciously',
-      '6. Write in English',
-      '7. Output pure Markdown — do not wrap in code blocks',
-      '8. Start each article with a level-1 heading (#), maintain clear structure',
-      '9. Appropriate length: 300-2000 words (adjust by topic complexity)',
-      '10. End with a back link: [← Back to Overview](index.md) or [← Back to Overview](../index.md)',
-    ].join('\n');
-  }
-
   // ═══ Phase 8: 同步 Cursor 端 MD ═══════════════════════════
 
   /**
@@ -1990,119 +910,6 @@ export class WikiGenerator {
     }
   }
 
-  // ═══ Phase 9: 去重 ═════════════════════════════════════════
-
-  /**
-   * 两层去重
-   *
-   * Layer 1: Title slug 碰撞 — 同名文件不同目录 → hash 相同则删除副本
-   * Layer 2: Content hash    — 跨文件内容完全相同 → 仅保留第一个
-   *
-   * @param {Array} files
-   * @returns {{ removed: string[], kept: number }}
-   */
-  _dedup(files) {
-    const removed = [];
-
-    // Layer 1: slug 碰撞（同名文件跨目录）
-    const slugMap = new Map(); // slug → first file
-    for (const file of files) {
-      const slug = path.basename(file.path, path.extname(file.path)).toLowerCase();
-      if (slugMap.has(slug)) {
-        const existing = slugMap.get(slug);
-        // 完全相同 hash → 移除后来的
-        if (existing.hash === file.hash) {
-          const fullPath = path.join(this.wikiDir, file.path);
-          try {
-            fs.unlinkSync(fullPath);
-          } catch {
-            /* skip */
-          }
-          removed.push(file.path);
-          logger.info(
-            `[WikiGenerator] Dedup: removed ${file.path} (same hash as ${existing.path})`
-          );
-        }
-        // hash 不同 → 保留两个（不同目录允许同名）
-      } else {
-        slugMap.set(slug, file);
-      }
-    }
-
-    // Layer 2: content hash 碰撞（不同文件名但内容相同）
-    const hashMap = new Map(); // hash → first file path
-    for (const file of files) {
-      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/');
-
-        if (isCurrentSynced && !isFirstSynced) {
-          // 当前是 synced，first 是 codegen → 删除 synced
-          const fullPath = path.join(this.wikiDir, file.path);
-          try {
-            fs.unlinkSync(fullPath);
-          } catch {
-            /* skip */
-          }
-          removed.push(file.path);
-          logger.info(
-            `[WikiGenerator] Dedup: removed synced ${file.path} (same content as ${firstPath})`
-          );
-        }
-        // 其他情况保留两个
-      } else {
-        hashMap.set(file.hash, file.path);
-      }
-    }
-
-    // 从 files 数组中移除已删除的
-    for (let i = files.length - 1; i >= 0; i--) {
-      if (removed.includes(files[i].path)) {
-        files.splice(i, 1);
-      }
-    }
-
-    if (removed.length > 0) {
-      this._emit(WikiPhase.DEDUP, 93, `去重: 移除 ${removed.length} 个重复文件`);
-    } else {
-      this._emit(WikiPhase.DEDUP, 93, '无重复文件');
-    }
-
-    return { removed, kept: files.length };
-  }
-
-  // ═══ 辅助方法 ══════════════════════════════════════════════
-
-  /** 从 CodeEntityGraph 提取继承根节点 */
-  _getInheritanceRoots() {
-    if (!this.codeEntityGraph) {
-      return [];
-    }
-    try {
-      // 尝试查询继承关系
-      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' }) || [];
-        if (children.length > 0) {
-          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));
-    } catch {
-      return [];
-    }
-  }
 
   _emit(phase, progress, message) {
     try {
@@ -2174,7 +981,7 @@ export class WikiGenerator {
       const extSet = LanguageService.sourceExts;
       let totalSize = 0;
       const names = [];
-      this._walkDir(
+      walkDir(
         this.projectRoot,
         (filePath) => {
           const ext = path.extname(filePath);
@@ -2195,123 +1002,10 @@ export class WikiGenerator {
     }
   }
 
-  /**
-   * 遍历目录（排除 build/Pods/DerivedData 等）
-   */
-  _walkDir(dir, callback, maxFiles = 500) {
-    const excludeNames = new Set([
-      'Pods',
-      'Carthage',
-      'node_modules',
-      '.build',
-      'build',
-      'DerivedData',
-      'vendor',
-      '.git',
-      '__tests__',
-      'Tests',
-      'AutoSnippet',
-      '.cursor',
-    ]);
-    let count = 0;
-
-    const walk = (d) => {
-      if (count >= maxFiles) {
-        return;
-      }
-      let entries;
-      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;
-        }
-
-        const fullPath = path.join(d, entry.name);
-        if (entry.isDirectory()) {
-          walk(fullPath);
-        } else if (entry.isFile()) {
-          callback(fullPath);
-          count++;
-        }
-      }
-    };
-
-    walk(dir);
-  }
-
   _abortedResult() {
     return { success: false, error: 'aborted', duration: 0 };
   }
 
-  /**
-   * 从文件相对路径推断所属模块名
-   * SPM 约定: Sources/{ModuleName}/... → ModuleName
-   * 否则取第一级目录名
-   */
-  _inferModuleFromPath(filePath) {
-    const parts = filePath.split('/');
-    const sourcesIdx = parts.indexOf('Sources');
-    if (sourcesIdx >= 0 && sourcesIdx + 1 < parts.length) {
-      return parts[sourcesIdx + 1];
-    }
-    return parts.length > 1 ? parts[0] : null;
-  }
-
-  /**
-   * 获取某个 Target 对应的源文件列表
-   * 按优先级匹配: target.path → target.info.path → sourceFilesByModule[name]
-   */
-  _getModuleSourceFiles(target, projectInfo) {
-    const sfm = projectInfo.sourceFilesByModule || {};
-    const name = target.name;
-
-    // 1. 按模块名直接匹配（最常见: Sources/{name}/ 解析出的 key）
-    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)
-      );
-      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;
-      }
-    }
-
-    return [];
-  }
-}
-
-// ─── 工具函数 ────────────────────────────────────────────────
-
-function _slug(name) {
-  return name.replace(/[^a-zA-Z0-9_-]/g, '_').toLowerCase();
-}
-
-function _mermaidId(name) {
-  return name.replace(/[^a-zA-Z0-9]/g, '_');
 }
 
 export default WikiGenerator;