@hupan56/wlkj 3.3.5 → 3.3.7

package/package.json

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

package/templates/qoder/commands/wl-prd.md

@@ -23,6 +23,29 @@ User input: $ARGUMENTS
 | 生成 PRD 正文 | **Qoder AI** | 宿主 AI 比我们调 qwen-plus 更强 |
 | 写文件 | **Qoder Write** | 原生文件操作 |
 
+## 🚨 工具接口铁律（防思考链跑飞，先读）
+
+**① 一个门面，名字随便叫都对。** 知识查询统一走 `wlkj.py` 或 `kg.py`，**三套名字已互通**（引擎层别名）：
+| 你想干 | wlkj.py | kg.py | MCP 工具名 |
+|---|---|---|---|
+| 搜代码 | `wlkj.py search <词>` | `kg.py search <词>` | search_code |
+| 搜 API | `wlkj.py search <词>` | `kg.py api <词>` | search_api |
+| 语义检索 | `wlkj.py semantic <词>` | `kg.py semantic <词>` | rag_search |
+| 上下文打包 | `wlkj.py context <词>` | `kg.py context <词>` | context_pack |
+> 用哪个名都行（`kg.py search_code` 也认）。**别再因"未知子命令"慌张**。
+
+**② 中文歧义词先提炼再查**（否则 context "保险" 命中的是社保不是车险）：
+- 保险 → 车辆保险 / 商业险 / 交强险 / 保险异常
+- 异常 → 告警 alarmType / 报错 / 校验失败
+- 计划 → 作业计划 / 养护计划 / 计划任务
+- 列表/记录 → 带具体业务对象（车辆保险记录、考勤记录）
+> 拿不准时先 `kg.py search <具体词>` 看返回的控制器/实体名，再用全名 `kg.py context <全名>`。
+
+**③ 禁止跌入手动 grep/find 读源码。** 知识层有就拿知识层；**只有**以下情况才用 Grep/Read 读源码：
+- 知识层确实没建（search 返 0 条，且换词仍 0）
+- 要看某个具体文件的实现细节（已定位到文件）
+> ❌ 不要 `find data/code` / `grep -r` 找模块——那是知识层 search 的活，手动做=思考链跑飞。
+
 ## 🧠 Planning Agent（完整模式强制前置 · 非建议）
 
 > ⚠️ **完整模式必须先 Planning 再生成**（不再是"建议"）。

package/templates/qoder/commands/wl-search.md

@@ -20,6 +20,25 @@ result = cap.mcp.call("rag_search", {"query": "车辆保养", "top_k": 8})
 
 自动路由：有 MCP 走 MCP（直连平台知识层，快），无 MCP 走 wlkj.py（CLI 降级）。零宿主感知。
 
+## 🚨 接口铁律（防混名/防歧义，先读）
+
+**① 三套名字已互通**（引擎层别名，AI 猜哪个都对，别因"未知子命令"慌）：
+| 干啥 | wlkj.py / kg.py 子命令 | MCP 工具名 |
+|---|---|---|
+| 搜代码 | `search <词>` | search_code |
+| 搜 API | `api <词>`（kg.py）/ `search <词>`（wlkj.py）| search_api |
+| 语义检索 | `semantic <词>` | rag_search |
+| 上下文 | `context <词>` | context_pack |
+| 影响分析 | `impact <实体>` | get_impact |
+> `kg.py search_code 保险` = `kg.py search 保险`，都认。
+
+**② 中文歧义词先提炼**（否则"保险"命中社保不是车险）：
+保险→车辆保险/商业险/交强险 · 异常→告警alarmType/报错 · 计划→作业/养护计划 · 列表→带业务对象（车辆保险记录）。
+拿不准先 `search <具体词>` 看返回的控制器名，再用全名 `context <全名>`。
+
+**③ 禁止 find/grep 手动找模块**——那是 search 的活。只有 search 换词仍返 0 或要看具体文件实现时，才用 Grep/Read。
+
+
 ## ⚡ 第一步：先判断问题类型，选对检索通道（3 路检索）
 
 **核心升级：本命令有 3 路检索，按问题类型选最合适的一路（不是无脑 search_code）。**

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

@@ -872,6 +872,20 @@ def main(argv=None):
         return 0
     cmd = argv[0]
     rest = argv[1:]
+    # ★ MCP 名兼容：AI 常把 MCP 工具名(search_code)当 kg.py 子命令调 → "未知子命令"。
+    # 在此统一归一化，AI 猜哪个名（kg.py 子命令 / MCP 工具名）都能命中（治工作流混名）。
+    _MCP_ALIASES = {
+        'search_code': 'search', 'search_api': 'api', 'search_prds': 'prd',
+        'search_field': 'search', 'search_style': 'search', 'search_wiki': 'wiki',
+        'rag_search': 'semantic', 'ask_corpus': 'semantic',
+        'context_pack': 'context', 'context_360': 'context360',
+        'get_impact': 'impact', 'multi_hop': 'hop',
+        'coverage_matrix': 'coverage', 'feature_overview': 'feature',
+        'get_workflow': 'workflow', 'get_design_system': 'design-system',
+        'fill_prototype': 'fill-prototype',
+    }
+    if cmd in _MCP_ALIASES:
+        cmd = _MCP_ALIASES[cmd]
     # 查找子命令
     handler = None
     for name, fn, _ in COMMANDS:

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

@@ -51,9 +51,21 @@ from foundation.integrations.zentao_client import ZentaoClient
 # ============================================================
 
 def _zentao_creds():
