@hupan56/wlkj 2.7.12 → 3.1.2

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

@@ -16,7 +16,7 @@ User input: $ARGUMENTS
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`；所有仓库内相对路径（workspace/、data/code/）都前置 `"$R/"`。
+> 后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`；所有仓库内相对路径（workspace/、data/code/）都前置 `"$R/"`。
 
 ## CRITICAL: Data Isolation
 
@@ -35,52 +35,33 @@ If no developer is set, refuse and say "Run /wl-init first".
 
 ## Data Sources (All Filtered by Current Developer)
 
-### 1. Who am I?
-```
-Read .qoder/.developer -> get developer name (e.g., "小王")
-This name is used to filter ALL data below.
-```
+### ⚡ Fast Path：一次拿全（必须先跑，禁止逐个 cat/ls/git log）
 
-### 2. My Tasks (workspace/tasks/)
 ```bash
-# Find tasks where creator OR assignee = current developer
-python "$R/.qoder/scripts/task.py" list --mine
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+python "$R/.qoder/scripts/orchestration/wlkj.py" report-snapshot "$R"            # 日报(今天)
+python "$R/.qoder/scripts/orchestration/wlkj.py" report-snapshot "$R" --days 7   # 周报(近7天)
 ```
-Only show tasks where task.json has:
-- `creator` == current developer, OR
-- `assignee` == current developer
 
-### 3. My Session History
-```
-Read: workspace/members/{current_developer}/journal/
-Only files in THIS developer's journal directory.
-```
+一个命令返回 JSON，**5 个数据源已全部按当前开发者过滤**：
+- `developer` — 当前开发者名（过滤键）
+- `my_tasks` — task.py list --mine 的结果
+- `commits` — {项目: [提交]} 自动扫 data/code/ 各项目按 author 过滤
+- `journal` — 该开发者 journal 的学习/反馈事件
+- `my_prds` — 该开发者写的 PRD/草稿
+- `date_range` — 报告日期范围
 
-### 4. My Git Commits
-```bash
-# For each project in data/code/:
-cd "$R/data/code/{project}"
-git log --author="{current_developer}" --since="{date}" --oneline
-```
-Filter by git author matching current developer name.
-
-### 5. My PRDs
-```
-Read: workspace/members/{current_developer}/drafts/ -> drafts by this developer
-Read: workspace/specs/prd/*.md -> check if PRD frontmatter has author == current developer
-```
+> 性能：旧方式 7 步顺序采集、5-7 次调用；聚合后 1 轮 1 次调用（实测更快）。
+> `developer` 为 "(未设置)" → 停下，提示先 `/wl-init`。缺失字段为 null = 该源无内容，如实写"无产出"。
 
 ---
 
 ## Daily Report Flow
 
-1. Read `.qoder/.developer` -> get developer name and role
-2. Calculate today's date range
-3. Filter tasks by creator/assignee == developer
-4. Filter git log by --author == developer
-5. Read developer's journal entries from today
-6. Check developer's drafts for new PRDs
-7. Generate report with ONLY this developer's data
+1. **跑聚合脚本一次拿全数据**（见上 Fast Path，已含 developer/tasks/commits/journal/prds）
+2. **用拿到的数据生成报告**（只写当前开发者的数据，见下方模板）
+
+> 禁止再逐个 cat .developer / ls / git log —— 聚合脚本已全给。数据源无内容就如实写"无产出"。
 
 Output:
 ```
@@ -102,7 +83,7 @@ Output:
 ```
 
 Save to: workspace/members/{developer}/journal/daily-{date}.md
-Then auto-sync (user never touches git): `python "$R/.qoder/scripts/team_sync.py" push`
+Then auto-sync (user never touches git): `cap.mcp.call("sync", {"direction": "push"})`
 
 ---
 
@@ -151,7 +132,7 @@ Output:
 ```
 
 Save to: workspace/members/{developer}/journal/weekly-{week}.md
-Then auto-sync (user never touches git): `python "$R/.qoder/scripts/team_sync.py" push`
+Then auto-sync (user never touches git): `cap.mcp.call("sync", {"direction": "push"})`
 
 ---
 

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

@@ -16,7 +16,7 @@ User input: $ARGUMENTS (default: show current status)
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`；仓库内相对路径都前置 `"$R/"`。
+> 后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`；仓库内相对路径都前置 `"$R/"`。
 
 ## Scopes
 - (no arg or "current") -> Current sprint status
@@ -30,7 +30,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 **PREFERRED: MCP 工具：**
 ```
