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

package/files/.github/skills/core/page-codegen/templates/universal/TPL-RECORD-FORM.md

@@ -2,7 +2,6 @@
 
 > 见 SKILL.md 主文件（约束 + 按钮规则 + Mock 规范等共用规则）。
 
-
 > 适用场景：通过 BaseQuery 选定主记录（如炉号、生产计划号），展示可编辑的 BaseForm 字段区 + BaseTable 明细行，**无分页**。
 > 典型于生产域实绩录入（转炉实绩、精炼实绩、连铸实绩等）。
 > 参考实现：`src/views/produce/production-omom/lgsj/mmsm-convert-progress/`
@@ -23,16 +22,19 @@ import {
   BaseQueryItemDesc,
   ActionButtonDesc,
   TableColumnDesc,
-  BusLogicDataType
+  BusLogicDataType,
 } from "@/types/page";
 import type { BaseFormItemDesc } from "@jhlc/common-core/src/components/form/common/type";
 import c_spliterTitle from "@/components/local/c_spliterTitle/index.vue";
 import { getAction, postAction } from "@jhlc/common-core/src/api/action";
 import { debounce } from "lodash-es";
+import { defineColumns } from "@agile-team/wk-skills-ui/runtime";
+
+export const BOTTOM_TABLE_CID = "[pageAbbr]-[base36Timestamp]";
 
 export const API_CONFIG = {
-  getByKey:     "/[服务缩写]/[资源名]/getBy[Key]",    // 按主键查询（炉号/计划号/熔炼号）
-  saveOrUpdate: "/[服务缩写]/[资源名]/saveOrUpdate"   // 保存实绩
+  getByKey: "/[服务缩写]/[资源名]/getBy[Key]", // 按主键查询（炉号/计划号/熔炼号）
+  saveOrUpdate: "/[服务缩写]/[资源名]/saveOrUpdate", // 保存实绩
 } as const;
 
 // ─────────────── 查询区 ───────────────
@@ -44,8 +46,8 @@ export const queryItems: BaseQueryItemDesc<any>[] = [
   {
     name: "[keyField]",
     label: "[主键名]",
-    placeholder: "请输入[主键名]"
-  }
+    placeholder: "请输入[主键名]",
+  },
   // 如需关联 Picker，使用 componentVNode 渲染（参考 mmsm-convert-progress PlanMainPicker）
 ];
 
@@ -54,7 +56,7 @@ export const select = async () => {
   const res = await getAction(API_CONFIG.getByKey, queryParam.value);
   form.value = {
     ...queryParam.value,
-    ...(res.data?.[主数据字段] || {})
+    ...(res.data?.[主数据字段] || {}),
   };
   bottomTableData.value = res.data?.[明细字段] || [];
 };
@@ -85,7 +87,7 @@ export const formItems: BaseFormItemDesc<any>[] = [
     label: "",
     labelWidth: "0px",
     span: 4,
-    componentVNode: () => h(c_spliterTitle, { title: "[分区名称]" })
+    componentVNode: () => h(c_spliterTitle, { title: "[分区名称]" }),
   },
   // 普通文本
   { label: "[字段名]", name: "[fieldName]", placeholder: "请输入[字段名]" },
@@ -96,22 +98,22 @@ export const formItems: BaseFormItemDesc<any>[] = [
     placeholder: "请选择[字典字段]",
     logicType: BusLogicDataType.dict,
     logicValue: "[dictCode]",
-    required: true
+    required: true,
   },
   // 时间
   {
     label: "[时间字段]",
     name: "[timeField]",
     placeholder: "请选择[时间字段]",
-    logicType: BusLogicDataType.datetime
+    logicType: BusLogicDataType.datetime,
   },
   // 数值
   {
     label: "[数值字段]",
     name: "[numField]",
     placeholder: "请输入[数值字段]",
-    logicType: BusLogicDataType.number
-  }
+    logicType: BusLogicDataType.number,
+  },
 ];
 
 /** 工具栏（需传入 formRef 以触发校验） */
@@ -126,13 +128,15 @@ export const toolbars = (formRef: any): ActionButtonDesc[] => [
         ElMessageBox.confirm("确定保存吗？", "提示", {
           confirmButtonText: "确定",
           cancelButtonText: "取消",
-          type: "warning"
+          type: "warning",
         }).then(async () => {
-          const res = await postAction(API_CONFIG.saveOrUpdate, { ...form.value });
+          const res = await postAction(API_CONFIG.saveOrUpdate, {
+            ...form.value,
+          });
           ElMessage.success(res?.message || "保存成功");
         });
       });
-    }, 600)
+    }, 600),
   },
   {
     label: "重置",
@@ -141,8 +145,8 @@ export const toolbars = (formRef: any): ActionButtonDesc[] => [
     onClick: () => {
       resetForm();
       formRef?.resetFields();
-    }
-  }
+    },
+  },
 ];
 
 // ─────────────── 明细表格区 ───────────────