-    """构建禅道客户端。凭据不全返回 None。
-    url 来自 .qoder/config.yaml (团队共享); user/password 来自 secrets/zentao.env (个人)。"""
-    return ZentaoClient.from_config()
+    """构建禅道客户端。返回 (client, preset_account)。
+
+    凭据源优先级：
+      ① 云平台 per-user 凭据（Option A：get_zentao_creds）—— account 已知（preset）
+      ② 本地 .qoder/config.yaml + secrets/zentao.env —— account 走 member.json
+    云凭据优先：demo 机器在内网可达禅道，平台凭据比本地文件更可能是最新配的。
+    凭据全无 → (None, '')。
+    """
+    c = _cloud_zentao_creds()
+    if c and c.get('ok') and c.get('url') and c.get('account') and c.get('password'):
+        try:
+            return ZentaoClient(c['url'], c['account'], c['password']), c['account']
+        except Exception:
+            pass
+    return ZentaoClient.from_config(), ''
 
 
 def _cloud_my_panel():
@@ -107,6 +119,52 @@ def _cloud_my_panel():
     return data  # {ok:True/False, ...}
 
 
+def _cloud_zentao_creds():
+    """Option A：从平台取禅道凭据（url/account/password 解密）。
+
+    用途：云到禅道被防火墙挡（my-panel 登录失败）时，本机（demo 机器，内网可达）
+    用平台凭据直连禅道拉真实数据。凭据随绑定 token 取本人配置（同信任级）。
+    Returns: {ok:True, url, account, password} 或 None（云不可达/未配置）。
+    """
+    import json as _json
+    import urllib.request as _u
+    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
+    endpoint = url if url.endswith('/mcp') else url + '/mcp'
+    body = _json.dumps({"jsonrpc": "2.0", "id": 1, "method": "tools/call",
+                        "params": {"name": "get_zentao_creds", "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=15) as resp:
+            r = _json.loads(resp.read().decode('utf-8', errors='replace'))
+        text = r.get('result', {}).get('content', [{}])[0].get('text', '')
+        data = _json.loads(text) if text else {}
+        return data if data.get('ok') else None
+    except Exception:
+        return None
+
+
 def _resolve_my_account(developer):
     """解析当前 developer → 禅道 account。返回 (account, 错误原因)。"""
     mem = get_member(developer)
@@ -451,28 +509,31 @@ def fetch_workbench(include_closed=False, kind=None):
     else:
         cloud_error = None  # 云不可达（switch_project 没跑/平台宕机）→ 静默回退本地
 
-    # ① 凭据（本地回退）
-    client = _zentao_creds()
+    # ① 凭据（云平台优先 Option A，回退本地文件）
+    client, preset_account = _zentao_creds()
     if client is None:
-        base_msg = ('禅道凭据未配置。推荐在【平台设置 → 禅道】配置（panel 自动走云）；'
+        base_msg = ('禅道凭据未配置。推荐在【平台设置 → 禅道】配置（panel 自动走云取凭据）；'
                     '或本地 .qoder/config.yaml 的 zentao.url + secrets/zentao.env 账号密码。')
         if cloud_error:
-            base_msg += '（注：平台已配凭据但云端连不上禅道：%s；本机若在内网可配本地凭据直连。）' % cloud_error
+            base_msg += '（云 my-panel 失败：%s）' % cloud_error
         return {'ok': False, 'error': base_msg}, 3
 
     ok, msg = client.credentials_ok()
     if not ok:
         return {'ok': False, 'error': '禅道凭据不完整: %s' % msg}, 3
 
-    # ② 内网连通
+    # ② 内网连通（本机能否直连禅道——demo 机器在内网可达）
     ok, msg = client.check_intranet()
     if not ok:
-        return {'ok': False, 'error': '连不上禅道内网: %s' % msg}, 5
+        return {'ok': False, 'error': '本机连不上禅道内网: %s' % msg}, 5
 
-    # ③ 归属
-    my_account, err = _resolve_my_account(developer) if developer else (None, '未识别当前开发者身份。')
-    if not my_account:
-        return {'ok': False, 'error': err}, 3
+    # ③ 归属（云凭据带的 account 优先；否则走 member.json）
+    if preset_account:
+        my_account = preset_account
+    else:
+        my_account, err = _resolve_my_account(developer) if developer else (None, '未识别当前开发者身份。')
+        if not my_account:
+            return {'ok': False, 'error': err}, 3
 
     # ④ 收集 (三域并行, 按 kind 决定取哪几域)
     from concurrent.futures import ThreadPoolExecutor

package/templates/qoder/scripts/orchestration/wlkj.py

@@ -47,6 +47,17 @@ DISPATCH = {
     'kg-incremental': 'domain/kg/build/kg_incremental.py',
     'kg-semantic': 'domain/kg/graph/kg_semantic.py',
     'semantic': 'domain/kg/graph/kg_semantic.py',
+    # ★ MCP 名别名（AI 常把 MCP 工具名当 wlkj.py 命令调 → 未知命令。归一化后两边名都认）
+    'search_code': 'domain/kg/search/search_index.py',
+    'search_api': 'domain/kg/search/search_index.py',
+    'search_prds': 'domain/kg/search/search_index.py',
+    'search_field': 'domain/kg/search/search_index.py',
+    'search_style': 'domain/kg/search/search_index.py',
+    'rag_search': 'domain/kg/graph/kg_semantic.py',
+    'ask_corpus': 'domain/kg/graph/kg_semantic.py',
+    'context_pack': 'domain/kg/search/context_pack.py',
+    'context_360': 'domain/kg/search/context_pack.py',
+    'get_impact': 'domain/kg/search/search_index.py',
     'style': 'domain/kg/build/build_style_index.py',
     # ── 任务 / 同步 ──
     'task': 'domain/task/task.py',