@hupan56/wlkj 3.2.0 → 3.3.0

package/templates/qoder/scripts/domain/kg/search/_remote.py

@@ -0,0 +1,187 @@
+"""本地引擎 → 工作台 MCP 远程查询层。
+
+替代直连本地 kg.duckdb（已删），所有知识查询走 MCP HTTP → 工作台 PostgreSQL。
+下游命令（kg.py / wl-search / context_pack）零改动：函数签名不变，print 格式不变。
+
+用法（search_index.py 内）：
+    from domain.kg.search._remote import call_remote, render_search_code
+    data = call_remote("search_code", {"keyword": query})
+    sys.stdout.write(render_search_code(data))
+"""
+import json
+import sys
+import os
+
+# McpCap 路径（相对于 .qoder/scripts/）
+_scripts = os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(__file__))))
+if _scripts not in sys.path:
+    sys.path.insert(0, _scripts)
+
+_mcp = None
+
+
+def _get_mcp():
+    """惰性初始化 McpCap（首次调用连工作台 MCP server）。"""
+    global _mcp
+    if _mcp is None:
+        from capability.adapters.mcp import McpCap
+        _mcp = McpCap()
+    return _mcp
+
+
+def call_remote(tool, args):
+    """调工作台 MCP 工具，返回 dict。失败抛 RuntimeError（无本地降级，kg.duckdb 已删）。"""
+    cap = _get_mcp()
+    result = cap.call(tool, args)
+    if result.is_error:
+        raise RuntimeError("MCP工具 %s 调用失败: %s" % (tool, getattr(result, 'text', '')[:200]))
+    try:
+        data = json.loads(result.text)
+    except Exception:
+        raise RuntimeError("MCP返回非JSON: %s" % result.text[:200])
+    if isinstance(data, dict) and data.get("degraded") and data.get("error"):
+        raise RuntimeError("工作台降级: %s" % data["error"])
+    return data
+
+
+# ============================================================
+# 渲染器：把 MCP JSON → 原本地 print 文本格式（下游命令零改动）
+# ============================================================
+
+def render_search_code(data):
+    """渲染 search_code 结果（仿 search_index.py _search_keywords_impl 格式）。"""
+    items = data.get("items", [])
+    if not items:
+        return "No matches.\n"
+    lines = ["[%d matches]" % len(items)]
+    for it in items[:20]:
+        t = it.get("type", "")
+        name = it.get("name", "")
+        label = it.get("label", "")
+        f = it.get("file", "")
+        plat = it.get("platform", "")
+        short = f.replace("\\", "/").split("/")[-1] if f else ""
+        suffix = "  ->  data/code/%s" % f.replace("\\", "/") if f else ""
+        line = "  [%s] %s" % (t, name)
+        if label and label != name:
+            line += "（%s）" % label
+        if f:
+            line += "  %s%s" % (short, suffix)
+        lines.append(line)
+    return "\n".join(lines) + "\n"
+
+
+def render_search_api(data):
+    """渲染 search_api 结果。"""
+    items = data.get("items", [])
+    if not items:
+        return "No API matches.\n"
+    lines = ["[%d API matches]" % len(items)]
+    for it in items[:20]:
+        verb = (it.get("verb") or "").upper()
+        url = it.get("url", "")
+        fn = it.get("fn", "")
+        lines.append("  %s %s -> %s" % (verb or "GET", url, fn))
+    return "\n".join(lines) + "\n"
+
+
+def render_search_field(data):
+    """渲染 search_field 结果。"""
+    items = data.get("items", [])
+    if not items:
+        return "No field matches.\n"
+    lines = ["[%d field matches]" % len(items)]
+    for it in items[:20]:
+        field = it.get("field", "")
+        title = it.get("title", "")
+        count = it.get("count", 0)
+        lines.append("  %s = %s (用%d次)" % (field, title, count))
+    return "\n".join(lines) + "\n"
+
+
+def render_search_prds(data):
+    """渲染 PRD 搜索结果。"""
+    items = data.get("items", [])
+    if not items:
+        return "No PRD matches.\n"
+    lines = ["[%d PRD matches]" % len(items)]
+    for it in items[:10]:
+        title = it.get("title", "")
+        status = it.get("status", "")
+        lines.append("  [%s] %s" % (status, title))
+    return "\n".join(lines) + "\n"
+
+
+def render_search_style(data):
+    """渲染风格搜索结果。"""
+    items = data.get("items", [])
+    if not items:
+        return "No style matches.\n"
+    lines = ["[%d style matches]" % len(items)]
+    for it in items[:10]:
+        lines.append("  %s: %s" % (it.get("title", ""), it.get("description", "")[:60]))
+    return "\n".join(lines) + "\n"
+
+
+def render_impact(data):
+    """渲染影响分析结果。"""
+    entity = data.get("entity")
+    if not entity:
+        return "Entity not found.\n"
+    totals = data.get("totals", {})
+    by_type = data.get("byType", {})
+    lines = [
+        "影响分析: %s (%s)" % (entity.get("name", ""), entity.get("type", "")),
+        "  影响范围: %s 节点 / %s 关系" % (totals.get("nodes", 0), totals.get("links", 0)),
+    ]
+    if by_type:
+        lines.append("  按类型: " + ", ".join("%s·%d" % (k, v) for k, v in by_type.items()))
+    for section in [("upstream", "⬆ 谁依赖它"), ("downstream", "⬇ 它依赖谁")]:
+        key, label = section
+        layers = data.get(key, [])
+        if layers:
+            lines.append(label)
+            for layer in layers:
+                depth = layer.get("depth", "?")
+                items = layer.get("items", [])
+                names = [it.get("name", "")[:30] for it in items[:5]]
+                lines.append("  L%s: %s" % (depth, ", ".join(names)))
+                if len(items) > 5:
+                    lines.append("       +%d more" % (len(items) - 5))
+    return "\n".join(lines) + "\n"
+
+
+def render_context360(data):
+    """渲染 context_360 结果。"""
+    parts = []
+    for key, label in [("code", "CODE"), ("api", "API"), ("field", "FIELD")]:
+        section = data.get(key, {})
+        # context_360 返回 {code: {items:[...], total:N}, ...} 不是直接 list
+        items = section.get("items", []) if isinstance(section, dict) else (section if isinstance(section, list) else [])
+        if items:
+            parts.append("[%s] %d matches" % (label, len(items)))
+            for it in items[:5]:
+                if isinstance(it, dict):
+                    name = it.get("name", it.get("url", it.get("field", "")))
+                    t = it.get("type", "")
+                    extra = it.get("title", it.get("label", ""))
+                    line = "  %s %s" % (t, name) if t else "  %s" % name
+                    if extra and extra != name:
+                        line += "（%s）" % extra
+                    parts.append(line)
+    if not parts:
+        return "No context found.\n"
+    return "\n".join(parts) + "\n"
+
+
+def render_rag_search(data):
+    """渲染 RAG 语义检索结果。"""
+    items = data.get("items", [])
+    if not items:
+        return "No semantic matches.\n"
+    lines = ["[%d semantic matches] vec=%s" % (len(items), data.get("vector_ok"))]
+    for it in items[:10]:
+        name = it.get("name", "")
+        score = it.get("vec_score", 0)
+        lines.append("  [%.2f] %s (%s)" % (score, name, it.get("type", "")))
+    return "\n".join(lines) + "\n"

