@agile-team/wl-skills-kit 2.7.0 → 2.7.2

package/mcp/api/client.js

@@ -49,10 +49,17 @@ function wlsFetch(urlPath, options, config) {
           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}`,
+              error: (json.message || `服务端返回 code=${json.code}`) + hint,
               code: json.code,
             })
           }

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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.7.0",
-  "description": "AI Skill 模板包 v2.7.0 — 13 条编码规范 + 10 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目",
+  "version": "2.7.2",
+  "description": "AI Skill 模板包 v2.7.2 — 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"
     ]
   }
-}
+}