@hupan56/wlkj 3.3.6 → 3.3.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "3.3.6",
+  "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/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',