package/templates/qoder/scripts/domain/kg/search/context_pack.py

@@ -198,8 +198,38 @@ def main():
 
 
 def _compute_and_print(query, platform, page_type):
-    """实际的 context_pack 计算 (原 main 逻辑)。"""
-
+    """实际的 context_pack 计算 → 走工作台 MCP context_pack（本地 JSON 索引已废弃）。"""
+    try:
+        from domain.kg.search._remote import call_remote
+        data = call_remote("context_pack", {"query": query, "platform": platform})
+        # MCP context_pack 返回聚合结果，直接渲染
+        print('# Context Pack: {} (platform: {})'.format(query, platform or 'all'))
+        for section_key, section_label in [("code", "相关代码"), ("api", "API"),
+                                            ("field", "字段"), ("wiki", "Wiki"),
+                                            ("prd", "PRD")]:
+            items = data.get(section_key, [])
+            if not items:
+                continue
+            print('\n## %s (%d)' % (section_label, len(items)))
+            for it in items[:8]:
+                if isinstance(it, dict):
+                    name = it.get("name", it.get("url", it.get("field", "")))
+                    label = it.get("label", it.get("title", ""))
+                    line = "- %s" % name
+                    if label and label != name:
+                        line += "（%s）" % label
+                    print(line)
+        print("\n（数据来自工作台 PostgreSQL，MCP context_pack 工具）")
+        return
+    except Exception as e:
+        print("# Context Pack: MCP 调用失败（工作台未启动？）")
+        print("# 错误: %s" % str(e)[:200])
+        print("# 提示: 确保工作台后端在跑（start_pg.bat），mcp_config.json 配置正确")
+        return
+
+
+def _compute_and_print_local(query, platform, page_type):
+    """[已废弃] 原本地 JSON 索引逻辑（kg.duckdb 已删，load_index 会失败）。"""
     targets = []
     if platform and platform.lower() not in ('both', '两端'):
         targets = [PLATFORM_MAP.get(platform.lower(), platform)]

