@agile-team/wl-skills-kit 2.7.1 → 2.7.3

package/mcp/api/client.js

@@ -1,76 +1,83 @@
-'use strict'
-
-const https = require('https')
-const http = require('http')
-
-/**
- * 带鉴权的 HTTP 客户端（兼容 Node 16+，无额外依赖）
- *
- * @param {string} urlPath - 接口路径（以 / 开头），拼接到 config.gatewayPath 后
- * @param {{ method?: string, body?: unknown }} options
- * @param {{ gatewayPath: string, token: string }} config
- * @returns {Promise<{ ok: boolean, data: any, error?: string, code?: number }>}
- */
-function wlsFetch(urlPath, options, config) {
-  const fullUrl = config.gatewayPath + urlPath
-  const isHttps = fullUrl.startsWith('https')
-  const lib = isHttps ? https : http
-  const bodyStr = options.body ? JSON.stringify(options.body) : null
-
-  let urlObj
-  try {
-    urlObj = new URL(fullUrl)
-  } catch (e) {
-    return Promise.reject(new Error(`无效的 URL: ${fullUrl}`))
-  }
-
-  const reqOptions = {
-    hostname: urlObj.hostname,
-    port: urlObj.port || (isHttps ? 443 : 80),
-    path: urlObj.pathname + urlObj.search,
-    method: options.method || 'GET',
-    headers: {
-      'Content-Type': 'application/json',
-      'Authorization': `Bearer ${config.token}`,
-    },
-  }
-
-  if (bodyStr) {
-    reqOptions.headers['Content-Length'] = Buffer.byteLength(bodyStr)
-  }
-
-  return new Promise((resolve, reject) => {
-    const req = lib.request(reqOptions, (res) => {
-      let data = ''
-      res.on('data', (chunk) => { data += chunk })
-      res.on('end', () => {
-        try {
-          const json = JSON.parse(data)
-          if (json.code === 2000) {
-            resolve({ ok: true, data: json.data, code: json.code })
-          } else {
-            resolve({
-              ok: false,
-              data: null,
-              error: json.message || `服务端返回 code=${json.code}`,
-              code: json.code,
-            })
-          }
-        } catch (e) {
-          reject(new Error(`响应解析失败: ${e.message}，原始内容: ${data.slice(0, 200)}`))
-        }
-      })
-    })
-
-    req.on('error', (e) => reject(new Error(`请求失败: ${e.message}`)))
-    req.setTimeout(15000, () => {
-      req.destroy()
-      reject(new Error('请求超时（15s）'))
-    })
-
-    if (bodyStr) req.write(bodyStr)
-    req.end()
-  })
-}
-
-module.exports = { wlsFetch }
+'use strict'
+
+const https = require('https')
+const http = require('http')
+
+/**
+ * 带鉴权的 HTTP 客户端（兼容 Node 16+，无额外依赖）
+ *
+ * @param {string} urlPath - 接口路径（以 / 开头），拼接到 config.gatewayPath 后
+ * @param {{ method?: string, body?: unknown }} options
+ * @param {{ gatewayPath: string, token: string }} config
+ * @returns {Promise<{ ok: boolean, data: any, error?: string, code?: number }>}
+ */
+function wlsFetch(urlPath, options, config) {
+  const fullUrl = config.gatewayPath + urlPath
+  const isHttps = fullUrl.startsWith('https')
+  const lib = isHttps ? https : http
+  const bodyStr = options.body ? JSON.stringify(options.body) : null
+
+  let urlObj
+  try {
+    urlObj = new URL(fullUrl)
+  } catch (e) {
+    return Promise.reject(new Error(`无效的 URL: ${fullUrl}`))
+  }
+
+  const reqOptions = {
+    hostname: urlObj.hostname,
+    port: urlObj.port || (isHttps ? 443 : 80),
+    path: urlObj.pathname + urlObj.search,
+    method: options.method || 'GET',
+    headers: {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${config.token}`,
+    },
+  }
+
+  if (bodyStr) {
+    reqOptions.headers['Content-Length'] = Buffer.byteLength(bodyStr)
+  }
+
+  return new Promise((resolve, reject) => {
+    const req = lib.request(reqOptions, (res) => {
+      let data = ''
+      res.on('data', (chunk) => { data += chunk })
+      res.on('end', () => {
+        try {
+          const json = JSON.parse(data)
+          if (json.code === 2000) {
+            resolve({ ok: true, data: json.data, code: json.code })
+          } else {
+            // 友好提示：401/4004 等典型错误附带排查指引
+            let hint = ''
+            if (json.code === 401 || /token|未登录|鉴权/i.test(json.message || '')) {
+              hint = '（Token 可能已过期，请重新登录后更新 env.local.json 的 token 字段，仅填纯 JWT 不含 bearer 前缀）'
+            } else if (json.code === 4004 || /url:|not\s*found/i.test(json.message || '')) {
+              hint = '（接口未找到。可能是 gatewayPath 配置缺失前缀或后端环境差异；请检查 env.local.json 的 gatewayPath。不要让 AI 绕开 MCP 自己拼 HTTP）'
+            }
+            resolve({
+              ok: false,
+              data: null,
+              error: (json.message || `服务端返回 code=${json.code}`) + hint,
+              code: json.code,
+            })
+          }
+        } catch (e) {
+          reject(new Error(`响应解析失败: ${e.message}，原始内容: ${data.slice(0, 200)}`))
+        }
+      })
+    })
+
+    req.on('error', (e) => reject(new Error(`请求失败: ${e.message}`)))
+    req.setTimeout(15000, () => {
+      req.destroy()
+      reject(new Error('请求超时（15s）'))
+    })
+
+    if (bodyStr) req.write(bodyStr)
+    req.end()
+  })
+}
+
+module.exports = { wlsFetch }

package/mcp/server.js

@@ -122,7 +122,28 @@ function startServer() {
 
 // 仅在直接执行时启动监听；被 require（如测试）时不启动
 if (require.main === module) {
+  printBanner();
   startServer();
 }
 
+/**
+ * 启动 banner — 写入 stderr，不污染 stdout 的 JSON-RPC 通道
+ * 让用户在编辑器 MCP 输出面板能直观看到：版本、工具数量、项目根
+ */
+function printBanner() {
+  const projectRoot = process.env.WL_PROJECT_ROOT || process.cwd();
+  const lines = [
+    "",
+    "═══════════════════════════════════════════════════",
+    `  wl-skills MCP Server v${PKG.version}`,
+    "═══════════════════════════════════════════════════",
+    `  项目根 (WL_PROJECT_ROOT): ${projectRoot}`,
+    `  已注册工具 (${TOOLS.length}):`,
+    ...TOOLS.map((t) => `    • ${t.name}`),
+    "═══════════════════════════════════════════════════",
+    "",
+  ];
+  process.stderr.write(lines.join("\n") + "\n");
+}
+
 module.exports = { TOOLS, HANDLERS, dispatchTool, startServer };

package/mcp/tools/dictSync.js

@@ -170,4 +170,9 @@ async function handleDictUpsert(args, config) {
   return output
 }
 
-module.exports = { handleDictQuery, handleDictUpsert }
+module.exports = {
+  handleDictQuery,
+  handleDictUpsert,
+  // 导出纯工具函数供单测覆盖
+  _internal: { extractModules },
+}

package/mcp/tools/menuSync.js

@@ -413,4 +413,15 @@ module.exports = {
   handleMenuQuery,
   handleMenuUpsert,
   handleMenuSyncFromReport,
+  // 导出纯工具函数供单测覆盖
+  _internal: {
+    cleanCell,
+    splitMarkdownRow,
+    isDividerRow,
+    parseBoolean,
+    normalizeTree,
+    flattenMenus,
+    findExisting,
+    parseReport,
+  },
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.7.1",
-  "description": "AI Skill 模板包 v2.7.1 — 13 条编码规范 + 10 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目",
+  "version": "2.7.3",
+  "description": "AI Skill 模板包 v2.7.3 — 13 条编码规范 + 10 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目",
   "main": "./bin/wl-skills.js",
   "bin": {
     "wl-skills": "bin/wl-skills.js"
@@ -43,9 +43,10 @@
     "prepare": "husky",
     "cz": "git-cz",
     "lint": "eslint .",
+    "lint:skills": "node scripts/lint-skills.js",
     "test": "vitest run",
     "version:verify": "node scripts/verify-version.js",
-    "prepublishOnly": "node scripts/verify-version.js && vitest run"
+    "prepublishOnly": "node scripts/verify-version.js && node scripts/lint-skills.js && vitest run"
   },
   "dependencies": {
     "xlsx": "^0.18.5"
@@ -74,4 +75,4 @@
       "eslint --fix --no-cache"
     ]
   }
-}
+}