@hupan56/wlkj 3.3.3 → 3.3.5

package/package.json

@@ -1,29 +1,29 @@
-{
-  "name": "@hupan56/wlkj",
-  "version": "3.3.3",
-  "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
-  "bin": {
-    "wlkj": "bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "templates/",
-    "MAC-VERIFY.md"
-  ],
-  "keywords": [
-    "workflow",
-    "ai",
-    "prd",
-    "pipeline",
-    "qoder",
-    "product",
-    "team"
-  ],
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=16"
-  }
-}
+{
+  "name": "@hupan56/wlkj",
+  "version": "3.3.5",
+  "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
+  "bin": {
+    "wlkj": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "templates/",
+    "MAC-VERIFY.md"
+  ],
+  "keywords": [
+    "workflow",
+    "ai",
+    "prd",
+    "pipeline",
+    "qoder",
+    "product",
+    "team"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=16"
+  }
+}

package/templates/qoder/scripts/capability/adapters/mcp.py

@@ -132,6 +132,11 @@ class McpCap:
 
     def _cli_fallback(self, tool_name: str, args: dict) -> Optional[str]:
         """MCP 工具名 → wlkj.py 执行。无映射返回 None。"""
+        # ★ 递归守卫：search_code→kg search→search_index→call_remote→call→_cli_fallback 会无限套娃。
+        # 已在降级子进程内（_run_wlkj 设了 _WLKJ_IN_CLI_FALLBACK=1）则直接放弃降级，返回原始错误。
+        import os as _os
+        if _os.environ.get("_WLKJ_IN_CLI_FALLBACK"):
+            return None
         entry = self._TOOL_TO_WLKJ.get(tool_name)
         if entry is None:
             return None
@@ -183,10 +188,12 @@ class McpCap:
             repo = os.getcwd()
         wlkj = os.path.join(repo, ".qoder", "scripts", "orchestration", "wlkj.py")
         try:
+            # 递归守卫：子进程内 _WLKJ_IN_CLI_FALLBACK=1，其 McpCap 不再降级（否则套娃）
+            env = dict(os.environ, _WLKJ_IN_CLI_FALLBACK="1")
             r = subprocess.run(
                 [sys.executable, wlkj, cmd] + args,
                 capture_output=True, text=True, timeout=60,
-                encoding="utf-8", errors="replace",
+                encoding="utf-8", errors="replace", env=env,
             )
             if r.returncode == 0:
                 return r.stdout.strip()

package/templates/qoder/scripts/capability/registry_mcp.py