package/templates/qoder/scripts/domain/kg/search/search_index.py

@@ -413,6 +413,22 @@ def _check_index_freshness():
 
 
 def search_keywords(query, platform=None):
+    """搜代码关键词 → 走工作台 MCP search_code（本地 kg.duckdb 已删，不再直连）。"""
+    try:
+        from domain.kg.search._remote import call_remote, render_search_code
+        data = call_remote("search_code", {"keyword": query, "platform": platform})
+        sys.stdout.write(render_search_code(data))
+        return
+    except Exception as e:
+        print("MCP search_code 失败（工作台未启动？）: %s" % str(e)[:200])
+        print("提示: 确保工作台后端在跑（start_pg.bat），mcp_config.json 配置正确")
+        return
+
+
+def search_keywords_local(query, platform=None):
+    """[已废弃] 原本地直连 kg.duckdb 的搜索逻辑。保留仅供回退参考。
+    本地 kg.duckdb 已删除，此函数会报 code-keyword.json not found。
+    """
     # 先查缓存 (命中即数据未变, 直接还)。缓存 key 已含 kg.duckdb mtime, 命中就说明
     # 数据源没变, 跳过 _check_index_freshness 的 os.walk —— 50 人团队每天几十次
     # 搜索, 每次都 walk 目录是纯浪费。未命中才做新鲜度检查 + 计算。
@@ -581,6 +597,17 @@ def _semantic_fallback(query, platform=None):
 
 
 def search_prds(query):
+    """搜 PRD → 走工作台 MCP search_prds。"""
+    try:
+        from domain.kg.search._remote import call_remote, render_search_prds
+        data = call_remote("search_prds", {"query": query})
+        sys.stdout.write(render_search_prds(data))
+    except Exception as e:
+        print("MCP search_prds 失败: %s" % str(e)[:200])
+
+
+def search_prds_local(query):
+    """[已废弃] 原本地逻辑。"""
     prd_index = load_index('prd-index.json', hint='Run: python .qoder/scripts/domain/task/git_sync.py --prd-only')
     if prd_index is None:
         return
@@ -627,7 +654,17 @@ def search_prds(query):
 
 
 def search_style(style_type, platform=None):
