@hupan56/wlkj 3.3.14 → 3.3.15

package/bin/cli.js

@@ -383,7 +383,7 @@ async function doInit(name, roleArg) {
   console.log(`\n--- 自动初始化 ---`);
   const setupPath = path.join(cwd, ".qoder", "scripts", "deployment", "setup", "setup.py");
   if (fs.existsSync(setupPath)) {
-    const setupArgs = [name, role, "--skip-cron", "--skip-qoderwork"].filter(Boolean);
+    const setupArgs = [name, role, "--skip-cron", "--skip-qoderwork", "--skip-code"].filter(Boolean);
     try {
       const cmd = `python "${setupPath}" ${setupArgs.map(a => `"${a}"`).join(" ")}`;
       console.log(`  运行: setup.py ${setupArgs.join(" ")}`);
@@ -443,6 +443,21 @@ async function doInit(name, roleArg) {
     }
   }
 
+  // === 6.6. 连云平台 bind 项目（云模式：KG 在云平台，引擎调云 MCP）===
+  if (pyCmd) {
+    const switchScript = path.join(cwd, ".qoder", "scripts", "domain", "kg", "switch_project.py");
+    if (fs.existsSync(switchScript)) {
+      console.log(`\n--- 连云平台 bind 项目 ---`);
+      console.log(`  问平台邮箱/密码 → 拉项目列表 → 选项目 → 写 mcp_config（连云）`);
+      try {
+        const env = { ...process.env, PYTHONIOENCODING: "utf-8", PYTHONUTF8: "1" };
+        execSync(`${pyCmd} "${switchScript}"`, { cwd, stdio: "inherit", timeout: 180000, env });
+      } catch (e) {
+        console.log(`  [WARN] 云 bind 未完成，可手动: python .qoder/scripts/domain/kg/switch_project.py`);
+      }
+    }
+  }
+
   // === 7. 写版本戳 ===
   writeEngineVersion(cwd);
 

package/package.json

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

package/templates/qoder/commands/optional/wl-spec.md

@@ -12,7 +12,7 @@ User input:
 
 ## Auto Generate Spec
 1. Read current task PRD and design artifacts
-2. Load .qoder/agents/spec-generator.md
+2. dispatch 到 `qoder-spec-gen` sub-agent（.qoder/agents/qoder-spec-gen.toml — 它读 spec-generator skill + spec 契约自动生成）
 3. Generate spec.md based on PRD + Design
 4. ★ 契约头**必须**写 `status: draft`（wl-code gate 依据）：
    ```markdown
@@ -26,7 +26,9 @@ User input:
 6. Notify dev to review — 提示用户审阅后回复"确认"，确认后改 `status: confirmed`
 7. ★ 用户确认后，上传 spec 到平台（按 zentao_id 反查需求挂载 → 资产中心随需求可见，无需发布）：
    ```bash
-   python -m domain.integration.spec_upload <spec.md> --zentao-id <禅道story号> [--code-targets CtrlA,SvcB]
+   R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+   PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
+   $PY "$R/.qoder/scripts/orchestration/wlkj.py" spec-upload <spec.md> --zentao-id <禅道story号> [--code-targets CtrlA,SvcB]
    ```
    - 契约头无 `platform_spec_id` → `create_spec(zentao_id,...)` 新建 + 平台反查 Requirement 挂上 → `confirm_spec` 进 confirmed → 回写 `platform_spec_id`（幂等锚）
    - 契约头有 `platform_spec_id` → 自动走 `update_spec`（version+1，不重复建）

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

@@ -22,7 +22,9 @@ User input: $ARGUMENTS (commit message)
 7. Push to remote
 8. 回流平台：提交 + push 后执行回流，把本次 commit 沉淀到平台知识层
    ```bash
-   python -m domain.integration.return_to_platform commit --last
+   R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+   PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
+   $PY "$R/.qoder/scripts/orchestration/wlkj.py" return commit --last
    ```
    - 自动取 HEAD commit（sha/message/author/时间）→ POST 平台 `/api/git/commits/record`
    - message 里的 `[#REQ-xxx]` / `[#<禅道号>]` 平台自动解析，建 commit→需求 边

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

@@ -70,7 +70,7 @@ grep -l WLKJ_PROJECT_ID "$R/.qoder/mcp_config.json" 2>/dev/null && echo "已绑
 
 ### 未绑定或要切换？一行命令：
 ```bash
-$PY "$R/.qoder/scripts/domain/kg/switch_project.py"
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" switch-project
 ```
 脚本会：
 1. 问邮箱+密码（或用 --email/--pw 参数）
@@ -80,7 +80,7 @@ $PY "$R/.qoder/scripts/domain/kg/switch_project.py"
 
 非交互模式（CI/自动化）：
 ```bash
-$PY "$R/.qoder/scripts/domain/kg/switch_project.py" --email a@b.c --pw xxx --project-uuid <UUID>
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" switch-project --email a@b.c --pw xxx --project-uuid <UUID>
 ```
 
 **之后所有命令自动用该项目的知识层、token、回流地址。不同人选不同项目 = 完全隔离。**

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

@@ -23,6 +23,11 @@ User input: $ARGUMENTS
 | 生成 PRD 正文 | **Qoder AI** | 宿主 AI 比我们调 qwen-plus 更强 |
 | 写文件 | **Qoder Write** | 原生文件操作 |
 
+## 🚨 工具接口铁律（见 tool_guide · 会话已注入精简版）
+
+**单一信源** `.qoder/scripts/tool_guide.md`（SessionStart 已注入精简版：repo_root 定位 / 三套名 wlkj·kg·MCP 互通 / 中文歧义词提炼 / 优先级口诀）。需完整三套名映射表或歧义词清单时 Read 它。
+**两条红线常记**：① 三套名字都认（`search`/`semantic`/`context`），别因"未知子命令"慌张；② 禁 `find data/code` / `grep -r` 找模块——那是知识层 search 的活，手动做=思考链跑飞；只有 search 换词仍返 0 或已定位到具体文件时才 Grep/Read。
+
 ## 🧠 Planning Agent（完整模式强制前置 · 非建议）
 
 > ⚠️ **完整模式必须先 Planning 再生成**（不再是"建议"）。
@@ -132,7 +137,12 @@ if schema and schema.get("columns"):
 ```
 等价 CLI（脚本兜底）：
 ```bash
+# ★ 有 REQ-ID 用 ctx-cache：PRD→spec→code 链路同 REQ 复用上下文（T1.3，省 2 次往返）
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" ctx-cache <REQ-ID> <业务词> --platform <web|app>
+# 无 REQ-ID / 首次取：普通 context
 $PY "$R/.qoder/scripts/orchestration/wlkj.py" context <业务词> --platform <web|app>
+# PRD/spec 改动后失效该 REQ 缓存重来：
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" ctx-cache <REQ-ID> --clear
 ```
 - 第 4 段 = 历史 PRD（防重复）
 - 第 5 段 = 相关 API
@@ -171,6 +181,20 @@ $PY "$R/.qoder/scripts/orchestration/wlkj.py" eval <prd.md> [原型.html]
 ```
 ≥ 80% 才 PASS。完整模板见 `.qoder/templates/prd-full-template.md`。
 
+### 业务保真打分（接真命令产物 · BF1/BF2）
+
+> EVA 结构分(章齐)≠业务保真。PRD 出来后打业务保真分：产物是不是真 ICS 业务（真表/真写法）。
+```python
+from capability import resolve
+cap = resolve()
+# BF1 schema保真(提的表是真 ICS 业务表) + BF2 内容保真(LLM-judge vs 真 PRD, 是不是 ICS 写法非通用文)
+r = cap.mcp.call("bf_score", {"kind": "prd", "content": "<PRD 正文>", "feature": "<业务主题如 保险>"})
+# → BF1_schema.score(目标≥0.85) + BF2_content.score(目标≥4/5)
+```
+- BF1 低 → PRD 提了编造/非 ICS 表 → 补真表（query_schema/db_tables）。
+- BF2 低 → 内容是通用产品文非 ICS 写法 → 参考 rag_search(kind=prd) 真 PRD 范本重写。
+- 原型保真（BF3 组件/BF4 颜色）：`cap.mcp.call("bf_score", {"kind":"proto","content":"<原型 HTML>"})` → 用真 fywl-ui 设计系统核。
+
 ---
 
 ## 快速模式（6 章 Mini-PRD）

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

@@ -20,20 +20,27 @@ result = cap.mcp.call("rag_search", {"query": "车辆保养", "top_k": 8})
 
 自动路由：有 MCP 走 MCP（直连平台知识层，快），无 MCP 走 wlkj.py（CLI 降级）。零宿主感知。
 
-## ⚡ 第一步：先判断问题类型，选对检索通道（3 路检索）
+## 🚨 接口铁律（见 tool_guide · 会话已注入精简版）
 
-**核心升级：本命令有 3 路检索，按问题类型选最合适的一路（不是无脑 search_code）。**
+**单一信源** `.qoder/scripts/tool_guide.md`（SessionStart 已注入精简版：repo_root 定位 / 三套名 wlkj·kg·MCP 互通 / 中文歧义词提炼 / 优先级口诀）。需完整三套名映射表或歧义词清单时 Read 它。
+**两条红线常记**：① 三套名字都认（`search`/`semantic`/`context`/`impact`），别因"未知子命令"慌；② 禁 `find`/`grep -r`/`findstr /s` 全盘扫 `data/code`——那是 search 的活，手动做=思考链跑飞。
 
-| 问题类型 | 首选检索通道 | 为什么 |
-|---------|-------------|--------|
-| **"车辆保养"相关的代码/字段/API**（语义找相关，词不必一样） | `rag_search` 语义召回 | 能找到"维修记录"即使没共享词，召回最全 |
-| **"这个功能的业务流程是什么 / 整体怎么运转"**（全局问答） | `ask_corpus` GraphRAG 问答 | 用社区摘要直接答，不是堆代码片段 |
-| **"handleExport 这个符号在哪定义/调用"**（精确符号定位） | `search_code` 关键词 | 精确命中，找特定符号最快 |
-| **"XX怎么实现的/怎么做的"**（一次取全代码+API+字段） | `context_pack` | 一条命令拿全 8 段上下文 |
-| **"改 XX 影响谁"** | `get_impact` | 影响分析专用 |
 
-> **顺序铁律**：理解/盘点类问题，**先 rag_search（语义召回最全）**；有"整体流程/业务怎么运转"的全局问题，**再补 ask_corpus（GraphRAG 答案级）**；只在精确找某个符号/特定字符串时才用 search_code。
-> Glob 找不到文件时用 search_code 兜底，**不准跑 find/findstr/dir /s**。
+## ⚡ 第一步：确定性路由（按顺序匹配第一个命中信号，零猜测）
+
+**差模型也走得对：逐条检查 `$ARGUMENTS`，第一个命中的信号决定检索通道——不要"判断问题类型"，按表查。**
+
+| # | 信号（`$ARGUMENTS` 含这些词） | 走这个通道（直达，先调一次） |
+|---|---|---|
+| 1 | "影响谁" / "改 XX 影响" / "波及" | `get_impact`（影响分析） |
+| 2 | "表结构" / "字段" / "枚举" / "真实数据" / "查库" | DB 通道：**先 `list_envs` 问环境**（见下「数据库查询」） |
+| 3 | "哪些没测" / "覆盖" / "盲区" / "测试矩阵" | `coverage_matrix` |
+| 4 | "业务流程" / "整体怎么运转" / "是干嘛的" | `ask_corpus`（GraphRAG 问答），再叠 `rag_search` 补事实 |
+| 5 | "盘点" / "有哪些代码" / "一次取全" | `context_pack`（8 段一次拿全） |
+| 6 | 精确符号（camelCase / 下划线 / 路径，如 `handleExport`、`/asset`） | `search_code`（精确关键词） |
+| 7 | **（以上都没命中）默认** | **`rag_search`（语义召回最全，top_k=8）** |
+
+> **铁律**：理解/盘点类问题默认 `rag_search`（语义召回最全，能找到没共享词的相关代码，如"车辆保养"→"维修记录"）；只在精确找符号时用 `search_code`；Glob 找不到文件用 `search_code` 兜底，**不准 find/findstr/dir /s 全盘扫**。
 
 ### 三路检索详解（RAG 升级核心）
 

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

@@ -35,7 +35,9 @@ 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`。
+- **看任务**：`my_workbench` / `list_my_tasks` / `list_execution_tasks` **默认只返回指派给我的**（assignedTo=我），不会看到队友。要看全队排期才传 `all=true`。本地流最快，优先走它。
+- **看我的活**：本地 `qw_mcp_call("my_workbench")` **优先**（快）；本地不可得（无凭据/进程没起）再降级平台 `cap.mcp.call("get_my_zentao_panel")`（凭据走平台 per-user 配置，云防火墙时 `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/config.yaml

@@ -226,9 +226,3 @@ notification:
   console:
     type: console
     enabled: true
-
-# ── 云平台 MCP（知识层走平台，不建本地kg）──
-# 共识：本地引擎全走平台。kg MCP 连云平台 HTTP MCP@10010（81241实体+43工具），
-# 不连本地 kg.duckdb（空）。install_qoderwork 读此 url 配 mcp.json SSE。
-platform_mcp:
-  url: "http://10.89.7.120:10010/mcp"

package/templates/qoder/contracts/insight.md

@@ -0,0 +1,55 @@
+# 模块契约：insight（需求探索）
+
+> 需求上游探索站。在写 PRD 之前把"该做什么、为什么做"想清楚。
+> 四模式：clarify（默认，产品听不懂时对焦）/ discover（发现机会）/ research（调研竞品）/ plan（规划 roadmap）。
+> 与 prd 的分工：insight 想清楚方向，prd 落地怎么做。
+
+---
+
+## Input（吃什么）
+
+| 优先级 | 输入 | 怎么用 |
+|--------|------|--------|
+| **完整** | 一个模糊需求/产品想法 | 先 clarify 对焦，再按需 discover/research/plan |
+| 参考 | 现状代码/业务 | `context_pack` / `feature_overview` 锚定现状，禁止编造 |
+| 参考 | 竞品/外部信息 | research 模式走 WebSearch + 多 agent 调研 |
+
+**第一性原理**：看未来，不编造。结论必须锚定现状（context_pack）。
+
+---
+
+## Output（吐什么）
+
+### 探索产物
+
+```
+路径：data/docs/drafts/
+内含（按模式产出）：
+  insight-plan-{topic}-{date}.md      ← plan 模式：OST/Gap 分析 + MVP + Roadmap
+  research-agent-{N}-{视角}.md        ← research 模式：多视角调研中间产物
+  insight-research-{topic}-{date}.md  ← research 模式：汇总报告
+  clarify-prototype-*.html            ← clarify 模式：帮产品理解的原型（可选）
+```
+
+### 核心方法
+
+- **OST**（Objective-Strategy-Tactic）：目标→策略→战术拆解
+- **JTBD**（Jobs-to-be-done）：用户要完成的"任务"
+- **Gap 分析**：现状 vs 目标的差距 → 机会
+
+---
+
+## 校验（合格标准）
+
+- [ ] 结论锚定现状（引用了 context_pack / 真实代码），非空中楼阁
+- [ ] 全中文输出（语言锁）
+- [ ] 有明确"转 PRD"或"放弃"的建议，不悬空
+- [ ] research 模式：调研有来源，不是泛泛而谈
+
+---
+
+## 不做（边界）
+
+- 不写实现级 PRD（那是 prd 模块的活）
+- 不直接改代码（那是 code 模块的活）
+- discover/research 是辅助决策，**最终是否落地由人决定**

package/templates/qoder/hooks/pre-tool-use-commit.py

@@ -0,0 +1,124 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""pre-tool-use-commit.py - P0-3 w3: wl-commit msg 门禁（PreToolUse on Bash git commit）
+
+stop-eval.py 里 _enforce_commit_msg_gate 的**正确落点**：pre-tool-use（commit 执行前验 msg），
+而非 stop-eval（后者 git log -1 不分"本轮 wl-commit" vs 平台开发/工具 commit → 误拦）。
+
+做法（确定性 + 不误拦其他）：
+  1. PreToolUse 命中 Bash + command 含 "git commit"
+  2. 提取 -m 消息（兼容 -m "x" / -m 'x' / --message=x / 多 -m）
+  3. 查需求关联标记 [#REQ-<uuid>] (S3) 或 [#<禅道号>] (S5.1)
+  4. 缺标记：
+     - 默认 ADVISORY（exit 0 + stdout 强提醒）—— 不阻断，避免误拦工具/平台/文档 commit
+     - 环境变量 WLCOMMIT_GATE_BLOCK=1 时 → exit 2 硬拦（wl-commit 强流程场景才开）
+
+铁律：永远 exit 0（除非 BLOCK 模式显式开）；失败 try/except 静默（hook 崩绝不阻塞）。
+非 git commit 命令 / 非 Bash → exit 0。
+"""
+import json
+import os
+import re
+import sys
+
+if sys.platform == 'win32':
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+        sys.stderr.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+
+NL = chr(10)
+BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+HOOK_ERRORS_LOG = os.path.join(BASE, '.qoder', '.runtime', 'hook-errors.log')
+
+# 需求关联标记：[#REQ-xxx] 或 [#123]（禅道号）
+_REQ_TAG_RE = re.compile(r'\[#REQ-[\w-]+\]|\[#\d+\]')
+# 提取 git commit -m 的消息（兼容引号/多段/--message= / 组合短旗 -am）
+# (?:^|\s)-[a-zA-Z]*m  匹配 -m / -am / -cm 等（单 dash 短旗组合；空白前缀避 --message 误匹）
+_M_QUOTED = re.compile(r'''(?:^|\s)-[a-zA-Z]*m\s*(['"])(.*?)\1''', re.S)
+_M_BARE = re.compile(r'(?:^|\s)-[a-zA-Z]*m\s+(\S.*?)\s*(?=(?:^|\s)-[a-zA-Z]*m\s|$)', re.S)
+_MSG_EQ = re.compile(r'(?:^|\s)--message=(\S.*?)\s*(?:--|$)', re.S)
+
+
+def _read_stdin():
+    try:
+        raw = sys.stdin.read()
+        if raw and raw.strip():
+            return json.loads(raw)
+    except Exception:
+        pass
+    return {}
+
+
+def _extract_msg(command):
+    """从 git commit 命令里提取 commit message（拼多 -m）。提不到返 ''。"""
+    if "--message=" in command:
+        m = _MSG_EQ.search(command)
+        if m:
+            return m.group(1).strip()
+    # 所有 -m "..." / -m '...' 段拼接
+    parts = _M_QUOTED.findall(command)  # [(quote, msg), ...]
+    if parts:
+        return "\n".join(p[1] for p in parts).strip()
+    # 裸 -m word（无引号）
+    m = _M_BARE.search(command)
+    if m:
+        return m.group(1).strip()
+    return ""
+
+
+def _log_err(line):
+    from datetime import datetime
+    try:
+        os.makedirs(os.path.dirname(HOOK_ERRORS_LOG), exist_ok=True)
+        with open(HOOK_ERRORS_LOG, 'a', encoding='utf-8') as f:
+            f.write('[{}] pre-tool-use-commit: {}{}'.format(
+                datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(line)[:200], NL))
+    except Exception:
+        pass
+
+
+def main():
+    data = _read_stdin()
+    tool = data.get("tool_name") or data.get("tool") or ""
+    if tool.lower() not in ("bash", "shell", "execute_bash"):
+        sys.exit(0)
+    tinput = data.get("tool_input") or data.get("input") or {}
+    command = tinput.get("command") or tinput.get("cmd") or ""
+    if not isinstance(command, str) or "git commit" not in command:
+        sys.exit(0)
+    # 跳过 --amend 无 -m / 自动生成（如 merge commit）—— 只验带 -m 的显式 commit
+    msg = _extract_msg(command)
+    if not msg:
+        sys.exit(0)  # 提不到 -m（可能 -F 文件或 amend），不拦
+    if _REQ_TAG_RE.search(msg):
+        sys.exit(0)  # 含需求标记，放行
+
+    # 缺标记
+    block_mode = os.environ.get("WLCOMMIT_GATE_BLOCK", "").lower() in ("1", "true", "yes")
+    preview = msg.replace("\n", " ")[:100]
+    if block_mode:
+        sys.stderr.write(
+            '【wl-commit msg 门禁·硬拦】commit msg 缺需求关联标记:\n  %s\n'
+            '修复: git commit --amend 补 [#REQ-<uuid>] (S3) 或 [#<禅道号>] (S5.1 push 后)。\n'
+            '(此硬拦由 WLCOMMIT_GATE_BLOCK=1 开启；平台/工具/文档 commit 关该 env 或走非 wl-commit 流程。)\n'
+            % preview)
+        sys.exit(2)
+    # 默认 advisory：不阻断，强提醒
+    sys.stdout.write(
+        '⚠️ 【wl-commit msg 提醒】本次 commit msg 缺需求关联标记 [#REQ-xxx]/[#禅道号]:\n'
+        '  %s\n'
+        '若这是 /wl-commit 流程，建议 amend 补标记关联需求(F1 闭环数据)；'
+        '若是平台/工具/文档 commit 可忽略本提醒。\n' % preview)
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except SystemExit:
+        raise
+    except Exception as e:
+        _log_err("fatal: %s" % str(e)[:150])
+        sys.exit(0)  # 永不阻塞

package/templates/qoder/hooks/session-start.py

@@ -129,7 +129,7 @@ def get_index_info():
             recent = errors[-10:]  # 取最后 10 行检查
             if len(recent) >= 3:
                 lines.append('[WARN] hook 最近频繁失败 (%d 条错误), 详情见 .qoder/.runtime/hook-errors.log' % len(recent))
-                lines.append('  跑 python .qoder/scripts/setup/init_doctor.py --fix 排查')
+                lines.append('  跑 python .qoder/scripts/orchestration/wlkj.py doctor --fix 排查')
     except OSError:
         pass
 
@@ -289,6 +289,22 @@ def get_usability_summary():
     return NL.join(lines) if lines else ''
 
 
+def get_tool_guide():
+    """注入 tool_guide 精简版(共用工具用法关键执行位), 命令正文不再重复(单一信源, T1.2)。
+    完整版见 .qoder/scripts/tool_guide.md。纯静态文本, 失败绝不阻塞。"""
+    return NL.join([
+        '## Tool Guide (共用工具用法 · 完整见 .qoder/scripts/tool_guide.md)',
+        '环境自检(任何脚本前先跑, 定 R/$PY):',
+        '  R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.',
+        '  PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)',
+        '  后续统一 $PY "$R/.qoder/scripts/orchestration/wlkj.py" <命令>',
+        '接口三套名互通: wlkj.py / kg.py / MCP 名字都认(search/semantic/context/impact), 别因"未知子命令"慌',
+        '中文歧义词先提炼再查: 保险->车险/商业险/交强险 · 异常->告警/报错 · 计划->作业/养护',
+        '禁全盘扫: 不要 find / grep -r / findstr /s / os.walk data/code, 那是知识层 search 的活',
+        '优先级口诀: 精确搜用Grep · 语义找用rag_search · 取全用context_pack · 查库先list_envs · 影响用get_impact',
+    ])
+
+
 def main():
     parts = []
     parts.append('<qoder-context>')
@@ -345,6 +361,9 @@ def main():
         parts.append('')
         parts.append(style_info)
 
+    parts.append('')
+    parts.append(get_tool_guide())
+
     parts.append('</qoder-context>')
     # Hook-1: 健康标记 — AI 能感知 hook 是否真的跑了
     # QoderWork/Quest 里看不到 [hook-ok] 就知道 hook 没生效, 要自取上下文

package/templates/qoder/hooks/stop-eval.py

@@ -179,6 +179,127 @@ def _last_record_by_prd():
     return last_by_prd
 
 
+def _enforce_code_ac_gate():
+    """P0-3: wl-code spec AC 门禁。找近 spec + eval_code_ac.py 对账, AC<100% 阻断。
+
+    治"代码漏实现 spec AC"（wl-code 自检全打勾反例）。无 spec / 脚本缺失 / 崩溃 → 放行(不阻塞)。
+    """
+    import subprocess
+    qoder_script = os.path.join(BASE, '.qoder', 'scripts', 'validation', 'metrics', 'eval_code_ac.py')
+    pkg_script = os.path.join(BASE, 'packages', 'wlkj', 'templates', 'qoder',
+                              'scripts', 'validation', 'metrics', 'eval_code_ac.py')
+    script = qoder_script if os.path.isfile(qoder_script) else pkg_script
+    if not os.path.isfile(script):
+        return  # 脚本不在, 放行
+    try:
+        r = subprocess.run([sys.executable, script], cwd=BASE,
+                           capture_output=True, text=True, timeout=30)
+    except Exception:
+        return  # 崩溃绝不阻塞
+    if r.returncode != 2:
+        return  # exit 0 = 无 spec / AC 全覆盖, 放行
+    out_lines = [l for l in (r.stdout or '').split('\n') if l.strip()]
+    try:
+        data = json.loads(out_lines[-1]) if out_lines else {}
+    except Exception:
+        data = {}
+    missed = data.get('missed', []) or []
+    rate = data.get('rate', 0)
+    miss_str = '\n'.join('  - ' + str(m)[:80] for m in missed[:5])
+    sys.stderr.write(
+        '【wl-code AC 门禁】检测到 spec 验收标准未被代码覆盖 (覆盖率 %s%%):\n%s\n'
+        '修复: 对照 spec 第6章 PRD 验收标准映射表, 把未实现的 AC 补进代码, 重跑至 100%%。\n'
+        % (int(rate * 100), miss_str))
+    sys.exit(2)
+
+
+def _enforce_cases_lint_gate():
+    """P0-3 w2: wl-test cases 格式门禁。扫近 10min cases 文件(含 intent/action/anchor 键的 json),
+    跑 lint_cases.py，旧格式(action+CSS selector) → exit 2。无 cases/脚本缺/崩溃 → 放行(不阻塞)。"""
+    import subprocess
+    qoder_script = os.path.join(BASE, '.qoder', 'scripts', 'validation', 'metrics', 'lint_cases.py')
+    pkg_script = os.path.join(BASE, 'packages', 'wlkj', 'templates', 'qoder',
+                              'scripts', 'validation', 'metrics', 'lint_cases.py')
+    script = qoder_script if os.path.isfile(qoder_script) else pkg_script
+    if not os.path.isfile(script):
+        return
+    now = time.time()
+    cases_files = []
+    for root in (os.path.join(BASE, 'workspace', 'members'), os.path.join(BASE, 'workspace', 'tasks')):
+        if not os.path.isdir(root):
+            continue
+        for dirpath, dirs, files in os.walk(root):
+            dirs[:] = [d for d in dirs if d not in ('node_modules', '.git', '__pycache__', '.secrets')]
+            for fn in files:
+                if not fn.endswith('.json'):
+                    continue
+                fp = os.path.join(dirpath, fn)
+                try:
+                    if now - os.path.getmtime(fp) > 600:
+                        continue
+                except OSError:
+                    continue
+                try:
+                    head = open(fp, encoding='utf-8', errors='replace').read(2000)
+                except Exception:
+                    continue
+                if '"intent"' in head or '"action"' in head or '"anchor"' in head:
+                    cases_files.append(fp)
+    for fp in cases_files[:5]:
+        try:
+            r = subprocess.run([sys.executable, script, fp, '--json'], cwd=BASE,
+                               capture_output=True, text=True, timeout=15)
+        except Exception:
+            continue
+        if r.returncode != 2:
+            continue
+        out_lines = [l for l in (r.stdout or '').split('\n') if l.strip()]
+        try:
+            data = json.loads(out_lines[-1]) if out_lines else {}
+        except Exception:
+            data = {}
+        blocks = [v for v in (data.get('violations') or []) if v.get('severity') == 'BLOCK']
+        if blocks:
+            detail = '\n'.join('  - case#%s %s' % (v.get('idx'), str(v.get('detail', ''))[:60]) for v in blocks[:5])
+            sys.stderr.write(
+                '【wl-test cases 门禁】%s 检测到旧格式用例(action+CSS selector，新 Playwright 管线不认):\n%s\n'
+                '修复: 改 intent+anchor 格式，anchor={role,name}(来自 recall/snapshot)，凭据用 {{ask:key}}。\n'
+                % (os.path.basename(fp), detail))
+            sys.exit(2)
+
+
+def _enforce_commit_msg_gate():
+    """P0-3 w3: wl-commit msg 门禁。近 30min commit msg 须含 [#REQ-xxx] 或 [#禅道号]。
+
+    治"commit 不关联需求"（F1 闭环数据断）。memory commit-convention-zentao-id:
+    S3 [#REQ-<uuid8>] / S5.1 push 后 [#<禅道号>]。无标记 → exit 2 提示 amend。
+    """
+    import re as _re
+    import subprocess
+    try:
+        r = subprocess.run(['git', 'log', '-1', '--format=%B|||%ct'], cwd=BASE,
+                           capture_output=True, text=True, timeout=10)
+        out = (r.stdout or '').strip()
+    except Exception:
+        return  # 崩溃不阻塞
+    if '|||' not in out:
+        return
+    msg, _, ts_s = out.rpartition('|||')
+    try:
+        ts = int(ts_s)
+    except ValueError:
+        ts = 0
+    if ts and time.time() - ts > 1800:
+        return  # 非本轮 commit
+    if _re.search(r'\[#REQ-[\w-]+\]|\[#\d+\]', msg):
+        return  # 含需求标记, 放行
+    sys.stderr.write(
+        '【wl-commit msg 门禁】最近 commit msg 缺需求关联标记:\n  %s\n'
+        '修复: git commit --amend 补 [#REQ-<uuid>] (S3) 或 [#<禅道号>] (S5.1 push 后)。\n'
+        % msg.replace('\n', ' ')[:120])
+    sys.exit(2)
+
+
 def main():
     try:
         data = _read_stdin()
@@ -186,6 +307,14 @@ def main():
         if _is_reentry(data):
             sys.exit(0)
 
+        # ★ P0-3 wl-code spec AC 门禁（代码漏实现 AC 检测, 治自检全打勾）
+        _enforce_code_ac_gate()
+        # P0-3 w2 wl-test cases 格式门禁（旧 action+CSS selector → 拦）
+        _enforce_cases_lint_gate()
+        # w3 wl-commit msg 门禁: 应在 pre-tool-use（git commit 命令前验 msg）而非 stop-eval——
+        # stop-eval 的 git log -1 不分"本轮 wl-commit"vs 其他 commit, 会在平台开发等非 wl-commit
+        # 场景误拦。函数 _enforce_commit_msg_gate 已定义待 pre-tool-use 细化接入。
+
         # 找近 10 分钟产出的 PRD, 检查是否已【通过】门禁
         recent = _recent_prd_files()
         if not recent:

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

@@ -21,6 +21,7 @@ McpMemoryProvider：memory 职责链的 MCP provider，接通 kg.duckdb learning
 """
 from __future__ import annotations
 
+import json
 from typing import Any, Optional
 
 from ..registry_mcp import McpRegistry, _load_servers
@@ -132,6 +133,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 +189,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.py

@@ -17,10 +17,7 @@ import os
 from typing import Any
 
 from .caps import (
-    NoOpCronCap,
-    NoOpNotifyCap,
     NoOpPresentCap,
-    NoOpSandboxCap,
 )
 
 

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

@@ -51,7 +51,7 @@ _KNOWLEDGE_SERVER_ALIASES = ["wlinkj-knowledge", "qoder-knowledge-graph"]
 SERVERS: dict[str, dict] = {
     "qoder-knowledge-graph": {
         "kind": "http",
-        "url": "http://127.0.0.1:10010/mcp",
+        "url": os.environ.get("WLKJ_BASE_URL", "http://10.89.7.120") + "/mcp",
         "note": "知识图谱。已改为 http 模式，指向资产平台 MCP 服务（POST /mcp JSON-RPC）",
     },
     "qoder-zentao": {
@@ -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]: