@agile-team/wl-skills-kit 2.7.3 → 2.9.1

package/files/mock/_utils.ts

@@ -0,0 +1,35 @@
+/**
+ * Mock 公共工具函数
+ * 由 wl-skills-kit 提供，所有 mock 模块文件统一 import 此文件。
+ * 注意：本文件无 export default，vite-plugin-mock 会安全跳过，不会报错。
+ */
+import Mock from "mockjs";
+
+export const Random = Mock.Random;
+export const pick = <T>(arr: T[]): T => Random.pick(arr) as T;
+export const bool = () => Random.boolean();
+
+/** 标准分页响应 */
+export function pageResult(records: any[], total: number) {
+  return { code: 2000, message: "操作成功", data: { records, total } };
+}
+
+/** 标准成功响应 */
+export function ok(data: any = null) {
+  return { code: 2000, message: "操作成功", data };
+}
+
+/** 通用分页截取（兼容 pageNo/current、pageSize/size 两种参数名） */
+export function paginate(pool: any[], query: any) {
+  const current = Number(query?.current || query?.pageNo) || 1;
+  const size = Number(query?.size || query?.pageSize) || 10;
+  const start = (current - 1) * size;
+  return pageResult(pool.slice(start, start + size), pool.length);
+}
+
+/** 当前时间字符串 */
+export function nowStr() {
+  return new Date()
+    .toLocaleString("zh-CN", { hour12: false })
+    .replace(/\//g, "-");
+}

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

@@ -23,6 +23,22 @@
 <script setup>
 import { ref, reactive, onMounted, useSlots, onUnmounted } from "vue";
 
+// ⚠️ [DEPRECATED] C_Splitter 已废弃，请改用：
+//   左右分割 → <jh-drag-col :leftWidth="260"> #left / #right </jh-drag-col>
+//   上下分栈 → <jh-drag-row :topHeight="200"> #top / #bottom </jh-drag-row>
+// 原因：C_Splitter 在 onMounted 中调用 slots.default() 冻结 vnode 快照，
+//      导致子树响应式绑定（v-if / v-show / 插值）与父组件 ref 完全解耦，
+//      ref 赋值不触发重渲染。详见 .github/standards/14-layout-containers.md
+if (typeof window !== "undefined" && !window.__C_SPLITTER_WARNED__) {
+  window.__C_SPLITTER_WARNED__ = true;
+  // eslint-disable-next-line no-console
+  console.warn(
+    "[C_Splitter 已废弃] 已检测到 C_Splitter 使用。请改用 jh-drag-col / jh-drag-row。\n" +
+    "原因：slots.default() 被冻结为 vnode 快照，导致子树响应式失效。\n" +
+    "详见：.github/standards/14-layout-containers.md"
+  );
+}
+
 const props = defineProps({
   direction: {
     type: String,

package/files/src/components/local/c_formSections/README.md

@@ -472,7 +472,7 @@ const defaultForm = generateDefaultFormData(sectionsConfig);
 - ✅ 真实的保存/草稿/取消逻辑（使用 request + Mock）
 - ✅ 项次信息管理（带分页，使用 jh-pagination）
 - ✅ 全屏模式支持
-- ✅ C_Splitter 拖动调整布局
+- ✅ jh-drag-row 拖拽调整布局
 
 **使用方式**:
 

package/mcp/tools/dictSync.js

@@ -1,178 +1,178 @@
-'use strict'
-
-const { queryDictModules, saveDictModule, saveDictItem } = require('../api/dictApi')
-
-/**
- * 从字典树查询响应中提取模块列表
- * 响应结构: { dictionary: { children: DictModule[] } }
- *
- * @param {any} data - queryDictModules 返回的 result.data
- * @returns {object[]}
- */
-function extractModules(data) {
-  if (!data) return []
-  if (data.dictionary && Array.isArray(data.dictionary.children)) {
-    return data.dictionary.children
-  }
-  if (Array.isArray(data)) return data
-  return []
-}
-
-/**
- * wls_dict_query 工具处理器
- * 查询当前应用的所有字典模块及字典项
- *
- * @param {object} config
- * @returns {Promise<string>}
- */
-async function handleDictQuery(config) {
-  const result = await queryDictModules(config)
-
-  if (!result.ok) {
-    return `❌ 查询字典失败: ${result.error} (code: ${result.code})`
-  }
-
-  const modules = extractModules(result.data)
-
-  if (modules.length === 0) {
-    return '✅ 字典查询成功，当前应用暂无字典数据'
-  }
-
-  return `✅ 字典查询成功，共 ${modules.length} 个模块\n\n${JSON.stringify(modules, null, 2)}`
-}
-
-/**
- * wls_dict_upsert 工具处理器
- * 新增或更新字典模块及字典项（完整幂等流程）
- *
- * 流程：
- * ① 查询现有模块，检查 strSn 是否已存在
- * ② 若不存在：创建模块（data=null）→ 重新查询 → 用 strSn 定位拿 id
- * ③ 若已存在：跳过模块创建，直接取已有 id
- * ④ 遍历 items，跳过 strSn 已存在的，其余逐条创建
- *
- * @param {{ module: object, items?: object[] }} args
- * @param {object} config
- * @returns {Promise<string>}
- */
-async function handleDictUpsert(args, config) {
-  const { module: moduleBody, items = [] } = args
-
-  if (!moduleBody || !moduleBody.strSn) {
-    return '❌ 参数错误：module.strSn 必填'
-  }
-  if (!moduleBody.strName) {
-    return '❌ 参数错误：module.strName 必填'
-  }
-
-  // ① 查询现有模块
-  const queryResult = await queryDictModules(config)
-  if (!queryResult.ok) {
-    return `❌ 查询字典失败: ${queryResult.error}`
-  }
-
-  const existingModules = extractModules(queryResult.data)
-  let targetModule = existingModules.find((m) => m.strSn === moduleBody.strSn)
-  let moduleAction
-
-  // ② 模块不存在时创建
-  if (!targetModule) {
-    const saveBody = {
-      strSn: moduleBody.strSn,
-      strName: moduleBody.strName,
-      sortPriority: moduleBody.sortPriority != null ? String(moduleBody.sortPriority) : '1',
-      strLevel: 2,
-    }
-
-    const createResult = await saveDictModule(saveBody, config)
-    if (!createResult.ok) {
-      return `❌ 创建字典模块失败: ${createResult.error}`
-    }
-
-    // ③ 重新查询（data=null，只能靠 re-query 拿 id）
-    const reQueryResult = await queryDictModules(config)
-    if (!reQueryResult.ok) {
-      return `❌ 重新查询字典失败: ${reQueryResult.error}`
-    }
-
-    const freshModules = extractModules(reQueryResult.data)
-    targetModule = freshModules.find((m) => m.strSn === moduleBody.strSn)
-
-    if (!targetModule) {
-      return `❌ 字典模块创建后未能找到（strSn="${moduleBody.strSn}"），请在字典管理后台确认`
-    }
-
-    moduleAction = '✅ 已创建'
-  } else {
-    moduleAction = '⏭ 已存在（跳过创建）'
-  }
-
-  const moduleId = targetModule.id
-
-  // ④ 处理字典项
-  const existingItems = Array.isArray(targetModule.dictionaries)
-    ? targetModule.dictionaries
-    : []
-  const existingSns = new Set(existingItems.map((i) => i.strSn))
-
-  const itemResults = []
-
-  for (const item of items) {
-    if (existingSns.has(item.strSn)) {
-      itemResults.push({
-        strSn: item.strSn,
-        strName: item.strName || '',
-        status: '⏭ 已存在（跳过）',
-      })
-      continue
-    }
-
-    const itemBody = {
-      moduleId,
-      strSn: item.strSn,
-      strName: item.strName,
-      strLevel: 2,
-      dtlValue: item.dtlValue != null ? item.dtlValue : '',
-      dtlValueRequired: item.dtlValueRequired || false,
-      dtlValue2Required: item.dtlValue2Required || false,
-      dtlValue3Required: item.dtlValue3Required || false,
-      dtlValue4Required: item.dtlValue4Required || false,
-    }
-
-    const createResult = await saveDictItem(itemBody, config)
-    if (createResult.ok) {
-      itemResults.push({ strSn: item.strSn, strName: item.strName || '', status: '✅ 已创建' })
-    } else {
-      itemResults.push({
-        strSn: item.strSn,
-        strName: item.strName || '',
-        status: `❌ 失败: ${createResult.error}`,
-      })
-    }
-  }
-
-  const createdCount = itemResults.filter((r) => r.status.startsWith('✅')).length
-  const skippedCount = itemResults.filter((r) => r.status.startsWith('⏭')).length
-  const failedCount = itemResults.filter((r) => r.status.startsWith('❌')).length
-
-  let output = `字典模块 "${moduleBody.strSn}" (${moduleBody.strName})：${moduleAction}\n`
-  output += `模块 ID：${moduleId}\n`
-
-  if (items.length > 0) {
-    output += `字典项：创建 ${createdCount}，跳过 ${skippedCount}，失败 ${failedCount}\n\n`
-    output += '| strSn | strName | 状态 |\n'
-    output += '|---|---|---|\n'
-    for (const r of itemResults) {
-      output += `| ${r.strSn} | ${r.strName} | ${r.status} |\n`
-    }
-  }
-
-  return output
-}
-
-module.exports = {
-  handleDictQuery,
-  handleDictUpsert,
-  // 导出纯工具函数供单测覆盖
-  _internal: { extractModules },
-}
+'use strict'
+
+const { queryDictModules, saveDictModule, saveDictItem } = require('../api/dictApi')
+
+/**
+ * 从字典树查询响应中提取模块列表
+ * 响应结构: { dictionary: { children: DictModule[] } }
+ *
+ * @param {any} data - queryDictModules 返回的 result.data
+ * @returns {object[]}
+ */
+function extractModules(data) {
+  if (!data) return []
+  if (data.dictionary && Array.isArray(data.dictionary.children)) {
+    return data.dictionary.children
+  }
+  if (Array.isArray(data)) return data
+  return []
+}
+
+/**
+ * wls_dict_query 工具处理器
+ * 查询当前应用的所有字典模块及字典项
+ *
+ * @param {object} config
+ * @returns {Promise<string>}
+ */
+async function handleDictQuery(config) {
+  const result = await queryDictModules(config)
+
+  if (!result.ok) {
+    return `❌ 查询字典失败: ${result.error} (code: ${result.code})`
+  }
+
+  const modules = extractModules(result.data)
+
+  if (modules.length === 0) {
+    return '✅ 字典查询成功，当前应用暂无字典数据'
+  }
+
+  return `✅ 字典查询成功，共 ${modules.length} 个模块\n\n${JSON.stringify(modules, null, 2)}`
+}
+
+/**
+ * wls_dict_upsert 工具处理器
+ * 新增或更新字典模块及字典项（完整幂等流程）
+ *
+ * 流程：
+ * ① 查询现有模块，检查 strSn 是否已存在
+ * ② 若不存在：创建模块（data=null）→ 重新查询 → 用 strSn 定位拿 id
+ * ③ 若已存在：跳过模块创建，直接取已有 id
+ * ④ 遍历 items，跳过 strSn 已存在的，其余逐条创建
+ *
+ * @param {{ module: object, items?: object[] }} args
+ * @param {object} config
+ * @returns {Promise<string>}
+ */
+async function handleDictUpsert(args, config) {
+  const { module: moduleBody, items = [] } = args
+
+  if (!moduleBody || !moduleBody.strSn) {
+    return '❌ 参数错误：module.strSn 必填'
+  }
+  if (!moduleBody.strName) {
+    return '❌ 参数错误：module.strName 必填'
+  }
+
+  // ① 查询现有模块
+  const queryResult = await queryDictModules(config)
+  if (!queryResult.ok) {
+    return `❌ 查询字典失败: ${queryResult.error}`
+  }
+
+  const existingModules = extractModules(queryResult.data)
+  let targetModule = existingModules.find((m) => m.strSn === moduleBody.strSn)
+  let moduleAction
+
+  // ② 模块不存在时创建
+  if (!targetModule) {
+    const saveBody = {
+      strSn: moduleBody.strSn,
+      strName: moduleBody.strName,
+      sortPriority: moduleBody.sortPriority != null ? String(moduleBody.sortPriority) : '1',
+      strLevel: 2,
+    }
+
+    const createResult = await saveDictModule(saveBody, config)
+    if (!createResult.ok) {
+      return `❌ 创建字典模块失败: ${createResult.error}`
+    }
+
+    // ③ 重新查询（data=null，只能靠 re-query 拿 id）
+    const reQueryResult = await queryDictModules(config)
+    if (!reQueryResult.ok) {
+      return `❌ 重新查询字典失败: ${reQueryResult.error}`
+    }
+
+    const freshModules = extractModules(reQueryResult.data)
+    targetModule = freshModules.find((m) => m.strSn === moduleBody.strSn)
+
+    if (!targetModule) {
+      return `❌ 字典模块创建后未能找到（strSn="${moduleBody.strSn}"），请在字典管理后台确认`
+    }
+
+    moduleAction = '✅ 已创建'
+  } else {
+    moduleAction = '⏭ 已存在（跳过创建）'
+  }
+
+  const moduleId = targetModule.id
+
+  // ④ 处理字典项
+  const existingItems = Array.isArray(targetModule.dictionaries)
+    ? targetModule.dictionaries
+    : []
+  const existingSns = new Set(existingItems.map((i) => i.strSn))
+
+  const itemResults = []
+
+  for (const item of items) {
+    if (existingSns.has(item.strSn)) {
+      itemResults.push({
+        strSn: item.strSn,
+        strName: item.strName || '',
+        status: '⏭ 已存在（跳过）',
+      })
+      continue
+    }
+
+    const itemBody = {
+      moduleId,
+      strSn: item.strSn,
+      strName: item.strName,
+      strLevel: 2,
+      dtlValue: item.dtlValue != null ? item.dtlValue : '',
+      dtlValueRequired: item.dtlValueRequired || false,
+      dtlValue2Required: item.dtlValue2Required || false,
+      dtlValue3Required: item.dtlValue3Required || false,
+      dtlValue4Required: item.dtlValue4Required || false,
+    }
+
+    const createResult = await saveDictItem(itemBody, config)
+    if (createResult.ok) {
+      itemResults.push({ strSn: item.strSn, strName: item.strName || '', status: '✅ 已创建' })
+    } else {
+      itemResults.push({
+        strSn: item.strSn,
+        strName: item.strName || '',
+        status: `❌ 失败: ${createResult.error}`,
+      })
+    }
+  }
+
+  const createdCount = itemResults.filter((r) => r.status.startsWith('✅')).length
+  const skippedCount = itemResults.filter((r) => r.status.startsWith('⏭')).length
+  const failedCount = itemResults.filter((r) => r.status.startsWith('❌')).length
+
+  let output = `字典模块 "${moduleBody.strSn}" (${moduleBody.strName})：${moduleAction}\n`
+  output += `模块 ID：${moduleId}\n`
+
+  if (items.length > 0) {
+    output += `字典项：创建 ${createdCount}，跳过 ${skippedCount}，失败 ${failedCount}\n\n`
+    output += '| strSn | strName | 状态 |\n'
+    output += '|---|---|---|\n'
+    for (const r of itemResults) {
+      output += `| ${r.strSn} | ${r.strName} | ${r.status} |\n`
+    }
+  }
+
+  return output
+}
+
+module.exports = {
+  handleDictQuery,
+  handleDictUpsert,
+  // 导出纯工具函数供单测覆盖
+  _internal: { extractModules },
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.7.3",
-  "description": "AI Skill 模板包 v2.7.3 — 13 条编码规范 + 10 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目",
+  "version": "2.9.1",
+  "description": "AI Skill 模板包 v2.9.1  — 13 条编码规范 + 10 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目",
   "main": "./bin/wl-skills.js",
   "bin": {
     "wl-skills": "bin/wl-skills.js"