autosnippet 3.2.9 → 3.2.11

package/lib/service/wiki/WikiRenderers.js

@@ -1,1903 +0,0 @@
-/**
- * WikiRenderers.js — Wiki 文档渲染函数
- *
- * 从 WikiGenerator.js 中提取的 Markdown 渲染器和 AI Prompt 构建函数。
- * 所有函数均为无状态纯函数（不依赖 class 实例）。
- *
- * @module WikiRenderers
- */
-
-import path from 'node:path';
-import { LanguageService } from '../../shared/LanguageService.js';
-import {
-  getInheritanceRoots,
-  getLangTerms,
-  getModuleSourceFiles,
-  inferModulePurpose,
-  mermaidId,
-  slug,
-} from './WikiUtils.js';
-
-// Re-export BUILD_SYSTEM_MARKERS for renderGettingStarted internals
-// NOTE: BUILD_SYSTEM_MARKERS is accessed via LanguageService directly where needed
-
-// ═══ AI Prompt 构建 ════════════════════════════════════════
-
-/**
- * 为特定主题构建 AI 撰写 prompt (V3 AI-first 核心)
- *
- * 关键区别: 不是润色骨架，而是提供丰富数据让 AI 写完整文章
- *
- * @param {object} topic
- * @param {object} data - { projectInfo, astInfo, moduleInfo, knowledgeInfo }
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- * @returns {string}
- */
-export function buildArticlePrompt(topic, data, isZh, codeEntityGraph) {
-  const { projectInfo, astInfo, moduleInfo, knowledgeInfo } = data;
-  const parts = [];
-  const langTerms = getLangTerms(projectInfo.primaryLanguage || 'unknown');
-  const tl = isZh ? langTerms.typeLabel.zh : langTerms.typeLabel.en;
-  const il = isZh ? langTerms.interfaceLabel.zh : langTerms.interfaceLabel.en;
-
-  // 公共项目上下文
-  parts.push(`# 项目: ${projectInfo.name}`);
-  parts.push(
-    `源文件数: ${projectInfo.sourceFiles.length}, 模块: ${moduleInfo.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 buildTypes = (projectInfo.buildSystems || []).map((b) => b.buildTool);
-      if (projectInfo.hasPackageSwift && !buildTypes.some((t) => t.includes('SPM'))) {
-        buildTypes.push('SPM');
-      }
-      if (projectInfo.hasPodfile && !buildTypes.includes('CocoaPods')) {
-        buildTypes.push('CocoaPods');
-      }
-      if (projectInfo.hasXcodeproj) {
-        buildTypes.push('Xcode Project');
-      }
-      if (buildTypes.length > 0) {
-        parts.push(`构建系统: ${buildTypes.join(' + ')}`);
-      }
-      parts.push('');
-
-      // 模块结构
-      if (moduleInfo.targets.length > 0) {
-        parts.push('### 模块列表');
-        for (const t of moduleInfo.targets) {
-          const files = 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(
-          `${tl}: ${astInfo.overview.totalClasses || 0}, ${il}: ${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 (moduleInfo.targets.length > 0) {
-        parts.push('### 模块及依赖关系');
-        for (const t of moduleInfo.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 = getInheritanceRoots(codeEntityGraph);
-      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(`- ${tl}: ${moduleClasses.length} 个`);
-      parts.push(`- ${il}: ${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(`### ${il}列表: ${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('');
-
-      // 列出检测到的构建系统
-      const bs = projectInfo.buildSystems || [];
-      if (bs.length > 0) {
-        parts.push(`构建系统: ${bs.map((b) => b.buildTool).join(', ')}`);
-      } else {
-        // 兼容旧数据
-        if (projectInfo.hasPackageSwift) {
-          parts.push('构建系统: Swift Package Manager');
-        }
-        if (projectInfo.hasPodfile) {
-          parts.push('构建系统: CocoaPods');
-        }
-        if (projectInfo.hasXcodeproj) {
-          parts.push('构建系统: Xcode Project');
-        }
-      }
-      parts.push('');
-
-      if (moduleInfo.targets.length > 0) {
-        const mainTargets = moduleInfo.targets.filter((t) => t.type !== 'test');
-        const testTargets = moduleInfo.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(`## 任务: 撰写${il}参考文档`);
-      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} 个${il}, ${astInfo.classes.length} 个${tl}`);
-      parts.push('');
-      parts.push(
-        `要求: 撰写${il}参考文档。按模块分组，分析每个${il}的用途和意义，描述${il}之间的关系和设计意图。`
-      );
-      break;
-    }
-
-    case 'folder-overview': {
-      const profiles = topic._folderProfiles || [];
-      parts.push('## 任务: 撰写项目文件夹结构分析文档');
-      parts.push('');
-      parts.push('注意: 本项目的代码实体（类/函数/协议等）无法通过 AST 自动提取，');
-      parts.push('因此以「文件夹画像」方式进行结构分析。');
-      parts.push('');
-      parts.push(`### 发现 ${profiles.length} 个重要文件夹`);
-      parts.push('');
-      for (const fp of profiles) {
-        parts.push(`#### ${fp.relPath}`);
-        parts.push(`- 源文件: ${fp.fileCount} 个, 总大小: ${(fp.totalSize / 1024).toFixed(1)}KB`);
-        parts.push(
-          `- 语言分布: ${Object.entries(fp.langBreakdown)
-            .map(([l, c]) => `${l}(${c})`)
-            .join(', ')}`
-        );
-        if (fp.entryPoints.length > 0) {
-          parts.push(`- 入口文件: ${fp.entryPoints.join(', ')}`);
-        }
-        if (fp.namingPatterns.length > 0) {
-          parts.push(`- 命名约定: ${fp.namingPatterns.join(', ')}`);
-        }
-        if (fp.imports.length > 0) {
-          parts.push(`- 依赖引用: ${fp.imports.join(', ')}`);
-        }
-        if (fp.purpose) {
-          parts.push(`- 推断功能: ${fp.purpose.zh || fp.purpose.en || '-'}`);
-        }
-        if (fp.readme) {
-          parts.push(`- README 摘要: ${fp.readme.slice(0, 200)}`);
-        }
-        if (fp.headerComments.length > 0) {
-          parts.push(`- 代码注释: ${fp.headerComments.join('; ')}`);
-        }
-        parts.push('');
-      }
-      parts.push('要求: 撰写项目结构分析文档。');
-      parts.push('重点分析:');
-      parts.push('1. 项目整体架构分层 — 从文件夹结构推断项目架构（MVC/分层/微服务等）');
-      parts.push('2. 各文件夹的职责与协作关系 — 从文件命名和 import 关系推断');
-      parts.push('3. 用 Mermaid graph TD 画出文件夹之间的依赖关系图');
-      parts.push('4. 从命名约定分析团队编码规范');
-      parts.push('5. 对照文件夹的文件分布特征，评估项目的工程化程度');
-      break;
-    }
-
-    case 'folder-profile': {
-      const fp = topic._folderProfile;
-      parts.push(`## 任务: 撰写 "${fp.name}" 目录的深度分析文档`);
-      parts.push('');
-      parts.push('注意: 本项目的代码实体无法通过 AST 提取，以下分析基于文件夹画像。');
-      parts.push('');
-      parts.push('### 目录信息');
-      parts.push(`- 路径: ${fp.relPath}`);
-      parts.push(`- 源文件: ${fp.fileCount} 个`);
-      parts.push(`- 总大小: ${(fp.totalSize / 1024).toFixed(1)}KB`);
-      parts.push(
-        `- 语言分布: ${Object.entries(fp.langBreakdown)
-          .map(([l, c]) => `${l}(${c})`)
-          .join(', ')}`
-      );
-      parts.push('');
-
-      if (fp.entryPoints.length > 0) {
-        parts.push(`### 入口文件: ${fp.entryPoints.join(', ')}`);
-        parts.push('');
-      }
-
-      if (fp.readme) {
-        parts.push('### 目录 README');
-        parts.push(fp.readme.slice(0, 500));
-        parts.push('');
-      }
-
-      if (fp.fileNames.length > 0) {
-        parts.push(`### 文件列表 (${fp.fileNames.length} 个)`);
-        parts.push(fp.fileNames.slice(0, 40).join(', '));
-        parts.push('');
-      }
-
-      if (fp.namingPatterns.length > 0) {
-        parts.push(`### 命名约定: ${fp.namingPatterns.join(', ')}`);
-        parts.push('');
-      }
-
-      if (fp.imports.length > 0) {
-        parts.push(`### 依赖引用: ${fp.imports.join(', ')}`);
-        parts.push('');
-      }
-
-      if (fp.headerComments.length > 0) {
-        parts.push('### 关键文件注释');
-        for (const hc of fp.headerComments) {
-          parts.push(`- ${hc}`);
-        }
-        parts.push('');
-      }
-
-      parts.push('要求: 撰写该目录的深度分析文档。');
-      parts.push('包含: 目录职责推断(从文件名和注释推断)、文件组织分析、命名规范评估、');
-      parts.push('依赖关系分析(从 import 推断)、关键文件说明。');
-      parts.push('从文件命名模式推断出这个目录承担的功能角色和设计意图。');
-      break;
-    }
-  }
-
-  return parts.join('\n');
-}
-
-/**
- * 构建非 AI 降级的丰富模板内容
- * 即使没有 AI，也要产出有意义的内容 (不是只有列表罗列)
- *
- * @param {object} topic
- * @param {object} data - { projectInfo, astInfo, moduleInfo, knowledgeInfo }
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- * @returns {string}
- */
-export function buildFallbackArticle(topic, data, isZh, codeEntityGraph) {
-  const { projectInfo, astInfo, moduleInfo, knowledgeInfo } = data;
-
-  switch (topic.type) {
-    case 'overview':
-      return renderIndex(projectInfo, astInfo, moduleInfo, knowledgeInfo, isZh, topic._allTopics);
-    case 'architecture':
-      return renderArchitecture(projectInfo, astInfo, moduleInfo, isZh, codeEntityGraph);
-    case 'getting-started':
-      return renderGettingStarted(projectInfo, moduleInfo, astInfo, isZh);
-    case 'module':
-      return renderModule(topic._moduleData.target, astInfo, knowledgeInfo, isZh, projectInfo);
-    case 'patterns':
-      return renderPatterns(knowledgeInfo, isZh);
-    case 'pattern-category':
-      return renderPatternCategory(topic._patternData, isZh);
-    case 'reference':
-      return renderProtocolReference(astInfo, isZh, projectInfo);
-    case 'folder-overview':
-      return renderFolderOverview(topic._folderProfiles, projectInfo, isZh);
-    case 'folder-profile':
-      return renderFolderProfile(topic._folderProfile, projectInfo, isZh);
-    default:
-      return '';
-  }
-}
-
-// ═══ Markdown 渲染器 ═══════════════════════════════════════
-
-/**
- * 渲染项目概述页 (index.md)
- */
-export function renderIndex(project, ast, modules, knowledge, isZh, allTopics) {
-  const title = isZh ? '项目概述' : 'Project Overview';
-  const langTerms = getLangTerms(project.primaryLanguage || 'unknown');
-  const tl = isZh ? langTerms.typeLabel.zh : langTerms.typeLabel.en;
-  const il = isZh ? langTerms.interfaceLabel.zh : langTerms.interfaceLabel.en;
-
-  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('');
-
-  // 从 buildSystems 或 legacy 字段推断项目类型标签
-  const types = [];
-  if (project.buildSystems?.length > 0) {
-    for (const bs of project.buildSystems) {
-      types.push(bs.buildTool);
-    }
-  } else {
-    if (project.hasPackageSwift) {
-      types.push('SPM');
-    }
-    if (project.hasPodfile) {
-      types.push('CocoaPods');
-    }
-    if (project.hasXcodeproj) {
-      types.push('Xcode Project');
-    }
-  }
-  const projectTypeLabel =
-    types.join(' + ') ||
-    (project.primaryLanguage ? LanguageService.displayName(project.primaryLanguage) : 'Software');
-
-  const overview = ast.overview || {};
-  const mainTargets = modules.targets.filter((t) => t.type !== 'test');
-  const testTargets = modules.targets.filter((t) => t.type === 'test');
-
-  if (isZh) {
-    lines.push(
-      `**${project.name}** 是一个 ${projectTypeLabel} 项目，` +
-        `包含 ${project.sourceFiles.length} 个源文件` +
-        (overview.totalClasses ? `、${overview.totalClasses} 个${tl}` : '') +
-        (overview.totalProtocols ? `、${overview.totalProtocols} 个${il}` : '') +
-        `。`
-    );
-    if (mainTargets.length > 0) {
-      lines.push(
-        `项目由 ${mainTargets.length} 个功能模块组成` +
-          (testTargets.length > 0 ? `，配备 ${testTargets.length} 个测试模块` : '') +
-          `。`
-      );
-    }
-  } else {
-    lines.push(
-      `**${project.name}** is a ${projectTypeLabel} project ` +
-        `containing ${project.sourceFiles.length} source files` +
-        (overview.totalClasses ? `, ${overview.totalClasses} ${tl}` : '') +
-        (overview.totalProtocols ? `, ${overview.totalProtocols} ${il}` : '') +
-        `.`
-    );
-    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 (modules.targets.length > 0) {
-    lines.push(`## ${isZh ? '模块总览' : 'Module Overview'}`);
-    lines.push('');
-    lines.push(
-      `| ${isZh ? '模块' : 'Module'} | ${isZh ? '类型' : 'Type'} | ${isZh ? '源文件' : 'Files'} | ${tl} | ${il} |`
-    );
-    lines.push('|--------|------|--------|--------|----------|');
-    for (const t of modules.targets) {
-      const moduleFiles = 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('');
-  } else if (project.sourceFilesByModule && Object.keys(project.sourceFilesByModule).length >= 2) {
-    // 无 moduleService targets → 使用 sourceFilesByModule 推断的模块
-    const sfm = project.sourceFilesByModule;
-    const sorted = Object.entries(sfm).sort((a, b) => b[1].length - a[1].length);
-    lines.push(`## ${isZh ? '模块总览' : 'Module Overview'}`);
-    lines.push('');
-    lines.push(
-      isZh
-        ? `项目代码按目录结构可划分为 ${sorted.length} 个模块:`
-        : `The project code is organized into ${sorted.length} modules:`
-    );
-    lines.push('');
-    lines.push(
-      `| ${isZh ? '模块' : 'Module'} | ${isZh ? '源文件' : 'Files'} | ${isZh ? '说明' : 'Description'} |`
-    );
-    lines.push('|--------|--------|------|');
-    for (const [modName, modFiles] of sorted.slice(0, 15)) {
-      const hasDoc = allTopics?.some((tp) => tp.type === 'module' && tp.title === modName);
-      const nameCol = hasDoc ? `[${modName}](modules/${slug(modName)}.md)` : modName;
-      const purpose = inferModulePurpose(modName, [], [], modFiles);
-      const desc = purpose ? (isZh ? purpose.zh : purpose.en) : '-';
-      lines.push(`| ${nameCol} | ${modFiles.length} | ${desc} |`);
-    }
-    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(`| ${tl} | ${overview.totalClasses} |`);
-  }
-  if (overview.totalProtocols) {
-    lines.push(`| ${il} | ${overview.totalProtocols} |`);
-  }
-  if (overview.totalMethods) {
-    lines.push(`| ${isZh ? '方法总数' : 'Methods'} | ${overview.totalMethods} |`);
-  }
-  if (modules.targets.length > 0) {
-    lines.push(`| ${isZh ? '模块数' : 'Modules'} | ${modules.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');
-}
-
-/**
- * 渲染架构总览文档 (architecture.md)
- *
- * @param {object} project
- * @param {object} ast
- * @param {object} modules
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- */
-export function renderArchitecture(project, ast, modules, isZh, codeEntityGraph) {
-  const lines = [
-    `# ${isZh ? '架构总览' : 'Architecture Overview'}`,
-    '',
-    `> ${isZh ? '本文档由 AutoSnippet Repo Wiki 自动生成' : 'Auto-generated by AutoSnippet Repo Wiki'}`,
-    '',
-  ];
-
-  // 依赖图 (Mermaid)
-  if (modules.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 modules.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 (modules.depGraph) {
-      const edges = modules.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('');
-  } else if (project.sourceFilesByModule && Object.keys(project.sourceFilesByModule).length >= 2) {
-    // 无 moduleService → 从 sourceFilesByModule 推断模块结构图
-    const sfm = project.sourceFilesByModule;
-    // 只显示有实质内容的模块（>= 2 个文件），避免单文件噪声
-    const sorted = Object.entries(sfm)
-      .filter(([, files]) => files.length >= 2)
-      .sort((a, b) => b[1].length - a[1].length);
-    const topModules = sorted.slice(0, 15);
-
-    lines.push(`## ${isZh ? '模块结构图' : 'Module Structure'}`);
-    lines.push('');
-    lines.push('```mermaid');
-    lines.push('graph TD');
-    lines.push(`    Root["${project.name}"]`);
-    for (const [modName] of topModules) {
-      const sid = mermaidId(modName);
-      lines.push(`    ${sid}["${modName}"]`);
-      lines.push(`    Root --> ${sid}`);
-    }
-    lines.push('```');
-    lines.push('');
-
-    // 模块详情表
-    lines.push(`## ${isZh ? '模块详情' : 'Module Details'}`);
-    lines.push('');
-    lines.push(
-      `| ${isZh ? '模块' : 'Module'} | ${isZh ? '源文件数' : 'Files'} | ${isZh ? '说明' : 'Description'} |`
-    );
-    lines.push('|--------|-------|------|');
-    for (const [modName, modFiles] of topModules) {
-      const purpose = inferModulePurpose(modName, [], [], modFiles);
-      const desc = purpose ? (isZh ? purpose.zh : purpose.en) : '-';
-      lines.push(`| ${modName} | ${modFiles.length} | ${desc} |`);
-    }
-    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 (codeEntityGraph) {
-    try {
-      const topClasses = getInheritanceRoots(codeEntityGraph);
-      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');
-}
-
-/**
- * 渲染模块详情文档 (modules/{name}.md)
- */
-export function renderModule(target, ast, knowledge, isZh, projectInfo) {
-  const langTerms = getLangTerms(projectInfo?.primaryLanguage || 'unknown');
-  const tl = isZh ? langTerms.typeLabel.zh : langTerms.typeLabel.en;
-  const il = isZh ? langTerms.interfaceLabel.zh : langTerms.interfaceLabel.en;
-  const lines = [
-    `# ${target.name}`,
-    '',
-    `> ${isZh ? '模块文档 — 由 AutoSnippet Repo Wiki 自动生成' : 'Module doc — Auto-generated by AutoSnippet Repo Wiki'}`,
-    '',
-  ];
-
-  // 收集模块数据
-  const moduleFiles = projectInfo ? 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 = inferModulePurpose(target.name, moduleClasses, moduleProtocols, moduleFiles);
-  if (purpose) {
-    lines.push(
-      isZh
-        ? `**${target.name}** ${purpose.zh}，包含 ${moduleFiles.length} 个源文件、${moduleClasses.length} 个${tl}${moduleProtocols.length > 0 ? `、${moduleProtocols.length} 个${il}` : ''}。`
-        : `**${target.name}** ${purpose.en}, containing ${moduleFiles.length} source files, ${moduleClasses.length} ${tl}${moduleProtocols.length > 0 ? `, ${moduleProtocols.length} ${il}` : ''}.`
-    );
-  } else {
-    lines.push(
-      isZh
-        ? `**${target.name}** 是项目中的一个 ${target.type || 'target'} 模块，包含 ${moduleFiles.length} 个源文件、${moduleClasses.length} 个${tl}。`
-        : `**${target.name}** is a ${target.type || 'target'} module in the project, containing ${moduleFiles.length} source files and ${moduleClasses.length} ${tl}.`
-    );
-  }
-  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(`| ${tl} | ${moduleClasses.length} |`);
-  }
-  if (moduleProtocols.length > 0) {
-    lines.push(`| ${il} | ${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(`### ${il} (${moduleProtocols.length})`);
-      lines.push('');
-      lines.push(
-        isZh
-          ? `${target.name} 定义了 ${moduleProtocols.length} 个${il}，用于规范模块的接口边界:`
-          : `${target.name} defines ${moduleProtocols.length} ${il} 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(`### ${tl} (${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');
-}
-
-/**
- * 渲染代码模式文档 (patterns.md)
- */
-export function 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 || 'text'}`);
-        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 降级模板)
- */
-export function renderGettingStarted(project, modules, ast, isZh) {
-  const lines = [
-    `# ${isZh ? '快速上手' : 'Getting Started'}`,
-    '',
-    `> ${isZh ? '本文档由 AutoSnippet Repo Wiki 自动生成' : 'Auto-generated by AutoSnippet Repo Wiki'}`,
-    '',
-  ];
-
-  // 从 buildSystems 或 legacy 字段推断
-  const bs = project.buildSystems || [];
-  const ecoSet = new Set(bs.map((b) => b.eco));
-
-  // ── 环境要求 (按检测到的生态系统动态生成) ──
-  lines.push(`## ${isZh ? '环境要求' : 'Prerequisites'}`);
-  lines.push('');
-  if (ecoSet.has('spm') || 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+');
-    const hasCocoaPods = bs.some((b) => b.buildTool === 'CocoaPods');
-    if (hasCocoaPods || project.hasPodfile) {
-      lines.push(isZh ? '- CocoaPods 1.10+' : '- CocoaPods 1.10+');
-    }
-  }
-  if (project.hasXcodeproj) {
-    lines.push(isZh ? '- Xcode (最新稳定版)' : '- Xcode (latest stable version)');
-    // Xcode 项目额外环境提示
-    if (!ecoSet.has('spm') && !project.hasPackageSwift && !project.hasPodfile) {
-      lines.push(isZh ? '- macOS (建议最新版本)' : '- macOS (latest version recommended)');
-      lines.push(
-        isZh
-          ? '- Apple Developer Account (如需真机调试)'
-          : '- Apple Developer Account (for device testing)'
-      );
-    }
-  }
-  if (ecoSet.has('node')) {
-    lines.push(isZh ? '- Node.js 18+ (推荐 20 LTS)' : '- Node.js 18+ (20 LTS recommended)');
-    const hasYarn = bs.some((b) => b.buildTool === 'Yarn');
-    const hasPnpm = bs.some((b) => b.buildTool === 'pnpm');
-    lines.push(hasYarn ? '- Yarn' : hasPnpm ? '- pnpm' : '- npm');
-  }
-  if (ecoSet.has('python')) {
-    lines.push(isZh ? '- Python 3.8+' : '- Python 3.8+');
-    const hasPipenv = bs.some((b) => b.buildTool === 'Pipenv');
-    const hasPoetry = bs.some((b) => b.buildTool === 'Poetry');
-    if (hasPipenv) {
-      lines.push('- Pipenv');
-    } else if (hasPoetry) {
-      lines.push('- Poetry');
-    }
-  }
-  if (ecoSet.has('go')) {
-    lines.push(isZh ? '- Go 1.21+' : '- Go 1.21+');
-  }
-  if (ecoSet.has('rust')) {
-    lines.push(isZh ? '- Rust (最新 stable)' : '- Rust (latest stable)');
-    lines.push('- Cargo');
-  }
-  if (ecoSet.has('jvm')) {
-    const hasGradle = bs.some((b) => b.buildTool?.startsWith('Gradle'));
-    lines.push(isZh ? '- JDK 17+' : '- JDK 17+');
-    lines.push(hasGradle ? '- Gradle' : '- Maven');
-  }
-  if (ecoSet.has('dart')) {
-    lines.push(isZh ? '- Flutter / Dart SDK' : '- Flutter / Dart SDK');
-  }
-  if (ecoSet.has('dotnet')) {
-    lines.push(isZh ? '- .NET 6+ SDK' : '- .NET 6+ SDK');
-  }
-  if (ecoSet.has('ruby')) {
-    lines.push(isZh ? '- Ruby 3.0+' : '- Ruby 3.0+');
-    lines.push('- Bundler');
-  }
-  lines.push('');
-
-  // ── 项目目录结构 ──
-  lines.push(`## ${isZh ? '项目结构' : 'Project Structure'}`);
-  lines.push('');
-  lines.push('```');
-  lines.push(`${project.name}/`);
-  if (modules.targets.length > 0) {
-    const mainTargets = modules.targets.filter((t) => t.type !== 'test');
-    const testTargets = modules.targets.filter((t) => t.type === 'test');
-    if (mainTargets.length > 0) {
-      const srcDir = ecoSet.has('spm') || project.hasPackageSwift ? 'Sources' : 'src';
-      lines.push(`├── ${srcDir}/`);
-      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) {
-      const testDir = ecoSet.has('spm') || project.hasPackageSwift ? 'Tests' : 'test';
-      lines.push(`├── ${testDir}/`);
-      for (let i = 0; i < testTargets.length; i++) {
-        const prefix = i === testTargets.length - 1 ? '│   └──' : '│   ├──';
-        lines.push(`${prefix} ${testTargets[i].name}/`);
-      }
-    }
-  }
-  // 显示构建配置文件
-  for (const b of bs) {
-    const marker = BUILD_SYSTEM_FILES[b.buildTool];
-    if (marker) {
-      lines.push(`├── ${marker}`);
-    }
-  }
-  // legacy 兜底
-  if (bs.length === 0) {
-    if (project.hasPackageSwift) {
-      lines.push('├── Package.swift');
-    }
-    if (project.hasPodfile) {
-      lines.push('├── Podfile');
-    }
-  }
-  lines.push('```');
-  lines.push('');
-
-  // ── 构建步骤 (按检测到的生态系统动态生成) ──
-  lines.push(`## ${isZh ? '构建与运行' : 'Build & Run'}`);
-  lines.push('');
-
-  for (const b of bs) {
-    _pushBuildSteps(lines, b, project.name, isZh);
-  }
-
-  // legacy 兜底 — 如果没有检测到 buildSystems
-  if (bs.length === 0) {
-    if (project.hasPackageSwift) {
-      _pushBuildSteps(lines, { eco: 'spm', buildTool: 'SPM' }, project.name, isZh);
-    }
-    if (project.hasPodfile) {
-      _pushBuildSteps(lines, { eco: 'spm', buildTool: 'CocoaPods' }, project.name, isZh);
-    }
-    // Xcode 项目兜底 (无 SPM / CocoaPods)
-    if (!project.hasPackageSwift && !project.hasPodfile && project.hasXcodeproj) {
-      _pushBuildSteps(lines, { eco: 'xcode', buildTool: 'Xcode' }, project.name, isZh);
-    }
-  }
-
-  // ── 源文件统计 (增强无 moduleService 场景) ──
-  if (modules.targets.length === 0 && project.sourceFilesByModule) {
-    const sfm = project.sourceFilesByModule;
-    const modEntries = Object.entries(sfm).sort((a, b) => b[1].length - a[1].length);
-    if (modEntries.length > 0) {
-      lines.push(`## ${isZh ? '项目模块概览' : 'Module Overview'}`);
-      lines.push('');
-      lines.push(
-        `| ${isZh ? '模块' : 'Module'} | ${isZh ? '源文件数' : 'Files'} | ${isZh ? '说明' : 'Description'} |`
-      );
-      lines.push('|--------|-------|------|');
-      for (const [modName, modFiles] of modEntries.slice(0, 15)) {
-        const purpose = inferModulePurpose(modName, [], [], modFiles);
-        const desc = purpose ? (isZh ? purpose.zh : purpose.en) : '-';
-        lines.push(`| ${modName} | ${modFiles.length} | ${desc} |`);
-      }
-      lines.push('');
-    }
-  }
-
-  // ── 模块说明 ──
-  if (modules.targets.length > 0) {
-    const mainTargets = modules.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 = 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');
-}
-
-/* 构建配置文件名映射 (用于目录树显示) — 从 LanguageService.buildSystemMarkers 动态派生 */
-const BUILD_SYSTEM_FILES = Object.fromEntries(
-  LanguageService.buildSystemMarkers.map((m) => [m.buildTool, m.file])
-);
-
-/**
- * 按生态系统输出构建步骤
- * @private
- */
-function _pushBuildSteps(lines, buildSys, projectName, isZh) {
-  const { eco, buildTool } = buildSys;
-
-  lines.push(`### ${isZh ? `使用 ${buildTool}` : `Using ${buildTool}`}`);
-  lines.push('');
-  lines.push('```bash');
-  lines.push(isZh ? '# 获取项目' : '# Clone the project');
-  lines.push(`git clone <repository-url>`);
-  lines.push(`cd ${projectName}`);
-  lines.push('');
-
-  switch (eco) {
-    case 'spm':
-      if (buildTool === 'CocoaPods') {
-        lines.push('pod install');
-        lines.push('open *.xcworkspace');
-      } else {
-        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');
-      }
-      break;
-    case 'node':
-      if (buildTool === 'Yarn') {
-        lines.push('yarn install');
-        lines.push('yarn build');
-        lines.push('yarn test');
-      } else if (buildTool === 'pnpm') {
-        lines.push('pnpm install');
-        lines.push('pnpm build');
-        lines.push('pnpm test');
-      } else {
-        lines.push('npm install');
-        lines.push('npm run build');
-        lines.push('npm test');
-      }
-      break;
-    case 'python':
-      if (buildTool === 'Poetry') {
-        lines.push('poetry install');
-        lines.push('poetry run pytest');
-      } else if (buildTool === 'Pipenv') {
-        lines.push('pipenv install');
-        lines.push('pipenv run pytest');
-      } else {
-        lines.push('pip install -r requirements.txt');
-        lines.push('pytest');
-      }
-      break;
-    case 'go':
-      lines.push('go mod download');
-      lines.push('go build ./...');
-      lines.push('go test ./...');
-      break;
-    case 'rust':
-      lines.push('cargo build');
-      lines.push('cargo test');
-      break;
-    case 'jvm':
-      if (buildTool?.startsWith('Gradle')) {
-        lines.push('./gradlew build');
-        lines.push('./gradlew test');
-      } else {
-        lines.push('mvn install');
-        lines.push('mvn test');
-      }
-      break;
-    case 'dart':
-      lines.push('flutter pub get');
-      lines.push('flutter run');
-      lines.push('flutter test');
-      break;
-    case 'dotnet':
-      lines.push('dotnet restore');
-      lines.push('dotnet build');
-      lines.push('dotnet test');
-      break;
-    case 'ruby':
-      lines.push('bundle install');
-      break;
-    case 'xcode':
-      lines.push(isZh ? '# 使用 Xcode 打开项目' : '# Open with Xcode');
-      lines.push(`open *.xcodeproj 2>/dev/null || open *.xcworkspace`);
-      lines.push('');
-      lines.push(isZh ? '# 或通过命令行构建' : '# Or build via command line');
-      lines.push(`xcodebuild -project *.xcodeproj -scheme ${projectName} build`);
-      break;
-    default:
-      lines.push(isZh ? '# 请查阅项目 README' : '# Please refer to the project README');
-      break;
-  }
-
-  lines.push('```');
-  lines.push('');
-}
-
-/**
- * 按分类拆分的代码模式文档
- */
-export function 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');
-}
-
-/**
- * 协议参考文档
- */
-export function renderProtocolReference(ast, isZh, projectInfo) {
-  const langTerms = getLangTerms(projectInfo?.primaryLanguage || 'unknown');
-  const il = isZh ? langTerms.interfaceLabel.zh : langTerms.interfaceLabel.en;
-
-  const lines = [
-    `# ${isZh ? `${il}参考` : `${il} Reference`}`,
-    '',
-    `> ${isZh ? `项目中定义的 ${ast.protocols.length} 个${il}` : `${ast.protocols.length} ${il} defined in the project`}`,
-    '',
-  ];
-
-  lines.push(
-    isZh
-      ? `${il}定义了类型需要遵循的接口契约。本项目共定义了 ${ast.protocols.length} 个${il}，以下按模块分组展示。`
-      : `${il} define interface contracts that types must conform to. This project defines ${ast.protocols.length} ${il}, 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} 个${il}:`
-        : `${mod} module defines ${protos.length} ${il}:`
-    );
-    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 ? `其他${il}` : `Other ${il}`}`);
-    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');
-}
-
-// ═══ Folder Profile 渲染器 (AST 不可用时的降级策略) ═══════
-
-/**
- * 渲染文件夹结构总览 (folder-structure.md)
- *
- * @param {import('./WikiUtils.js').FolderProfile[]} profiles
- * @param {object} projectInfo
- * @param {boolean} isZh
- * @returns {string}
- */
-export function renderFolderOverview(profiles, projectInfo, isZh) {
-  const lines = [
-    `# ${isZh ? '项目结构分析' : 'Project Structure Analysis'}`,
-    '',
-    `> ${isZh ? '本文档由 AutoSnippet Repo Wiki 自动生成（基于文件夹画像分析）' : 'Auto-generated by AutoSnippet Repo Wiki (folder profiling mode)'}`,
-    '',
-  ];
-
-  // 说明为什么是文件夹分析模式
-  lines.push(
-    isZh
-      ? `> 💡 本项目的主要语言 (${LanguageService.displayName(projectInfo.primaryLanguage)}) 暂不支持深度 AST 解析，因此使用文件夹画像分析来代替。`
-      : `> 💡 The project's primary language (${LanguageService.displayName(projectInfo.primaryLanguage)}) does not support deep AST analysis yet, so folder profiling is used instead.`
-  );
-  lines.push('');
-
-  // ── 结构鸟瞰 (Mermaid) ──
-  lines.push(`## ${isZh ? '结构鸟瞰' : 'Structure Overview'}`);
-  lines.push('');
-  lines.push('```mermaid');
-  lines.push('graph TD');
-  lines.push(`    Root["${projectInfo.name}"]`);
-
-  // 只显示深度 = 1 的顶层文件夹
-  const topLevel = profiles.filter((fp) => fp.depth === 1);
-
-  for (const fp of topLevel) {
-    const sid = mermaidId(fp.name);
-    lines.push(`    ${sid}["${fp.name} (${fp.fileCount})"]`);
-    lines.push(`    Root --> ${sid}`);
-  }
-
-  // 画 import 关系边
-  const folderNames = new Set(profiles.map((fp) => fp.name));
-  for (const fp of profiles) {
-    const fromId = mermaidId(fp.name);
-    for (const imp of fp.imports) {
-      if (folderNames.has(imp) && imp !== fp.name) {
-        lines.push(`    ${fromId} -.-> ${mermaidId(imp)}`);
-      }
-    }
-  }
-
-  lines.push('```');
-  lines.push('');
-
-  // ── 文件夹总览表 ──
-  lines.push(`## ${isZh ? '文件夹总览' : 'Folder Overview'}`);
-  lines.push('');
-  lines.push(
-    `| ${isZh ? '文件夹' : 'Folder'} | ${isZh ? '路径' : 'Path'} | ${isZh ? '文件数' : 'Files'} | ${isZh ? '大小' : 'Size'} | ${isZh ? '语言' : 'Languages'} | ${isZh ? '说明' : 'Description'} |`
-  );
-  lines.push('|--------|------|-------|------|------|------|');
-
-  for (const fp of profiles) {
-    const hasDoc = fp.fileCount >= 5;
-    const folderDocSlug = slug(fp.relPath.replaceAll('/', '-'));
-    const nameCol = hasDoc ? `[${fp.relPath}](folders/${folderDocSlug}.md)` : fp.relPath;
-    const sizeStr =
-      fp.totalSize > 1024 * 1024
-        ? `${(fp.totalSize / 1024 / 1024).toFixed(1)}MB`
-        : `${(fp.totalSize / 1024).toFixed(1)}KB`;
-    const langs = Object.entries(fp.langBreakdown)
-      .sort((a, b) => b[1] - a[1])
-      .slice(0, 3)
-      .map(([l]) => l)
-      .join(', ');
-    const desc = fp.purpose ? (isZh ? fp.purpose.zh : fp.purpose.en) : '-';
-    lines.push(
-      `| ${nameCol} | \`${fp.relPath}\` | ${fp.fileCount} | ${sizeStr} | ${langs} | ${desc} |`
-    );
-  }
-  lines.push('');
-
-  // ── 命名约定总结 ──
-  const allPatterns = {};
-  for (const fp of profiles) {
-    for (const p of fp.namingPatterns) {
-      allPatterns[p] = (allPatterns[p] || 0) + 1;
-    }
-  }
-  const commonPatterns = Object.entries(allPatterns)
-    .filter(([, c]) => c >= 2)
-    .sort((a, b) => b[1] - a[1]);
-
-  if (commonPatterns.length > 0) {
-    lines.push(`## ${isZh ? '命名约定' : 'Naming Conventions'}`);
-    lines.push('');
-    lines.push(
-      isZh
-        ? '通过分析文件命名模式，检测到以下在多个文件夹中出现的约定:'
-        : 'The following naming conventions were detected across multiple folders:'
-    );
-    lines.push('');
-    for (const [pattern, count] of commonPatterns) {
-      lines.push(
-        `- **${pattern}** — ${isZh ? `出现在 ${count} 个文件夹` : `found in ${count} folders`}`
-      );
-    }
-    lines.push('');
-  }
-
-  // ── 依赖关系 ──
-  const allImports = [];
-  for (const fp of profiles) {
-    for (const imp of fp.imports) {
-      if (folderNames.has(imp) && imp !== fp.name) {
-        allImports.push({ from: fp.name, to: imp });
-      }
-    }
-  }
-
-  if (allImports.length > 0) {
-    lines.push(`## ${isZh ? '文件夹间依赖' : 'Inter-Folder Dependencies'}`);
-    lines.push('');
-    lines.push(
-      isZh
-        ? '通过分析 import/require 语句推断的文件夹间引用关系:'
-        : 'Dependencies between folders inferred from import/require statements:'
-    );
-    lines.push('');
-    for (const dep of allImports) {
-      lines.push(`- \`${dep.from}\` → \`${dep.to}\``);
-    }
-    lines.push('');
-  }
-
-  lines.push(`[← ${isZh ? '返回概述' : 'Back to Overview'}](index.md)`);
-  lines.push('');
-  return lines.join('\n');
-}
-
-/**
- * 渲染单个文件夹的深度画像文档 (folders/{name}.md)
- *
- * @param {import('./WikiUtils.js').FolderProfile} fp
- * @param {object} projectInfo
- * @param {boolean} isZh
- * @returns {string}
- */
-export function renderFolderProfile(fp, projectInfo, isZh) {
-  const lines = [
-    `# ${fp.name}`,
-    '',
-    `> ${isZh ? '文件夹画像文档 — 由 AutoSnippet Repo Wiki 自动生成' : 'Folder profile doc — Auto-generated by AutoSnippet Repo Wiki'}`,
-    '',
-  ];
-
-  // ── 概述 ──
-  lines.push(`## ${isZh ? '概述' : 'Overview'}`);
-  lines.push('');
-
-  const purposeStr = fp.purpose
-    ? isZh
-      ? fp.purpose.zh
-      : fp.purpose.en
-    : isZh
-      ? '通过文件夹画像分析推断其功能'
-      : 'functionality inferred from folder profiling';
-
-  if (isZh) {
-    lines.push(
-      `**${fp.name}** 位于 \`${fp.relPath}\`，${purposeStr}。` +
-        `包含 ${fp.fileCount} 个源文件，总大小 ${(fp.totalSize / 1024).toFixed(1)}KB。`
-    );
-  } else {
-    lines.push(
-      `**${fp.name}** is located at \`${fp.relPath}\`, ${purposeStr}. ` +
-        `Contains ${fp.fileCount} source files totaling ${(fp.totalSize / 1024).toFixed(1)}KB.`
-    );
-  }
-  lines.push('');
-
-  // ── 信息表 ──
-  lines.push(`| ${isZh ? '属性' : 'Property'} | ${isZh ? '值' : 'Value'} |`);
-  lines.push('|--------|------|');
-  lines.push(`| ${isZh ? '路径' : 'Path'} | \`${fp.relPath}\` |`);
-  lines.push(`| ${isZh ? '源文件数' : 'Source Files'} | ${fp.fileCount} |`);
-  const sizeStr =
-    fp.totalSize > 1024 * 1024
-      ? `${(fp.totalSize / 1024 / 1024).toFixed(1)}MB`
-      : `${(fp.totalSize / 1024).toFixed(1)}KB`;
-  lines.push(`| ${isZh ? '总大小' : 'Total Size'} | ${sizeStr} |`);
-  if (fp.entryPoints.length > 0) {
-    lines.push(`| ${isZh ? '入口文件' : 'Entry Points'} | ${fp.entryPoints.join(', ')} |`);
-  }
-  lines.push('');
-
-  // ── README (如果有) ──
-  if (fp.readme) {
-    lines.push(`## ${isZh ? '目录说明' : 'Directory README'}`);
-    lines.push('');
-    lines.push(
-      `> ${fp.readme
-        .split('\n')
-        .filter((l) => l.trim())
-        .slice(0, 5)
-        .join('\n> ')}`
-    );
-    lines.push('');
-  }
-
-  // ── 语言分布 ──
-  lines.push(`## ${isZh ? '语言分布' : 'Language Distribution'}`);
-  lines.push('');
-  lines.push(
-    `| ${isZh ? '语言' : 'Language'} | ${isZh ? '文件数' : 'Files'} | ${isZh ? '占比' : 'Share'} |`
-  );
-  lines.push('|--------|-------|------|');
-  const total = Object.values(fp.langBreakdown).reduce((a, b) => a + b, 0);
-  for (const [lang, count] of Object.entries(fp.langBreakdown).sort((a, b) => b[1] - a[1])) {
-    const pct = total > 0 ? ((count / total) * 100).toFixed(0) : 0;
-    lines.push(`| ${lang} | ${count} | ${pct}% |`);
-  }
-  lines.push('');
-
-  // ── 文件列表 (分类展示) ──
-  lines.push(`## ${isZh ? '文件列表' : 'File Listing'}`);
-  lines.push('');
-
-  // 按类别分: 入口文件 / 大文件 / 普通文件
-  if (fp.entryPoints.length > 0) {
-    lines.push(`### ${isZh ? '🎯 入口文件' : '🎯 Entry Points'}`);
-    lines.push('');
-    for (const ep of fp.entryPoints) {
-      lines.push(`- \`${ep}\``);
-    }
-    lines.push('');
-  }
-
-  if (fp.keyFiles.length > 0) {
-    lines.push(`### ${isZh ? '📌 关键文件' : '📌 Key Files'}`);
-    lines.push('');
-    lines.push(
-      isZh
-        ? '以下文件体积最大或作为入口文件，可能包含核心逻辑:'
-        : 'These files are the largest or serve as entry points, likely containing core logic:'
-    );
-    lines.push('');
-    for (const kf of fp.keyFiles) {
-      lines.push(`- \`${path.basename(kf)}\``);
-    }
-    lines.push('');
-  }
-
-  // 所有文件列表 (截断)
-  const maxDisplay = 50;
-  lines.push(`### ${isZh ? '全部文件' : 'All Files'} (${fp.fileNames.length})`);
-  lines.push('');
-  for (const fn of fp.fileNames.slice(0, maxDisplay)) {
-    lines.push(`- \`${fn}\``);
-  }
-  if (fp.fileNames.length > maxDisplay) {
-    lines.push(
-      `- ... ${isZh ? `还有 ${fp.fileNames.length - maxDisplay} 个文件` : `and ${fp.fileNames.length - maxDisplay} more files`}`
-    );
-  }
-  lines.push('');
-
-  // ── 命名约定 ──
-  if (fp.namingPatterns.length > 0) {
-    lines.push(`## ${isZh ? '命名约定' : 'Naming Conventions'}`);
-    lines.push('');
-    lines.push(
-      isZh
-        ? '通过分析文件命名模式，检测到以下约定:'
-        : 'Detected naming conventions from file name analysis:'
-    );
-    lines.push('');
-    for (const p of fp.namingPatterns) {
-      lines.push(`- **${p}**`);
-    }
-    lines.push('');
-  }
-
-  // ── 依赖关系 ──
-  if (fp.imports.length > 0) {
-    lines.push(`## ${isZh ? '依赖引用' : 'Dependencies'}`);
-    lines.push('');
-    lines.push(
-      isZh
-        ? `通过分析 import/require 语句，\`${fp.name}\` 引用了以下模块/目录:`
-        : `From import/require analysis, \`${fp.name}\` references the following modules/directories:`
-    );
-    lines.push('');
-    for (const imp of fp.imports) {
-      lines.push(`- \`${imp}\``);
-    }
-    lines.push('');
-  }
-
-  // ── 代码注释摘要 ──
-  if (fp.headerComments.length > 0) {
-    lines.push(`## ${isZh ? '代码注释摘要' : 'Code Comments Summary'}`);
-    lines.push('');
-    lines.push(
-      isZh ? '从关键文件头部提取的注释信息:' : 'Comments extracted from key file headers:'
-    );
-    lines.push('');
-    for (const hc of fp.headerComments) {
-      lines.push(`- ${hc}`);
-    }
-    lines.push('');
-  }
-
-  lines.push(
-    `[← ${isZh ? '返回结构分析' : 'Back to Structure Analysis'}](../folder-structure.md) | [← ${isZh ? '返回概述' : 'Back to Overview'}](../index.md)`
-  );
-  lines.push('');
-  return lines.join('\n');
-}
-
-// ═══ V3 AI 系统 Prompt ═══════════════════════════════════
-
-/**
- * 构建 AI 系统 Prompt (V3 — 撰写完整文章，非润色骨架)
- */
-export function 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');
-}