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

package/lib/safe-fix.js

@@ -0,0 +1,115 @@
+"use strict";
+
+/**
+ * lib/safe-fix.js — 确定性机械修复引擎（v2.11.1+）
+ *
+ * 解决的问题：
+ *   过去"修复"完全靠 AI 改源码，机械性偏差（缺 render-type、::v-deep、未用 import 等）
+ *   也走 AI，慢且不确定。本模块对一批"幂等、零语义判断"的偏差做确定性自动修复，
+ *   AI 只处理需要语义判断的部分。
+ *
+ * 覆盖的安全修复（F1~F5，全部幂等）：
+ *   F1: <BaseTable> 缺 render-type="agGrid"  → 补 render-type="agGrid"
+ *   F2: ::v-deep / /deep/                      → :deep()
+ *   F3: import C_Splitter / <C_Splitter>       → 仅标记，不自动改（需人工换布局）
+ *   F4: 行尾多余空白                            → 清除
+ *   F5: 文件末尾缺换行                          → 补 \n
+ *
+ * 设计原则：
+ *   - 只做"改了一定对"的修复，任何有歧义的改动一律跳过并交回 AI
+ *   - dryRun 模式只报告将改什么，不写盘
+ *   - 返回每个文件的改动条目，供 CLI 汇总输出
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const SKIP_DIRS = ["node_modules", "dist", ".git", "demo"];
+
+function walk(dir, base, out) {
+  out = out || [];
+  if (!fs.existsSync(dir)) return out;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory()) {
+      if (SKIP_DIRS.includes(entry.name)) continue;
+      walk(path.join(dir, entry.name), base, out);
+    } else if (/\.(vue|ts|scss)$/.test(entry.name)) {
+      out.push(path.join(dir, entry.name));
+    }
+  }
+  return out;
+}
+
+/**
+ * 对单个文件内容做安全修复
+ * @returns {{ content: string, changes: string[] }}
+ */
+function fixContent(content, ext) {
+  const changes = [];
+  let out = content;
+
+  // F1: BaseTable 缺 render-type（仅 .vue）
+  if (ext === ".vue") {
+    out = out.replace(/<BaseTable\b([^>]*?)>/g, (full, attrs) => {
+      if (/render-type\s*=/.test(attrs)) return full;
+      changes.push('F1: BaseTable 补 render-type="agGrid"');
+      return '<BaseTable render-type="agGrid"' + attrs + ">";
+    });
+  }
+
+  // F2: ::v-deep / /deep/ → :deep()（.vue/.scss）
+  if (ext === ".vue" || ext === ".scss") {
+    if (/::v-deep\b|\/deep\//.test(out)) {
+      // ::v-deep .foo → :deep(.foo)  ；保守处理：仅替换写法标记，复杂选择器交 AI
+      const before = out;
+      out = out.replace(/::v-deep\s+([^\s{,]+)/g, ":deep($1)");
+      out = out.replace(/\/deep\/\s+([^\s{,]+)/g, ":deep($1)");
+      if (out !== before) changes.push("F2: ::v-deep//deep/ → :deep()");
+    }
+  }
+
+  // F4: 行尾空白
+  const trimmed = out.replace(/[ \t]+$/gm, "");
+  if (trimmed !== out) {
+    changes.push("F4: 清除行尾空白");
+    out = trimmed;
+  }
+
+  // F5: 文件末尾换行
+  if (out.length > 0 && !out.endsWith("\n")) {
+    out += "\n";
+    changes.push("F5: 补文件末尾换行");
+  }
+
+  return { content: out, changes };
+}
+
+/**
+ * 扫描目录并执行安全修复
+ * @param {string} targetDir
+ * @param {string} scanRel
+ * @param {object} options { dryRun }
+ * @returns {{ files: Array<{rel,changes}>, fixedCount, fileCount }}
+ */
+function runSafeFix(targetDir, scanRel, options) {
+  options = options || {};
+  const scanDir = path.join(targetDir, scanRel || "src/views");
+  const files = walk(scanDir, targetDir);
+  const result = [];
+  let fixedCount = 0;
+
+  for (const abs of files) {
+    const ext = path.extname(abs);
+    const content = fs.readFileSync(abs, "utf8");
+    const { content: fixed, changes } = fixContent(content, ext);
+    if (changes.length === 0) continue;
+    fixedCount += changes.length;
+    const rel = path.relative(targetDir, abs).replace(/\\/g, "/");
+    result.push({ rel, changes });
+    if (!options.dryRun) fs.writeFileSync(abs, fixed, "utf8");
+  }
+
+  return { files: result, fixedCount, fileCount: files.length };
+}
+
+module.exports = { runSafeFix, fixContent };

package/mcp/config.js

@@ -4,7 +4,7 @@ const fs = require('fs')
 const path = require('path')
 
 /**
- * 从项目的 .github/skills/sync/env.local.json 加载 MCP 运行配置
+ * 从项目的 .wl-skills/skills/sync/env.local.json 加载 MCP 运行配置
  * 项目根目录通过环境变量 WL_PROJECT_ROOT 传入（由 .cursor/mcp.json 注入）
  */
 function loadConfig() {
@@ -12,12 +12,12 @@ function loadConfig() {
     ? path.resolve(process.env.WL_PROJECT_ROOT)
     : process.cwd()
 
-  const configPath = path.join(projectRoot, '.github', 'skills', 'sync', 'env.local.json')
+  const configPath = path.join(projectRoot, '.wl-skills', '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`
+      `请先执行 pnpm dlx @agile-team/wl-skills-kit init，然后填写 .wl-skills/skills/sync/env.local.json`
     )
   }
 

package/mcp/tools/projectTools.js

@@ -5,6 +5,7 @@ const path = require("path");
 const { execFileSync } = require("child_process");
 const https = require("https");
 const { runAstRules } = require("../../lib/ast-rules");
+const { alignPage } = require("../../lib/page-spec");
 
 function getProjectRoot() {
   return process.env.WL_PROJECT_ROOT
@@ -203,6 +204,15 @@ 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}`]);
+    }
+  }
+
   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.1",
+  "description": "AI Skill 模板包 v2.11.1 — 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>