@agile-team/wl-skills-kit 2.4.2 → 2.5.0

package/files/.github/skills/core/page-codegen/templates/universal/TPL-TREE-LIST.md

@@ -2,7 +2,6 @@
 
 > 见 SKILL.md 主文件（约束 + 按钮规则 + Mock 规范等共用规则）。
 
-
 #### index.vue
 
 ```vue
@@ -24,7 +23,14 @@
           @reset="select"
         />
         <BaseToolbar :items="toolbars" />
-        <BaseTable ref="tableRef" :data="list" :columns="columns" showToolbar />
+        <BaseTable
+          ref="tableRef"
+          render-type="agGrid"
+          :cid="TABLE_CID"
+          :data="list"
+          :columns="columns"
+          showToolbar
+        />
         <jh-pagination
           v-show="page.total && page.total > 0"
           :total="page.total || 0"
@@ -39,7 +45,7 @@
 </template>
 
 <script setup lang="ts">
-import { createPage, loadTree } from "./data";
+import { createPage, loadTree, TABLE_CID } from "./data";
 
 const Page = createPage();
 const {
@@ -52,7 +58,7 @@ const {
   columns,
   toolbars,
   select,
-  handleNodeClick
+  handleNodeClick,
 } = Page;
 
 onMounted(() => {
@@ -74,9 +80,13 @@ import {
   BaseQueryItemDesc,
   ActionButtonDesc,
   TableColumnDesc,
-  BusLogicDataType
+  BusLogicDataType,
 } from "@/types/page";
 import { getAction, postAction } from "@jhlc/common-core/src/api/action";
+import { ElMessage } from "element-plus";
+import { defineColumns, renderOps } from "@agile-team/wk-skills-ui/runtime";
+
+export const TABLE_CID = "[pageAbbr]-[base36Timestamp]";
 
 export const API_CONFIG = {
   tree: "/[服务缩写]/[树资源]/tree",
@@ -84,7 +94,7 @@ export const API_CONFIG = {
   remove: "/[服务缩写]/[主资源]/remove",
   getById: "/[服务缩写]/[主资源]/getById",
   save: "/[服务缩写]/[主资源]/save",
-  update: "/[服务缩写]/[主资源]/update"
+  update: "/[服务缩写]/[主资源]/update",
 } as const;
 
 // ===== 树形数据 =====
@@ -106,7 +116,7 @@ export function createPage(editModalRef?: any) {
 
     queryDef(): BaseQueryItemDesc<any>[] {
       return [
-        { name: "[fieldName]", label: "[中文名]", placeholder: "请输入" }
+        { name: "[fieldName]", label: "[中文名]", placeholder: "请输入" },
       ];
     }
 
@@ -115,7 +125,7 @@ export function createPage(editModalRef?: any) {
         {
           name: "primary",
           label: "新增",
-          onClick: () => _editModalRef?.value?.open()
+          onClick: () => _editModalRef?.value?.open(),
         },
         {
           name: "danger",
@@ -124,34 +134,44 @@ export function createPage(editModalRef?: any) {
             const rows = this.tableRef.value?.getSelectionRows();
             if (!rows?.length) return ElMessage.warning("请先选择数据");
             this.removeBatch();
-          }
-        }
+          },
+        },
       ];
     }
 
     columnsDef(): TableColumnDesc<any>[] {
-      return [
-        { type: "selection" },
-        { type: "index" },
-        { label: "[字段名]", name: "[fieldName]", minWidth: 120 },
+      return defineColumns([
+        {
+          type: "selection",
+          width: 55,
+          fixed: "left",
+          align: "center",
+          headerAlign: "center",
+        },
+        { type: "index", label: "序号", width: 60, align: "center" },
+        {
+          label: "[字段名]",
+          name: "[fieldName]",
+          cid: `${TABLE_CID}-[fieldName]`,
+          minWidth: 120,
+        },
         {
           label: "操作",
+          name: "_action",
+          cid: `${TABLE_CID}-action`,
           width: 140,
           fixed: "right",
-          operations: [
-            {
-              name: "edit",
-              label: "编辑",
-              onClick: (row: any) => _editModalRef?.value?.edit(row.id)
-            },
-            {
-              name: "remove",
-              label: "删除",
-              onClick: (row: any) => this.remove(row.id)
-            }
-          ]
-        }
-      ];
+          align: "center",
+          defaultSlot: ({ row }: any) =>
+            renderOps([
+              {
+                type: "edit",
+                onClick: () => _editModalRef?.value?.edit(row.id),
+              },
+              { type: "del", onClick: () => this.remove(row.id) },
+            ]),
+        },
+      ] as any) as TableColumnDesc<any>[];
     }
   })();
 
@@ -168,7 +188,7 @@ export function createPage(editModalRef?: any) {
   return {
     ...created,
     treeData,
-    handleNodeClick
+    handleNodeClick,
   };
 }
 ```

package/files/.github/skills/sync/menu-sync/SKILL.md

@@ -19,9 +19,10 @@ description: "Use when: creating system menus for newly generated pages, batch r
 
 | 数据                                             | 来源                       | 说明                                    |
 | ------------------------------------------------ | -------------------------- | --------------------------------------- |
-| 菜单名称、路径、组件、权限、隐藏、排序、应用编码 | `reports/SYS_MENU_INFO.md` | 由 page-codegen 追加写入，AI 直接读取   |
-| `parentMenuNameCode`                             | API 自动查询               | AI 调 children 接口获取，无需手填       |
-| **gatewayPath、parentMenuId、sysAppNo、token**   | `env.local.json`           | 每套环境不同，唯一需要手动维护的 4 个值 |
+| 菜单名称、路径、组件、权限、隐藏、排序、应用编码 | `.github/reports/SYS_MENU_INFO*.md` | 由 page-codegen 追加写入，AI 直接读取 |
+| `parentMenuNameCode`                             | `wls_menu_query` 查询菜单树 | 从父级节点获取，无需手填               |
+| **gatewayPath、parentMenuId、sysAppNo、token**   | `env.local.json`           | 可通过 token/接口辅助提取               |
+| **domainId**                                     | 用户确认 / 菜单后台 Network | 当前权限下无法总是自动获取，需确认     |
 
 ### 配置文件（统一维护，菜单/字典/权限共用）
 
@@ -33,7 +34,8 @@ description: "Use when: creating system menus for newly generated pages, batch r
   "sysAppNo": "应用编码（从已有菜单的sysAppNo字段获取，非明文）",
   "token": "Bearer Token（不含bearer前缀）",
   "menu": {
-    "parentMenuId": "父级菜单ID"
+    "parentMenuId": "父级菜单ID",
+    "domainId": "应用域ID"
   }
 }
 ```
@@ -47,9 +49,15 @@ menu-sync 读取规则：`parentMenuId` 优先从 `menu.parentMenuId` 读取，
 
 1. **首次**：按 `env/guide.md` 填写 `skills/sync/env.local.json` 的字段
 2. **之后**：直接对 AI 说「帮我创建菜单」/「同步菜单」/「补菜单」
-3. AI 自动执行：读 `reports/SYS_MENU_INFO.md` → 读 `env.local.json` → 查父级已有子节点 → 逐条对比去重 → 调 `/system/menu/save` → 输出 created/skipped 结果表
+3. AI 自动执行：读 `.github/reports/SYS_MENU_INFO*.md` → 读 `env.local.json` → 优先调用 `wls_menu_sync_from_report` 一步完成确定性同步；如需手动拆分，则 `wls_menu_query` 查 domain 菜单树 → 先 upsert 一级目录 → 用返回 id upsert 二级页面菜单 → 输出 created/updated/skipped 结果表
 4. **全程无需手动执行任何命令**
 
+SYS_MENU_INFO.md 是 menu-sync Skill 的输入数据源：
+- **自动创建**：用户说"帮我创建菜单" → menu-sync 调用 `wls_menu_sync_from_report` 读取 SYS_MENU_INFO.md → 调 API 按目录与页面顺序创建/更新
+- **手动创建**：用户也可直接按 SYS_MENU_INFO.md 的表格在系统管理后台手动创建菜单
+- 两种方式等价，菜单创建后通过 `组件路径` 字段与 pages.ts 注册的文件路径关联
+- **自动创建顺序**：优先使用 `wls_menu_sync_from_report`；手动拆分时必须先调用 `wls_menu_query` 获取当前 domain 菜单树，再 `wls_menu_upsert` 创建/更新一级目录（type=M），拿到目录 id 后再创建二级菜单（type=C）。不得把二级页面全部直接挂到根 `parentMenuId`。
+
 ---
 
 ## 方案演进路线
@@ -90,18 +98,23 @@ menu-sync 读取规则：`parentMenuId` 优先从 `menu.parentMenuId` 读取，
 
 ### 执行流程
 
-#### Step 1: 查询父级下已有菜单（防重复）
+#### Step 1: 查询当前 domain 菜单树（防重复 + 取父级信息）
 
 ```
-GET {gatewayPath}/system/menu/children?current=1&size=100&menuId={parentMenuId}
-Headers:
-  authorization: bearer {token}
-  Sysappno: {sysAppNo}
+工具：wls_menu_query
+读取：env.local.json → menu.domainId
+返回：当前应用域完整菜单树
 ```
 
-#### Step 2: 逐条创建菜单
+> 推荐：具备 MCP 时优先调用 `wls_menu_sync_from_report`，它会自动读取最新 `SYS_MENU_INFO*.md`、查询菜单树、复用/更新目录，再把二级菜单挂到对应目录下。可先传 `dryRun: true` 做预览。
+
+#### Step 2: 先创建一级目录（type=M）
+
+对于 `SYS_MENU_INFO` 中的一级目录，按 `menuName/path` 在父级 `parentMenuId` 下去重；不存在则创建，存在则复用 id。
+
+#### Step 3: 再创建二级页面菜单（type=C）
 
-对于每条待创建的菜单，先检查是否与已有菜单重名（`menuName` 或 `path` 相同），重复则跳过。
+对于每条页面菜单，`parentId` 必须使用上一步对应目录的 id，禁止全部挂到根 `parentMenuId`。
 
 > **响应码说明**：后端成功响应为 `code: 2000`（非标准 HTTP 200），判断成功应检查 `response.body.code === 2000` 或 `message` 包含"成功"。
 
@@ -201,11 +214,12 @@ pages.ts 条目:
 
 ### 树形菜单处理
 
-如果需要先创建目录再创建子菜单：
+如果 `SYS_MENU_INFO` 包含一级目录和二级菜单，必须按以下顺序处理：
 
 1. 先以 `type: "M"` 创建目录
 2. 保存成功后取返回的 `data.id`
 3. 以新 `id` 作为 `parentId` 继续创建子菜单
+4. 若目录已存在，复用已存在目录 id，不重复创建
 
 ---