@@ -150,17 +154,18 @@ export const toolbars = (formRef: any): ActionButtonDesc[] => [
 export const bottomTableData = ref<any[]>([]);
 
 /** 明细表格列配置 */
-export const bottomTableColumns: TableColumnDesc<any>[] = [
-  { type: "index", width: 55 },
+export const bottomTableColumns: TableColumnDesc<any>[] = defineColumns([
+  { type: "index", label: "序号", width: 60, align: "center" },
   {
     label: "[列名]",
     name: "[fieldName]",
+    cid: `${BOTTOM_TABLE_CID}-[fieldName]`,
     minWidth: 100,
     sortable: true,
-    filterable: true
-  }
+    filterable: true,
+  },
   // 按原型顺序添加明细列，通常为只读（无操作列）
-];
+] as any) as TableColumnDesc<any>[];
 ```
 
 #### index.vue
@@ -190,6 +195,8 @@ export const bottomTableColumns: TableColumnDesc<any>[] = [
       />
       <!-- 明细表格（无分页） -->
       <BaseTable
+        render-type="agGrid"
+        :cid="BOTTOM_TABLE_CID"
         :data="bottomTableData"
         :columns="bottomTableColumns"
         :height="300"
@@ -209,7 +216,8 @@ import {
   reset,
   bottomTableData,
   bottomTableColumns,
-  resetForm
+  BOTTOM_TABLE_CID,
+  resetForm,
 } from "./data";
 
 const formRef = ref<any>(null);
@@ -248,14 +256,14 @@ onMounted(() => {
 
 #### 关键约束
 
-| 约束 | 说明 |
-|------|------|
-| **不用 AbstractPageQueryHook** | 直接导出 `ref` + 函数，无 `createPage()` 包装 |
-| **无分页** | `bottomTableData` 绑定全量数据，不加 `jh-pagination` |
-| **auto-select: false** | BaseQuery 查询是"选择主记录"，不自动触发，用户主动点击 |
-| **toolbars(formRef)** | template 中调用函数传入 `formRef`，不是直接绑定数组 |
-| **debounce 保存** | 防止连点，来自 `lodash-es`，600ms |
-| **c_spliterTitle 分区** | 表单字段按业务分组，每组前插分隔标题 |
+| 约束                           | 说明                                                   |
+| ------------------------------ | ------------------------------------------------------ |
+| **不用 AbstractPageQueryHook** | 直接导出 `ref` + 函数，无 `createPage()` 包装          |
+| **无分页**                     | `bottomTableData` 绑定全量数据，不加 `jh-pagination`   |
+| **auto-select: false**         | BaseQuery 查询是"选择主记录"，不自动触发，用户主动点击 |
+| **toolbars(formRef)**          | template 中调用函数传入 `formRef`，不是直接绑定数组    |
+| **debounce 保存**              | 防止连点，来自 `lodash-es`，600ms                      |
+| **c_spliterTitle 分区**        | 表单字段按业务分组，每组前插分隔标题                   |
 
 #### Mock 文件要点
 
@@ -312,20 +320,29 @@ export default mockApi;
 defineExpose({ loadData, collectFormData, validate, loadDiffData, clearDiffData })
 ```
 
-| 方法 | 说明 |
-|------|------|
+| 方法                     | 说明                                     |
+| ------------------------ | ---------------------------------------- |
 | `loadDiffData(prevData)` | 接收旧版数据，组件内部对比并渲染差异指示 |
-| `clearDiffData()` | 清除比对状态 |
+| `clearDiffData()`        | 清除比对状态                             |
 
 **组件内部实现要点**：
 
 1. **表单字段 diff**：用 `div.diff-field-col` 包裹 `jh-select` + `<span class="diff-old-value">`，旧值出现在字段**下方**（不破坏原布局）：
+
 ```html
 <el-form-item label="纳税类型" prop="taxCategory">
   <div class="diff-field-col">
-    <jh-select v-model="basicInfo.taxCategory" dict="tax_category" label="" placeholder="请选择" />
-    <span v-if="diffBasicInfo && diffBasicInfo.taxCategory !== basicInfo.taxCategory"
-          class="diff-old-value">{{ diffBasicInfo.taxCategory }}</span>
+    <jh-select
+      v-model="basicInfo.taxCategory"
+      dict="tax_category"
+      label=""
+      placeholder="请选择"
+    />
+    <span
+      v-if="diffBasicInfo && diffBasicInfo.taxCategory !== basicInfo.taxCategory"
+      class="diff-old-value"
+      >{{ diffBasicInfo.taxCategory }}</span
+    >
   </div>
 </el-form-item>
 ```
@@ -333,6 +350,7 @@ defineExpose({ loadData, collectFormData, validate, loadDiffData, clearDiffData
 > **数据约定**：`diffBasicInfo` 中存储显示标签（如 `"小规模纳税人"`），不存储 dict code，与 `basicInfo` 保持一致格式，才能正确比对和展示。
 
 2. **表格行 diff**：使用 `computed` 在每条主数据行后插入带 `_isDiffRow: true` 标记的旧版行：
+
 ```typescript
 const displayList = computed(() => {
   if (!diffList.value) return mainList.value;
@@ -341,8 +359,11 @@ const displayList = computed(() => {
     result.push({ ...row, _seq: i + 1 });
     const old = diffList.value![i];
     if (old) {
-      const changed = Object.keys(old).filter(k => !k.startsWith('_') && String(old[k]) !== String(row[k]));
-      if (changed.length) result.push({ ...old, _isDiffRow: true, _changedFields: changed });
+      const changed = Object.keys(old).filter(
+        (k) => !k.startsWith("_") && String(old[k]) !== String(row[k]),
+      );
+      if (changed.length)
+        result.push({ ...old, _isDiffRow: true, _changedFields: changed });
     }
   });
   return result;
@@ -352,25 +373,49 @@ const displayList = computed(() => {
 3. **单元格级高亮**：每个 view 模式列的 `<span>` 加上 `diffCellClass(row, 'fieldName')`。
 
 4. **CSS 样式**（在组件 scoped style 中）：
+
 ```scss
 /* 表单字段 diff 包装器：列方向 flex，使旧值出现在 jh-select 下方 */
 .diff-field-col {
-  display: flex; flex-direction: column; width: 100%;
-  :deep(.el-select) { width: 100% !important; }
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  :deep(.el-select) {
+    width: 100% !important;
+  }
 }
 /* 表单字段旧值：在字段下方，● 前缀不加删除线，文字橙色 + 删除线 */
 .diff-old-value {
-  display: block; font-size: 12px; color: #e6a23c;
-  text-decoration: line-through; margin-top: 2px; line-height: 1.4;
-  &::before { content: "● "; text-decoration: none; display: inline-block; }
+  display: block;
+  font-size: 12px;
+  color: #e6a23c;
+  text-decoration: line-through;
+  margin-top: 2px;
+  line-height: 1.4;
+  &::before {
+    content: "● ";
+    text-decoration: none;
+    display: inline-block;
+  }
 }
 /* 表格对比行：已变更字段 —— 橙色 + 删除线 */
-.diff-changed { color: #e6a23c !important; text-decoration: line-through; }
-.diff-row-marker { color: #e6a23c; font-size: 12px; }
+.diff-changed {
+  color: #e6a23c !important;
+  text-decoration: line-through;
+}
+.diff-row-marker {
+  color: #e6a23c;
+  font-size: 12px;
+}
 /* 表格对比行：整行浅红背景 + 未变字段灰色，已变字段橙色覆盖 */
 :deep(.el-table .is-diff-row) {
   background-color: #fef0f0 !important;
-  td { background-color: #fef0f0 !important; color: #c0c4cc; }
-  .diff-changed { color: #e6a23c !important; }
+  td {
+    background-color: #fef0f0 !important;
+    color: #c0c4cc;
+  }
+  .diff-changed {
+    color: #e6a23c !important;
+  }
 }
 ```

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/core/prototype-scan/SKILL.md

@@ -108,6 +108,22 @@ AI 根据提取的信息，内部构建 page-spec JSON（**不输出给用户**
 
 ## 步骤
 
+> ### ⚠️ Axure 原型文件访问前置说明
+>
+> Axure 导出的 HTML 包含一个 `index.html` 入口，但**不能直接用 `open_browser_page(index.html)` 访问**：
+>
+> | 访问方式 | 结果 | 推荐 |
+> |---------|------|------|
+> | `open_browser_page(index.html)` | 被重定向到 `resources/chrome/chrome.html`（扩展安装引导页），侧边栏不渲染 | ❌ 永久不可用 |
+> | `open_browser_page(具体功能页.html)` | 页面内容正常，`read_page` 可读完整 DOM 快照 | ✅ **首选** |
+> | `read_file(xxx.html)` | 直接读 HTML 源码，用正则提取文本/label | ✅ 推荐（补细节用）|
+>
+> **根本原因**：VS Code 集成浏览器是独立 Playwright/Chromium 进程，**不加载用户 Chrome 的任何扩展**，即使用户本地已安装 Axure RP 扩展也无效。此行为不随环境变化。
+>
+> **补充**：浏览器面板显示 `(not visible)` 仅表示该标签不在前台，不代表无法访问，`screenshot_page`/`read_page` 照样可用。
+>
+> **菜单树**应从 `系统整体框架.html`（或类似全局框架页）的 DOM 文本节点提取，不依赖侧边栏渲染。
+
 ### 1. 全量扫描 HTML
 
 遍历所有 `.html` 文件，提取：

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，不重复创建
 
 ---