@hupan56/wlkj 2.3.0 → 2.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
   "bin": {
     "wlkj": "bin/cli.js"

package/templates/qoder/scripts/common/repowiki.py

@@ -24,31 +24,64 @@ from typing import Dict, List, Optional
 
 
 def find_repowiki_dirs(code_dir: str) -> List[tuple]:
-    """扫描 data/code/{project}/.qoder/repowiki/, 返回 [(project, wiki_root), ...]。"""
+    """扫描 data/code/{project}/.qoder/repowiki/, 返回 [(project, wiki_root), ...]。
+
+    健壮性: repowiki 目录可能存在但为空/损坏/正在生成中。
+    只返回 metadata 文件存在且非空的目录。
+    """
     results = []
     if not os.path.isdir(code_dir):
         return results
-    for proj in os.listdir(code_dir):
-        # 找 repowiki 目录 (可能是 zh/ 或 en/)
-        wiki_base = os.path.join(code_dir, proj, '.qoder', 'repowiki')
-        if not os.path.isdir(wiki_base):
-            continue
-        for lang in os.listdir(wiki_base):
-            lang_dir = os.path.join(wiki_base, lang)
-            meta = os.path.join(lang_dir, 'meta', 'repowiki-metadata.json')
-            if os.path.isfile(meta):
+    try:
+        projects = os.listdir(code_dir)
+    except OSError:
+        return results
+    for proj in projects:
+        try:
+            wiki_base = os.path.join(code_dir, proj, '.qoder', 'repowiki')
+            if not os.path.isdir(wiki_base):
+                continue
+            for lang in os.listdir(wiki_base):
+                lang_dir = os.path.join(wiki_base, lang)
+                if not os.path.isdir(lang_dir):
+                    continue
+                meta = os.path.join(lang_dir, 'meta', 'repowiki-metadata.json')
+                if not os.path.isfile(meta):
+                    continue
+                # 校验文件非空 (生成中可能写出 0 字节文件)
+                try:
+                    if os.path.getsize(meta) < 10:
+                        continue  # 太小, 可能正在生成
+                except OSError:
+                    continue
                 results.append((proj, lang_dir))
                 break  # 每个项目只取一个语言版本
+        except OSError:
+            continue  # 权限/路径问题, 跳过这个项目
     return results
 
 
 def load_wiki_metadata(wiki_root: str) -> Optional[dict]:
-    """加载 repowiki-metadata.json。"""
+    """加载 repowiki-metadata.json。
+
+    健壮性: 文件可能不存在/空/损坏/正在生成。
+    """
     meta_path = os.path.join(wiki_root, 'meta', 'repowiki-metadata.json')
     try:
+        if not os.path.isfile(meta_path):
+            return None
+        if os.path.getsize(meta_path) < 10:
+            return None  # 正在生成或空
         with open(meta_path, encoding='utf-8') as f:
-            return json.load(f)
-    except (OSError, json.JSONDecodeError):
+            data = json.load(f)
+        # 校验基本结构
+        if not isinstance(data, dict):
+            return None
+        # wiki_catalogs 可能为空 (生成中)
+        if not data.get('wiki_catalogs'):
+            return None  # 没有内容, 视为无效
+        return data
+    except (OSError, json.JSONDecodeError, UnicodeDecodeError):
         return None
 
 
@@ -73,76 +106,100 @@ def build_wiki_index(code_dir: str, output_path: str) -> dict:
     """扫描所有项目的 Repo Wiki, 构建 wiki-index.json。
 
     Returns:
-        构建的索引 dict: {keyword: [{project, title, catalog_id, md_path, dependent_files, description}]}
+        {'index': {...}, 'stats': {...}} 或 {'index': {}, 'stats': {...}}
+        始终返回含 'index' 和 'stats' 两个 key 的 dict (调用方可安全 .get)。
+        wiki 不存在/为空/损坏时 index 为 {}, stats 计数为 0。
     """
-    wiki_dirs = find_repowiki_dirs(code_dir)
-    if not wiki_dirs:
-        return {}
-
     index = {}  # keyword -> [entry, ...]
     stats = {'projects': 0, 'pages': 0, 'keywords': 0}
 
-    for project, wiki_root in wiki_dirs:
-        meta = load_wiki_metadata(wiki_root)
-        if not meta:
-            continue
-        stats['projects'] += 1
-
-        catalogs = meta.get('wiki_catalogs', [])
-        items = meta.get('wiki_items', [])
-        # catalog_id -> title 映射
-        id_to_title = {it.get('catalog_id'): it.get('title', '') for it in items}
-
-        for cat in catalogs:
-            cat_id = cat.get('id', '')
-            name = cat.get('name', '')
-            desc = cat.get('description', '')
-            dep_files = cat.get('dependent_files', '')
-            title = id_to_title.get(cat_id, name)
-
-            # 找对应的 markdown 文档
-            md_path = _find_md_for_catalog(wiki_root, cat_id, name)
-            if not md_path:
-                continue
+    wiki_dirs = find_repowiki_dirs(code_dir)
+    if not wiki_dirs:
+        # wiki 不存在或都损坏 → 写空索引, 避免每次搜索都重建
+        _write_wiki_index(output_path, index, stats)
+        return {'index': index, 'stats': stats}
 
-            stats['pages'] += 1
-
-            # 提取关键词 (标题 + 描述 + 依赖文件名)
-            kw_text = ' '.join([title, name, desc])
-            # 依赖文件也作为关键词 (异常.java → 搜"异常"能命中)
-            if dep_files:
-                kw_text += ' ' + dep_files.replace(',', ' ').replace('/', ' ')
-            keywords = _extract_keywords(kw_text)
-
-            entry = {
-                'project': project,
-                'title': title or name,
-                'catalog_id': cat_id,
-                'md_path': md_path,
-                'dependent_files': [f.strip() for f in dep_files.split(',') if f.strip()] if dep_files else [],
-                'description': desc,
-            }
-
-            for kw in keywords:
-                index.setdefault(kw, [])
-                if entry not in index[kw]:
-                    index[kw].append(entry)
+    for project, wiki_root in wiki_dirs:
+        try:
+            meta = load_wiki_metadata(wiki_root)
+            if not meta:
+                continue  # 这个项目的 wiki 损坏/为空, 跳过
+            stats['projects'] += 1
+
+            catalogs = meta.get('wiki_catalogs') or []
+            items = meta.get('wiki_items') or []
+            # catalog_id -> title 映射
+            id_to_title = {}
+            for it in items:
+                if isinstance(it, dict):
+                    cid = it.get('catalog_id')
+                    if cid:
+                        id_to_title[cid] = it.get('title', '')
+
+            for cat in catalogs:
+                try:
+                    if not isinstance(cat, dict):
+                        continue
+                    cat_id = cat.get('id', '')
+                    name = cat.get('name', '') or ''
+                    desc = cat.get('description', '') or ''
+                    dep_files = cat.get('dependent_files', '') or ''
+                    title = id_to_title.get(cat_id, name)
+
+                    # 找对应的 markdown 文档 (可能不存在, 生成中)
+                    md_path = _find_md_for_catalog(wiki_root, cat_id, name)
+                    if not md_path:
+                        continue  # 文档还没生成, 跳过
+
+                    stats['pages'] += 1
+
+                    # 提取关键词
+                    kw_text = ' '.join([str(title), str(name), str(desc)])
+                    if dep_files:
+                        kw_text += ' ' + str(dep_files).replace(',', ' ').replace('/', ' ')
+                    keywords = _extract_keywords(kw_text)
+
+                    entry = {
+                        'project': project,
+                        'title': str(title or name),
+                        'catalog_id': str(cat_id),
+                        'md_path': md_path,
+                        'dependent_files': [f.strip() for f in str(dep_files).split(',') if f.strip()],
+                        'description': str(desc),
+                    }
+
+                    for kw in keywords:
+                        index.setdefault(kw, [])
+                        if entry not in index[kw]:
+                            index[kw].append(entry)
+                except (OSError, TypeError, ValueError):
+                    continue  # 单条 catalog 出错不影响其他
+        except (OSError, TypeError):
+            continue  # 整个项目的 wiki 出错, 跳过
 
     stats['keywords'] = len(index)
+    _write_wiki_index(output_path, index, stats)
+    return {'index': index, 'stats': stats}
 
-    # 写入
-    os.makedirs(os.path.dirname(output_path), exist_ok=True)
-    with open(output_path, 'w', encoding='utf-8') as f:
-        json.dump({'index': index, 'stats': stats}, f, ensure_ascii=False, indent=2)
 
-    return {'index': index, 'stats': stats}
+def _write_wiki_index(output_path: str, index: dict, stats: dict) -> None:
+    """安全写入 wiki-index.json (best-effort, 失败不崩)。"""
+    try:
+        os.makedirs(os.path.dirname(output_path), exist_ok=True)
+        with open(output_path, 'w', encoding='utf-8') as f:
+            json.dump({'index': index, 'stats': stats}, f, ensure_ascii=False, indent=2)
+    except OSError:
+        pass
 
 
 def _find_md_for_catalog(wiki_root: str, catalog_id: str, name: str) -> Optional[str]:
     """在 content/ 目录下找对应的 markdown 文件。
 
     文件名通常等于 catalog name (.md), 在某个子分类目录下。
+    健壮性: name 为空/content 目录不存在时返回 None。
     """
+    if not name:
+        return None
     content_dir = os.path.join(wiki_root, 'content')
     if not os.path.isdir(content_dir):
         return None