@hupan56/wlkj 3.3.0 → 3.3.2

package/templates/qoder/scripts/engine/poller.py

@@ -1,219 +1,219 @@
-"""引擎轮询器：后台轮询平台 pending 触发 → 认领 → 执行 → 回流 → 回填结果。
-
-这是"平台→引擎→平台"真闭环的引擎侧执行器：
-1. 轮询 GET /trigger/pending（带项目令牌）
-2. 认领 POST /trigger/{tid}/claim（原子锁）
-3. 执行：根据 command 调 MCP 取知识 + 生成产出（简化版：rag_search + 模板拼接）
-4. 回流：create_prd/submit_return
-5. 回填：PATCH /trigger/{tid}（mcp_tools_called/knowledge_used）
-
-用法：
-  python poller.py --config ../mcp_config.json --interval 10
-
-注：完整版需要接 LLM（qwen-plus）生成 PRD/原型。当前是简化版（rag_search + 模板），
-验证闭环链路。接 LLM 后把 _execute 里的模板拼接换成 cap.mcp.call("ask_corpus",...) 生成。
-"""
-import json
-import time
-import urllib.request
-import urllib.error
-import argparse
-import os
-import sys
-from pathlib import Path
-
-
-def _load_config(config_path: str) -> dict:
-    with open(config_path, encoding="utf-8") as f:
-        return json.load(f)
-
-
-def _get_token(cfg: dict) -> str:
-    for srv in (cfg.get("mcpServers") or {}).values():
-        return srv.get("token", "")
-    return ""
-
-
-def _get_pid(cfg: dict) -> str:
-    for srv in (cfg.get("mcpServers") or {}).values():
-        env = srv.get("env") or {}
-        return env.get("WLKJ_PROJECT_ID", "")
-    return ""
-
-
-def _get_base(cfg: dict) -> str:
-    ep = cfg.get("return_endpoint") or {}
-    url = ep.get("url", "")
-    # 从 return_endpoint.url 提取 base（/api/projects 前面那段）
-    if "/api/" in url:
-        return url.split("/api/")[0]
-    for srv in (cfg.get("mcpServers") or {}).values():
-        u = srv.get("url", "")
-        if "/mcp" in u:
-            return u.split("/mcp")[0]
-    return "http://127.0.0.1:10010"
-
-
-def _api(base, method, path, token, body=None):
-    url = base + path
-    data = json.dumps(body).encode() if body else None
-    req = urllib.request.Request(url, data=data, method=method)
-    req.add_header("Content-Type", "application/json")
-    if token:
-        req.add_header("X-Engine-Token", token)
-    try:
-        with urllib.request.urlopen(req, timeout=30) as resp:
-            return resp.status, json.loads(resp.read().decode())
-    except urllib.error.HTTPError as e:
-        return e.code, json.loads(e.read().decode() or "{}")
-    except Exception as e:
-        return 0, {"error": str(e)}
-
-
-def _mcp_call(base, token, tool, args):
-    """通过 MCP JSON-RPC 调工具。"""
-    body = {"jsonrpc": "2.0", "id": 1, "method": "tools/call",
-            "params": {"name": tool, "arguments": args}}
-    data = json.dumps(body).encode()
-    req = urllib.request.Request(base + "/mcp", data=data, method="POST")
-    req.add_header("Content-Type", "application/json")
-    req.add_header("X-MCP-Token", token)
-    try:
-        with urllib.request.urlopen(req, timeout=60) as resp:
-            r = json.loads(resp.read().decode())
-            text = r.get("result", {}).get("content", [{}])[0].get("text", "")
-            return json.loads(text) if text else {}
-    except Exception as e:
-        return {"error": str(e)}
-
-
-def _execute(base, token, pid, command, args):
-    """执行触发的工作流（简化版：rag_search 取知识 + 模板拼 PRD + learn 写回）。
-    完整版应接 LLM（ask_corpus）生成自然语言 PRD。"""
-    query = (args or {}).get("query", "")
-    tools_called = []
-    knowledge_used = []
-
-    # 1) rag_search 取知识
-    if query:
-        r = _mcp_call(base, token, "rag_search", {"query": query, "top_k": 8})
-        tools_called.append("rag_search")
-        knowledge_used = [it.get("entity_id", "") for it in r.get("items", [])[:5]]
-        knowledge_text = "\n".join(
-            "- %s (%s)" % (it.get("text", "")[:60], it.get("entity_id", "")[:30])
-            for it in r.get("items", [])[:8]
-        )
-        # 1b) get_learnings 查之前学到的（反哺）
-        lr = _mcp_call(base, token, "get_learnings", {"project_id": pid, "limit": 5})
-        tools_called.append("get_learnings")
-        learnings_text = "\n".join(
-            "- [%s] %s" % (l.get("category",""), (l.get("pattern","")[:60]))
-            for l in (lr.get("items") or [])[:5]
-        ) or "(暂无学习记录)"
-    else:
-        knowledge_text = "(无关键词)"
-        learnings_text = ""
-
-    # 2) 根据 command 生成产出
-    if "prd" in command.lower():
-        prd_md = f"# {query} PRD（引擎自动生成）\n\n## 概述\n基于知识层自动生成的「{query}」需求文档。\n\n## 相关知识\n{knowledge_text}\n\n## 历史学习\n{learnings_text}\n\n## 功能\n（根据上述知识补充）"
-        # 回流
-        r = _mcp_call(base, token, "create_prd", {
-            "project_id": pid, "title": f"{query}PRD(引擎触发)", "content_md": prd_md, "status": "planning"
-        })
-        tools_called.append("create_prd")
-        # 学习写回：把这次的关键认知沉淀
-        _mcp_call(base, token, "learn", {"project_id": pid, "category": "rule",
-            "pattern": f"{query}: PRD已生成，涉及知识{len(knowledge_used)}条", "source": "wlkj-poller"})
-        tools_called.append("learn")
-        output = f"生成PRD: {query}PRD(引擎触发) + 学习沉淀"
-    elif "design" in command.lower():
-        html = f"<html><body><h1>{query}</h1><p>引擎自动生成原型</p></body></html>"
-        r = _mcp_call(base, token, "create_prototype", {
-            "project_id": pid, "feature": f"{query}(引擎触发)", "platform": "web", "html": html
-        })
-        tools_called.append("create_prototype")
-        output = f"生成原型: {query}(引擎触发)"
-    else:
-        # learn 写回
-        _mcp_call(base, token, "learn", {
-            "project_id": pid, "category": "rule", "pattern": f"{query}相关规则(引擎触发)",
-            "source": "wlkj-poller"
-        })
-        tools_called.append("learn")
-        output = f"执行命令: {command}"
-
-    return {"output": output, "tools": tools_called, "knowledge": knowledge_used}
-
-
-def poll_once(cfg):
-    """轮询一次：取 pending → 认领 → 执行 → 回填。"""
-    token = _get_token(cfg)
-    pid = _get_pid(cfg)
-    base = _get_base(cfg)
-    if not token or not pid:
-        print("[poller] 配置缺 token/project_id，跳过")
-        return
-
-    # 1) 查 pending
-    _, pending = _api(base, "GET", f"/api/projects/{pid}/trigger/pending", token)
-    items = pending.get("pending", [])
-    if not items:
-        return  # 无待执行
-
-    for item in items[:1]:  # 一次只处理 1 条
-        tid = item.get("triggerId")
-        cmd = item.get("command", "")
-        args = item.get("args", {})
-        print(f"[poller] 认领: {tid} {cmd} {args}")
-
-        # 2) claim
-        code, resp = _api(base, "POST", f"/api/projects/{pid}/trigger/workflow/{tid}/claim",
-                          token, {"engine_id": "poller-001"})
-        if code != 200:
-            print(f"[poller] 认领失败({code}): {resp}")
-            continue
-
-        # 3) 执行
-        t0 = time.time()
-        try:
-            result = _execute(base, token, pid, cmd, args)
-            status = "success"
-        except Exception as e:
-            result = {"output": str(e), "tools": [], "knowledge": []}
-            status = "failed"
-
-        # 4) patch 回填
-        _api(base, "PATCH", f"/api/projects/{pid}/trigger/workflow/{tid}", token, {
-            "status": status,
-            "output_summary": result["output"],
-            "knowledge_used": result["knowledge"],
-            "mcp_tools_called": result["tools"],
-            "duration_sec": int(time.time() - t0),
-        })
-        print(f"[poller] 完成: {status} → {result['output']} (tools={result['tools']})")
-
-
-def main():
-    parser = argparse.ArgumentParser(description="wlkj 引擎轮询器")
-    parser.add_argument("--config", default=str(Path(__file__).parent.parent.parent / "mcp_config.json"))
-    parser.add_argument("--interval", type=int, default=10, help="轮询间隔(秒)")
-    parser.add_argument("--once", action="store_true", help="只跑一次")
-    args = parser.parse_args()
-
-    cfg = _load_config(args.config)
-    print(f"[poller] 启动: project={_get_pid(cfg)} interval={args.interval}s")
-    print(f"[poller] 按 Ctrl+C 停止")
-
-    while True:
-        try:
-            poll_once(cfg)
-        except Exception as e:
-            print(f"[poller] 异常: {e}")
-        if args.once:
-            break
-        time.sleep(args.interval)
-
-
-if __name__ == "__main__":
-    main()
+"""引擎轮询器：后台轮询平台 pending 触发 → 认领 → 执行 → 回流 → 回填结果。
+
+这是"平台→引擎→平台"真闭环的引擎侧执行器：
+1. 轮询 GET /trigger/pending（带项目令牌）
+2. 认领 POST /trigger/{tid}/claim（原子锁）
+3. 执行：根据 command 调 MCP 取知识 + 生成产出（简化版：rag_search + 模板拼接）
+4. 回流：create_prd/submit_return
+5. 回填：PATCH /trigger/{tid}（mcp_tools_called/knowledge_used）
+
+用法：
+  python poller.py --config ../mcp_config.json --interval 10
+
+注：完整版需要接 LLM（qwen-plus）生成 PRD/原型。当前是简化版（rag_search + 模板），
+验证闭环链路。接 LLM 后把 _execute 里的模板拼接换成 cap.mcp.call("ask_corpus",...) 生成。
+"""
+import json
+import time
+import urllib.request
+import urllib.error
+import argparse
+import os
+import sys
+from pathlib import Path
+
+
+def _load_config(config_path: str) -> dict:
+    with open(config_path, encoding="utf-8") as f:
+        return json.load(f)
+
+
+def _get_token(cfg: dict) -> str:
+    for srv in (cfg.get("mcpServers") or {}).values():
+        return srv.get("token", "")
+    return ""
+
+
+def _get_pid(cfg: dict) -> str:
+    for srv in (cfg.get("mcpServers") or {}).values():
+        env = srv.get("env") or {}
+        return env.get("WLKJ_PROJECT_ID", "")
+    return ""
+
+
+def _get_base(cfg: dict) -> str:
+    ep = cfg.get("return_endpoint") or {}
+    url = ep.get("url", "")
+    # 从 return_endpoint.url 提取 base（/api/projects 前面那段）
+    if "/api/" in url:
+        return url.split("/api/")[0]
+    for srv in (cfg.get("mcpServers") or {}).values():
+        u = srv.get("url", "")
+        if "/mcp" in u:
+            return u.split("/mcp")[0]
+    return "http://127.0.0.1:10010"
+
+
+def _api(base, method, path, token, body=None):
+    url = base + path
+    data = json.dumps(body).encode() if body else None
+    req = urllib.request.Request(url, data=data, method=method)
+    req.add_header("Content-Type", "application/json")
+    if token:
+        req.add_header("X-Engine-Token", token)
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return resp.status, json.loads(resp.read().decode())
+    except urllib.error.HTTPError as e:
+        return e.code, json.loads(e.read().decode() or "{}")
+    except Exception as e:
+        return 0, {"error": str(e)}
+
+
+def _mcp_call(base, token, tool, args):
+    """通过 MCP JSON-RPC 调工具。"""
+    body = {"jsonrpc": "2.0", "id": 1, "method": "tools/call",
+            "params": {"name": tool, "arguments": args}}
+    data = json.dumps(body).encode()
+    req = urllib.request.Request(base + "/mcp", data=data, method="POST")
+    req.add_header("Content-Type", "application/json")
+    req.add_header("X-MCP-Token", token)
+    try:
+        with urllib.request.urlopen(req, timeout=60) as resp:
+            r = json.loads(resp.read().decode())
+            text = r.get("result", {}).get("content", [{}])[0].get("text", "")
+            return json.loads(text) if text else {}
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def _execute(base, token, pid, command, args):
+    """执行触发的工作流（简化版：rag_search 取知识 + 模板拼 PRD + learn 写回）。
+    完整版应接 LLM（ask_corpus）生成自然语言 PRD。"""
+    query = (args or {}).get("query", "")
+    tools_called = []
+    knowledge_used = []
+
+    # 1) rag_search 取知识
+    if query:
+        r = _mcp_call(base, token, "rag_search", {"query": query, "top_k": 8})
+        tools_called.append("rag_search")
+        knowledge_used = [it.get("entity_id", "") for it in r.get("items", [])[:5]]
+        knowledge_text = "\n".join(
+            "- %s (%s)" % (it.get("text", "")[:60], it.get("entity_id", "")[:30])
+            for it in r.get("items", [])[:8]
+        )
+        # 1b) get_learnings 查之前学到的（反哺）
+        lr = _mcp_call(base, token, "get_learnings", {"project_id": pid, "limit": 5})
+        tools_called.append("get_learnings")
+        learnings_text = "\n".join(
+            "- [%s] %s" % (l.get("category",""), (l.get("pattern","")[:60]))
+            for l in (lr.get("items") or [])[:5]
+        ) or "(暂无学习记录)"
+    else:
+        knowledge_text = "(无关键词)"
+        learnings_text = ""
+
+    # 2) 根据 command 生成产出
+    if "prd" in command.lower():
+        prd_md = f"# {query} PRD（引擎自动生成）\n\n## 概述\n基于知识层自动生成的「{query}」需求文档。\n\n## 相关知识\n{knowledge_text}\n\n## 历史学习\n{learnings_text}\n\n## 功能\n（根据上述知识补充）"
+        # 回流
+        r = _mcp_call(base, token, "create_prd", {
+            "project_id": pid, "title": f"{query}PRD(引擎触发)", "content_md": prd_md, "status": "planning"
+        })
+        tools_called.append("create_prd")
+        # 学习写回：把这次的关键认知沉淀
+        _mcp_call(base, token, "learn", {"project_id": pid, "category": "rule",
+            "pattern": f"{query}: PRD已生成，涉及知识{len(knowledge_used)}条", "source": "wlkj-poller"})
+        tools_called.append("learn")
+        output = f"生成PRD: {query}PRD(引擎触发) + 学习沉淀"
+    elif "design" in command.lower():
+        html = f"<html><body><h1>{query}</h1><p>引擎自动生成原型</p></body></html>"
+        r = _mcp_call(base, token, "create_prototype", {
+            "project_id": pid, "feature": f"{query}(引擎触发)", "platform": "web", "html": html
+        })
+        tools_called.append("create_prototype")
+        output = f"生成原型: {query}(引擎触发)"
+    else:
+        # learn 写回
+        _mcp_call(base, token, "learn", {
+            "project_id": pid, "category": "rule", "pattern": f"{query}相关规则(引擎触发)",
+            "source": "wlkj-poller"
+        })
+        tools_called.append("learn")
+        output = f"执行命令: {command}"
+
+    return {"output": output, "tools": tools_called, "knowledge": knowledge_used}
+
+
+def poll_once(cfg):
+    """轮询一次：取 pending → 认领 → 执行 → 回填。"""
+    token = _get_token(cfg)
+    pid = _get_pid(cfg)
+    base = _get_base(cfg)
+    if not token or not pid:
+        print("[poller] 配置缺 token/project_id，跳过")
+        return
+
+    # 1) 查 pending
+    _, pending = _api(base, "GET", f"/api/projects/{pid}/trigger/pending", token)
+    items = pending.get("pending", [])
+    if not items:
+        return  # 无待执行
+
+    for item in items[:1]:  # 一次只处理 1 条
+        tid = item.get("triggerId")
+        cmd = item.get("command", "")
+        args = item.get("args", {})
+        print(f"[poller] 认领: {tid} {cmd} {args}")
+
+        # 2) claim
+        code, resp = _api(base, "POST", f"/api/projects/{pid}/trigger/workflow/{tid}/claim",
+                          token, {"engine_id": "poller-001"})
+        if code != 200:
+            print(f"[poller] 认领失败({code}): {resp}")
+            continue
+
+        # 3) 执行
+        t0 = time.time()
+        try:
+            result = _execute(base, token, pid, cmd, args)
+            status = "success"
+        except Exception as e:
+            result = {"output": str(e), "tools": [], "knowledge": []}
+            status = "failed"
+
+        # 4) patch 回填
+        _api(base, "PATCH", f"/api/projects/{pid}/trigger/workflow/{tid}", token, {
+            "status": status,
+            "output_summary": result["output"],
+            "knowledge_used": result["knowledge"],
+            "mcp_tools_called": result["tools"],
+            "duration_sec": int(time.time() - t0),
+        })
+        print(f"[poller] 完成: {status} → {result['output']} (tools={result['tools']})")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="wlkj 引擎轮询器")
+    parser.add_argument("--config", default=str(Path(__file__).parent.parent.parent / "mcp_config.json"))
+    parser.add_argument("--interval", type=int, default=10, help="轮询间隔(秒)")
+    parser.add_argument("--once", action="store_true", help="只跑一次")
+    args = parser.parse_args()
+
+    cfg = _load_config(args.config)
+    print(f"[poller] 启动: project={_get_pid(cfg)} interval={args.interval}s")
+    print(f"[poller] 按 Ctrl+C 停止")
+
+    while True:
+        try:
+            poll_once(cfg)
+        except Exception as e:
+            print(f"[poller] 异常: {e}")
+        if args.once:
+            break
+        time.sleep(args.interval)
+
+
+if __name__ == "__main__":
+    main()

