@agile-team/wl-skills-ui 1.8.2 → 1.8.3

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to **@agile-team/wl-skills-ui** will be documented in this f
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.8.3] - 2026-05-13
+
+### Added
+
+- **scan --only / --skip**：支持规则级过滤，`--only R001,R016` 仅跑指定规则，`--skip R031-R037` 排除范围（支持连字符范围展开）。
+- **exempt init 脚手架**：`wl-scan exempt init --target src` 智能扫描 src 下 big-screen/dashboard/chart 等个性化目录，自动生成 `.wl-exempt.json` 模板。
+
 ## [1.8.2] - 2026-05-13
 
 ### Fixed

package/README.md

@@ -213,14 +213,15 @@ yarn add @agile-team/wl-skills-ui
 
 ## 版本亮点
 
-当前 v1.8.2：
+当前 v1.8.3：
 
-- **修复**搜索区字号 13px/12px 混杂 → 统一 12px；必填星号 `* *` 重复 → 精确单颗控制
-- 新增 **scanner fixture 测试集**（16 条自动化测试，`npm test`）和 **SCSS 链路检查**（`npm run check:scss`）
-- `scan --baseline` 一步到位：扫描后自动对比基线输出漂移报告，CI 增量门槛
-- **漂移检测** `scanner/drift.mjs` + CLI `wl-scan drift` + MCP `wl_ui_drift`
+- `scan --only R001,R016` / `--skip R031-R037` 规则级过滤（支持范围展开）
+- `exempt init --target src` 智能扫描个性化目录，自动生成 `.wl-exempt.json`
+- **修复**搜索区字号统一 12px；必填星号 `* *` 去重
+- **scanner fixture 测试集**（16 条，`npm test`）+ **SCSS 链路检查**（`npm run check:scss`）
+- `scan --baseline` 一步漂移对比 + **drift.mjs** / MCP `wl_ui_drift`
 - **R-rule 单一事实源** `standards/rules.json`（29 条），五向一致性守卫
-- **长效治理方案** `docs/governance-long-term.md`（基线 / 豁免 / 漂移 / 版本钉死 / AI 守护）
+- **长效治理方案** `docs/governance-long-term.md`
 
 历史亮点（v1.7.1）：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/wl-skills-ui",
-  "version": "1.8.2",
+  "version": "1.8.3",
   "description": "企业级 UI 风格对齐框架 — Vue + Element Plus 项目通用化妆/原生双模式（tokens / element / vendors / layouts / runtime / scanner / fixer / skills）",
   "type": "module",
   "main": "./es/index.js",

package/scanner/index.mjs

@@ -4,6 +4,8 @@
  *
  * 用法：
  *   wl-scan scan --target <path>          # 风格扫描
+ *   wl-scan scan --target <path> --only R001,R016
+ *   wl-scan scan --target <path> --skip R031-R037
  *   wl-scan scan --target <path> --outFile report.md
  *   wl-scan scan --target <path> --output json
  *   wl-scan check --project <path>        # 接入完整性检查
@@ -12,6 +14,7 @@
  *   wl-scan all --project <path>          # 接入检查 + 风格扫描 + 报告
  *   wl-scan init                          # 打印接入指引
  *   wl-scan drift --baseline <f> --current <f>  # 漂移检测
+ *   wl-scan exempt init --target <path>          # 生成 .wl-exempt.json 豁免模板
  *   wl-scan snapshot list                  # 列出快照
  *   wl-scan snapshot rollback [--id <id>]  # 回退到快照（默认最新）
  *   wl-scan snapshot diff [--id <id>]      # 查看快照与当前差异
@@ -45,6 +48,7 @@ const SUBCOMMANDS = new Set([
   "all",
   "init",
   "drift",
+  "exempt",
   "snapshot",
 ]);
 let subcommand = "scan";
@@ -71,6 +75,8 @@ const { values } = parseArgs({
     exempt: { type: "string", default: "" },
     baseline: { type: "string", default: "" },
     current: { type: "string", default: "" },
+    only: { type: "string", default: "" },
+    skip: { type: "string", default: "" },
   },
   strict: false,
 });
@@ -199,6 +205,24 @@ function runScan(targetDir, excludeDirs, exemptConfig) {
   };
 }
 
