@agile-team/wl-skills-kit 2.2.0 → 2.3.1

package/files/src/components/global/C_Tree/data.ts

@@ -0,0 +1,61 @@
+import { ref, watch } from "vue";
+import { Search } from "@element-plus/icons-vue";
+
+// ===== 类型定义 =====
+export interface Props {
+  tabs?: Array<{ label: string; name: string }>;
+  treeData: any[];
+  treeProps?: Record<string, string>;
+  defaultActiveTab?: string;
+  showSearch?: boolean;
+  searchPlaceholder?: string;
+  defaultExpandAll?: boolean;
+  highlightCurrent?: boolean;
+}
+
+// ===== 组件逻辑 =====
+export function createTree(
+  props: Props,
+  emit: (e: "node-click" | "tab-change", ...args: any[]) => void,
+) {
+  const activeTab = ref(props.defaultActiveTab ?? "tab1");
+  const searchKeyword = ref("");
+  const treeRef = ref<any>(null);
+
+  const filterNode = (value: string, data: any) => {
+    if (!value) return true;
+    const label = data[props.treeProps?.label || "label"];
+    return label && label.includes(value);
+  };
+
+  const handleNodeClick = (data: any) => {
+    emit("node-click", data);
+  };
+
+  watch(searchKeyword, (val) => {
+    treeRef.value?.filter(val);
+  });
+
+  watch(activeTab, (val) => {
+    emit("tab-change", val);
+  });
+
+  const clearSearch = () => {
+    searchKeyword.value = "";
+  };
+
+  const switchTab = (tabName: string) => {
+    activeTab.value = tabName;
+  };
+
+  return {
+    Search,
+    activeTab,
+    searchKeyword,
+    treeRef,
+    filterNode,
+    handleNodeClick,
+    clearSearch,
+    switchTab,
+  };
+}

package/files/src/components/global/C_Tree/index.vue

@@ -45,20 +45,7 @@
 </template>
 
 <script setup lang="ts">
-import { ref, watch } from "vue";
-import { Search } from "@element-plus/icons-vue";
-
-// Props 定义
-interface Props {
-  tabs?: Array<{ label: string; name: string }>;
-  treeData: any[];
-  treeProps?: Record<string, string>;
-  defaultActiveTab?: string;
-  showSearch?: boolean;
-  searchPlaceholder?: string;
-  defaultExpandAll?: boolean;
-  highlightCurrent?: boolean;
-}
+import { createTree, type Props } from "./data";
 
 const props = withDefaults(defineProps<Props>(), {
   treeProps: () => ({ children: "children", label: "label" }),
@@ -69,51 +56,23 @@ const props = withDefaults(defineProps<Props>(), {
   highlightCurrent: true
 });
 
-// Emits 定义
 const emit = defineEmits<{
   (e: "node-click", data: any): void;
   (e: "tab-change", tabName: string): void;
 }>();
 
-// 状态
-const activeTab = ref(props.defaultActiveTab);
-const searchKeyword = ref("");
-const treeRef = ref<any>(null);
-
-// 过滤节点
-const filterNode = (value: string, data: any) => {
-  if (!value) return true;
-  const label = data[props.treeProps.label || "label"];
-  return label && label.includes(value);
-};
-
-// 节点点击
-const handleNodeClick = (data: any) => {
-  emit("node-click", data);
-};
-
-// 监听搜索关键词
-watch(searchKeyword, (val) => {
-  treeRef.value?.filter(val);
-});
-
-// 监听tab切换
-watch(activeTab, (val) => {
-  emit("tab-change", val);
-});
-
-// 暴露方法
-defineExpose({
-  treeRef,
-  searchKeyword,
+const {
+  Search,
   activeTab,
-  clearSearch: () => {
-    searchKeyword.value = "";
-  },
-  switchTab: (tabName: string) => {
-    activeTab.value = tabName;
-  }
-});
+  searchKeyword,
+  treeRef,
+  filterNode,
+  handleNodeClick,
+  clearSearch,
+  switchTab
+} = createTree(props, emit);
+
+defineExpose({ treeRef, searchKeyword, activeTab, clearSearch, switchTab });
 </script>
 
 <style scoped lang="scss" src="./index.scss"></style>

package/files/src/components/local/c_listModal/index.scss

@@ -0,0 +1,4 @@
+.dialog-footer {
+  display: flex;
+  justify-content: flex-end;
+}

package/files/src/components/local/c_listModal/index.vue

@@ -133,4 +133,4 @@ defineExpose({
 });
 </script>
 
-<style scoped lang="scss"></style>
+<style scoped lang="scss" src="./index.scss"></style>

package/mcp/api/client.js

@@ -0,0 +1,76 @@
+'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 }

package/mcp/api/dictApi.js

@@ -0,0 +1,40 @@
+'use strict'
+
+const { wlsFetch } = require('./client')
+
+/**
+ * 查询字典树（全量，含所有模块和字典项）
+ * GET /system/business/dict/getDictionaryTreeData
+ * 响应结构: { data: { dictionary: { children: DictModule[] } } }
+ *
+ * @param {{ gatewayPath: string, token: string }} config
+ */
+function queryDictModules(config) {
+  return wlsFetch('/system/business/dict/getDictionaryTreeData', {}, config)
+}
+
+/**
+ * 新增或更新字典模块
+ * POST /system/dictModule/save
+ * ⚠️ 响应 data 为 null，创建后必须通过 queryDictModules + strSn 匹配才能拿到 id
+ *
+ * @param {object} body - DictModuleSaveBody
+ * @param {{ gatewayPath: string, token: string }} config
+ */
+function saveDictModule(body, config) {
+  return wlsFetch('/system/dictModule/save', { method: 'POST', body }, config)
+}
+
+/**
+ * 新增字典值（词典项）
+ * POST /system/business/dict/save
+ * 响应 data 为 null（只需确认 code=2000 成功即可）
+ *
+ * @param {object} body - DictItemSaveBody
+ * @param {{ gatewayPath: string, token: string }} config
+ */
+function saveDictItem(body, config) {
+  return wlsFetch('/system/business/dict/save', { method: 'POST', body }, config)
+}
+
+module.exports = { queryDictModules, saveDictModule, saveDictItem }

package/mcp/api/menuApi.js

@@ -0,0 +1,32 @@
+'use strict'
+
+const { wlsFetch } = require('./client')
+
+/**
+ * 查询指定应用域的菜单树
+ * GET /system/menu/getMenuTreeByDomainId?domainId={domainId}
+ *
+ * @param {string} domainId
+ * @param {{ gatewayPath: string, token: string }} config
+ */
+function queryMenuTree(domainId, config) {
+  return wlsFetch(
+    `/system/menu/getMenuTreeByDomainId?domainId=${encodeURIComponent(domainId)}`,
+    {},
+    config
+  )
+}
+
+/**
+ * 新增或更新菜单
+ * POST /system/menu/save
+ * 有 id → 更新；无 id → 新增（响应 data 含服务端生成的完整对象包括 id）
+ *
+ * @param {object} body - MenuSaveBody
+ * @param {{ gatewayPath: string, token: string }} config
+ */
+function saveMenu(body, config) {
+  return wlsFetch('/system/menu/save', { method: 'POST', body }, config)
+}
+
+module.exports = { queryMenuTree, saveMenu }

package/mcp/config.js

@@ -0,0 +1,47 @@
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+
+/**
+ * 从项目的 .github/skills/sync/env.local.json 加载 MCP 运行配置
+ * 项目根目录通过环境变量 WL_PROJECT_ROOT 传入（由 .cursor/mcp.json 注入）
+ */
+function loadConfig() {
+  const projectRoot = process.env.WL_PROJECT_ROOT
+    ? path.resolve(process.env.WL_PROJECT_ROOT)
+    : process.cwd()
+
+  const configPath = path.join(projectRoot, '.github', 'skills', 'sync', 'env.local.json')
+
+  if (!fs.existsSync(configPath)) {
+    throw new Error(
+      `配置文件不存在: ${configPath}\n` +
+      `请先执行 npx @agile-team/wl-skills-kit init，然后填写 .github/skills/sync/env.local.json`
+    )
+  }
+
+  let raw
+  try {
+    raw = JSON.parse(fs.readFileSync(configPath, 'utf8'))
+  } catch (e) {
+    throw new Error(`配置文件解析失败: ${e.message}`)
+  }
+
+  if (!raw.gatewayPath || raw.gatewayPath.includes('你的网关')) {
+    throw new Error('请在 env.local.json 中填写真实的 gatewayPath（当前为占位值）')
+  }
+  if (!raw.token || raw.token.includes('Bearer Token')) {
+    throw new Error('请在 env.local.json 中填写真实的 token（当前为占位值）')
+  }
+
+  return {
+    gatewayPath: raw.gatewayPath.replace(/\/$/, ''), // 去掉尾部斜杠
+    token: raw.token,
+    sysAppNo: raw.sysAppNo || '',
+    menu: raw.menu || {},
+    dict: raw.dict || {},
+  }
+}
+
+module.exports = { loadConfig }

package/mcp/server.js

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+'use strict'
+
+/**
+ * wl-skills MCP Server
+ *
+ * 实现 MCP 协议（stdio transport，JSON-RPC 2.0）
+ * 暴露 4 个工具：
+ *   wls_menu_query   查询菜单树
+ *   wls_menu_upsert  批量新增/更新菜单
+ *   wls_dict_query   查询字典模块
+ *   wls_dict_upsert  新增/更新字典模块及字典项
+ *
+ * 启动方式（由 .cursor/mcp.json 自动注入）：
+ *   node node_modules/@agile-team/wl-skills-kit/mcp/server.js
+ */
+
+const readline = require('readline')
+const { loadConfig } = require('./config')
+const { handleMenuQuery, handleMenuUpsert } = require('./tools/menuSync')
+const { handleDictQuery, handleDictUpsert } = require('./tools/dictSync')
+
+const PKG = require('../package.json')
+
+// ─── Tool 注册表 ────────────────────────────────────────────────────────
+
+const TOOLS = [
+  {
+    name: 'wls_menu_query',
+    description:
+      '查询当前应用的完整菜单树。自动从 .github/skills/sync/env.local.json 读取 domainId，' +
+      '无需传参。在 wls_menu_upsert 前调用，用于判断哪些菜单需要新增、哪些需要更新。',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: 'wls_menu_upsert',
+    description:
+      '批量新增或更新菜单项。有 id 字段 → 更新；无 id 字段 → 新增。' +
+      '新增时响应自动包含服务端生成的 id，可链式用于创建子菜单。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        items: {
+          type: 'array',
+          description:
+            'MenuSaveBody 数组。每项字段：' +
+            'id(更新时传), sysAppNo, menuName, menuNameCode, parentId, ' +
+            'type("M"=目录/"C"=菜单), path, icon, orderNum, ' +
+            'useCache(1), common(2), hidden(false), editMode(false), ' +
+            'component(type=C时传), permission(type=C时传)',
+          items: { type: 'object' },
+        },
+      },
+      required: ['items'],
+    },
+  },
+  {
+    name: 'wls_dict_query',
+    description:
+      '查询当前应用的所有字典模块及字典项。在 wls_dict_upsert 前调用，' +
+      '用于判断哪些模块/字典项已存在。',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: 'wls_dict_upsert',
+    description:
+      '新增或更新字典模块及其字典项。内部自动处理：' +
+      '若模块不存在则创建（data=null 后自动 re-query 获取 id），' +
+      '若已存在则直接取 id；字典项自动跳过已存在的 strSn。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        module: {
+          type: 'object',
+          description: 'DictModuleSaveBody: strSn(必填), strName(必填), sortPriority("1"), strLevel(2)',
+          properties: {
+            strSn: { type: 'string', description: '模块标识符，如 "gender"' },
+            strName: { type: 'string', description: '模块显示名，如 "性别"' },
+            sortPriority: { type: 'string', description: '排序，字符串类型，如 "1"' },
+            strLevel: { type: 'number', description: '固定传 2' },
+          },
+          required: ['strSn', 'strName'],
+        },
+        items: {
+          type: 'array',
+          description:
+            'DictItemSaveBody 数组（可选）。每项字段：' +
+            'strSn(必填), strName(必填), strLevel(2), ' +
+            'dtlValue(""), dtlValueRequired(false), dtlValue2Required(false), ' +
+            'dtlValue3Required(false), dtlValue4Required(false)',
+          items: { type: 'object' },
+        },
+      },
+      required: ['module'],
+    },
+  },
+]
+
+// ─── JSON-RPC 协议层 ────────────────────────────────────────────────────
+
+function send(obj) {
+  process.stdout.write(JSON.stringify(obj) + '\n')
+}
+
+function sendResult(id, result) {
+  send({ jsonrpc: '2.0', id, result })
+}
+
+function sendError(id, code, message) {
+  send({ jsonrpc: '2.0', id, error: { code, message } })
+}
+
+// ─── Tool 调度 ───────────────────────────────────────────────────────────
+
+async function dispatchTool(id, toolName, toolArgs) {
+  let config
+  try {
+    config = loadConfig()
+  } catch (e) {
+    // 配置加载失败：以文本形式返回给 AI（不是 JSON-RPC error，AI 能读）
+    sendResult(id, { content: [{ type: 'text', text: `❌ 配置加载失败: ${e.message}` }], isError: true })
+    return
+  }
+
+  try {
+    let text
+    switch (toolName) {
+      case 'wls_menu_query':
+        text = await handleMenuQuery(config)
+        break
+      case 'wls_menu_upsert':
+        text = await handleMenuUpsert(toolArgs, config)
+        break
+      case 'wls_dict_query':
+        text = await handleDictQuery(config)
+        break
+      case 'wls_dict_upsert':
+        text = await handleDictUpsert(toolArgs, config)
+        break
+      default:
+        sendError(id, -32601, `未知工具: ${toolName}`)
+        return
+    }
+    sendResult(id, { content: [{ type: 'text', text }] })
+  } catch (e) {
+    sendResult(id, {
+      content: [{ type: 'text', text: `❌ 工具执行异常: ${e.message}` }],
+      isError: true,
+    })
+  }
+}
+
+// ─── 消息循环 ────────────────────────────────────────────────────────────
+
+const rl = readline.createInterface({ input: process.stdin, terminal: false })
+
+rl.on('line', async (line) => {
+  const raw = line.trim()
+  if (!raw) return
+
+  let msg
+  try {
+    msg = JSON.parse(raw)
+  } catch (e) {
+    send({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } })
+    return
+  }
+
+  const { id, method, params = {} } = msg
+
+  // Notifications（无 id）不需要响应
+  if (id === undefined || id === null) return
+
+  switch (method) {
+    case 'initialize':
+      sendResult(id, {
+        protocolVersion: '2024-11-05',
+        capabilities: { tools: {} },
+        serverInfo: { name: 'wl-skills', version: PKG.version },
+      })
+      break
+
+    case 'tools/list':
+      sendResult(id, { tools: TOOLS })
+      break
+
+    case 'tools/call':
+      await dispatchTool(id, params.name, params.arguments || {})
+      break
+
+    case 'ping':
+      sendResult(id, {})
+      break
+
+    default:
+      sendError(id, -32601, `Method not found: ${method}`)
+  }
+})
+
+rl.on('close', () => {
+  process.exit(0)
+})