@hupan56/wlkj 3.3.18 → 3.4.0

package/package.json

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

package/templates/qoder/scripts/deployment/setup/init_doctor.py

@@ -81,6 +81,21 @@ def say(tag, msg):
     print('{} {}'.format(tag, msg))
 
 
+def _detect_cloud_kg():
+    """检测 kg MCP 是否走云平台 SSE url（共识：全走平台，不建本地 kg）。"""
+    try:
+        _mcp_f = os.path.join(os.path.expanduser('~'), '.qoderwork', 'mcp.json')
+        if os.path.isfile(_mcp_f):
+            import json as _j
+            _cfg = _j.loads(open(_mcp_f, encoding='utf-8').read())
+            _kg = (_cfg.get('mcpServers') or {}).get('qoder-knowledge-graph', {})
+            if _kg.get('url') or _kg.get('type') == 'sse':
+                return True
+    except Exception:
+        pass
+    return False
+
+
 def problem(msg, hint=None):
     issues.append(msg)
     say(BAD, msg)
@@ -483,6 +498,9 @@ def print_degraded_status():
 
 def check_index(fix):
     print('\n--- 5. 知识图谱 (data/index/) ---')
+    if _detect_cloud_kg():
+        say(OK, '知识层走云平台 SSE（不依赖本地 kg.duckdb，平台有81241实体+43工具）')
+        return
     age = index_age_days()
     if age is None:
         # 全迁 PG 后 kg.duckdb 废弃：环境配了 PG → 知识层在平台，不报缺失
@@ -553,8 +571,11 @@ def check_style(fix):
         else:
             problem(fname + ' 缺失', '该文件提交在 git 中, 先解决团队同步 (team_sync pull)')
 
-    # kg.duckdb 知识图谱 (统一存储) — 全迁 PG 后知识层在平台，本地 duckdb 废弃
+    # kg.duckdb 知识图谱 — 全迁 PG 后知识层在平台，本地 duckdb 废弃
+    # ★ 共识：kg 走云 SSE 时也不检查本地
     _pg_mode = os.environ.get('KNOWLEDGE_BACKEND', '').lower() == 'pg' or 'postgresql' in os.environ.get('DATABASE_URL', '')
+    if _detect_cloud_kg():
+        _pg_mode = True
     kg_path = os.path.join(INDEX_DIR, 'kg.duckdb')
     role = ''
     try:

package/templates/qoder/scripts/protocol/mcp/kg_mcp_server.py

@@ -89,15 +89,17 @@ from foundation.protocol.mcp_base import BaseMCPServer, tool
 def _require_kgdb():
     """检查 kg.duckdb 是否存在。存在返回 None; 不存在返回友好提示字符串。
 
-    防止 get_db() 创建空库后查询报 CatalogException (49 台没预建图谱的机器)。
+    ★ 共识：本地引擎全走平台。kg MCP 走云 SSE url，不依赖本地 kg.duckdb。
+    但本文件是"本地 launcher 模式"的 server——只在 mcp.json 没配 SSE url 时被调用。
+    配了 SSE url 时 QoderWork 直连云平台，本文件根本不会启动。
+    所以这里只需检查本地 duckdb，报错了也只影响 launcher 模式（非共识路径）。
     """
     try:
         from foundation.core.paths import DATA_INDEX_DIR
         db_path = DATA_INDEX_DIR / 'kg.duckdb'
         if not db_path.is_file():
-            return ("知识图谱未构建 (kg.duckdb 不存在)。请管理员跑:\n"
-                    "  python .qoder/scripts/orchestration/wlkj.py kg-build\n"
-                    "或非管理员: npx @hupan56/wlkj update (会 git pull 拉团队已构建的 kg.duckdb)")
+            return ("知识图谱走云平台（mcp.json kg → SSE url），本地 kg.duckdb 不需要。\n"
+                    "如果云平台不通，可本地构建: python .qoder/scripts/orchestration/wlkj.py kg-build")
     except Exception:
         pass
     return None
@@ -111,9 +113,56 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
     """
 
     SERVER_NAME = "qoder-knowledge-graph"
-    SERVER_VERSION = "1.1.0"
+    SERVER_VERSION = "2.0.0"
+
+    # ★ v2.0 共识改造：kg 走云平台。本 server 的所有工具不再直连本地 duckdb，
+    # 而是转发到云平台 HTTP MCP@10010（http://10.89.7.120:10010/mcp）。
+    # 工具名映射：本地工具名 → 云平台等价 MCP 工具
+    PLATFORM_MCP_URL = os.environ.get("WLKJ_PLATFORM_MCP", "http://10.89.7.120:10010/mcp")
+    # 本地工具 → 云平台工具映射（名称不同或参数不同）
+    _TOOL_MAP = {
+        "search_code": "search_code",
+        "search_api": "search_code",
+        "search_prd": "rag_search",
+        "get_impact": "get_impact",
+        "context_360": "context_360",
+        "context_pack": "context_pack",
+        "get_workflow": "business_trace",
+        "multi_hop": "business_trace",
+        "search_wiki": "rag_search",
+        "search_field": "schema_link",
+        "list_modules": "search_code",
+        "coverage_matrix": "rag_search",
+        "feature_overview": "evidence_chain",
+        "table_impact": "get_impact",
+        "fill_prototype": None,  # 云平台无等价（本地原型模板）
+        "get_design_system": "get_design_system",
+        "semantic_search": "rag_search",
+    }
+
+    def _call_platform(self, tool_name, args):
+        """转发工具调用到云平台 MCP HTTP API。"""
+        import urllib.request, urllib.error
+        mapped = self._TOOL_MAP.get(tool_name)
+        if not mapped:
+            return json.dumps({"error": f"工具 {tool_name} 无云平台等价（本地功能）"}, ensure_ascii=False)
+        # 云平台 MCP HTTP: POST /mcp body={"tool": "<name>", "args": {...}}
+        try:
+            body = json.dumps({"tool": mapped, "args": args or {}}).encode("utf-8")
+            req = urllib.request.Request(
+                self.PLATFORM_MCP_URL,
+                data=body,
+                headers={"Content-Type": "application/json"},
+                method="POST",
+            )
+            with urllib.request.urlopen(req, timeout=30) as resp:
+                return resp.read().decode("utf-8")
+        except urllib.error.HTTPError as e:
+            return json.dumps({"error": f"云平台 HTTP {e.code}: {e.reason}"}, ensure_ascii=False)
+        except Exception as e:
+            return json.dumps({"error": f"云平台不可达: {type(e).__name__}: {str(e)[:120]}"}, ensure_ascii=False)
 
-    # ── 搜索类 (转发到 search_index) ──────────────────────────────────
+    # ── 工具实现（全部转发到云平台）──────────────────────────────────
 
     @tool("search_code",
           "搜索代码: 按关键词查找代码文件在哪。例: search_code(keyword='考勤') 或 search_code(keyword='车辆', platform='web')",
@@ -122,10 +171,16 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
               "platform": {"type": "string", "enum": ["web", "app"], "description": "平台: web=PC管理端, app=移动端。可选"},
           }, "required": ["keyword"]})
     def _t_search_code(self, args):
-        _ensure_imports()
-        kw = args.get("keyword", "")
-        plat = args.get("platform") or ""
-        return _capture(_search.search_keywords, kw, plat) or "无匹配结果"
+        return self._call_platform("search_code", args)
+
+    @tool("search_code",
+          "搜索代码: 按关键词查找代码文件在哪。例: search_code(keyword='考勤') 或 search_code(keyword='车辆', platform='web')",
+          {"type": "object", "properties": {
+              "keyword": {"type": "string", "description": "搜索关键词(中文或英文)"},
+              "platform": {"type": "string", "enum": ["web", "app"], "description": "平台: web=PC管理端, app=移动端。可选"},
+          }, "required": ["keyword"]})
+    def _t_search_code(self, args):
+        return self._call_platform("search_code", args)
 
     @tool("search_api",
           "搜索API端点: 按关键词查找后端接口。例: search_api(keyword='salary')",
@@ -133,8 +188,7 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
               "keyword": {"type": "string", "description": "API关键词"},
           }, "required": ["keyword"]})
     def _t_search_api(self, args):
-        _ensure_imports()
-        return _capture(_search.search_api, args.get("keyword", "")) or "无匹配结果"
+        return self._call_platform("search_api", args)
 
     @tool("search_prd",
           "搜索PRD: 查已有需求文档,防止重复造轮子。例: search_prd(keyword='考勤')",
@@ -142,8 +196,7 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
               "keyword": {"type": "string", "description": "PRD关键词"},
           }, "required": ["keyword"]})
     def _t_search_prd(self, args):
-        _ensure_imports()
-        return _capture(_search.search_prds, args.get("keyword", "")) or "无匹配PRD"
+        return self._call_platform("search_prd", args)
 
     @tool("get_impact",
           "影响分析: 改某接口/路径会影响哪些前端页面和按钮?评估改动风险。例: get_impact(endpoint='/asset') 或 get_impact(endpoint='export')",
@@ -151,8 +204,7 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
               "endpoint": {"type": "string", "description": "API端点路径或关键词, 如 /asset/list 或 export"},
           }, "required": ["endpoint"]})
     def _t_get_impact(self, args):
-        _ensure_imports()
-        return _capture(_search.search_impact, args.get("endpoint", "")) or "未找到匹配端点"
+        return self._call_platform("get_impact", args)
 
     @tool("context_360",
           "360度视图: 查看符号(端点/函数/处理器)的全部关联信息。例: context_360(symbol='handleExport') 或 context_360(symbol='/system/role')",
@@ -160,8 +212,7 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
               "symbol": {"type": "string", "description": "符号名: 端点/函数名/处理器名"},
           }, "required": ["symbol"]})
     def _t_context_360(self, args):
-        _ensure_imports()
-        return _capture(_search.search_context360, args.get("symbol", "")) or "未找到匹配符号"
+        return self._call_platform("context_360", args)
 
     @tool("context_pack",
           "上下文打包: 一次返回关键词相关的全部上下文(代码+页面+字段+PRD+API+布局指纹)。避免来回查。例: context_pack(keyword='车辆', platform='web')",
@@ -173,321 +224,98 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
                        "description": "角色裁剪: pm=字段+PRD+API, design=页面+布局+风格, dev=代码+API, test=代码+PRD+API。可选"},
           }, "required": ["keyword"]})
     def _t_context_pack(self, args):
-        _ensure_imports()
-        kw = args.get("keyword", "")
-        plat = args.get("platform", "")
-        pt = args.get("page_type", "")
-        role = args.get("role", "")
-        full = _capture(_context._compute_and_print, kw, plat, pt)
-        if not full:
-            return "无匹配上下文"
-        if role:
-            try:
-                from foundation.identity.roles import filter_by_role
-                return filter_by_role(full, role)
-            except Exception:
-                return full
-        return full
-
-    # ── 知识图谱查询类 (DuckDB 直查) ──────────────────────────────────
+        return self._call_platform("context_pack", args)
 
     @tool("get_workflow",
-          "业务流程: 查看一个模块的完整操作链(query→create→audit→archive→export→delete)。数据源: DuckDB workflows 表。优先匹配英文模块名, 中文输入会返回候选模块列表。例: get_workflow(module='assets') 或 get_workflow(module='cost')",
+          "业务流程: 查看一个模块的完整操作链。",
           {"type": "object", "properties": {
-              "module": {"type": "string", "description": "模块名(英文优先): assets/cost/hr/maintenance/operation/qualityAndSafety/veh/settings/dashboard/flow/systems/monitor/quasafe"},
+              "module": {"type": "string", "description": "模块名(英文优先)"},
           }, "required": ["module"]})
     def _t_get_workflow(self, args):
-        from domain.kg.kg_capabilities import workflow_query
-        from domain.kg.storage.kg_duckdb import get_db_readonly
-        q = (args.get("module") or '').strip()
-        if not q:
-            return "请提供模块名。可选: assets/cost/hr/maintenance/operation/qualityAndSafety/veh/settings/dashboard/flow/systems/monitor/quasafe"
-        # ⚠ 先检查 kg.duckdb 存在! get_db() 会创建空库 → 查询报 CatalogException
-        # (49 台没预建图谱的机器会看到原始异常, 而非友好提示)。
-        _hint = _require_kgdb()
-        if _hint:
-            return _hint
-        con = get_db_readonly()
-        if con is None:
-            return "知识图谱暂不可用 (kg.duckdb 连接失败), 稍后重试或联系管理员。"
-        try:
-            return workflow_query(con, q)
-        finally:
-            try: con.close()
-            except Exception: pass
+        return self._call_platform("get_workflow", args)
 
     @tool("multi_hop",
-          "知识图谱多跳遍历: 从一个符号出发, 沿edges递归N跳, 找出全部可达实体(页面→接口→控制器→测试)。知识图谱核心能力。支持别名解析(传中文/端点/函数名自动转entity_id)。例: multi_hop(symbol='资产管理') 或 multi_hop(symbol='handleExport', max_depth=3)",
+          "知识图谱多跳遍历: 从一个符号出发, 沿edges递归N跳。",
           {"type": "object", "properties": {
-              "symbol": {"type": "string", "description": "起点符号: 可传entity_id、别名(资产管理)、端点(/asset/list)或函数名"},
-              "max_depth": {"type": "integer", "default": 3, "description": "最大跳数(1-5), 默认3。越大越全但越慢"},
+              "symbol": {"type": "string", "description": "起点符号"},
+              "max_depth": {"type": "integer", "default": 3, "description": "最大跳数(1-5)"},
           }, "required": ["symbol"]})
     def _t_multi_hop(self, args):
-        from domain.kg.kg_capabilities import hop_query
-        from domain.kg.storage.kg_duckdb import get_db_readonly, multi_hop
-        sym = (args.get("symbol") or '').strip()
-        if not sym:
-            return "请提供起点符号 (entity_id / 端点 / 函数名 / 中文别名)"
-        try:
-            depth = int(args.get("max_depth", 3))
-        except (TypeError, ValueError):
-            depth = 3
-        depth = max(1, min(5, depth))
-        _hint = _require_kgdb()
-        if _hint:
-            return _hint
-        con = get_db_readonly()
-        if con is None:
-            return "知识图谱暂不可用 (kg.duckdb 连接失败), 稍后重试或联系管理员。"
-        try:
-            return hop_query(con, sym, depth, multi_hop_fn=multi_hop)
-        finally:
-            try: con.close()
-            except Exception: pass
+        return self._call_platform("multi_hop", args)
 
     @tool("search_wiki",
-          "搜索Repo Wiki: 查Qoder IDE生成的模块级语义文档(架构/职责/依赖), 比读源码省token。写PRD前优先查。例: search_wiki(keyword='考勤') 或 search_wiki(keyword='权限')",
+          "搜索Repo Wiki: 查模块级语义文档。",
           {"type": "object", "properties": {
-              "keyword": {"type": "string", "description": "Wiki关键词(中/英文)"},
+              "keyword": {"type": "string", "description": "Wiki关键词"},
           }, "required": ["keyword"]})
     def _t_search_wiki(self, args):
-        from domain.kg.kg_capabilities import wiki_query
-        kw = (args.get("keyword") or '').strip()
-        if not kw:
-            return "请提供搜索关键词"
-        return wiki_query(kw)
+        return self._call_platform("search_wiki", args)
 
     @tool("search_field",
-          "搜索字段: 查某个字段在哪些页面用过、中文标题是什么。例: search_field(field='plateNo') 或 search_field(field='车牌号')",
+          "搜索字段: 查某个字段在哪些页面用过。",
           {"type": "object", "properties": {
               "field": {"type": "string", "description": "字段名(英文field或中文标题)"},
           }, "required": ["field"]})
     def _t_search_field(self, args):
-        from domain.kg.storage.kg_duckdb import get_db_readonly
-        field = (args.get("field") or '').strip()
-        _hint = _require_kgdb()
-        if _hint:
-            return _hint
-        con = get_db_readonly()
-        if con is None:
-            return "知识图谱暂不可用 (kg.duckdb 连接失败), 稍后重试或联系管理员。"
-        try:
-            rows = con.execute(
-                "SELECT field, title, count, sample_files FROM fields "
-                "WHERE LOWER(field) LIKE ? OR LOWER(title) LIKE ? LIMIT 20",
-                ['%' + field.lower() + '%', '%' + field.lower() + '%']
-            ).fetchall()
-        finally:
-            con.close()
-        if not rows:
-            return "未找到字段 '%s'" % field
-        lines = ["字段搜索 '%s' (%d个匹配)" % (field, len(rows))]
-        for f, t, c, s in rows:
-            lines.append("  %s -> %s (用了%d次)" % (f, t, c))
-        return '\n'.join(lines)
+        return self._call_platform("search_field", args)
 
     @tool("list_modules",
-          "模块清单: 列出项目所有业务模块及其中文名。例: list_modules() 或 list_modules(platform='web')",
+          "模块清单: 列出项目所有业务模块。",
           {"type": "object", "properties": {
-              "platform": {"type": "string", "enum": ["web", "app"], "description": "平台过滤。可选"},
+              "platform": {"type": "string", "enum": ["web", "app"], "description": "平台过滤"},
           }})
     def _t_list_modules(self, args):
-        from domain.kg.storage.kg_duckdb import get_db_readonly
-        platform = args.get("platform", "")
-        _hint = _require_kgdb()
-        if _hint:
-            return _hint
-        con = get_db_readonly()
-        if con is None:
-            return "知识图谱暂不可用 (kg.duckdb 连接失败), 稍后重试或联系管理员。"
-        try:
-            if platform == 'web':
-                rows = con.execute("SELECT dir, cn, project FROM modules WHERE project LIKE '%fywl%' ORDER BY dir").fetchall()
-            elif platform == 'app':
-                rows = con.execute("SELECT dir, cn, project FROM modules WHERE project LIKE '%Carmg%' OR project LIKE '%H5%' ORDER BY dir").fetchall()
-            else:
-                rows = con.execute("SELECT dir, cn, project FROM modules ORDER BY project, dir").fetchall()
-        finally:
-            con.close()
-        if not rows:
-            return "无模块数据"
-        lines = ["模块清单 (%d个)" % len(rows)]
-        cur = ""
-        for d, cn, proj in rows:
-            if proj != cur:
-                cur = proj
-                lines.append("[%s]" % proj)
-            lines.append("  %s -> %s" % (d, cn))
-        return '\n'.join(lines)
+        return self._call_platform("list_modules", args)
 
     @tool("coverage_matrix",
-          "功能×测试覆盖矩阵: 哪些功能有测试覆盖, 哪些是空白? 标出回归测试盲区。例: coverage_matrix()",
+          "功能×测试覆盖矩阵。",
           {"type": "object", "properties": {}})
     def _t_coverage_matrix(self, args):
-        from domain.kg.graph.graph_traverse import CodeGraph
-        from foundation.core.paths import DATA_INDEX_DIR
-        g = CodeGraph(str(DATA_INDEX_DIR))
-        return g.coverage_matrix() or "无法生成覆盖矩阵"
+        return self._call_platform("coverage_matrix", args)
 
     @tool("feature_overview",
-          "功能画像: 一个功能的完整画像(端点+按钮+测试+页面)。例: feature_overview(feature='资产管理') 或 feature_overview(feature='asset')",
+          "功能画像: 一个功能的完整画像。",
           {"type": "object", "properties": {
-              "feature": {"type": "string", "description": "功能名(中/英文都行): 资产管理/asset/hr"},
+              "feature": {"type": "string", "description": "功能名(中/英文)"},
           }, "required": ["feature"]})
     def _t_feature_overview(self, args):
-        from domain.kg.graph.graph_traverse import CodeGraph
-        from foundation.core.paths import DATA_INDEX_DIR
-        g = CodeGraph(str(DATA_INDEX_DIR))
-        result = g.feature_overview(args.get("feature", ""))
-        if result and '不存在' not in result:
-            return result
-        # DuckDB 兜底: entity-registry.json 缺失时, 用 DuckDB 直接查
-        feat = args.get("feature", "")
-        fl = feat.lower()
-        try:
-            import duckdb as _ddb
-            con = _ddb.connect(str(DATA_INDEX_DIR / 'kg.duckdb'), read_only=True)
-            eps = con.execute(
-                "SELECT canonical FROM entities WHERE type='ENDPOINT' AND "
-                "(lower(canonical) LIKE ? OR lower(canonical) LIKE ?) LIMIT 15",
-                ['%' + fl + '%', '%' + feat + '%']).fetchall()
-            btns = con.execute(
-                "SELECT canonical FROM entities WHERE type='BUTTON' AND "
-                "lower(canonical) LIKE ? LIMIT 10", ['%' + fl + '%']).fetchall()
-            con.close()
-            lines = ['功能画像: %s (DuckDB兜底)' % feat]
-            if eps:
-                lines.append('端点(%d):' % len(eps))
-                for (e,) in eps[:10]:
-                    lines.append('  %s' % e)
-            if btns:
-                lines.append('按钮(%d):' % len(btns))
-                for (b,) in btns[:5]:
-                    lines.append('  %s' % b)
-            if not eps and not btns:
-                lines.append('  (无匹配。换关键词重试)')
-            return chr(10).join(lines)
-        except Exception as e:
-            return '未找到功能 "%s" (DuckDB兜底也失败: %s)' % (feat, str(e)[:60])
-
-    # ── 跨层影响分析 ──────────────────────────────────────────────────
+        return self._call_platform("feature_overview", args)
 
     @tool("table_impact",
-          "改表影响分析: 改某数据库表会影响哪些 Entity 类和接口? 跨层遍历(数据层→代码层)。例: table_impact(table='quality_case') → 找到 QualityCase 类 + 影响的 Controller/接口",
+          "改表影响分析: 改某数据库表会影响哪些 Entity 类和接口。",
           {"type": "object", "properties": {
-              "table": {"type": "string", "description": "数据库表名 (如 quality_case)"},
+              "table": {"type": "string", "description": "数据库表名"},
           }, "required": ["table"]})
     def _t_table_impact(self, args):
-        from foundation.core.paths import DATA_INDEX_DIR
-        import duckdb as _ddb
-        db_path = str(DATA_INDEX_DIR / 'kg_db.duckdb')
-        if not os.path.isfile(db_path):
-            return "数据层图谱未构建。请先跑: python .qoder/scripts/domain/kg/build/kg_build_db.py"
-        table = (args.get("table") or "").strip()
-        try:
-            con = _ddb.connect(db_path, read_only=True)
-        except Exception as e:
-            return "数据层图谱暂时不可用(可能正在重建): %s。稍后重试。" % str(e)[:60]
-        try:
-            ents = con.execute(
-                "SELECT DISTINCT entity_class FROM entity_table_map WHERE table_name = ?",
-                [table]
-            ).fetchall()
-            ent_list = [r[0] for r in ents]
-            if not ent_list:
-                return "表 '%s' 在 entity_table_map 中无映射 (可能该表无 @TableName 注解的 Entity)" % table
-            lines = ["改表影响分析: %s" % table]
-            lines.append("  对应 Entity: %s" % ', '.join(ent_list))
-            cols = con.execute(
-                "SELECT column_name, data_type, column_comment FROM db_columns "
-                "WHERE table_name = ? LIMIT 10", [table]
-            ).fetchall()
-            if cols:
-                lines.append("  表字段 (%d+):" % len(cols))
-                for cn, dt, cc in cols:
-                    lines.append("    %s (%s) %s" % (cn, dt, (cc or '')[:30]))
-            try:
-                con.execute("ATTACH '%s' AS code (READ_ONLY)" % str(DATA_INDEX_DIR / 'kg.duckdb'))
-                lines.append("  影响的接口/控制器:")
-                found = 0
-                for ec in ent_list:
-                    refs = con.execute(
-                        "SELECT type, canonical FROM code.entities "
-                        "WHERE contains(canonical, ?) AND type IN ('CONTROLLER','ENDPOINT') "
-                        "LIMIT 12", [ec]
-                    ).fetchall()
-                    for t, c in refs:
-                        lines.append("    [%s] %s" % (t, c))
-                        found += 1
-                if not found:
-                    lines.append("    (代码图谱中未找到引用 %s 的接口)" % ent_list[0])
-                con.execute("DETACH code")
-            except Exception as e:
-                lines.append("  (代码图谱查询失败: %s)" % str(e)[:60])
-            return '\n'.join(lines)
-        finally:
-            con.close()
-
-    # ── 原型/设计类 (子进程调用) ──────────────────────────────────────
+        return self._call_platform("table_impact", args)
+
+    # ── 原型/设计/语义 (全部走云平台) ────────────────────────────────
 
     @tool("fill_prototype",
-          "原型预填: 用真实代码数据(表格列/表单字段/布局参数)自动填模板,输出80%完成的HTML草稿+数据清单。AI只需微调20%。出原型前必须调。例: fill_prototype(keyword='营业外合同', platform='web')",
+          "原型预填: 用真实代码数据自动填模板。",
           {"type": "object", "properties": {
               "keyword": {"type": "string", "description": "业务关键词"},
-              "platform": {"type": "string", "enum": ["web", "app"], "description": "平台: web或app。默认web"},
+              "platform": {"type": "string", "enum": ["web", "app"], "description": "平台"},
           }, "required": ["keyword"]})
     def _t_fill_prototype(self, args):
-        from foundation.core.paths import find_script
-        kw = args.get("keyword", "")
-        plat = args.get("platform", "web")
-        script = find_script('fill_prototype.py')
-        if script is None:
-            return "fill_prototype.py 未找到 (脚本迁移后路径未更新)"
-        try:
-            r = subprocess.run([sys.executable, str(script), kw, '--platform', plat],
-                               capture_output=True, text=True, encoding='utf-8',
-                               errors='replace', timeout=30, cwd=str(script.parent))
-            return r.stdout or "fill_prototype 无输出 (可能索引缺失)"
-        except Exception as e:
-            return "[error] fill_prototype: %s" % str(e)
+        return self._call_platform("fill_prototype", args)
 
     @tool("get_design_system",
-          "设计系统查询: 返回项目完整设计规范(布局指纹/颜色token/页面模式/组件表/图标规则/behaviors)。出任何原型前必须先调。例: get_design_system() 或 get_design_system(platform='web')",
+          "设计系统查询: 返回项目完整设计规范。",
           {"type": "object", "properties": {
-              "platform": {"type": "string", "enum": ["web", "app"], "description": "平台: 只返回指定平台的指纹。不传则返回全部"},
+              "platform": {"type": "string", "enum": ["web", "app"], "description": "平台过滤"},
           }})
     def _t_get_design_system(self, args):
-        from foundation.core.paths import find_script
-        design_md = os.path.join(BASE_DIR, 'data', 'design', 'DESIGN.md')
-        if not os.path.isfile(design_md):
-            gen_script = find_script('gen_design_doc.py')
-            if gen_script is not None:
-                subprocess.run([sys.executable, str(gen_script)], capture_output=True, timeout=30)
-        if os.path.isfile(design_md):
-            content = open(design_md, encoding='utf-8').read()
-            plat = args.get("platform")
-            if plat:
-                lines = content.split('\n')
-                result = []
-                in_section = False
-                for line in lines:
-                    if line.startswith('### ') and plat.lower() in line.lower():
-                        in_section = True
-                    elif line.startswith('### ') and in_section:
-                        break
-                    if in_section:
-                        result.append(line)
-                return '\n'.join(result) if result else content
-            return content
-        return "DESIGN.md 不存在且生成失败。请手动跑: python .qoder/scripts/design/gen_design_doc.py"
+        return self._call_platform("get_design_system", args)
 
     @tool("semantic_search",
-          "语义搜索(概念检索): 用自然语言找代码/API/功能,不依赖精确关键词。查'报销'能命中 expense/reimburse。需先构建embedding(管理员跑 kg_semantic.py build-embeddings)。例: semantic_search(query='报销流程') 或 semantic_search(query='车辆调度')",
+          "语义搜索: 用自然语言找代码/API/功能。",
           {"type": "object", "properties": {
-              "query": {"type": "string", "description": "自然语言查询(中/英文均可)"},
-              "top_k": {"type": "integer", "default": 10, "description": "返回前N条, 默认10"},
+              "query": {"type": "string", "description": "自然语言查询"},
+              "top_k": {"type": "integer", "default": 10, "description": "返回前N条"},
           }, "required": ["query"]})
     def _t_semantic_search(self, args):
+        return self._call_platform("semantic_search", args)
         from domain.kg.graph.kg_semantic import semantic_search, embedding_status
         query = (args.get("query") or '').strip()
         if not query: