@agile-team/wl-skills-kit 2.3.4 → 2.3.6

package/mcp/tools/permissionSync.js

@@ -0,0 +1,321 @@
+'use strict'
+
+const {
+  queryRoleList,
+  saveRole,
+  queryAssignableMenus,
+  saveRoleMenus,
+  queryMenuChildren,
+} = require('../api/roleApi')
+const { saveMenu } = require('../api/menuApi')
+
+/* ──────────────────────────────────────────────────────────────────────
+ * 角色管理
+ * ──────────────────────────────────────────────────────────────────── */
+
+/**
+ * wls_role_query 工具处理器
+ * 查询角色列表（仅返回字段精简后的角色摘要）
+ */
+async function handleRoleQuery(args, config) {
+  const result = await queryRoleList(args || {}, config)
+
+  if (!result.ok) {
+    return `❌ 查询角色失败: ${result.error} (code: ${result.code})`
+  }
+
+  const page = result.data && result.data.page
+  const records = (page && page.records) || []
+
+  if (records.length === 0) {
+    return '✅ 角色查询成功，当前应用暂无角色数据'
+  }
+
+  // 仅保留关键字段，减少 token 浪费
+  const slim = records.map((r) => ({
+    id: r.id,
+    roleName: r.roleName,
+    code: r.code,
+    sysAppNo: r.sysAppNo,
+    roleDesc: r.roleDesc,
+  }))
+
+  return [
+    `✅ 角色查询成功，当前页 ${records.length} 条 / 共 ${page.total} 条（current=${page.current}, pages=${page.pages}）`,
+    '',
+    JSON.stringify(slim, null, 2),
+  ].join('\n')
+}
+
+/**
+ * wls_role_upsert 工具处理器
+ * 批量新增角色（仅新增，不更新；以 code 字段去重）
+ *
+ * @param {{ items: Array<{ roleName: string, code: string, configDesc?: string }> }} args
+ */
+async function handleRoleUpsert(args, config) {
+  const { items } = args || {}
+
+  if (!Array.isArray(items) || items.length === 0) {
+    return '❌ 参数错误：items 必须是非空数组'
+  }
+
+  // 先查全量角色，按 code 去重
+  const queryResult = await queryRoleList({ size: 999 }, config)
+  if (!queryResult.ok) {
+    return `❌ 查询现有角色失败: ${queryResult.error}`
+  }
+  const existingCodes = new Set(
+    ((queryResult.data && queryResult.data.page && queryResult.data.page.records) || [])
+      .map((r) => r.code)
+  )
+
+  const results = []
+
+  for (const item of items) {
+    if (!item.roleName || !item.code) {
+      results.push({
+        roleName: item.roleName || '(未命名)',
+        code: item.code || '(无)',
+        status: '❌ roleName 与 code 必填',
+      })
+      continue
+    }
+
+    if (existingCodes.has(item.code)) {
+      results.push({
+        roleName: item.roleName,
+        code: item.code,
+        status: '⏭ 已存在（跳过）',
+      })
+      continue
+    }
+
+    const body = {
+      roleName: item.roleName,
+      code: item.code,
+      configDesc: item.configDesc || '',
+    }
+
+    const r = await saveRole(body, config)
+    results.push({
+      roleName: item.roleName,
+      code: item.code,
+      status: r.ok ? '✅ 创建成功' : `❌ 失败: ${r.error}`,
+    })
+  }
+
+  return formatTable(
+    results,
+    ['roleName', 'code', 'status'],
+    ['角色名', 'code', '状态']
+  )
+}
+
+/* ──────────────────────────────────────────────────────────────────────
+ * 角色授权（给角色挂菜单）
+ * ──────────────────────────────────────────────────────────────────── */
+
+/**
+ * wls_role_assign_menus 工具处理器
+ * 给指定角色批量分配菜单权限
+ *
+ * @param {{ roleId: string, menuIds: string[] }} args - menuIds 用数组传入，内部拼成逗号字符串
+ */
+async function handleRoleAssignMenus(args, config) {
+  const { roleId, menuIds } = args || {}
+
+  if (!roleId) {
+    return '❌ 参数错误：roleId 必填'
+  }
+  if (!Array.isArray(menuIds) || menuIds.length === 0) {
+    return '❌ 参数错误：menuIds 必须是非空字符串数组'
+  }
+
+  const body = {
+    roleId,
+    menuIds: menuIds.join(','),
+  }
+
+  const r = await saveRoleMenus(body, config)
+  if (!r.ok) {
+    return `❌ 角色授权失败: ${r.error} (code: ${r.code})`
+  }
+
+  return `✅ 角色授权成功（roleId=${roleId}，已分配 ${menuIds.length} 个菜单/动作）`
+}
+
+/**
+ * wls_assignable_menus_query 工具处理器
+ * 查询全量可授权菜单（扁平/树形由后端决定）
+ */
+async function handleAssignableMenusQuery(_args, config) {
+  const r = await queryAssignableMenus(config)
+  if (!r.ok) {
+    return `❌ 查询可授权菜单失败: ${r.error} (code: ${r.code})`
+  }
+  // data 可能是 { records: [...] } 或数组
+  const records = (r.data && r.data.records) || (Array.isArray(r.data) ? r.data : [])
+  if (records.length === 0) {
+    return '✅ 查询成功，当前无可授权菜单'
+  }
+  return [
+    `✅ 可授权菜单查询成功，共 ${records.length} 条`,
+    '',
+    JSON.stringify(records, null, 2),
+  ].join('\n')
+}
+
+/* ──────────────────────────────────────────────────────────────────────
+ * 挂动作（给页面菜单加 type=A 的动作按钮）
+ * ──────────────────────────────────────────────────────────────────── */
+
+/**
+ * wls_action_query 工具处理器
+ * 查询指定页面菜单下的动作子项（type=A）
+ *
+ * @param {{ menuId: string }} args
+ */
+async function handleActionQuery(args, config) {
+  const { menuId } = args || {}
+  if (!menuId) {
+    return '❌ 参数错误：menuId 必填（页面菜单 id）'
+  }
+
+  const r = await queryMenuChildren(menuId, config)
+  if (!r.ok) {
+    return `❌ 查询子菜单失败: ${r.error} (code: ${r.code})`
+  }
+
+  const records = (r.data && r.data.records) || []
+  // 仅保留 type=A（动作）
+  const actions = records.filter((m) => m.type === 'A')
+
+  if (actions.length === 0) {
+    return `✅ 查询成功，菜单 ${menuId} 下暂无动作（type=A）`
+  }
+
+  const slim = actions.map((a) => ({
+    id: a.id,
+    menuName: a.menuName,
+    permission: a.permission,
+    orderNum: a.orderNum,
+    icon: a.icon,
+  }))
+
+  return [
+    `✅ 动作查询成功，共 ${actions.length} 条`,
+    '',
+    JSON.stringify(slim, null, 2),
+  ].join('\n')
+}
+
+/**
+ * wls_action_upsert 工具处理器
+ * 在指定页面菜单下批量新增动作（type=A），按 permission 去重
+ *
+ * @param {{ parentId: string, items: Array<object> }} args
+ *   items 元素：{ menuName, permission, icon?, orderNum?, useCache? }
+ */
+async function handleActionUpsert(args, config) {
+  const { parentId, items } = args || {}
+
+  if (!parentId) {
+    return '❌ 参数错误：parentId 必填（页面菜单 id）'
+  }
+  if (!Array.isArray(items) || items.length === 0) {
+    return '❌ 参数错误：items 必须是非空数组'
+  }
+
+  // 先查父菜单下已有动作，按 permission 去重
+  const queryResult = await queryMenuChildren(parentId, config)
+  if (!queryResult.ok) {
+    return `❌ 查询现有动作失败: ${queryResult.error}`
+  }
+  const existing = ((queryResult.data && queryResult.data.records) || [])
+    .filter((m) => m.type === 'A')
+  const existingPerms = new Set(existing.map((m) => m.permission))
+
+  const results = []
+
+  for (const item of items) {
+    if (!item.menuName || !item.permission) {
+      results.push({
+        menuName: item.menuName || '(未命名)',
+        permission: item.permission || '(无)',
+        status: '❌ menuName 与 permission 必填',
+      })
+      continue
+    }
+
+    if (existingPerms.has(item.permission)) {
+      results.push({
+        menuName: item.menuName,
+        permission: item.permission,
+        status: '⏭ 已存在（跳过）',
+      })
+      continue
+    }
+
+    const body = {
+      parentId,
+      type: 'A',
+      menuName: item.menuName,
+      permission: item.permission,
+      icon: item.icon || 'list',
+      orderNum: item.orderNum != null ? item.orderNum : 1,
+      useCache: item.useCache != null ? item.useCache : 1,
+      sysAppNo: config.sysAppNo,
+      intIsActive: 1,
+    }
+
+    const r = await saveMenu(body, config)
+    if (r.ok) {
+      const saved = r.data
+      results.push({
+        menuName: item.menuName,
+        permission: item.permission,
+        status: `✅ 创建成功 (id=${saved ? saved.id : '?'})`,
+      })
+    } else {
+      results.push({
+        menuName: item.menuName,
+        permission: item.permission,
+        status: `❌ 失败: ${r.error}`,
+      })
+    }
+  }
+
+  return formatTable(
+    results,
+    ['menuName', 'permission', 'status'],
+    ['动作名', '权限码', '状态']
+  )
+}
+
+/* ──────────────────────────────────────────────────────────────────────
+ * 工具函数
+ * ──────────────────────────────────────────────────────────────────── */
+
+function formatTable(rows, keys, headers) {
+  const successCount = rows.filter((r) => r.status.startsWith('✅')).length
+  const skipCount = rows.filter((r) => r.status.startsWith('⏭')).length
+  const failCount = rows.length - successCount - skipCount
+
+  let out = `操作完成：成功 ${successCount} 条，跳过 ${skipCount} 条，失败 ${failCount} 条\n\n`
+  out += '| ' + headers.join(' | ') + ' |\n'
+  out += '|' + headers.map(() => '---').join('|') + '|\n'
+  for (const r of rows) {
+    out += '| ' + keys.map((k) => r[k]).join(' | ') + ' |\n'
+  }
+  return out
+}
+
+module.exports = {
+  handleRoleQuery,
+  handleRoleUpsert,
+  handleRoleAssignMenus,
+  handleAssignableMenusQuery,
+  handleActionQuery,
+  handleActionUpsert,
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.3.4",
+  "version": "2.3.6",
   "description": "AI Skill 模板包 — 一键导入 AI 指令 + 组件文档 + 通用组件 + 领域样例，覆盖 Copilot/Cursor/Windsurf/Kiro 等主流 AI 编辑器",
   "main": "./bin/wl-skills.js",
   "bin": {

package/files/.github/skills/sync/permission-sync/SKILL.draft.md

@@ -1,91 +0,0 @@
----
-name: permission-sync
-description: "[PLANNED — DRAFT, not yet active] 权限同步 Skill 设计草稿。基于 reports/SYS_PERMISSION_INFO.md 基线，将页面级/按钮级权限码注册到系统权限表，并按角色分配。"
-status: planned
----
-
-# Skill: 权限同步（permission-sync）— 草稿
-
-> ⚠️ **本文件为设计草稿（SKILL.draft.md），未启用，不参与 AI 调度。**
-
----
-
-## 1. 设计目标
-
-新增页面后，除菜单外还需注册：
-
-- **页面访问权限**（`mmwr:customer:list`）
-- **按钮级权限**（`mmwr:customer:add` / `:edit` / `:remove` / `:approve` / `:export` ...）
-- **数据权限**（可选：客户经理只看自己的客户等）
-- **角色绑定**（哪些角色获得这些权限）
-
----
-
-## 2. 数据流
-
-```
-本地基线                                  后端接口                              Skill 触发
-────────────────────────────────────────  ──────────────────────────────────  ────────────────
-reports/SYS_PERMISSION_INFO.md  ─fetch─→  GET  /sys/permission/listAll
-                                ←compare── POST /sys/permission/batchSave
-                                ─upload─→ POST /sys/role/assignPermissions  ─→  "同步权限"
-```
-
----
-
-## 3. 权限码命名规范
-
-```
-{服务缩写}:{资源camelCase}:{操作}
-```
-
-| 操作     | 含义           | 示例                            |
-| -------- | -------------- | ------------------------------- |
-| list     | 查看列表       | `mmwr:customer:list`            |
-| detail   | 查看详情       | `mmwr:customer:detail`          |
-| add      | 新增           | `mmwr:customer:add`             |
-| edit     | 编辑           | `mmwr:customer:edit`            |
-| remove   | 删除           | `mmwr:customer:remove`          |
-| export   | 导出           | `mmwr:customer:export`          |
-| import   | 导入           | `mmwr:customer:import`          |
-| submit   | 提交审批       | `mmwr:customer:submit`          |
-| approve  | 审批通过       | `mmwr:customer:approve`         |
-| reject   | 审批驳回       | `mmwr:customer:reject`          |
-| {custom} | 自定义业务操作 | `mmwr:customer:convertToFormal` |
-
----
-
-## 4. 三种工作模式
-
-| 模式       | 触发                    | 动作                                                   |
-| ---------- | ----------------------- | ------------------------------------------------------ |
-| `scan`     | "扫描权限码"            | 从 src/views/ 扫 v-permission / hasPerm 调用，输出清单 |
-| `register` | "注册权限码 / 同步权限" | 对比基线 → 创建缺失 + 更新描述                         |
-| `assign`   | "给 XX 角色分配权限"    | 选定角色 + 选定权限码 → 调 /sys/role/assignPermissions |
-
----
-
-## 5. 安全约束
-
-- **生产环境拒绝直接 push**：检测 gatewayPath 含 prod/.com 时强制走"导出 SQL"模式
-- **角色分配二次确认**：每次 assign 必须在 Pre-flight 中列出"角色 → 新增/移除的权限"，得到用户 yes 才执行
-- **不删除权限**：永远只新增/更新，删除走人工 SQL（防误删导致大面积失权）
-- **审计**：每次 register/assign 输出 `reports/PERMISSION_SYNC_<YYYYMMDD>.md`，含完整调用日志和回滚 SQL
-
----
-
-## 6. 与其他 Skill 联动
-
-- **page-codegen**：生成 toolbar 时根据 api.md 操作集自动加 `v-permission` 指令
-- **menu-sync**：菜单注册后提示"是否同步注册访问权限"
-- **convention-audit**：审计按钮是否都有 v-permission
-
----
-
-## 7. 转正前的开发任务
-
-- [ ] 确认后端权限模型（RBAC / ABAC？是否分页面权限和按钮权限？）
-- [ ] 数据权限是否纳入本 Skill（建议：暂不，单独 data-permission-sync）
-- [ ] 设计 v-permission 指令的项目内实现（如 @jhlc/common-core 提供则复用）
-- [ ] 多租户场景下的权限继承策略
-- [ ] 与 SSO（嘉为蓝鲸）权限同步策略