autosnippet 3.0.13 → 3.1.1

package/lib/service/wiki/WikiGenerator.js

@@ -35,22 +35,17 @@ import fs from 'node:fs';
 import path from 'node:path';
 import Logger from '../../infrastructure/logging/Logger.js';
 import { LanguageService } from '../../shared/LanguageService.js';
+import { buildAiSystemPrompt, buildArticlePrompt, buildFallbackArticle } from './WikiRenderers.js';
 import {
-  slug,
-  walkDir,
-  inferModuleFromPath,
-  getModuleSourceFiles,
-  getInheritanceRoots,
   dedup,
   detectBuildSystems,
   getLangTerms,
+  getModuleSourceFiles,
+  inferModuleFromPath,
   profileFolders,
+  slug,
+  walkDir,
 } from './WikiUtils.js';
-import {
-  buildArticlePrompt,
-  buildFallbackArticle,
-  buildAiSystemPrompt,
-} from './WikiRenderers.js';
 
 const logger = Logger.getInstance();
 
@@ -260,10 +255,10 @@ export class WikiGenerator {
       name: path.basename(this.projectRoot),
       root: this.projectRoot,
       // 通用构建系统检测（替代硬编码 iOS 三件套）
-      buildSystems: [],   // [{eco, buildTool}]
+      buildSystems: [], // [{eco, buildTool}]
       sourceFiles: [],
       languages: {},
-      langProfile: null,  // LanguageService.detectProfile() 结果
+      langProfile: null, // LanguageService.detectProfile() 结果
       primaryLanguage: 'unknown',
       // 保留向后兼容字段
       hasPackageSwift: false,
@@ -341,7 +336,11 @@ export class WikiGenerator {
     info.langProfile = LanguageService.detectProfile(bareStats);
     info.primaryLanguage = info.langProfile.primary;
 
-    this._emit(WikiPhase.SCAN, 12, `发现 ${info.sourceFiles.length} 个源文件 (${LanguageService.displayName(info.primaryLanguage)})`);
+    this._emit(
+      WikiPhase.SCAN,
+      12,
+      `发现 ${info.sourceFiles.length} 个源文件 (${LanguageService.displayName(info.primaryLanguage)})`
+    );
     return info;
   }
 
@@ -488,7 +487,8 @@ export class WikiGenerator {
     // ── 2. 架构概览 (需要模块/依赖关系) ──
     const moduleKeys = Object.keys(astInfo.classNamesByModule || {});
     const sourceModuleKeys = Object.keys(projectInfo.sourceFilesByModule || {});
-    const hasMultiModule = moduleInfo.targets.length >= 2 || moduleKeys.length >= 2 || sourceModuleKeys.length >= 2;
+    const hasMultiModule =
+      moduleInfo.targets.length >= 2 || moduleKeys.length >= 2 || sourceModuleKeys.length >= 2;
     const hasDepGraph = moduleInfo.depGraph != null;
     const hasInheritance = this.codeEntityGraph != null;
 
@@ -506,7 +506,9 @@ export class WikiGenerator {
     const hasEntryPoints = (astInfo.overview?.entryPoints?.length || 0) > 0;
     const hasBuildSystem =
       projectInfo.buildSystems.length > 0 ||
-      projectInfo.hasPackageSwift || projectInfo.hasPodfile || projectInfo.hasXcodeproj;
+      projectInfo.hasPackageSwift ||
+      projectInfo.hasPodfile ||
+      projectInfo.hasXcodeproj;
 
     if (hasEntryPoints || hasBuildSystem) {
       topics.push({
@@ -520,8 +522,7 @@ export class WikiGenerator {
 
     // ── 4. 模块深度文档 (仅对实质性模块生成) ──
     const discoverers = moduleInfo.projectInfo?.discoverers || [];
-    const genericOnlyDiscovery =
-      discoverers.length === 1 && discoverers[0]?.id === 'generic';
+    const genericOnlyDiscovery = discoverers.length === 1 && discoverers[0]?.id === 'generic';
     const monolithSingleTarget =
       moduleInfo.targets.length === 1 &&
       (moduleInfo.targets[0]?.path === projectInfo.root ||
@@ -560,11 +561,15 @@ export class WikiGenerator {
       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;
+        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;
+        if (richness < 3) {
+          continue;
+        }
         topics.push({
           id: `module-${slug(modName)}`,
           path: `modules/${slug(modName)}.md`,
@@ -634,14 +639,19 @@ export class WikiGenerator {
       });
     }
 
-    // ── 7. 文件夹画像文档 (AST 稀疏项目的降级策略) ──
-    //   当 AST 无法提取足够的 类/函数/协议 时，转为文件夹级分析
+    // ── 7. 文件夹画像文档 ──
+    //   触发条件 (满足任一即启用):
+    //   a) AST 稀疏: 类/协议 < 5 且无模块文档
+    //   b) generic monolith: 仅 generic discoverer + 单 target + 多目录
+    //   c) 核心文章过少: 当前主题 ≤ 4 篇 → 用文件夹分析补充内容丰富度
     const astEntityCount = (astInfo.classes?.length || 0) + (astInfo.protocols?.length || 0);
-    const hasModuleDocs = topics.some(t => t.type === 'module');
+    const hasModuleDocs = topics.some((t) => t.type === 'module');
     const astSparse = astEntityCount < 5 && !hasModuleDocs;
     const shouldProfileForGenericMonolith =
       genericOnlyDiscovery && monolithSingleTarget && sourceModuleKeys.length >= 2;
-    const shouldEnableFolderProfiling = astSparse || shouldProfileForGenericMonolith;
+    const tooFewCoreArticles = topics.length <= 4 && sourceModuleKeys.length >= 2;
+    const shouldEnableFolderProfiling =
+      astSparse || shouldProfileForGenericMonolith || tooFewCoreArticles;
 
     if (shouldEnableFolderProfiling) {
       const rawFolderProfiles = profileFolders(projectInfo, {
@@ -676,18 +686,25 @@ export class WikiGenerator {
         const MAX_FOLDER_DOCS = 10;
         let folderDocCount = 0;
         for (const fp of folderProfiles) {
-          if (folderDocCount >= MAX_FOLDER_DOCS) break;
-          if (fp.fileCount < 5) continue;
+          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; // 过于单薄的文件夹不值得独立文档
+          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}`,
@@ -700,10 +717,14 @@ export class WikiGenerator {
           folderDocCount++;
         }
 
-        const folderProfileReason = astSparse ? 'AST sparse' : 'generic monolith';
+        const folderProfileReason = astSparse
+          ? 'AST sparse'
+          : tooFewCoreArticles
+            ? `few core articles (${topics.length - topics.filter((t) => t.type === 'folder-overview' || t.type === 'folder-profile').length} core)`
+            : 'generic monolith';
         logger.info(
           `[WikiGenerator] Folder profiling (${folderProfileReason}): ${folderProfiles.length} folders analyzed, ` +
-            `${topics.filter(t => t.type === 'folder-profile').length} folder docs planned`
+            `${topics.filter((t) => t.type === 'folder-profile').length} folder docs planned`
         );
       }
     }
@@ -809,7 +830,10 @@ export class WikiGenerator {
 
       // 写入文件
       const fileInfo = this._writeFile(topic.path, content);
-      if (composed > 0 && content !== buildFallbackArticle(topic, structuredData, isZh, this.codeEntityGraph)) {
+      if (
+        composed > 0 &&
+        content !== buildFallbackArticle(topic, structuredData, isZh, this.codeEntityGraph)
+      ) {
         fileInfo.polished = true;
       }
       files.push(fileInfo);
@@ -823,9 +847,14 @@ export class WikiGenerator {
       let overviewContent = null;
       // overview 始终存在于 files 中（因为 priority 最高且始终生成）
       // 重新用实际 writtenTopics 渲染
-      overviewContent = buildFallbackArticle(overviewTopic, structuredData, isZh, this.codeEntityGraph);
+      overviewContent = buildFallbackArticle(
+        overviewTopic,
+        structuredData,
+        isZh,
+        this.codeEntityGraph
+      );
       // 如果之前 AI compose 过 overview，保留 AI 版本（AI 版本已在初次写入时处理导航）
-      const overviewFile = files.find(f => f.path === overviewTopic.path);
+      const overviewFile = files.find((f) => f.path === overviewTopic.path);
       if (overviewFile && !overviewFile.polished && overviewContent) {
         this._writeFile(overviewTopic.path, overviewContent);
       }
@@ -910,7 +939,6 @@ export class WikiGenerator {
     }
   }
 
-
   _emit(phase, progress, message) {
     try {
       this.onProgress(phase, progress, message);
@@ -1005,7 +1033,6 @@ export class WikiGenerator {
   _abortedResult() {
     return { success: false, error: 'aborted', duration: 0 };
   }
-
 }
 
 export default WikiGenerator;

package/lib/service/wiki/WikiRenderers.js

@@ -10,16 +10,16 @@
 import path from 'node:path';
 import { LanguageService } from '../../shared/LanguageService.js';
 import {
-  slug,
-  mermaidId,
-  getModuleSourceFiles,
   getInheritanceRoots,
-  inferModulePurpose,
   getLangTerms,
+  getModuleSourceFiles,
+  inferModulePurpose,
+  mermaidId,
+  slug,
 } from './WikiUtils.js';
 
 // Re-export BUILD_SYSTEM_MARKERS for renderGettingStarted internals
-import { BUILD_SYSTEM_MARKERS } from './WikiUtils.js';
+// NOTE: BUILD_SYSTEM_MARKERS is accessed via LanguageService directly where needed
 
 // ═══ AI Prompt 构建 ════════════════════════════════════════
 
@@ -193,9 +193,7 @@ export function buildArticlePrompt(topic, data, isZh, codeEntityGraph) {
       parts.push('');
 
       if (deps.length > 0) {
-        parts.push(
-          `### 依赖: ${deps.map((d) => (typeof d === 'string' ? d : d.name)).join(', ')}`
-        );
+        parts.push(`### 依赖: ${deps.map((d) => (typeof d === 'string' ? d : d.name)).join(', ')}`);
         parts.push('');
       }
 
@@ -255,9 +253,15 @@ export function buildArticlePrompt(topic, data, isZh, codeEntityGraph) {
         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');
+        if (projectInfo.hasPackageSwift) {
+          parts.push('构建系统: Swift Package Manager');
+        }
+        if (projectInfo.hasPodfile) {
+          parts.push('构建系统: CocoaPods');
+        }
+        if (projectInfo.hasXcodeproj) {
+          parts.push('构建系统: Xcode Project');
+        }
       }
       parts.push('');
 
@@ -370,9 +374,7 @@ export function buildArticlePrompt(topic, data, isZh, codeEntityGraph) {
         }
       }
       parts.push('');
-      parts.push(
-        `总计: ${astInfo.protocols.length} 个${il}, ${astInfo.classes.length} 个${tl}`
-      );
+      parts.push(`总计: ${astInfo.protocols.length} 个${il}, ${astInfo.classes.length} 个${tl}`);
       parts.push('');
       parts.push(
         `要求: 撰写${il}参考文档。按模块分组，分析每个${il}的用途和意义，描述${il}之间的关系和设计意图。`
@@ -392,7 +394,11 @@ export function buildArticlePrompt(topic, data, isZh, codeEntityGraph) {
       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(', ')}`);
+        parts.push(
+          `- 语言分布: ${Object.entries(fp.langBreakdown)
+            .map(([l, c]) => `${l}(${c})`)
+            .join(', ')}`
+        );
         if (fp.entryPoints.length > 0) {
           parts.push(`- 入口文件: ${fp.entryPoints.join(', ')}`);
         }
@@ -433,7 +439,11 @@ export function buildArticlePrompt(topic, data, isZh, codeEntityGraph) {
       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(
+        `- 语言分布: ${Object.entries(fp.langBreakdown)
+          .map(([l, c]) => `${l}(${c})`)
+          .join(', ')}`
+      );
       parts.push('');
 
       if (fp.entryPoints.length > 0) {
@@ -497,26 +507,13 @@ export function buildFallbackArticle(topic, data, isZh, codeEntityGraph) {
 
   switch (topic.type) {
     case 'overview':
-      return renderIndex(
-        projectInfo,
-        astInfo,
-        moduleInfo,
-        knowledgeInfo,
-        isZh,
-        topic._allTopics
-      );
+      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
-      );
+      return renderModule(topic._moduleData.target, astInfo, knowledgeInfo, isZh, projectInfo);
     case 'patterns':
       return renderPatterns(knowledgeInfo, isZh);
     case 'pattern-category':
@@ -562,11 +559,19 @@ export function renderIndex(project, ast, modules, knowledge, isZh, allTopics) {
       types.push(bs.buildTool);
     }
   } else {
-    if (project.hasPackageSwift) types.push('SPM');
-    if (project.hasPodfile) types.push('CocoaPods');
-    if (project.hasXcodeproj) types.push('Xcode Project');
+    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 projectTypeLabel =
+    types.join(' + ') ||
+    (project.primaryLanguage ? LanguageService.displayName(project.primaryLanguage) : 'Software');
 
   const overview = ast.overview || {};
   const mainTargets = modules.targets.filter((t) => t.type !== 'test');
@@ -632,9 +637,10 @@ export function renderIndex(project, ast, modules, knowledge, isZh, allTopics) {
     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(
+      isZh
+        ? `项目代码按目录结构可划分为 ${sorted.length} 个模块:`
+        : `The project code is organized into ${sorted.length} modules:`
     );
     lines.push('');
     lines.push(
@@ -642,9 +648,7 @@ export function renderIndex(project, ast, modules, knowledge, isZh, allTopics) {
     );
     lines.push('|--------|--------|------|');
     for (const [modName, modFiles] of sorted.slice(0, 15)) {
-      const hasDoc = allTopics?.some(
-        (tp) => tp.type === 'module' && tp.title === modName
-      );
+      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) : '-';
@@ -738,9 +742,7 @@ export function renderArchitecture(project, ast, modules, isZh, codeEntityGraph)
       const sid = mermaidId(target.name);
       if (!rendered.has(sid)) {
         const shape =
-          target.type === 'test'
-            ? `${sid}[["${target.name} (Test)"]]`
-            : `${sid}["${target.name}"]`;
+          target.type === 'test' ? `${sid}[["${target.name} (Test)"]]` : `${sid}["${target.name}"]`;
         lines.push(`    ${shape}`);
         rendered.add(sid);
       }
@@ -876,12 +878,7 @@ export function renderModule(target, ast, knowledge, isZh, projectInfo) {
   lines.push('');
 
   // 推断模块功能 (基于名称和内容)
-  const purpose = inferModulePurpose(
-    target.name,
-    moduleClasses,
-    moduleProtocols,
-    moduleFiles
-  );
+  const purpose = inferModulePurpose(target.name, moduleClasses, moduleProtocols, moduleFiles);
   if (purpose) {
     lines.push(
       isZh
@@ -1153,7 +1150,11 @@ export function renderGettingStarted(project, modules, ast, isZh) {
     // 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)');
+      lines.push(
+        isZh
+          ? '- Apple Developer Account (如需真机调试)'
+          : '- Apple Developer Account (for device testing)'
+      );
     }
   }
   if (ecoSet.has('node')) {
@@ -1166,8 +1167,11 @@ export function renderGettingStarted(project, modules, ast, isZh) {
     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 (hasPipenv) {
+      lines.push('- Pipenv');
+    } else if (hasPoetry) {
+      lines.push('- Poetry');
+    }
   }
   if (ecoSet.has('go')) {
     lines.push(isZh ? '- Go 1.21+' : '- Go 1.21+');
@@ -1222,12 +1226,18 @@ export function renderGettingStarted(project, modules, ast, isZh) {
   // 显示构建配置文件
   for (const b of bs) {
     const marker = BUILD_SYSTEM_FILES[b.buildTool];
-    if (marker) lines.push(`├── ${marker}`);
+    if (marker) {
+      lines.push(`├── ${marker}`);
+    }
   }
   // legacy 兜底
   if (bs.length === 0) {
-    if (project.hasPackageSwift) lines.push('├── Package.swift');
-    if (project.hasPodfile) lines.push('├── Podfile');
+    if (project.hasPackageSwift) {
+      lines.push('├── Package.swift');
+    }
+    if (project.hasPodfile) {
+      lines.push('├── Podfile');
+    }
   }
   lines.push('```');
   lines.push('');
@@ -1560,8 +1570,7 @@ export function renderFolderOverview(profiles, projectInfo, isZh) {
   lines.push(`    Root["${projectInfo.name}"]`);
 
   // 只显示深度 = 1 的顶层文件夹
-  const topLevel = profiles.filter(fp => fp.depth === 1);
-  const deeper = profiles.filter(fp => fp.depth > 1);
+  const topLevel = profiles.filter((fp) => fp.depth === 1);
 
   for (const fp of topLevel) {
     const sid = mermaidId(fp.name);
@@ -1570,7 +1579,7 @@ export function renderFolderOverview(profiles, projectInfo, isZh) {
   }
 
   // 画 import 关系边
-  const folderNames = new Set(profiles.map(fp => fp.name));
+  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) {
@@ -1595,18 +1604,19 @@ export function renderFolderOverview(profiles, projectInfo, isZh) {
     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 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} |`);
+    const desc = fp.purpose ? (isZh ? fp.purpose.zh : fp.purpose.en) : '-';
+    lines.push(
+      `| ${nameCol} | \`${fp.relPath}\` | ${fp.fileCount} | ${sizeStr} | ${langs} | ${desc} |`
+    );
   }
   lines.push('');
 
@@ -1631,7 +1641,9 @@ export function renderFolderOverview(profiles, projectInfo, isZh) {
     );
     lines.push('');
     for (const [pattern, count] of commonPatterns) {
-      lines.push(`- **${pattern}** — ${isZh ? `出现在 ${count} 个文件夹` : `found in ${count} folders`}`);
+      lines.push(
+        `- **${pattern}** — ${isZh ? `出现在 ${count} 个文件夹` : `found in ${count} folders`}`
+      );
     }
     lines.push('');
   }
@@ -1687,18 +1699,22 @@ export function renderFolderProfile(fp, projectInfo, isZh) {
   lines.push('');
 
   const purposeStr = fp.purpose
-    ? (isZh ? fp.purpose.zh : fp.purpose.en)
-    : (isZh ? '通过文件夹画像分析推断其功能' : 'functionality inferred from folder profiling');
+    ? 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。`
+        `包含 ${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.`
+        `Contains ${fp.fileCount} source files totaling ${(fp.totalSize / 1024).toFixed(1)}KB.`
     );
   }
   lines.push('');
@@ -1708,9 +1724,10 @@ export function renderFolderProfile(fp, projectInfo, isZh) {
   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`;
+  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(', ')} |`);
@@ -1721,14 +1738,22 @@ export function renderFolderProfile(fp, projectInfo, isZh) {
   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(
+      `> ${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(
+    `| ${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])) {
@@ -1817,9 +1842,7 @@ export function renderFolderProfile(fp, projectInfo, isZh) {
     lines.push(`## ${isZh ? '代码注释摘要' : 'Code Comments Summary'}`);
     lines.push('');
     lines.push(
-      isZh
-        ? '从关键文件头部提取的注释信息:'
-        : 'Comments extracted from key file headers:'
+      isZh ? '从关键文件头部提取的注释信息:' : 'Comments extracted from key file headers:'
     );
     lines.push('');
     for (const hc of fp.headerComments) {
@@ -1828,7 +1851,9 @@ export function renderFolderProfile(fp, projectInfo, isZh) {
     lines.push('');
   }
 
-  lines.push(`[← ${isZh ? '返回结构分析' : 'Back to Structure Analysis'}](../folder-structure.md) | [← ${isZh ? '返回概述' : 'Back to Overview'}](../index.md)`);
+  lines.push(
+    `[← ${isZh ? '返回结构分析' : 'Back to Structure Analysis'}](../folder-structure.md) | [← ${isZh ? '返回概述' : 'Back to Overview'}](../index.md)`
+  );
   lines.push('');
   return lines.join('\n');
 }