@hupan56/wlkj 3.1.32 → 3.3.0

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()

package/templates/qoder/scripts/domain/requirement/req.py

@@ -29,7 +29,7 @@ for _ in range(10):
         break
 if _cp not in _s.path: _s.path.insert(0, _cp)
 from bootstrap import setup; setup()
-from foundation.core.paths import get_repo_root
+from foundation.core.paths import get_repo_root
 
 import os
 import sys
@@ -164,10 +164,43 @@ def cmd_promote(req_id, dev=None):
     return 0
 
 
-def cmd_publish(req_id, dev=None):
-    """发布 = promote + 发禅道。PM 只用这个。"""
+def _parse_prd_meta(prd_path):
+    """从 PRD 提取发布所需元信息: 标题(首个#行) + spec(正文) + 可选 product/plan/build。
+
+    PRD 可在首行用 frontmatter 风格标注禅道目标:
+      <!-- zentao: product=1 plan=12 build=8 -->
+    没标则返回 None, 由发布方补。
+    """
+    text = prd_path.read_text(encoding="utf-8")
+    meta = {"product_id": None, "plan_id": None, "build_id": None,
+            "title": "", "spec": ""}
+    for line in text.splitlines():
+        s = line.strip()
+        if s.startswith("<!--") and "zentao" in s:
+            for kv in s.replace("<!--", "").replace("-->", "").split():
+                if "=" in kv:
+                    k, v = kv.split("=", 1)
+                    kk = {"product": "product_id", "plan": "plan_id", "build": "build_id"}.get(k)
+                    if kk and v.isdigit():
+                        meta[kk] = int(v)
+    # 标题: 第一个非空 # 行; spec: 全文(截断到 8000 防 API 截断)
+    for line in text.splitlines():
+        if line.startswith("# ") and line[2:].strip():
+            meta["title"] = line[2:].strip()[:80]
+            break
+    meta["spec"] = text[:8000]
+    return meta
+
+
+def cmd_publish(req_id, dev=None, product_id=None, plan_id=None, build_id=None, confirm=False):
+    """发布 = promote + 发禅道(建需求+关联计划+纳入版本)。
+
+    默认 dry-run(只打印不写禅道); --confirm 才真发。
+    产品/计划/版本: 优先用参数 > PRD里<!-- zentao: -->标注 > 缺则停在第该步问PM。
+    用 ZentaoClient 直连 HTTP(不走 MCP), AI 只触发一次, 省 token。
+    """
     dev = dev or get_developer(BASE) or "unknown"
-    # 先确保在 outputs (不在则 promote)
+    # 1. promote (草稿→产出)
     out_found = [e for e in find_req_dirs(req_id, dev, BASE) if e["area"] == "outputs"]
     if not out_found:
         print("草稿 → 产出...")
@@ -179,30 +212,92 @@ def cmd_publish(req_id, dev=None):
         print("✗ 发布失败: 产出区找不到 %s" % req_id)
         return 1
     out_path = out_found[0]["path"]
-    print()
-    print("发禅道 (从产出区: %s)" % out_path)
-    print("-" * 40)
-    # 找禅道 MCP 创建需求
-    try:
-        sys.path.insert(0, str(BASE / ".qoder" / "scripts" / "mcp"))
-        # 禅道发布: 读 PRD, 调 zentao MCP 建 story
-        prd_file = None
-        for f in out_path.iterdir():
-            if f.is_file() and (f.name.endswith(".md") and "prd" in f.name.lower()):
+
+    # 2. 找 PRD
+    prd_file = None
+    for f in out_path.iterdir():
+        if f.is_file() and f.suffix == ".md" and not f.name.startswith("_"):
+            if "prd" in f.name.lower() or prd_file is None:
                 prd_file = f
-                break
-            if f.is_file() and f.suffix == ".md" and not f.name.startswith("_"):
-                prd_file = f  # 第一个 md 当 PRD
-        if prd_file:
-            print("  PRD: %s" % prd_file.name)
-        print()
-        print("⚠️ 禅道发布需要 QoderWork 的禅道 MCP (mcp__qoder-zentao__create_story)。")
-        print("   AI 会读产出的 PRD, 调禅道建需求。")
-        print("   如果你在 QoderWork 里说'%s 发布', AI 会自动完成这步。" % req_id)
+    if not prd_file:
+        print("✗ 发布失败: 产出区没有 .md (PRD)。")
+        return 1
+    meta = _parse_prd_meta(prd_file)
+    pid = product_id or meta["product_id"]
+    plan = plan_id or meta["plan_id"]
+    build = build_id or meta["build_id"]
+
+    mode = "★真发" if confirm else "DRY-RUN(只预览不写禅道, 加 --confirm 真发)"
+    print("发禅道 [%s]  需求: %s  PRD: %s" % (mode, req_id, prd_file.name))
+    print("-" * 50)
+    print("  标题: %s" % meta["title"] or "(未提取到#标题)")
+    print("  产品: %s" % (pid if pid else "⚠️ 未指定 — 用 --product=N 或 PRD标 <!-- zentao: product=N -->"))
+
+    if not pid:
+        print("\n✗ 缺产品ID, 已停(禅道需求必须挂某产品)。")
+        print("  补: python req.py %s 发布 --product=N [--plan=M --build=K]" % req_id)
+        return 2
+    if not confirm:
+        print("\n  [预览] 将: 建 story(product=%s) → %s%s" % (
+            pid,
+            "关联计划#%s → " % plan if plan else "",
+            "纳入版本#%s" % build if build else ""))
+        print("  真发加 --confirm")
         return 0
+
+    # 3. 真发: 直连禅道 HTTP
+    try:
+        from foundation.integrations.zentao_client import ZentaoClient
     except Exception as e:
-        print("✗ 发布出错: %s" % e)
-        return 1
+        print("✗ 加载禅道客户端失败: %s" % e)
+        return 3
+    client = ZentaoClient.from_config()
+    if client is None:
+        print("✗ 禅道未配置(凭据/内网)。先 /wl-init 或检查 ~/.qoderwork/.secrets/zentao.env")
+        return 3
+    ok, msg = client.check_intranet()
+    if not ok:
+        print("✗ 禅道不可达: %s" % msg)
+        return 3
+
+    # 3a. 建 story
+    payload = {"title": meta["title"] or req_id, "spec": meta["spec"], "pri": 3, "category": "feature"}
+    r = client.api("POST", "/products/%s/stories" % pid, payload)
+    if r.status_code not in (200, 201):
+        print("✗ 建需求失败: %s %s" % (r.status_code, r.text[:120]))
+        return 3
+    story_id = r.json().get("id")
+    if not story_id:
+        print("✗ 建需求异常(无id): %s" % str(r.json())[:150])
+        return 3
+    print("  ✅ 需求已建 #%s" % story_id)
+
+    # 3b. 关联计划 (可选)
+    if plan:
+        r2 = client.api("POST", "/plans/%s/linkStory" % plan, {"stories": [story_id]})
+        if r2.status_code in (200, 201):
+            print("  ✅ 已关联计划 #%s" % plan)
+        else:
+            print("  ⚠️ 关联计划#%s 失败: %s (不影响,可手动)" % (plan, r2.status_code))
+
+    # 3c. 纳入版本 (可选)
+    if build:
+        r3 = client.api("POST", "/builds/%s/linkStory" % build, {"stories": [story_id]})
+        if r3.status_code in (200, 201):
+            print("  ✅ 已纳入版本 #%s" % build)
+        else:
+            print("  ⚠️ 纳入版本#%s 失败: %s (不影响,可手动)" % (build, r3.status_code))
+
+    # 3d. 回写 story_id 到 PRD (留痕, 防重复建)
+    try:
+        with open(prd_file, "a", encoding="utf-8") as fh:
+            fh.write("\n\n<!-- zentao: product=%s story=%s plan=%s build=%s -->\n" % (
+                pid, story_id, plan or 0, build or 0))
+    except Exception:
+        pass
+
+    print("\n🎉 发布完成! 禅道需求 #%s" % story_id)
+    return 0
 
 
 def main():
@@ -211,10 +306,21 @@ def main():
         return cmd_list()
     req_id = args[0]
     action = args[1] if len(args) > 1 else "show"
-    if action == "show":
+    # 发布支持 --product/--plan/--build/--confirm
+    if action in ("发布", "publish", "fabu"):
+        opts = {"product_id": None, "plan_id": None, "build_id": None, "confirm": False}
+        for a in args[2:]:
+            if a == "--confirm":
+                opts["confirm"] = True
+            elif a.startswith("--product="):
+                opts["product_id"] = int(a.split("=", 1)[1])
+            elif a.startswith("--plan="):
+                opts["plan_id"] = int(a.split("=", 1)[1])
+            elif a.startswith("--build="):
+                opts["build_id"] = int(a.split("=", 1)[1])
+        return cmd_publish(req_id, **opts)
+    elif action == "show":
         return cmd_show(req_id)
-    elif action in ("发布", "publish", "fabu"):
-        return cmd_publish(req_id)
     elif action == "promote":
         return cmd_promote(req_id)
     elif action == "list":