autosnippet 3.1.0 → 3.1.1

package/lib/service/wiki/WikiGenerator.js

@@ -639,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 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, {
@@ -712,7 +717,11 @@ 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`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autosnippet",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "Extract code patterns into a knowledge base for AI coding assistants",
   "type": "module",
   "main": "lib/bootstrap.js",