-    """Find pages of a given UI type (table/form/detail/modal/dashboard)."""
+    """搜风格 → 走工作台 MCP search_style。"""
+    try:
+        from domain.kg.search._remote import call_remote, render_search_style
+        data = call_remote("search_style", {"style_type": style_type, "platform": platform})
+        sys.stdout.write(render_search_style(data))
+    except Exception as e:
+        print("MCP search_style 失败: %s" % str(e)[:200])
+
+
+def search_style_local(style_type, platform=None):
+    """[已废弃] 原本地逻辑。"""
     si = load_index('ui-style.json', hint='Run: python build_style_index.py')
     if si is None:
         return
@@ -663,7 +700,17 @@ def search_style(style_type, platform=None):
 
 
 def search_field(field_name):
-    """Search field usage in ui-style.json field_map."""
+    """搜字段 → 走工作台 MCP search_field。"""
+    try:
+        from domain.kg.search._remote import call_remote, render_search_field
+        data = call_remote("search_field", {"name": field_name})
+        sys.stdout.write(render_search_field(data))
+    except Exception as e:
+        print("MCP search_field 失败: %s" % str(e)[:200])
+
+
+def search_field_local(field_name):
+    """[已废弃] 原本地逻辑。"""
     si = load_index('ui-style.json', hint='Run: python build_style_index.py')
     if si is None:
         return
@@ -681,7 +728,17 @@ def search_field(field_name):
 
 
 def search_api(query):
-    """Search API endpoints in code-api.json."""
+    """搜 API → 走工作台 MCP search_api。"""
+    try:
+        from domain.kg.search._remote import call_remote, render_search_api
+        data = call_remote("search_api", {"keyword": query})
+        sys.stdout.write(render_search_api(data))
+    except Exception as e:
+        print("MCP search_api 失败: %s" % str(e)[:200])
+
+
+def search_api_local(query):
+    """[已废弃] 原本地逻辑。"""
     ai = load_index('code-api.json', hint='Run: python .qoder/scripts/domain/task/git_sync.py --index-only')
     if ai is None:
         return
@@ -813,26 +870,23 @@ def search_wiki_cli(query):
 
 
 def search_impact(query):
-    """改这个接口/符号影响哪些页面/按钮/模块? (U1: 内存图遍历)"""
-    from domain.kg.graph.graph_traverse import CodeGraph
-    g = CodeGraph(INDEX_DIR)
-    result = g.impact(query)
-    if result:
-        print(result)
-    else:
-        print('未找到匹配 "{}" 的端点。尝试用部分路径, 如 /veh 或 export'.format(query))
-        print('提示: trace-chain 当前覆盖率 31%, 未覆盖的调用不会被列出')
+    """影响分析 → 走工作台 MCP get_impact。"""
+    try:
+        from domain.kg.search._remote import call_remote, render_impact
+        data = call_remote("get_impact", {"entity": query, "depth": 2})
+        sys.stdout.write(render_impact(data))
+    except Exception as e:
+        print("MCP get_impact 失败: %s" % str(e)[:200])
 
 
 def search_context360(query):
-    """符号的360度视图: 端点/函数/处理器/PRD (U1: 内存图遍历)"""
-    from domain.kg.graph.graph_traverse import CodeGraph
-    g = CodeGraph(INDEX_DIR)
-    result = g.context360(query)
-    if result:
-        print(result)
-    else:
-        print('未找到匹配 "{}" 的符号。'.format(query))
+    """360度视图 → 走工作台 MCP context_360。"""
+    try:
+        from domain.kg.search._remote import call_remote, render_context360
+        data = call_remote("context_360", {"symbol": query})
+        sys.stdout.write(render_context360(data))
+    except Exception as e:
+        print("MCP context_360 失败: %s" % str(e)[:200])
 
 
 def print_usage():

package/templates/qoder/scripts/domain/kg/switch_project.py

@@ -0,0 +1,159 @@
+#!/usr/bin/env python
+"""wlkj 项目切换脚本：选项目 → 拉平台 token → 写 mcp_config.json。
+
+用法：
+    python switch_project.py                          # 交互式：列出项目 → 选 → 写配置
+    python switch_project.py --email a@b.c --pw xxx  # 非交互：直接指定
+    python switch_project.py --project-uuid <UUID>   # 非交互：直接指定项目
+
+需工作台后端在跑（默认 http://127.0.0.1:10010）。
+"""
+import json
+import os
+import sys
+import urllib.request
+import urllib.error
+
+# 宿主根：脚本部署在 {host}/scripts/domain/kg/，4 级 dirname = {host}（.qoder 或 wlinkj-workflow）
+HOST_DIR = os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))))
+REPO_ROOT = os.path.dirname(HOST_DIR)  # qoderAll/
+
+
+def _find_config_path():
+    """按宿主探测 mcp_config.json：当前宿主根 → wlinkj-workflow → .qoder（适配多宿主部署）。"""
+    for p in (
+        os.path.join(HOST_DIR, "mcp_config.json"),                       # 当前宿主根(.qoder 或 wlinkj-workflow)
+        os.path.join(REPO_ROOT, "wlinkj-workflow", "mcp_config.json"),
+        os.path.join(REPO_ROOT, ".qoder", "mcp_config.json"),
+    ):
+        if os.path.isfile(p):
+            return p
+    return os.path.join(HOST_DIR, "mcp_config.json")  # 都没有则写当前宿主根
+
+
+CONFIG_PATH = _find_config_path()
+
+# 平台地址（默认 10010，可 env 覆盖）
+BASE_URL = os.environ.get("WLKJ_BASE_URL", "http://127.0.0.1:10010")
+
+
+def bind(email, password, base_url=BASE_URL):
+    """调平台 /api/auth/bind，返回 {projects:[{id,name,token,mcp_config}], base_url}。"""
+    data = json.dumps({"email": email, "password": password, "base_url": base_url}).encode()
+    req = urllib.request.Request(
+        f"{base_url}/api/auth/bind",
+        data=data, method="POST",
+        headers={"Content-Type": "application/json"},
+    )
+    try:
+        resp = urllib.request.urlopen(req, timeout=10)
+        return json.loads(resp.read())
+    except urllib.error.HTTPError as e:
+        body = e.read().decode("utf-8", errors="replace")[:200]
+        print(f"ERROR: 平台返回 {e.code}: {body}", file=sys.stderr)
+        sys.exit(1)
+    except urllib.error.URLError as e:
+        print(f"ERROR: 连不上平台 {base_url}: {e}", file=sys.stderr)
+        print(f"提示: 确保工作台在跑（start_pg.bat），或设 WLKJ_BASE_URL 环境变量", file=sys.stderr)
+        sys.exit(1)
+
+
+def write_config(project, base_url):
+    """把选中项目的 mcp_config 写入 mcp_config.json（保留 return_endpoint）。"""
+    # 读现有配置（保留注释和非 mcpServers 字段）
+    existing = {}
+    if os.path.isfile(CONFIG_PATH):
+        try:
+            with open(CONFIG_PATH, encoding="utf-8") as f:
+                existing = json.load(f)
+        except Exception:
+            pass
+
+    # 用平台的 mcp_config 覆盖
+    mcp_cfg = project.get("mcp_config", {})
+    if not mcp_cfg:
+        # 平台没返回完整 config，手动拼
+        mcp_cfg = {
+            "mcpServers": {"wlinkj-knowledge": {
+                "kind": "http",
+                "url": f"{base_url}/mcp",
+                "token": project.get("token", ""),
+                "env": {"WLKJ_PROJECT_ID": project.get("id", "")},
+            }},
+            "return_endpoint": {
+                "url": f"{base_url}/api/projects/{project.get('id','')}/returns",
+                "method": "POST",
+                "headers": {"X-Engine-Token": project.get("token", "")},
+            },
+        }
+
+    existing.update(mcp_cfg)
+    # 确保 return_endpoint 的端口正确
+    if "return_endpoint" in existing:
+        existing["return_endpoint"]["url"] = f"{base_url}/api/projects/{project['id']}/returns"
+
+    os.makedirs(os.path.dirname(CONFIG_PATH), exist_ok=True)
+    with open(CONFIG_PATH, "w", encoding="utf-8") as f:
+        json.dump(existing, f, ensure_ascii=False, indent=2)
+
+    print(f"OK: 已绑定项目「{project.get('name', project.get('id',''))}」")
+    print(f"    token: {project.get('token','')[:12]}...")
+    print(f"    project_id: {project.get('id','')}")
+    print(f"    配置写入: {CONFIG_PATH}")
+    print(f"    平台地址: {base_url}")
+
+
+def main():
+    import argparse
+    parser = argparse.ArgumentParser(description="切换 wlkj 项目绑定")
+    parser.add_argument("--email", help="平台邮箱")
+    parser.add_argument("--pw", "--password", dest="password", help="平台密码")
+    parser.add_argument("--project-uuid", help="直接指定项目 UUID（跳过选择）")
+    parser.add_argument("--base-url", default=BASE_URL, help=f"平台地址（默认 {BASE_URL}）")
+    parser.add_argument("--list", action="store_true", help="只列出项目，不写配置")
+    args = parser.parse_args()
+
+    # 1. 收集邮箱密码
+    email = args.email or os.environ.get("WLKJ_EMAIL") or input("平台邮箱: ").strip()
+    password = args.password or os.environ.get("WLKJ_PASSWORD") or input("平台密码: ").strip()
+
+    # 2. 拉项目列表
+    print(f"连接平台 {args.base_url} ...")
+    result = bind(email, password, args.base_url)
+    projects = result.get("projects", [])
+    if not projects:
+        print("该用户没有任何项目，请先在平台创建项目。")
+        sys.exit(1)
+
+    # 3. 列出项目
+    print(f"\n找到 {len(projects)} 个项目：")
+    for i, p in enumerate(projects):
+        print(f"  {i+1}. {p.get('name','?')} (id={p.get('id','?')[:8]})")
+
+    if args.list:
+        return
+
+    # 4. 选择项目
+    chosen = None
+    if args.project_uuid:
+        for p in projects:
+            if p.get("id") == args.project_uuid:
+                chosen = p
+                break
+        if not chosen:
+            print(f"ERROR: 项目 UUID '{args.project_uuid}' 不在列表中", file=sys.stderr)
+            sys.exit(1)
+    else:
+        try:
+            idx = int(input(f"\n选哪个项目？(1-{len(projects)}): ")) - 1
+            chosen = projects[idx]
+        except (ValueError, IndexError):
+            print("ERROR: 无效选择", file=sys.stderr)
+            sys.exit(1)
+
+    # 5. 写配置
+    write_config(chosen, args.base_url)
+
+
+if __name__ == "__main__":
+    main()

