@agile-team/wl-skills-kit 2.11.0 → 2.11.2

package/mcp/config.js

@@ -1,47 +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 }
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+
+/**
+ * 从项目的 .wl-skills/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, '.wl-skills', 'skills', 'sync', 'env.local.json')
+
+  if (!fs.existsSync(configPath)) {
+    throw new Error(
+      `配置文件不存在: ${configPath}\n` +
+      `请先执行 pnpm dlx @agile-team/wl-skills-kit init，然后填写 .wl-skills/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/registry.js

@@ -296,11 +296,16 @@ const DESCRIPTORS = [
   {
     name: "wls_validate_page",
     description:
-      "校验页面是否符合 wl-skills-kit 最新页面规范：BaseTable+AGGrid+cid、defineColumns、renderOps、mock-first、api.md 等。",
+      "校验页面是否符合 wl-skills-kit 最新页面规范：BaseTable+AGGrid+cid、defineColumns、renderOps、mock-first、api.md 等。开启 typecheck 额外执行 vue-tsc/tsc 类型检查（R14）。",
     inputSchema: {
       type: "object",
       properties: {
         path: { type: "string", description: "页面或目录路径，默认 src/views" },
+        typecheck: {
+          type: "boolean",
+          description:
+            "是否额外执行 vue-tsc/tsc --noEmit 类型检查（R14，体积较大，CI 场景开启）",
+        },
       },
       required: [],
     },

package/mcp/tools/projectTools.js

@@ -4,7 +4,8 @@ const fs = require("fs");
 const path = require("path");
 const { execFileSync } = require("child_process");
 const https = require("https");
-const { runAstRules } = require("../../lib/ast-rules");
+const { runAstRules, runTypeCheck } = require("../../lib/ast-rules");
+const { alignPage } = require("../../lib/page-spec");
 
 function getProjectRoot() {
   return process.env.WL_PROJECT_ROOT
@@ -203,6 +204,23 @@ async function handleValidatePage(args) {
     }
   }
 
+  // ── page-spec 比对（v2.11.1+，"约定 vs 代码"确定性核对 S1~S5）───────
+  for (const page of pages) {
+    const absDir = path.join(root, page.dir);
+    const { issues: specIssues } = alignPage(absDir, page.dir);
+    for (const iss of specIssues) {
+      issues.push([iss.dir, iss.level, `[${iss.rule}] ${iss.text}`]);
+    }
+  }
+
+  // ── 类型检查 R14（v2.11.2+，仅当 typecheck:true 触发）─────────────────
+  if (args && args.typecheck) {
+    const tc = runTypeCheck(root);
+    for (const iss of tc.issues) {
+      issues.push([iss.dir, iss.level, `[${iss.rule}] ${iss.text}`]);
+    }
+  }
+
   const errors = issues.filter((item) => item[1] === "error").length;
   const lines = [
     `✅ 页面校验完成：${scanPath}`,

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.11.0",
-  "description": "AI Skill 模板包 v2.11.0 — 14 条编码规范 + 11 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目（.wl-skills/ 统一隔离架构）",
+  "version": "2.11.2",
+  "description": "AI Skill 模板包 v2.11.2 — 14 条编码规范 + 11 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目（.wl-skills/ 统一隔离架构）",
   "main": "./bin/wl-skills.js",
+  "packageManager": "pnpm@11.5.3",
   "bin": {
     "wl-skills": "bin/wl-skills.js"
   },
@@ -37,28 +38,29 @@
     "url": "git+https://github.com/ChenyCHENYU/wl-skills-kit.git"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=18.0.0"
   },
   "scripts": {
-    "standards:init": "npx @robot-admin/git-standards init",
+    "standards:init": "pnpm dlx @robot-admin/git-standards init",
     "prepare": "husky",
     "cz": "git-cz",
     "lint": "eslint .",
     "lint:skills": "node scripts/lint-skills.js",
     "test": "vitest run",
     "version:verify": "node scripts/verify-version.js",
+    "verify": "pnpm version:verify && pnpm lint:skills && pnpm test",
+    "ci": "pnpm install --frozen-lockfile && pnpm verify",
+    "pack:dry": "npm pack --dry-run --ignore-scripts",
+    "release:check": "pnpm verify && npm pack --dry-run --ignore-scripts",
     "prepublishOnly": "node scripts/verify-version.js && node scripts/lint-skills.js && vitest run"
   },
-  "dependencies": {
-    "xlsx": "^0.18.5"
-  },
   "optionalDependencies": {
-    "@vue/compiler-sfc": "^3.2.0",
-    "@babel/parser": "^7.20.0"
+    "@babel/parser": "^7.20.0",
+    "@vue/compiler-sfc": "^3.2.0"
   },
   "peerDependencies": {
-    "@vue/compiler-sfc": "^3.2.0",
-    "@babel/parser": "^7.20.0"
+    "@babel/parser": "^7.20.0",
+    "@vue/compiler-sfc": "^3.2.0"
   },
   "peerDependenciesMeta": {
     "@vue/compiler-sfc": {
@@ -91,5 +93,8 @@
     "src/**/*.{js,jsx,ts,tsx,vue}": [
       "eslint --fix --no-cache"
     ]
+  },
+  "dependencies": {
+    "write-excel-file": "^4.1.1"
   }
 }

package/files/.wl-skills/src/components/global/C_Splitter/index.scss

@@ -1,61 +0,0 @@
-.my-splitter-container {
-  display: flex;
-  width: 100%;
-  height: 100%;
-  overflow: hidden;
-}
-
-.is-horizontal {
-  flex-direction: row;
-}
-.is-vertical {
-  flex-direction: column;
-}
-
-.splitter-item {
-  overflow: auto;
-}
-
-.splitter-trigger {
-  background-color: #f0f2f5;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  transition: background-color 0.2s;
-  z-index: 10;
-}
-
-.splitter-trigger:hover {
-  background-color: #409eff;
-}
-
-/* 水平线 */
-.is-horizontal > .splitter-trigger {
-  width: 4px;
-  cursor: col-resize;
-}
-.is-horizontal .trigger-line {
-  width: 1px;
-  height: 20px;
-  background: #dcdfe6;
-}
-
-/* 垂直线 */
-.is-vertical > .splitter-trigger {
-  height: 8px;
-  cursor: row-resize;
-  background-color: #f5f5f5;
-  flex-shrink: 0;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-}
-.is-vertical .trigger-line {
-  width: 30px;
-  height: 3px;
-  background: #d9d9d9;
-  border-radius: 2px;
-}
-.is-vertical > .splitter-trigger:hover .trigger-line {
-  background: #409eff;
-}

package/files/.wl-skills/src/components/global/C_Splitter/index.vue

@@ -1,149 +0,0 @@
-<template>
-  <div
-    ref="containerRef"
-    class="my-splitter-container"
-    :class="[`is-${direction}`]"
-  >
-    <template v-for="(item, index) in vnodes" :key="index">
-      <div class="splitter-item" :style="getItemStyle(index)">
-        <component :is="item" />
-      </div>
-
-      <div
-        v-if="index < vnodes.length - 1"
-        class="splitter-trigger"
-        @mousedown="(e) => onMouseDown(e, index)"
-      >
-        <div class="trigger-line"></div>
-      </div>
-    </template>
-  </div>
-</template>
-
-<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 赋值不触发重渲染。详见 .wl-skills/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" +
-    "详见：.wl-skills/standards/14-layout-containers.md"
-  );
-}
-
-const props = defineProps({
-  direction: {
-    type: String,
-    default: "horizontal" // horizontal | vertical
-  },
-  minSize: {
-    type: Number,
-    default: 50
-  }
-});
-
-const slots = useSlots();
-const containerRef = ref(null);
-const vnodes = ref([]); // 存储虚拟节点
-const paneConfigs = ref([]); // 存储每个面板的 minSize 等配置
-const sizes = reactive([]);
-const isDragging = ref(false);
-let currentTriggerIndex = -1;
-
-// 初始化：获取插槽并分配初始平均尺寸
-onMounted(() => {
-  const defaultSlots = slots.default ? slots.default() : [];
-  // 过滤掉注释节点(Symbol(v-cmt))和Fragment，只保留真正的元素
-  const children = defaultSlots.filter((v) => {
-    // 排除 Symbol 类型（注释节点）和 Fragment
-    if (typeof v.type === "symbol") return false;
-    // 保留 string（原生HTML元素）和 object（组件）
-    return typeof v.type === "string" || typeof v.type === "object";
-  });
-  vnodes.value = children;
-
-  const rect = containerRef.value.getBoundingClientRect();
-  const totalAvailable =
-    props.direction === "horizontal" ? rect.width : rect.height;
-  // vertical 模式 trigger 高度是 8px，horizontal 模式宽度是 4px
-  const triggerSize = props.direction === "horizontal" ? 4 : 8;
-  const triggerTotalSize = (children.length - 1) * triggerSize;
-
-  let remainingSize = totalAvailable - triggerTotalSize;
-  let autoCount = 0;
-
-  // 1. 第一次遍历：解析 initialSize (支持 200 或 "30%")
-  const tempSizes = children.map((vnode) => {
-    const initSize = vnode.props?.initialSize;
-    if (initSize === undefined || initSize === null) {
-      autoCount++;
-      return null;
-    }
-    const sizePx =
-      typeof initSize === "string" && initSize.endsWith("%")
-        ? (parseFloat(initSize) / 100) * (totalAvailable - triggerTotalSize)
-        : parseFloat(initSize);
-    remainingSize -= sizePx;
-    return sizePx;
-  });
-
-  // 2. 第二次遍历：填充 sizes 和 paneConfigs
-  tempSizes.forEach((size, idx) => {
-    sizes.push(size === null ? remainingSize / autoCount : size);
-    paneConfigs.value.push({
-      minSize: children[idx].props?.minSize || props.minSize
-    });
-  });
-});
-
-const getItemStyle = (index) => {
-  const prop = props.direction === "horizontal" ? "width" : "height";
-  return { [prop]: `${sizes[index]}px` };
-};
-
-// 拖拽逻辑
-const onMouseDown = (e, index) => {
-  isDragging.value = true;
-  currentTriggerIndex = index;
-  document.body.style.userSelect = "none";
-  document.body.style.cursor =
-    props.direction === "horizontal" ? "col-resize" : "row-resize";
-
-  window.addEventListener("mousemove", onMouseMove);
-  window.addEventListener("mouseup", onMouseUp);
-};
-
-const onMouseMove = (e) => {
-  if (!isDragging.value) return;
-  const i = currentTriggerIndex;
-  const movement = props.direction === "horizontal" ? e.movementX : e.movementY;
-
-  const minCurr = paneConfigs.value[i].minSize;
-  const minNext = paneConfigs.value[i + 1].minSize;
-
-  if (sizes[i] + movement >= minCurr && sizes[i + 1] - movement >= minNext) {
-    sizes[i] += movement;
-    sizes[i + 1] -= movement;
-  }
-};
-
-const onMouseUp = () => {
-  isDragging.value = false;
-  document.body.style.userSelect = "";
-  document.body.style.cursor = "";
-  window.removeEventListener("mousemove", onMouseMove);
-  window.removeEventListener("mouseup", onMouseUp);
-};
-
-onUnmounted(() => onMouseUp())
-</script>
-
-<style scoped src="./index.scss"></style>