@@ -73,16 +73,22 @@ SERVERS: dict[str, dict] = {
 
 
 def _mcp_config_path() -> Path:
-    """定位 mcp_config.json（在仓库根/宿主下）。"""
+    """定位 mcp_config.json（在仓库根/宿主下）。
+
+    ★ switch_project.py 实际写入位置是 {repo}/.qoder/mcp_config.json（云模式连云 bind 后），
+    必须优先查这里——否则读不到 token，transport 用空 token 调云 MCP 鉴权失败（历史 bug：
+    引擎 search 全返回"MCP返回非JSON"+递归降级套娃）。老形态 repo/mcp_config.json 兼容。
+    """
     repo = _get_repo_root()
     # registry_mcp.py 在 .../scripts/capability/, mcp_config.json 在宿主根（.qoder）。
     for cand in [
-        repo / "mcp_config.json",
+        repo / ".qoder" / "mcp_config.json",     # ★ 云模式实际写入位置（switch_project）
+        repo / "mcp_config.json",                 # 老形态：仓库根
         repo / "registry_mcp_config.json",
     ]:
         if cand.is_file():
             return cand
-    return repo / "mcp_config.json"
+    return repo / ".qoder" / "mcp_config.json"
 
 
 def _load_servers() -> dict[str, dict]:

package/templates/qoder/scripts/domain/kg/graph/kg_semantic.py

@@ -278,6 +278,31 @@ def build_embeddings(batch_size=64):
         con.close()
 
 
+def _cloud_rag_search(query, top_k=10):
+    """云优先语义搜索：调工作台 MCP rag_search（本地无 KG/embedding，全迁云）。
+
+    Returns:
+        [(entity_id, text, score), ...] 或 None（云不可用时返回 None，让调用方退本地）。
+    """
+    try:
+        from domain.kg.search._remote import call_remote
+        data = call_remote("rag_search", {"query": query, "top_k": top_k})
+    except Exception:
+        return None
+    items = data.get("items") or []
+    out = []
+    for it in items[:top_k]:
+        eid = it.get("entity_id") or it.get("id") or ""
+        text = it.get("text") or it.get("name") or ""
+        score = it.get("score")
+        try:
+            score = float(score) if score is not None else 0.0
+        except Exception:
+            score = 0.0
+        out.append((eid, text, score))
+    return out
+
+
 def semantic_search(query, top_k=10):
     """语义搜索: query→向量→余弦相似度→top_k 实体。
 
@@ -656,13 +681,24 @@ if __name__ == '__main__':
         n = build_embeddings()
         print('Built %d embeddings' % n)
 
-    elif len(sys.argv) > 2 and sys.argv[1] == 'search':
-        results = semantic_search(sys.argv[2])
+    elif (len(sys.argv) > 2 and sys.argv[1] == 'search') or \
+         (len(sys.argv) > 1 and sys.argv[1] not in ('--check', '--label', 'build-embeddings', '--status', '--backfill-cn')):
+        # 兼容两种姿势: `search <词>` 和裸词 `<词>`（wlkj.py semantic 保险异常 透传过来）。
+        # ★ 云优先：本地无 KG/embedding（全迁云），先调云 rag_search；云不可用才退本地 semantic_search。
+        query = sys.argv[2] if sys.argv[1] == 'search' else sys.argv[1]
+        results = _cloud_rag_search(query)
+        if results is None:
+            # 云不可用 → 退本地（开发期有本地 embedding 时仍可用）
+            results = semantic_search(query)
         if results:
-            for eid, text, score in results:
-                print('  %.3f  %s' % (score, text[:70]))
+            for row in results:
+                if len(row) == 3:
+                    eid, text, score = row
+                    print('  %.3f  %s' % (score, text[:70]))
+                else:
+                    print('  %s' % row)
         else:
-            print('(无结果或 embedding 未构建)')
+            print('(无结果或云 rag_search 不可用 + 本地 embedding 未构建)')
 
     elif len(sys.argv) > 1 and sys.argv[1] == '--status':
         st = embedding_status()

package/templates/qoder/scripts/domain/task/wlkj_panel.py

@@ -56,6 +56,57 @@ def _zentao_creds():
     return ZentaoClient.from_config()
 
 
+def _cloud_my_panel():
+    """云优先：调平台 get_my_zentao_panel（凭据走平台 per-user 配置，不出平台）。
+
+    直连云 /mcp JSON-RPC（读 .qoder/mcp_config.json 的 token+url）。
+    Returns: {ok:True, tasks, bugs, stories, account} 或 None（云不可达/工具失败）。
+    云返 {ok:False,error}（未配置/登录失败）→ 返该 dict（调用方据此提示+回退本地）。
+    """
+    import json as _json
+    import urllib.request as _u
+    import urllib.error as _ue
+    # 定位 mcp_config.json（switch_project 写在 .qoder/）
+    cfg_candidates = []
+    try:
+        from foundation.core.paths import get_repo_root
+        cfg_candidates.append(os.path.join(str(get_repo_root()), '.qoder', 'mcp_config.json'))
+    except Exception:
+        pass
+    cfg_candidates.append(os.path.join(_SCRIPTS, '..', 'mcp_config.json'))
+    token, url = '', ''
+    for cp in cfg_candidates:
+        try:
+            with open(cp, encoding='utf-8') as f:
+                cfg = _json.load(f)
+            srv = (cfg.get('mcpServers') or {}).get('wlinkj-knowledge') or {}
+            token = srv.get('token', '')
+            url = (srv.get('url') or '').rstrip('/')
+            if token and url:
+                break
+        except Exception:
+            continue
+    if not token or not url:
+        return None  # 云未绑定（switch_project 没跑）→ 回退本地
+    endpoint = url if url.endswith('/mcp') else url + '/mcp'
+    body = _json.dumps({"jsonrpc": "2.0", "id": 1, "method": "tools/call",
+                        "params": {"name": "get_my_zentao_panel", "arguments": {}}}).encode('utf-8')
+    req = _u.Request(endpoint, data=body, method='POST')
+    req.add_header('Content-Type', 'application/json')
+    req.add_header('X-MCP-Token', token)
+    try:
+        with _u.urlopen(req, timeout=30) as resp:
+            r = _json.loads(resp.read().decode('utf-8', errors='replace'))
+    except Exception:
+        return None  # 网络不通 → 回退本地
+    try:
+        text = r.get('result', {}).get('content', [{}])[0].get('text', '')
+        data = _json.loads(text) if text else {}
+    except Exception:
+        return None
+    return data  # {ok:True/False, ...}
+
+
 def _resolve_my_account(developer):
     """解析当前 developer → 禅道 account。返回 (account, 错误原因)。"""
     mem = get_member(developer)
@@ -359,12 +410,55 @@ def fetch_workbench(include_closed=False, kind=None):
     """
     developer = get_developer()
 
-    # ① 凭据
+    # ⓪ 云优先：调平台 get_my_zentao_panel（凭据走平台 per-user，不出平台）。
+    # 成功 → 直接用云数据，跳过本地凭据/连通/归属/收集（① ~ ④）。
+    # 未配置/登录失败 → 返回 {ok:False} 提示用户去平台配置，并回退本地（本地配了仍可用）。
+    # 云不可达(返回 None) → 静默回退本地全流程。
+    cloud = _cloud_my_panel()
+    if isinstance(cloud, dict):
+        # 云可达 → 云的判断权威（平台是凭据源）。
+        if cloud.get('ok'):
+            tasks = cloud.get('tasks') or []
+            bugs = cloud.get('bugs') or []
+            stories = cloud.get('stories') or []
+            # 按 kind 裁剪（与本地一致）
+            if kind == 'tasks':
+                bugs, stories = [], []
+            elif kind == 'bugs':
+                tasks, stories = [], []
+            elif kind == 'stories':
+                tasks, bugs = [], []
+            tasks, bugs, stories = _filter_live(tasks, bugs, stories, include_closed)
+            # 云路径：数据已平台聚合，归一化即可（进度检测需本地 client，云模式跳过给默认值）
+            norm_tasks = [_norm_task(t) for t in tasks]
+            norm_bugs = [_norm_bug(b) for b in bugs]
+            norm_stories = [_norm_story(s) for s in stories]
+            for it in norm_tasks + norm_bugs + norm_stories:
+                it['progress'] = {'prd': False, 'spec': 'none', 'code': False}
+            data = {'account': cloud.get('account', ''), 'developer': developer,
+                    'current_task': None, 'tasks': norm_tasks,
+                    'bugs': norm_bugs, 'stories': norm_stories}
+            meta = {'fetched_at': datetime.now().isoformat(timespec='seconds'),
+                    'source': 'cloud',
+                    'counts': {'tasks': len(norm_tasks), 'bugs': len(norm_bugs),
+                               'stories': len(norm_stories)},
+                    'include_closed': include_closed}
+            return {'ok': True, 'data': data, 'meta': meta}, 0
+        # 云可达但失败（未配置/登录失败/防火墙）→ 记下云诊断，回退本地。
+        # 回退价值：云到禅道常被防火墙挡，但本机（demo 机器，内网）可能直连可达。
+        # 本地也失败时，把云诊断一起带出（平台有凭据但云连不上 + 本地无凭据）。
+        cloud_error = cloud.get('error', '禅道不可用')
+    else:
+        cloud_error = None  # 云不可达（switch_project 没跑/平台宕机）→ 静默回退本地
+
+    # ① 凭据（本地回退）
     client = _zentao_creds()
     if client is None:
-        return {'ok': False,
-                'error': '禅道凭据未配置。请检查 .qoder/config.yaml 的 zentao.url, '
-                         '及 workspace/members/<我>/.private/secrets/zentao.env 的账号密码。'}, 3
+        base_msg = ('禅道凭据未配置。推荐在【平台设置 → 禅道】配置（panel 自动走云）；'
+                    '或本地 .qoder/config.yaml 的 zentao.url + secrets/zentao.env 账号密码。')
+        if cloud_error:
+            base_msg += '（注：平台已配凭据但云端连不上禅道：%s；本机若在内网可配本地凭据直连。）' % cloud_error
+        return {'ok': False, 'error': base_msg}, 3
 
     ok, msg = client.credentials_ok()
     if not ok: