@hupan56/wlkj 3.3.6 → 3.3.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "3.3.6",
+  "version": "3.3.8",
   "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/commands/wl-task.md

@@ -36,6 +36,23 @@ PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
 禅道是**每人一个账号**（凭据在 `workspace/members/{我}/.private/secrets/zentao.env`，gitignore），归属靠 member.json 的 `zentao_account` 映射 + 工具默认行为兜底：
 
 - **看任务**：`my_workbench` / `list_my_tasks` / `list_execution_tasks` **默认只返回指派给我的**（assignedTo=我），不会看到队友。要看全队排期才传 `all=true`。
+- **★ 看我的活（任务+需求+Bug 三域聚合）优先走平台 panel**（凭据走平台 per-user 配置，不再依赖本地 zentao.env）：
+  ```python
+  # ① 优先：平台聚合（云平台用平台凭据调禅道，凭据不出平台）
+  r = cap.mcp.call("get_my_zentao_panel", {})
+  if r.get("ok"):
+      # r.tasks / r.bugs / r.stories = 指派给我的全量（跨所有执行/产品）
+      ...
+  elif "未配置" in (r.get("error") or "") or "登录失败" in (r.get("error") or ""):
+      # ② 云到禅道被防火墙挡 → 取平台凭据 + 本机内网直连（demo 机器在内网可达）
+      c = cap.mcp.call("get_zentao_creds", {})
+      if c.get("ok"):
+          # 用 c.url/c.account/c.password 直连禅道拉我的活（脚本/qw_mcp_call）
+          ...
+  # ③ 都不可得 → 降级 qw_mcp_call("my_workbench") → 本地 task.py
+  ```
+  > 平台 panel 是新增的首选路径：凭据托管在平台（【平台设置→禅道】配一次，全机生效），不用每台机器配 `secrets/zentao.env`。云防火墙时 `get_zentao_creds` 取凭据本机直连。
+- **Bug→需求反查**：`cap.mcp.call("bug_trace", {"bug_id": X})` 查"这个 Bug 是哪个需求引入的"（平台新增，替代手动翻禅道）。
 - **空账号直接拒绝**：member.json 没配 `zentao_account` 时，"看我的"工具返回 `🚫 未识别禅道身份`（不再静默降级返回全队）。原样转述，引导 `/wl-init`。
 - **改任务前必校验**：start/finish/assign/update 拿到 task_id 后，**先 `get_task(id)` 看 assignedTo**：
   - `assignedTo == 我` → 正常执行；

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/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',