@hupan56/wlkj 3.1.10 → 3.1.12

package/bin/cli.js

@@ -1219,6 +1219,7 @@ function doHelp() {
   console.log("  (提交/同步 /wl-task 和 /wl-commit 会自动做, 不用单独 npx sync)");
   console.log("");
   console.log("=== 进阶 (管理员/特殊情况才用, 不常用) ===");
+  console.log("  npx @hupan56/wlkj selftest   全套件自检 (跨环境+QoderWork工具协议+smoke+体检+MCP)");
   console.log("  npx @hupan56/wlkj doctor     体检 (或在 Qoder 里 /wl-init 无参数)");
   console.log("  npx @hupan56/wlkj migrate    老团队一次性升级到 Trellis 架构");
   console.log("  npx @hupan56/wlkj run <脚本> 万能跑脚本 (AI 内部用, 用户很少需要)");
@@ -1432,5 +1433,43 @@ switch (cmd) {
   case "提交": case "拉取最新": case "同步":
   case "查看状态": case "提交PRD": case "提交Spec": case "提交任务":
     gitOp(cmd); break;
+
+  // ── 自检: 一条命令跑完所有验证套件 (替代 7 步手动清单的"环境验证"部分) ──
+  // 用法: npx @hupan56/wlkj selftest
+  // 跑: cross-env 模拟 + QoderWork 工具协议 + smoke + doctor + mcp_doctor
+  case "selftest": case "自检": {
+    const { spawnSync: _ss } = require("child_process");
+    const cwd = process.cwd();
+    const pyCmd = detectPyCmd();
+    const env = { ...process.env, PYTHONIOENCODING: "utf-8", PYTHONUTF8: "1", PYTHONPATH: path.join(cwd, ".qoder", "scripts") };
+    console.log("\n" + "=".repeat(56));
+    console.log("  wlkj selftest — 全套件自检 (验证跨环境 + 第一宿主)");
+    console.log("=".repeat(56));
+    let totalFail = 0;
+    const suites = [
+      ["1. 跨环境模拟验证", ["packages/wlkj/tests/test_cross_env.py"]],
+      ["2. QoderWork 工具协议 (真实 MCP JSON-RPC)", ["packages/wlkj/tests/test_qoderwork_tools.py"]],
+      ["3. 命令底层脚本 smoke", ["-c", "import sys; sys.path.insert(0, r'" + path.join(cwd, ".qoder", "scripts") + "'); exec(open(r'" + path.join(cwd, ".qoder", "scripts", "validation", "test", "smoke_all_commands.py") + "').read())"]],
+      ["4. 环境体检 (doctor)", [path.join(cwd, ".qoder", "scripts", "orchestration", "wlkj.py"), "doctor"]],
+      ["5. MCP 实测 (mcp_doctor)", [path.join(cwd, ".qoder", "scripts", "protocol", "mcp", "mcp_doctor.py")]],
+    ];
+    for (const [label, args] of suites) {
+      console.log("\n--- " + label + " ---");
+      if (!pyCmd) { console.log("  [SKIP] Python 未装"); continue; }
+      // suites 1-2 在 packages/wlkj/tests/ 下 (相对 cwd), 3-5 用绝对路径
+      const isTestFile = args[0] && args[0].endsWith(".py") && !args[0].startsWith(path.sep) && !args[0].includes(":");
+      const fullArgs = isTestFile ? [path.join(cwd, args[0])] : args;
+      try {
+        const r = _ss(pyCmd, fullArgs, { cwd, stdio: "inherit", timeout: 120000, env });
+        if (r.status !== 0) { console.log("  [FAIL] exit " + r.status); totalFail++; }
+      } catch (e) { console.log("  [FAIL] " + (e.message || "").slice(0, 80)); totalFail++; }
+    }
+    console.log("\n" + "=".repeat(56));
+    console.log(totalFail === 0 ? "  ✓ 全部自检通过" : "  ⚠ " + totalFail + " 个套件失败, 见上方");
+    console.log("=".repeat(56) + "\n");
+    process.exit(totalFail === 0 ? 0 : 1);
+    break;
+  }
+
   default: doHelp();
 }

package/package.json

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

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

@@ -198,7 +198,7 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
           }, "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
+        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"
@@ -207,7 +207,9 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
         _hint = _require_kgdb()
         if _hint:
             return _hint
-        con = get_db()
+        con = get_db_readonly()
+        if con is None:
+            return "知识图谱暂不可用 (kg.duckdb 连接失败), 稍后重试或联系管理员。"
         try:
             return workflow_query(con, q)
         finally:
@@ -222,7 +224,7 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
           }, "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, multi_hop
+        from domain.kg.storage.kg_duckdb import get_db_readonly, multi_hop
         sym = (args.get("symbol") or '').strip()
         if not sym:
             return "请提供起点符号 (entity_id / 端点 / 函数名 / 中文别名)"
@@ -234,7 +236,9 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
         _hint = _require_kgdb()
         if _hint:
             return _hint
-        con = get_db()
+        con = get_db_readonly()
+        if con is None:
+            return "知识图谱暂不可用 (kg.duckdb 连接失败), 稍后重试或联系管理员。"
         try:
             return hop_query(con, sym, depth, multi_hop_fn=multi_hop)
         finally:
@@ -259,12 +263,14 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
               "field": {"type": "string", "description": "字段名(英文field或中文标题)"},
           }, "required": ["field"]})
     def _t_search_field(self, args):
-        from domain.kg.storage.kg_duckdb import get_db
+        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()
+        con = get_db_readonly()
+        if con is None:
+            return "知识图谱暂不可用 (kg.duckdb 连接失败), 稍后重试或联系管理员。"
         try:
             rows = con.execute(
                 "SELECT field, title, count, sample_files FROM fields "
@@ -286,12 +292,14 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
               "platform": {"type": "string", "enum": ["web", "app"], "description": "平台过滤。可选"},
           }})
     def _t_list_modules(self, args):
-        from domain.kg.storage.kg_duckdb import get_db
+        from domain.kg.storage.kg_duckdb import get_db_readonly
         platform = args.get("platform", "")
         _hint = _require_kgdb()
         if _hint:
             return _hint
-        con = get_db()
+        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()