-mcp__qoder-knowledge-graph__feature_overview(feature='资产管理')
+cap.mcp.call("feature_overview", {"feature": "资产管理"})
 ```
 
 返回：该功能的完整画像——后端端点 + 前端按钮 + 测试用例 + 关联页面 + PRD。
@@ -66,10 +66,10 @@ Show:
 ## Health Score
 Calculate from:
 | Dimension | Weight | Source |
-| EVA quality trend | 25% | tail .qoder/learning/eval-history.jsonl (avg score_pct, target >=80) |
+| EVA quality trend | 25% | tail data/learning/eval-history.jsonl (avg score_pct, target >=80) |
 | Index freshness | 20% | data/index/.index-meta.json last_sync (<=7 days) + verify checks |
 | On-time delivery | 20% | task completion dates |
-| Sync health | 15% | python "$R/.qoder/scripts/team_sync.py" status (ahead/behind/dirty) |
+| Sync health | 15% | python "$R/.qoder/scripts/orchestration/wlkj.py" sync status (ahead/behind/dirty) |
 | Pipeline flow | 10% | PRD->Spec->Code conversion |
 | Learning growth | 10% | learning/patterns/ entries |
 

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

@@ -16,7 +16,7 @@ User input: $ARGUMENTS
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
+> 后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
 
 ## Step 1: Load Spec
 
@@ -26,7 +26,7 @@ Read the spec file to understand requirements.
 
 ## Step 2: Search Related Code
 
-Run: python "$R/.qoder/scripts/search_index.py" <keyword>
+Run: python "$R/.qoder/scripts/orchestration/wlkj.py" search <keyword>
 Find existing code that this implementation relates to.
 Read relevant files for context.
 

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

@@ -1,9 +1,9 @@
 ---
 name: wl-design
-description: "设计工序: 预览(蓝湖稿→HTML) / 扫描(看系统现状) / 评审(检查合规)。设计师在蓝湖画完,一条链接出预览。"
+description: "设计工序入口: import 录入设计稿→spec.json(默认) / generate 按设计spec出原型 / review 评审原型。"
 argument-hint: "[预览|扫描|评审] <蓝湖链接或功能名>"
 auto-approve: true
-allowed-tools: [Read, Glob, Grep, Bash, Write, Edit, mcp__qoder-knowledge-graph, mcp__lanhu, mcp__qoder-mysql]
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
 ---
 
 # /wl-design - 设计工序站
@@ -32,14 +32,14 @@ User input: $ARGUMENTS
 
 **Step 1：列设计稿**
 ```
-mcp__lanhu__lanhu_get_designs(url="<蓝湖链接>")
+cap.mcp.call("lanhu_get_designs", {"url": "<蓝湖链接>"})
 ```
 - 蓝湖链接含 `pid`（项目 ID），如 `https://lanhuapp.com/web/#/item/project/stage?tid=xxx&pid=xxx`
 - 返回设计稿列表（名称 + 序号）
 
 **Step 2：分析出 HTML**
 ```
-mcp__lanhu__lanhu_get_ai_analyze_design_result(url="<蓝湖链接>", design_names="<名称或序号或all>")
+cap.mcp.call("lanhu_get_ai_analyze_design_result", {"url": "<蓝湖链接>", "design_names": "<名称或序号或all>"})
 ```
 - 返回 **HTML+CSS 代码**（工具原文："GET VISUAL CONTENT + HTML CODE"）
 - AI 把返回的 HTML 存成文件：`workspace/members/{developer}/drafts/prototype-{feature}.html`