package/templates/qoder/scripts/domain/kg/sync_repowiki.py

@@ -0,0 +1,109 @@
+#!/usr/bin/env python
+"""同步 Qoder Repo Wiki → 平台 PG wiki 表。
+
+Qoder 自动为代码仓库生成 Repo Wiki（750+篇业务文档），存在：
+  data/code/{repo}/.qoder/repowiki/knowledge/zh/**/*.md
+
+本脚本读这些 md → UPSERT 到 PG wiki 表（repo + keyword + title + description）。
+这样知识层的 wiki 搜索(graphrag_ask/rag_search)能命中 Qoder 自动生成的高质量文档。
+
+用法：
+    python sync_repowiki.py                          # 同步全部仓库
+    python sync_repowiki.py --repo fywl-ics          # 只同步指定仓库
+    python sync_repowiki.py --dry-run                # 只统计不写
+"""
+import os
+import sys
+import glob
+
+_THIS_DIR = os.path.dirname(os.path.abspath(__file__))
+_up1 = os.path.dirname(_THIS_DIR)
+_up2 = os.path.dirname(_up1)
+SCRIPTS_DIR = os.path.dirname(_up2)
+REPO_ROOT = os.path.dirname(SCRIPTS_DIR)
+CODE_ROOT = os.path.join(REPO_ROOT, "data", "code")
+
+PG = dict(host="127.0.0.1", port=5432, user="wlinkj", password="changeme", dbname="wlinkj")
+
+
+def scan_repowiki(repo):
+    """扫描某仓库的 Repo Wiki，返回 [{path, title, content, dir_path}]。"""
+    wiki_base = os.path.join(CODE_ROOT, repo, ".qoder", "repowiki")
+    if not os.path.isdir(wiki_base):
+        return []
+    results = []
+    for md_path in glob.glob(os.path.join(wiki_base, "**", "*.md"), recursive=True):
+        try:
+            with open(md_path, encoding="utf-8") as f:
+                content = f.read()
+            # 标题：md 文件名或第一行 #
+            title = os.path.splitext(os.path.basename(md_path))[0]
+            for line in content.split("\n")[:5]:
+                if line.strip().startswith("#"):
+                    title = line.strip().lstrip("#").strip()
+                    break
+            # keyword：从目录路径提取业务模块名
+            rel = os.path.relpath(md_path, wiki_base)
+            parts = rel.replace("\\", "/").split("/")
+            keyword = parts[-2] if len(parts) >= 2 else title
+            results.append({
+                "path": md_path,
+                "rel_path": rel,
+                "title": title,
+                "keyword": keyword,
+                "content": content[:2000],  # 取前2000字
+            })
+        except Exception:
+            continue
+    return results
+
+
+def sync_to_pg(wiki_items, repo):
+    """UPSERT 到 PG wiki 表。"""
+    import psycopg2
+    from psycopg2.extras import execute_values
+
+    conn = psycopg2.connect(**PG)
+    conn.autocommit = True
+    cur = conn.cursor()
+
+    # ★ 不删旧数据（原 wiki 表有业务文档），只删 repowiki 来源的记录
+    # 用 md_path 前缀 'repowiki:' 标识（避免路径分隔符差异）
+    cur.execute("DELETE FROM wiki WHERE project = %s AND md_path LIKE 'repowiki:%%'", (repo,))
+
+    rows = [(w["keyword"], repo, w["title"], "repowiki:" + w["rel_path"], w["content"][:500])
+            for w in wiki_items]
+    if rows:
+        execute_values(
+            cur,
+            "INSERT INTO wiki(keyword, project, title, md_path, description) VALUES %s",
+            rows,
+        )
+
+    print(f"[{repo}] 同步 {len(rows)} 篇 Wiki 到 PG")
+    conn.close()
+
+
+def main():
+    import argparse
+    parser = argparse.ArgumentParser(description="同步 Qoder Repo Wiki → PG")
+    parser.add_argument("--repo", help="指定仓库名")
+    parser.add_argument("--dry-run", action="store_true", help="只统计不写")
+    args = parser.parse_args()
+
+    repos = [args.repo] if args.repo else ["fywl-ui", "fywl-ics", "Carmg-H5"]
+    total = 0
+    for repo in repos:
+        items = scan_repowiki(repo)
+        print(f"  {repo}: 扫到 {len(items)} 篇 Repo Wiki")
+        if items:
+            for it in items[:3]:
+                print(f"    [{it['keyword']}] {it['title']}")
+            if not args.dry_run:
+                sync_to_pg(items, repo)
+            total += len(items)
+    print(f"\n总计: {total} 篇 Wiki{'（dry-run 未写入）' if args.dry_run else ' 已同步到 PG'}")
+
+
+if __name__ == "__main__":
+    main()