package/templates/qoder/scripts/validation/metrics/present_board.py

@@ -0,0 +1,180 @@
+# -*- coding: utf-8 -*-
+"""present_board.py — 知识层富展示看板（cap.present.widget / 落盘降级）。
+
+子命令（数据走 MCP，HTML 自包含，复用 capability.present_html.present）：
+  impact   — get_impact 影响传播树（分层 upstream/downstream 可折叠）
+  coverage — coverage_matrix 覆盖热力图（功能×测试 有/无）
+  feature  — feature_overview 功能画像卡（端点+按钮+用例+页面+PRD）
+
+用法：
+  python present_board.py impact --entity handleExport --project-id <UUID>
+  python present_board.py coverage --project-id <UUID>
+  python present_board.py feature --feature 资产管理 --project-id <UUID>
+
+QoderWork 桌面端 → HTML 嵌入对话流；CLI/IDE → 落盘 workspace/members/{dev}/journal/。
+"""
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+
+
+def _resolve_repo():
+    env = os.environ.get("QODER_REPO") or os.environ.get("WLKJ_REPO")
+    if env:
+        return Path(env)
+    p = Path(__file__).resolve()
+    for parent in p.parents:
+        if (parent / ".qoder").is_dir() or (parent / "packages").is_dir():
+            return parent
+    return p.parent
+
+
+def _cap():
+    repo = _resolve_repo()
+    sd = str(repo / ".qoder" / "scripts")
+    if sd not in sys.path:
+        sys.path.insert(0, sd)
+    from capability.registry import resolve
+    return resolve(), repo
+
+
+def _unpack(r):
+    """cap.mcp.call 返回 ToolResult（.text 是 JSON 字符串），解包成 dict。"""
+    if isinstance(r, dict):
+        return r
+    if getattr(r, "is_error", False):
+        return {"error": getattr(r, "text", str(r))}
+    txt = getattr(r, "text", None)
+    if txt is None:
+        return r
+    try:
+        return json.loads(txt)
+    except Exception:
+        return {"raw": txt}
+
+
+_CSS = """
+body{font-family:-apple-system,'Segoe UI',sans-serif;margin:0;padding:20px;background:#f7f8fa;color:#1f2329}
+h1{font-size:20px;margin:0 0 8px} h3{font-size:14px;margin:12px 0 6px;color:#4e5969}
+p{color:#86909c;font-size:13px;margin:4px 0}
+details{background:#fff;border:1px solid #e5e6eb;border-radius:6px;padding:8px 12px;margin:6px 0}
+summary{cursor:pointer;font-weight:600;font-size:13px}
+ul{margin:6px 0;padding-left:20px} li{font-size:13px;line-height:1.8} small{color:#86909c}
+.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(160px,1fr));gap:8px}
+.cell{padding:10px;border-radius:6px;font-size:13px;text-align:center}
+.covered{background:#e8ffea;color:#00b42a;border:1px solid #b9f0c6}
+.gap{background:#fff2f0;color:#f53f3f;border:1px solid #ffd4d4}
+.cards{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:12px}
+.card{background:#fff;border:1px solid #e5e6eb;border-radius:8px;padding:12px}
+.card h3{margin-top:0}
+"""
+
+
+def _wrap(title, body):
+    return ("<!DOCTYPE html><html><head><meta charset='utf-8'>"
+            "<meta name='viewport' content='width=device-width,initial-scale=1'>"
+            "<title>%s</title><style>%s</style></head><body>%s</body></html>"
+            % (title, _CSS, body))
+
+
+def cmd_impact(args):
+    cap, repo = _cap()
+    impact = _unpack(cap.mcp.call("get_impact", {"project_id": args.project_id or "",
+                                                 "entity": args.entity, "depth": args.depth}))
+    from capability.present_html import present
+    if "error" in impact:
+        body = "<h1>影响分析 · %s</h1><p class='gap'>取数失败: %s</p>" % (args.entity, impact["error"][:200])
+        present(_wrap("影响分析-" + args.entity, body), name="impact-" + args.entity[:20], repo_root=repo)
+        return
+    sections = []
+    for direction, label in [("upstream", "↑ 谁依赖我（改动影响范围）"),
+                             ("downstream", "↓ 我依赖谁")]:
+        layers = impact.get(direction) or []
+        items_html = ""
+        for i, lay in enumerate(layers):
+            its = lay.get("items", []) if isinstance(lay, dict) else []
+            lis = "".join("<li>%s <small>%s</small></li>"
+                          % (it.get("id", "?"), it.get("type", "")) for it in its)
+            items_html += "<details open><summary>第%d层 (%d)</summary><ul>%s</ul></details>" % (i + 1, len(its), lis)
+        sections.append("<h3>%s</h3>%s" % (label, items_html))
+    totals = impact.get("totals", {}) or {}
+    bytype = impact.get("byType", {}) or {}
+    body = ("<h1>影响分析 · %s</h1><p>节点 %s · 类型分布 %s · depth %d</p>"
+            % (args.entity, totals.get("nodes", 0),
+               json.dumps(bytype, ensure_ascii=False), args.depth)) + "".join(sections)
+    present(_wrap("影响分析-" + args.entity, body),
+            name="impact-" + args.entity[:20], repo_root=repo)
+
+
+def cmd_coverage(args):
+    cap, repo = _cap()
+    cov = _unpack(cap.mcp.call("coverage_matrix", {"project_id": args.project_id or ""}))
+    from capability.present_html import present
+    if "error" in cov:
+        present(_wrap("覆盖矩阵", "<h1>测试覆盖矩阵</h1><p class='gap'>取数失败: %s</p>" % cov["error"][:200]),
+                name="coverage", repo_root=repo)
+        return
+    items = cov.get("items") or cov.get("matrix") or cov.get("features") or []
+    cells = "".join(_cov_cell(it) for it in items) or "<p>无覆盖数据</p>"
+    covered = sum(1 for it in items if it.get("has_test") or it.get("covered"))
+    body = ("<h1>测试覆盖矩阵</h1><p>共 %d 项 · 已覆盖 %d · 缺口 %d</p>"
+            % (len(items), covered, len(items) - covered)) + '<div class="grid">%s</div>' % cells
+    present(_wrap("覆盖矩阵", body), name="coverage", repo_root=repo)
+
+
+def _cov_cell(it):
+    name = it.get("feature") or it.get("name") or it.get("canonical") or "?"
+    has = it.get("has_test") or it.get("covered")
+    cls = "covered" if has else "gap"
+    return '<div class="cell %s">%s</div>' % (cls, name)
+
+
+def cmd_feature(args):
+    cap, repo = _cap()
+    feat = _unpack(cap.mcp.call("feature_overview", {"project_id": args.project_id or "",
+                                                     "feature": args.feature}))
+    from capability.present_html import present
+    if "error" in feat:
+        present(_wrap("功能画像-" + args.feature, "<h1>功能画像 · %s</h1><p class='gap'>取数失败: %s</p>" % (args.feature, feat["error"][:200])),
+                name="feature-" + args.feature[:20], repo_root=repo)
+        return
+    cards = []
+    for key, label in [("endpoints", "端点"), ("buttons", "按钮"),
+                       ("tests", "测试用例"), ("pages", "页面"), ("prds", "PRD")]:
+        lst = feat.get(key) or []
+        if not lst:
+            continue
+        lis = "".join("<li>%s</li>" % x for x in (lst if isinstance(lst, list) else [str(lst)])[:20])
+        cards.append('<div class="card"><h3>%s (%d)</h3><ul>%s</ul></div>' % (label, len(lst), lis))
+    complete = "完整" if len(cards) >= 4 else "部分"
+    body = ("<h1>功能画像 · %s</h1><p>覆盖 %d 维 · %s画像</p>"
+            % (args.feature, len(cards), complete)) + '<div class="cards">%s</div>' % "".join(cards)
+    present(_wrap("功能画像-" + args.feature, body),
+            name="feature-" + args.feature[:20], repo_root=repo)
+
+
+def main():
+    ap = argparse.ArgumentParser(description="知识层富展示看板")
+    sub = ap.add_subparsers(dest="cmd", required=True)
+    p_imp = sub.add_parser("impact")
+    p_imp.add_argument("--entity", required=True)
+    p_imp.add_argument("--project-id")
+    p_imp.add_argument("--depth", type=int, default=2)
+    p_cov = sub.add_parser("coverage")
+    p_cov.add_argument("--project-id")
+    p_fea = sub.add_parser("feature")
+    p_fea.add_argument("--feature", required=True)
+    p_fea.add_argument("--project-id")
+    args = ap.parse_args()
+    if args.cmd == "impact":
+        cmd_impact(args)
+    elif args.cmd == "coverage":
+        cmd_coverage(args)
+    elif args.cmd == "feature":
+        cmd_feature(args)
+
+
+if __name__ == "__main__":
+    main()

package/templates/qoder/settings.json

@@ -68,6 +68,16 @@
         ]
       }
     ],
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "command": "python .qoder/hooks/pre-tool-use.py || python3 .qoder/hooks/pre-tool-use.py"
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "*",