+// ── 公共：规则范围展开（R031-R037 → R031,R032,...,R037）────────────────────
+function expandRuleRange(input) {
+  const set = new Set();
+  for (const part of input.split(",").map((s) => s.trim())) {
+    const rangeMatch = part.match(/^(R)(\d+)-(R)?(\d+)$/i);
+    if (rangeMatch) {
+      const start = parseInt(rangeMatch[2]);
+      const end = parseInt(rangeMatch[4]);
+      for (let i = Math.min(start, end); i <= Math.max(start, end); i++) {
+        set.add("R" + String(i).padStart(3, "0"));
+      }
+    } else {
+      set.add(part.toUpperCase());
+    }
+  }
+  return set;
+}
+
 // ── 公共：按 layer / vendor / mode 过滤 ─────────────────────────────────────
 function applyFilters(issues) {
   let out = issues;
@@ -216,6 +240,16 @@ function applyFilters(issues) {
   } else if (values.mode === "native") {
     // 原生模式：全部 layer
   }
+  // --only R001,R016 → 仅保留指定规则
+  if (values.only) {
+    const allow = expandRuleRange(values.only);
+    out = out.filter((i) => allow.has(i.rule));
+  }
+  // --skip R031-R037 → 排除指定规则
+  if (values.skip) {
+    const deny = expandRuleRange(values.skip);
+    out = out.filter((i) => !deny.has(i.rule));
+  }
   return out;
 }
 
@@ -267,6 +301,76 @@ if (subcommand === "check") {
   process.exit(values["fail-on-error"] && hasError ? 1 : 0);
 }
 
+if (subcommand === "exempt") {
+  const sub = args[0] || "init";
+  if (sub === "init") {
+    const { existsSync } = await import("node:fs");
+    const projectRoot = resolve(values.project);
+    const targetDir = resolve(values.target);
+    const outPath = join(projectRoot, ".wl-exempt.json");
+    if (existsSync(outPath)) {
+      console.log(`⚠️  ${outPath} 已存在，跳过生成。如需重新生成请先删除。`);
+      process.exit(0);
+    }
+    // 智能扫描目标目录下常见的个性化子目录
+    const EXEMPT_KEYWORDS = [
+      "big-screen",
+      "dashboard",
+      "map-view",
+      "topology",
+      "flow-designer",
+      "report-designer",
+      "chart",
+      "3d",
+      "canvas",
+      "screen",
+      "monitor",
+      "cockpit",
+      "visual",
+    ];
+    const smartPaths = [];
+    function walkForExempt(dir, depth = 0) {
+      if (depth > 4) return;
+      try {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+          if (!entry.isDirectory()) continue;
+          if (["node_modules", "dist", ".git"].includes(entry.name)) continue;
+          const rel = relative(targetDir, join(dir, entry.name)).replace(
+            /\\/g,
+            "/",
+          );
+          if (
+            EXEMPT_KEYWORDS.some((kw) => entry.name.toLowerCase().includes(kw))
+          ) {
+            smartPaths.push(rel + "/**");
+          } else {
+            walkForExempt(join(dir, entry.name), depth + 1);
+          }
+        }
+      } catch {
+        /* ignore permission errors */
+      }
+    }
+    if (existsSync(targetDir)) walkForExempt(targetDir);
+    const { generateExemptTemplate } = await import("./exempt.mjs");
+    const template = JSON.parse(generateExemptTemplate());
+    if (smartPaths.length > 0) {
+      template.exemptPaths = [
+        ...new Set([...smartPaths, ...template.exemptPaths]),
+      ];
+      template.description += `（自动扫描 ${targetDir} 发现 ${smartPaths.length} 个候选目录）`;
+    }
+    writeFileSync(outPath, JSON.stringify(template, null, 2) + "\n", "utf8");
+    console.log(`✅ 已生成 ${outPath}`);
+    if (smartPaths.length > 0) {
+      console.log(`   自动发现 ${smartPaths.length} 个候选豁免目录:`);
+      for (const p of smartPaths) console.log(`     ${p}`);
+    }
+    console.log(`   请人工审核后提交至版本库。`);
+  }
+  process.exit(0);
+}
+
 if (subcommand === "drift") {
   const { driftFromFiles, formatDriftText, formatDriftJson } =
     await import("./drift.mjs");