@@ -64,7 +64,7 @@ mcp__lanhu__lanhu_get_ai_analyze_design_result(url="<蓝湖链接>", design_name
 
 ### 流程（1 次调用取全）
 ```
-mcp__qoder-knowledge-graph__context_pack(keyword='<功能名>', platform='web')
+cap.mcp.call("context_pack", {"keyword": "<功能名>", "platform": "web"})
 ```
 返回 8 段：相关代码 + 同类页面 + 字段 + API + 风格 token + 组件 + 数据库表结构。
 
@@ -121,5 +121,5 @@ mcp__qoder-knowledge-graph__context_pack(keyword='<功能名>', platform='web')
 
 评审输出后，记录到 learning：
 ```bash
-python "$R/.qoder/scripts/learn.py" record review_done "{\"target\":\"$feature\",\"result\":\"$pass_or_issues\"}"
+python "$R/.qoder/scripts/orchestration/wlkj.py" learn record review_done "{\"target\":\"$feature\",\"result\":\"$pass_or_issues\"}"
 ```

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

@@ -19,7 +19,7 @@ Usage:
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
 
 ## Engine: init_doctor.py (幂等, 增量, 永不重头再来)
 
@@ -28,7 +28,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ### Case 1: /wl-init (no arguments)
 ```bash
-python "$R/.qoder/scripts/init_doctor.py"
+python "$R/.qoder/scripts/orchestration/wlkj.py" doctor
 ```
 Report the doctor's findings to the user in friendly language.
 If it found fixable issues, ask: "发现 N 个问题，要我自动修复吗？"
@@ -36,7 +36,7 @@ then run with --fix.
 
 ### Case 2/3: /wl-init 小王 [pm]
 ```bash
-python "$R/.qoder/scripts/init_doctor.py" --fix 小王 [pm]
+python "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix 小王 [pm]
 ```
 This single command does ALL of:
 1. 注册/切换开发者 (.qoder/.developer, key=value 格式) + 个人空间目录

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

@@ -3,7 +3,7 @@ name: wl-prd
 description: "需求: 完整(13章,新功能) / 快速(6章,小改动) / 评审(检查质量)。默认根据描述自动判断。"
 argument-hint: "[完整|快速|评审] [需求描述]  可选: 参考:<insight报告路径>"
 auto-approve: true
-allowed-tools: [Read, Glob, Grep, Bash, Write, Edit, mcp__qoder-knowledge-graph, mcp__qoder-mysql]
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
 ---
 
 # /wl-prd - 需求工序站
@@ -34,32 +34,45 @@ User input: $ARGUMENTS
 **新模块/新业务/新流程用这个。** 支持衔接 insight：`参考:<报告路径>`
 
 **铁律：平台必问。** 先问：
-```
+``
 这个需求是针对哪个平台？
 1. Web 管理端 (fywl-ui)
 2. APP 移动端 (Carmg-H5)
 3. 两端都要
 请选择 (1/2/3):
-```
+``
 
 ### 取上下文（1 次调用取全 8 段）
-```bash
-python "$R/.qoder/scripts/context_pack.py" <业务词> --platform <web|app>
-```
+``bash
+python "$R/.qoder/scripts/orchestration/wlkj.py" context <业务词> --platform <web|app>
+``
 - 第 4 段 = 历史 PRD（防重复）
 - 第 5 段 = 相关 API
 - 第 8 段 = 数据库表结构+真实字段
-- 涉及枚举字段时额外调 `mcp__qoder-mysql__query_distinct`
+- 涉及枚举字段时额外调 `cap.mcp.call("query_distinct`
 
 ### 产出
 - PRD: `workspace/members/{dev}/drafts/REQ-{YYYY}-{NNN}-{标题}.md`（13 章）
-- 原型: `workspace/members/{dev}/drafts/prototype-{feature}.html`
-- 第一行必须带 `@contract` 头（platform/req-id/mode/acceptance）
+- 原型（**可选**，见下「原型要不要画」）: `workspace/members/{dev}/drafts/prototype-{feature}.html`
+- 第一行必须带 `@contract` 头（platform/req-id/mode/acceptance/prototype）
+
+### 原型要不要画？（融入批量确认）
+
+**默认建议**（用户可一键改，详见 `.qoder/skills/wl-prd-full/SKILL.md` STEP 0.5）：
+- 纯规则/接口/定时/参数/计算类 → **不画**（如"出交车点检固定为总部全局规则"）
+- 含页面/菜单/表单/弹窗/详情/向导/看板/大屏 → **画**
+- 加字段/按钮/文案/导出 → **不画**
+- 混合（页面+规则）→ 只画页面那部分
+
+**两端都画时**：默认只画主端一份，用户明确要求才画 2 份。
+
+**不画时**：PRD 第 11 章写 `无（{原因}，经用户确认豁免）` + `@contract` 头标 `prototype: none`；
+eval 自动跳过 A2（满分从 100 降到 70，照样 PASS）；`/wl-design` `/wl-code` 据此跳过原型环节。
 
 ### 质量门禁
-```bash
-python "$R/.qoder/scripts/eval_prd.py" <prd.md> [原型.html]
-```
+``bash
+python "$R/.qoder/scripts/orchestration/wlkj.py" eval <prd.md> [原型.html]
+``
 ≥ 80% 才 PASS。完整模板见 `.qoder/templates/prd-full-template.md`。
 
 ---
@@ -89,7 +102,7 @@ python "$R/.qoder/scripts/eval_prd.py" <prd.md> [原型.html]
    - 影响范围是否评估
    - 非功能性需求是否覆盖
    - ...
-3. 跑 EVA 评分：`eval_prd.py <prd.md>`
+3. 跑 EVA 评分：`python "$R/.qoder/scripts/orchestration/wlkj.py" eval <prd.md>`（wlkj.py eval 内部映射 validation/metrics/eval_prd.py）
 4. 输出：总分 + 7 项 ✓/✗ + 改进建议
 
 ---

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

@@ -0,0 +1,43 @@
+---
+description: "需求管理: 看需求/看产出/发布"
+argument-hint: "[REQ-ID] [发布]"
+---
+
+# /wl-req 需求生命周期管理
+
+> 一个需求的所有产出(PRD/原型/任务/规格)聚合在 REQ-ID 容器, 一条命令看全貌。
+
+## 用法 (只需记 2 个姿势)
+
+| 输入 | 做什么 |
+|------|--------|
+| `/wl-req` | 列出所有需求 (跨草稿/产出/历史桶) |
+| `/wl-req REQ-2026-001` | 显示该需求的全部产出 |
+| `/wl-req REQ-2026-001 发布` | 草稿→产出→发禅道 (一步到位) |
+
+## 实现层
+
+```bash
+# 列需求
+python "$R/.qoder/scripts/orchestration/wlkj.py" req
+
+# 看某需求全貌
+python "$R/.qoder/scripts/orchestration/wlkj.py" req REQ-2026-001
+
+# 发布 (promote + publish)
+python "$R/.qoder/scripts/orchestration/wlkj.py" req REQ-2026-001 发布
+```
+
+## 结构
+
+```
+workspace/members/{dev}/
+├── drafts/2026/06/W26/REQ-2026-001/   ← 草稿(私有)
+│   ├── prd.md
+│   ├── prototype.html
+│   └── tasks/
+├── outputs/2026/06/W26/REQ-2026-001/  ← 产出(团队可见, 发布后)
+│   └── exports/ (docx/pdf)
+```
+
+时间桶(YYYY/MM/Ww)内建: 本周=活动区, 历史=过去的桶, 无独立 archive。

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

@@ -3,45 +3,51 @@ name: wl-search
 description: "查代码/业务/API/字段/PRD + 知识图谱(影响分析/覆盖矩阵/功能画像/业务流程/多跳遍历)的唯一入口。"
 argument-hint: "[keyword] or --api [path] or subcommand. 全系13个能力见下表"
 auto-approve: true
-allowed-tools: [Read, Bash, mcp__qoder-knowledge-graph]
+allowed-tools: [Read, Bash]
 ---
 
 # /wl-search - 搜索代码 & 知识图谱
 
 User input: $ARGUMENTS
 
-## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
+## 执行方式（宿主无关，自动路由）
 
-**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
-```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```python
+from capability import resolve
+cap = resolve()
+result = cap.mcp.call("search_code", {"keyword": "保险", "platform": "web"})
 ```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
-
-## 双轨：MCP 优先（仅 QoderWork）/ kg.py 兜底（全系列通用）
-
-**QoderWork 环境**（有 `mcp__qoder-knowledge-graph`）：直接调 MCP 工具，更快。
-**其他 Qoder 载体**（IDE/Quest/CLI）：跑 `python "$R/.qoder/scripts/kg.py"`，功能等价。
-
-不确定在哪个环境？先试 MCP；MCP 工具不存在就用 kg.py。
 
-## 13 个能力对照表
-
-| 用户要查什么 | MCP 工具（QoderWork） | kg.py 命令（全系列） |
-|-------------|---------------------|---------------------|
-| 代码在哪 / 搜关键词 | `search_code(keyword='考勤', platform='web')` | `kg.py search 考勤 --platform web` |
-| API 端点 | `search_api(keyword='salary')` | `kg.py api salary` |
-| 已有 PRD（防重复造轮子） | `search_prd(keyword='保险')` | `kg.py prd 保险` |
-| 改某接口影响哪些页面 | `get_impact(endpoint='/asset')` | `kg.py impact /asset` |
-| 某函数/端点的完整关联 | `context_360(symbol='handleExport')` | `kg.py context360 handleExport` |
-| 一次取全(代码+页面+字段+API) | `context_pack(keyword='车辆', role='pm')` | `kg.py context 车辆 --role pm` |
-| 哪些功能有/没测试 | `coverage_matrix()` | `kg.py coverage` |
-| 功能完整画像 | `feature_overview(feature='资产管理')` | `kg.py feature 资产管理` |
-| 业务流程链（几步） | `get_workflow(module='assets')` | `kg.py workflow assets` |
-| 多跳遍历（关联实体） | `multi_hop(symbol='资产管理', max_depth=3)` | `kg.py hop 资产管理 --depth 3` |
-| Repo Wiki 模块文档 | `search_wiki(keyword='考勤')` | `kg.py wiki 考勤` |
-| 原型预填（真实数据） | `fill_prototype(keyword='车辆', platform='web')` | `kg.py fill-prototype 车辆 --platform web` |
-| 设计系统规范 | `get_design_system(platform='web')` | `kg.py design-system --platform web` |
+自动路由：有 MCP 走 MCP（快），无 MCP 走 wlkj.py（CLI 降级）。零宿主感知。
+
+## ⚡ 第一步：先判断问题类型，别一上来就 search
+
+| 问题类型 | 首选（一次到位） | ❌ 别这样 |
+|---------|-----------------|----------|
+| **"XX怎么实现的/怎么做的"** | `cap.mcp.call("context_pack", {"keyword": "XX", "role": "dev"})` | 不要一个个 search（会搜 5-7 次，慢费 token） |
+| **"XX代码在哪"** | `cap.mcp.call("search_code", {"keyword": "XX"})` | 不要 context（杀鸡用牛刀） |
+| **"改 XX 影响谁"** | `cap.mcp.call("get_impact", {"endpoint": "/XX"})` | — |
+
+> 理解一个功能怎么做的问题，`context_pack` 一条命令拿全代码+API+字段，绝大多数情况只需 Read 2-3 个文件就够，
+> 不用反复 search。Glob 找不到文件时用 search_code 兜底，**不准跑 find/findstr/dir /s**。
+
+## 13 个能力（统一 cap.mcp.call 调用）
+
+| 用户要查什么 | 调用方式 |
+|-------------|---------|
+| 代码在哪 / 搜关键词 | `cap.mcp.call("search_code", {"keyword": "考勤", "platform": "web"})` |
+| API 端点 | `cap.mcp.call("search_api", {"keyword": "salary"})` |
+| 已有 PRD（防重复造轮子） | `cap.mcp.call("search_prd", {"keyword": "保险"})` |
+| 改某接口影响哪些页面 | `cap.mcp.call("get_impact", {"endpoint": "/asset"})` |
+| 某函数/端点的完整关联 | `cap.mcp.call("context_360", {"symbol": "handleExport"})` |
+| 一次取全(代码+页面+字段+API) | `cap.mcp.call("context_pack", {"keyword": "车辆", "role": "pm"})` |
+| 哪些功能有/没测试 | `cap.mcp.call("coverage_matrix", {})` |
+| 功能完整画像 | `cap.mcp.call("feature_overview", {"feature": "资产管理"})` |
+| 业务流程链（几步） | `cap.mcp.call("get_workflow", {"module": "assets"})` |
+| 多跳遍历（关联实体） | `cap.mcp.call("multi_hop", {"symbol": "资产管理", "depth": 3})` |
+| Repo Wiki 模块文档 | `cap.mcp.call("search_wiki", {"keyword": "考勤"})` |
+| 原型预填（真实数据） | `cap.mcp.call("fill_prototype", {"keyword": "车辆", "platform": "web"})` |
+| 设计系统规范 | `cap.mcp.call("get_design_system", {"platform": "web"})` |
 
 ## 快速判断该用哪个
 
@@ -50,27 +56,52 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 - **"哪些功能缺测试"** → `coverage`
 - **"盘点流程有几步"** → `workflow`
 - **"XX 谁调用了/调用链"** → `context360` 或 `hop`
-- **写 PRD 前一次取全** → `context --role pm`
-- **出原型前** → `design-system` + `fill-prototype`
+- **写 PRD 前一次取全** → `context_pack --role pm`
+- **出原型前** → `design_system` + `fill_prototype`
 
-## 字段/页面风格/组件（仍用 search_index.py）
+## 字段/页面风格/组件
 
-这些 kg.py 未单独封装，直接跑：
+这些不是 MCP 工具，走 CLI 降级：
 
 ```
-python "$R/.qoder/scripts/search_index.py" --field <字段名>
-python "$R/.qoder/scripts/search_index.py" --style <table|form|detail|modal|dashboard> [--platform web|app]
-python "$R/.qoder/scripts/search_index.py" --list        # Top50 关键词
-python "$R/.qoder/scripts/search_index.py" --modules     # 项目模块概览
-python "$R/.qoder/scripts/search_index.py" --components  # 组件使用统计
+cap.mcp.call("search_code", {"keyword": "--field <字段名>"})     # 字段搜索
+cap.mcp.call("search_code", {"keyword": "--style table"})        # 风格搜索
+cap.mcp.call("search_code", {"keyword": "--list"})               # Top50 关键词
+cap.mcp.call("search_code", {"keyword": "--modules"})            # 项目模块概览
+cap.mcp.call("search_code", {"keyword": "--components"})         # 组件使用统计
 ```
 
+## 数据库查询（真实库表结构/数据/枚举）— ⚠️ 强制先问环境
+
+当用户意图涉及**数据库 / 表结构 / 字段 / 枚举取值 / 真实数据**，走 `cap.mcp.call("list_envs")` 等，**不走知识图谱**。
+
+可用工具（全部带可选 `env` 参数）：
+- `cap.mcp.call("list_envs", {})` — 列出所有可用环境（**第一步必须先调这个**）
+- `cap.mcp.call("query_schema", {"table": "t_xxx", "env": "test"})` — 表结构
+- `cap.mcp.call("query_data", {"table": "t_xxx", "env": "test"})` — 数据
+- `cap.mcp.call("query_distinct", {"table": "t_xxx", "column": "status", "env": "test"})` — 枚举值
+
+### 🔒 安全红线：查库前必须先问环境（不可跳过）
+
+**标准流程：**
+1. **先调 `cap.mcp.call("list_envs", {})`** 拿到所有环境标签，列给用户选
+2. **用户明确选定后**，后续工具调用都带上 `env=<用户选的标签>`
+3. 生产环境 🔴 真实数据，仅供核对字段含义/格式，**禁止作为业务结论外传**
+
 ## 没给参数时
 
-如果用户没给关键词/子命令，先问意图，或跑 `python "$R/.qoder/scripts/search_index.py" --list` 列出热门关键词让用户选。
+如果用户没给关键词/子命令，先问意图，或跑 `cap.mcp.call("search_code", {"keyword": "--list"})` 列出热门关键词让用户选。
 
 ## DO NOT grep the entire codebase
 
+🚫 **绝对禁止**用 `findstr /s`、`grep -r`、`os.walk`、`subprocess` 全盘递归扫 data/code。
+
+**中文文案/报错溯源**（用户查的是中文短语），**唯一合法方式**：
+```bash
+# grep-text 走 CLI 降级（不是 MCP 工具）
+python "$R/.qoder/scripts/orchestration/wlkj.py" kg grep-text 车辆不存在 --ext java --limit 20
+```
+
 ## How to Use Results
 
 1. Pick the most relevant files (2-3 max)
@@ -79,10 +110,10 @@ python "$R/.qoder/scripts/search_index.py" --components  # 组件使用统计
 
 ## Examples
 
-- `/wl-search 考勤` -> `kg.py search 考勤`
-- `/wl-search --api salary` -> `kg.py api salary`
-- `/wl-search 改 /asset 影响谁` -> `kg.py impact /asset`
-- `/wl-search 哪些功能没测试` -> `kg.py coverage`
-- `/wl-search 资产管理功能画像` -> `kg.py feature 资产管理`
-- `/wl-search 资产盘点流程` -> `kg.py workflow assets`
-- `/wl-search --modules` -> `search_index.py --modules`
+- `/wl-search 考勤` → `cap.mcp.call("search_code", {"keyword": "考勤"})`
+- `/wl-search --api salary` → `cap.mcp.call("search_api", {"keyword": "salary"})`
+- `/wl-search 改 /asset 影响谁` → `cap.mcp.call("get_impact", {"endpoint": "/asset"})`
+- `/wl-search 哪些功能没测试` → `cap.mcp.call("coverage_matrix", {})`
+- `/wl-search t_quality_case 表结构` → 先 `list_envs()` 问环境 → `query_schema`
+- `/wl-search 资产管理功能画像` → `cap.mcp.call("feature_overview", {"feature": "资产管理"})`
+- `/wl-search 车辆不存在报错从哪来` → `wlkj.py kg grep-text 车辆不存在 --ext java`