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

package/CHANGELOG.md

@@ -4,6 +4,27 @@ 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
+
+- **搜索区字号不一致**：`_base-query-toolbar.scss` 统一 label / input / select / placeholder 为 **12px**，消除 13px→12px 混杂导致的视觉跳动。
+- **必填星号重复 `* *`**：`_base-components.scss` 必填星号改为精确模式——默认只显示 `::before`，`asterisk-right` 仅显示 `::after`，避免 `display: inline-block !important` 同时作用于两个伪元素。`_jh-ui.scss` 同步精简为只声明颜色不控制 `display`。
+
+### Added
+
+- **scanner fixture 测试集**：`scanner/__tests__/` 覆盖 R001/R002/R006/R011/R016/R021 + drift 模块共 16 条自动化测试，`npm test` 一键跑。
+- **SCSS 链路检查**：`scripts/check-scss.mjs` 递归验证 `styles/index.scss` 和 `presets/skin.scss` 的 `@forward/@use` 链路完整性。
+- **scan --baseline 一步到位**：`wl-scan scan --target src --baseline .wl-baseline.json` 扫描后自动对比基线输出漂移报告，`--fail-on-error` 同时拦截新增违规。
+- `package.json` 新增 `test` 和 `check:scss` 脚本。
+
 ## [1.8.1] - 2026-05-13
 
 ### Added

package/README.md

@@ -213,14 +213,15 @@ yarn add @agile-team/wl-skills-ui
 
 ## 版本亮点
 
-当前 v1.8.1 版本完成 R-rule 治理体系单一事实源化，并落地业务项目长效治理方案：
-
-- 新增 **`standards/rules.json`** 作为 29 条 R-rule 的单一事实源；所有 standards 文档、SKILL.md、scanner、MCP、未来 ESLint 插件均从此派生
-- 新增 **`standards/rules-loader.mjs`** 共享加载器；新增 MCP 工具 **`wl_ui_list_rules`** / **`wl_ui_describe_rule`**，AI 写代码前一键查规则
-- 修复历史 ID 冲突与逻辑反转 bug：scanner `tag.mjs` 原 R017/R018 重号为 R019/R020（与 `color.mjs` 解耦，旧 ID 通过 `aliases` 兼容）；R011 由"必须放 #footer"反转为"不得放 #footer"，与 standards/ui/05 对齐
-- 清理 `_registry.md` 12 条幽灵 skill 引用；`runtime/style-align/SKILL.md` 改为指针式引用 rules.json，不再复述规则细节
-- `scripts/check-docs.mjs` 扩展为 R-rule / scanner / SKILL / registry 四向一致性守卫，CI 不一致直接红灯
-- 新增 **`docs/governance-long-term.md`**：业务项目长效治理方案（基线 / 豁免 / 漂移看板 / 版本钉死 / 写作期 AI 守护五机制），杜绝遗留累积与升级回归
+当前 v1.8.3：
+
+- `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`
 
 历史亮点（v1.7.1）：
 

package/docs/governance-long-term.md

@@ -78,24 +78,37 @@ npx wl-ui scan --target src --baseline .wl-baseline.json --fail-on=new-issues
 **目标**：让"逐渐变烂"可见，每次升级都能量化。
 
 ```bash
-# 每次 wl-skills-ui 升版后跑一次
-npx wl-ui audit --target src --output json --outFile .wl-drift-after.json
-node -e "console.log(require('@agile-team/wl-skills-ui/scanner/drift.mjs').report('.wl-baseline.json','.wl-drift-after.json'))"
+# 方式一：scan 一步到位（v1.8.2+）
+npx wl-ui scan --target src --baseline .wl-baseline.json --fail-on-error
+
+# 方式二：独立 drift 子命令
+npx wl-ui scan --target src --output json --outFile .wl-current.json
+npx wl-ui drift --baseline .wl-baseline.json --current .wl-current.json
 ```
 
-输出（示意）：
+输出示例：
 
 ```
-变化（基线 → 当前）
-  gained   +12  新增违规（红灯）
-  fixed    -45  消化历史（绿灯）
-  regressed +3  曾修过又破的（黄灯，最高优先级追查）
-  exempt    +0  豁免清单未扩张
-按规则 Top3：R017(+8) R001(+3) R009(+1)
-按目录 Top3：src/views/quote(+9) src/views/cost(+3)
+╭──────────────────────────────────────╮
+│        wl-skills-ui 漂移报告         │
+╰──────────────────────────────────────╯
+
+基线违规: 120  →  当前违规: 87  (-33)
+
+  🔴 gained   +3  新增违规
+  🟢 fixed    -36  消化历史
+
+新增 Top 规则:
+  R017  +2
+  R001  +1
+
+消化 Top 规则:
+  R009  -15
+  R004  -12
+  R016  -9
 ```
 
-> 实现入口：v1.8.0 起 `scanner/index.mjs` 已暴露 `--output json` 完整结构（含 `file/line/rule`），业务项目可基于该结构自实现 drift 报告；包内 `scanner/drift.mjs` 在 1.8.x 后续小版本提供。
+> 实现入口：`scanner/drift.mjs` 提供 `drift()` / `driftFromFiles()` / `formatDriftText()` / `formatDriftJson()` 四个 API。MCP 工具 `wl_ui_drift` 可供 AI 直接调用。
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/wl-skills-ui",
-  "version": "1.8.1",
+  "version": "1.8.3",
   "description": "企业级 UI 风格对齐框架 — Vue + Element Plus 项目通用化妆/原生双模式（tokens / element / vendors / layouts / runtime / scanner / fixer / skills）",
   "type": "module",
   "main": "./es/index.js",
@@ -41,6 +41,8 @@
     "build": "tsup && npm run sync:tokens",
     "prepare": "npm run build",
     "sync:tokens": "node -e \"import('fs').then(fs=>fs.copyFileSync('design/tokens/base.css','dist/tokens.css'))\"",
+    "test": "node --test scanner/__tests__/scan.test.mjs",
+    "check:scss": "node scripts/check-scss.mjs",
     "docs:check": "node scripts/check-docs.mjs",
     "scan": "node scanner/index.mjs scan",
     "check": "node scanner/index.mjs check",

package/scanner/__tests__/fixtures/r001-fail.vue

@@ -0,0 +1,7 @@
+<template>
+  <el-table :data="list">
+    <el-table-column type="selection" width="55" />
+    <el-table-column prop="name" label="名称" />
+    <el-table-column prop="status" label="状态" align="left" />
+  </el-table>
+</template>

package/scanner/__tests__/fixtures/r001-pass.vue

@@ -0,0 +1,7 @@
+<template>
+  <el-table :data="list" empty-text="暂无数据">
+    <el-table-column type="selection" align="center" header-align="center" width="55" />
+    <el-table-column prop="name" label="名称" align="center" />
+    <el-table-column prop="status" label="状态" align="center" />
+  </el-table>
+</template>

package/scanner/__tests__/fixtures/r002-fail.vue

@@ -0,0 +1,5 @@
+<template>
+  <el-table :data="list">
+    <el-table-column prop="name" label="名称" align="center" />
+  </el-table>
+</template>

package/scanner/__tests__/fixtures/r002-pass.vue

@@ -0,0 +1,5 @@
+<template>
+  <el-table :data="list" empty-text="暂无数据">
+    <el-table-column prop="name" label="名称" align="center" />
+  </el-table>
+</template>

package/scanner/__tests__/fixtures/r006-fail.vue

@@ -0,0 +1,10 @@
+<template>
+  <el-form>
+    <el-form-item label="名称">
+      <el-input v-model="form.name" />
+    </el-form-item>
+    <el-form-item label="类型">
+      <el-select v-model="form.type" />
+    </el-form-item>
+  </el-form>
+</template>

package/scanner/__tests__/fixtures/r006-pass.vue

@@ -0,0 +1,10 @@
+<template>
+  <el-form>
+    <el-form-item label="名称">
+      <el-input v-model="form.name" size="small" />
+    </el-form-item>
+    <el-form-item label="类型">
+      <el-select v-model="form.type" size="small" />
+    </el-form-item>
+  </el-form>
+</template>

package/scanner/__tests__/fixtures/r011-fail.vue

@@ -0,0 +1,11 @@
+<template>
+  <el-dialog v-model="visible" title="列表">
+    <el-table :data="list">
+      <el-table-column prop="name" label="名称" align="center" />
+    </el-table>
+    <template #footer>
+      <el-pagination :total="total" />
+      <el-button @click="visible = false">取消</el-button>
+    </template>
+  </el-dialog>
+</template>

package/scanner/__tests__/fixtures/r011-pass.vue

@@ -0,0 +1,14 @@
+<template>
+  <el-dialog v-model="visible" title="列表">
+    <el-table :data="list">
+      <el-table-column prop="name" label="名称" align="center" />
+    </el-table>
+    <div class="popup-pagination">
+      <el-pagination :total="total" />
+    </div>
+    <template #footer>
+      <el-button @click="visible = false">取消</el-button>
+      <el-button type="primary" @click="save">确定</el-button>
+    </template>
+  </el-dialog>
+</template>

package/scanner/__tests__/fixtures/r016-fail.vue

@@ -0,0 +1,9 @@
+<template>
+  <div class="box">hello</div>
+</template>
+<style scoped>
+.box {
+  color: #409eff;
+  background-color: #f56c6c;
+}
+</style>

package/scanner/__tests__/fixtures/r016-pass.vue

@@ -0,0 +1,9 @@
+<template>
+  <div class="box">hello</div>
+</template>
+<style scoped>
+.box {
+  color: var(--el-color-primary);
+  background-color: var(--el-fill-color-light);
+}
+</style>

package/scanner/__tests__/fixtures/r021-fail.vue

@@ -0,0 +1,3 @@
+<template>
+  <BaseTable :data="list" cid="test-table" empty-text="暂无数据" />
+</template>

package/scanner/__tests__/fixtures/r021-pass.vue

@@ -0,0 +1,3 @@
+<template>
+  <BaseTable :data="list" render-type="agGrid" cid="test-table" empty-text="暂无数据" />
+</template>

package/scanner/__tests__/scan.test.mjs

@@ -0,0 +1,145 @@
+/**
+ * scanner/__tests__/scan.test.mjs — scanner 规则 fixture 测试
+ *
+ * 用法：node --test scanner/__tests__/scan.test.mjs
+ *
+ * 约定：fixtures/<ruleId>-pass.vue → 0 violations of that rule
+ *       fixtures/<ruleId>-fail.vue → ≥1 violations of that rule
+ *
+ * 每条测试只断言对应 rule 的命中数，不受其他规则干扰。
+ */
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync, readdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { getRules } from "../rules/index.mjs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const FIXTURES = join(__dirname, "fixtures");
+const rules = getRules();
+
+/**
+ * 简易单文件扫描：跑所有规则，返回 issues 数组
+ */
+function scanFixture(filename) {
+  const content = readFileSync(join(FIXTURES, filename), "utf8");
+  const issues = [];
+
+  // extract template
+  const tmplMatch = content.match(/(<template[^>]*>)([\s\S]*?)(<\/template>)/);
+  const template = tmplMatch ? tmplMatch[0] : content;
+  const tmplOffset = tmplMatch
+    ? content.slice(0, content.indexOf(tmplMatch[0])).split("\n").length - 1
+    : 0;
+
+  // extract style
+  const styleMatch = content.match(/<style[^>]*>([\s\S]*?)<\/style>/);
+  const styleBlock = styleMatch ? styleMatch[1] : null;
+  const styleOffset = styleMatch
+    ? content.slice(0, content.indexOf(styleMatch[0])).split("\n").length
+    : 0;
+
+  // extract script
+  const scriptMatch = content.match(/<script[^>]*>([\s\S]*?)<\/script>/);
+  const scriptBlock = scriptMatch ? scriptMatch[1] : null;
+  const scriptOffset = scriptMatch
+    ? content.slice(0, content.indexOf(scriptMatch[0])).split("\n").length
+    : 0;
+
+  for (const rule of rules) {
+    if (typeof rule.check === "function") {
+      issues.push(...rule.check(template, filename, tmplOffset));
+    }
+    if (styleBlock && typeof rule.checkStyle === "function") {
+      issues.push(...rule.checkStyle(styleBlock, filename, styleOffset));
+    }
+    if (scriptBlock && typeof rule.checkScript === "function") {
+      issues.push(...rule.checkScript(scriptBlock, filename, scriptOffset));
+    }
+  }
+  return issues;
+}
+
+// ── 自动发现 fixtures 并生成测试 ────────────────────────────────────────────
+const fixtureFiles = readdirSync(FIXTURES).filter((f) => f.endsWith(".vue"));
+const grouped = new Map(); // ruleId → { pass: [], fail: [] }
+
+for (const f of fixtureFiles) {
+  const m = f.match(/^(r\d+)-(pass|fail)\.vue$/i);
+  if (!m) continue;
+  const ruleId = m[1].toUpperCase();
+  const kind = m[2]; // pass | fail
+  if (!grouped.has(ruleId)) grouped.set(ruleId, { pass: [], fail: [] });
+  grouped.get(ruleId)[kind].push(f);
+}
+
+for (const [ruleId, { pass, fail }] of grouped) {
+  describe(ruleId, () => {
+    for (const f of pass) {
+      it(`${f} → 0 violations`, () => {
+        const issues = scanFixture(f).filter((i) => i.rule === ruleId);
+        assert.equal(
+          issues.length,
+          0,
+          `Expected 0 ${ruleId} issues but got ${issues.length}: ${JSON.stringify(issues, null, 2)}`,
+        );
+      });
+    }
+    for (const f of fail) {
+      it(`${f} → ≥1 violations`, () => {
+        const issues = scanFixture(f).filter((i) => i.rule === ruleId);
+        assert.ok(issues.length > 0, `Expected ≥1 ${ruleId} issues but got 0`);
+      });
+    }
+  });
+}
+
+// ── drift 模块测试 ──────────────────────────────────────────────────────────
+const { drift } = await import("../drift.mjs");
+
+describe("drift", () => {
+  it("identical → 0 gained, 0 fixed", () => {
+    const data = { issues: [{ file: "a.vue", rule: "R001" }] };
+    const r = drift(data, data);
+    assert.equal(r.gained.count, 0);
+    assert.equal(r.fixed.count, 0);
+    assert.equal(r.netDelta, 0);
+  });
+
+  it("new issues → gained > 0", () => {
+    const base = { issues: [] };
+    const cur = { issues: [{ file: "a.vue", rule: "R001" }] };
+    const r = drift(base, cur);
+    assert.equal(r.gained.count, 1);
+    assert.equal(r.fixed.count, 0);
+  });
+
+  it("removed issues → fixed > 0", () => {
+    const base = { issues: [{ file: "a.vue", rule: "R001" }] };
+    const cur = { issues: [] };
+    const r = drift(base, cur);
+    assert.equal(r.gained.count, 0);
+    assert.equal(r.fixed.count, 1);
+  });
+
+  it("mixed → both gained and fixed", () => {
+    const base = {
+      issues: [
+        { file: "a.vue", rule: "R001" },
+        { file: "a.vue", rule: "R001" },
+        { file: "b.vue", rule: "R016" },
+      ],
+    };
+    const cur = {
+      issues: [
+        { file: "a.vue", rule: "R001" },
+        { file: "c.vue", rule: "R017" },
+        { file: "c.vue", rule: "R017" },
+      ],
+    };
+    const r = drift(base, cur);
+    assert.equal(r.gained.count, 2); // c.vue R017 ×2
+    assert.equal(r.fixed.count, 2); // a.vue R001 ×1 + b.vue R016 ×1
+  });
+});

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");
@@ -423,6 +527,30 @@ if (subcommand === "all") {
   } else {
     console.log(report);
   }
+
+  // ── baseline 漂移检测（--baseline <file>）────────────────────────────────
+  let driftResult = null;
+  if (values.baseline) {
+    const { existsSync: fileExists } = await import("node:fs");
+    const baselinePath = resolve(values.baseline);
+    if (fileExists(baselinePath)) {
+      const { drift, formatDriftText, formatDriftJson } =
+        await import("./drift.mjs");
+      const baseline = JSON.parse(readFileSync(baselinePath, "utf8"));
+      const currentData = { issues: filtered };
+      driftResult = drift(baseline, currentData);
+      console.error("");
+      if (values.output === "json") {
+        console.error(formatDriftJson(driftResult));
+      } else {
+        console.error(formatDriftText(driftResult));
+      }
+    } else {
+      console.error(`[wl-scan] 基线文件不存在: ${baselinePath}，跳过漂移检测`);
+    }
+  }
+
   const hasError = filtered.some((i) => i.severity === "error");
-  process.exit(values["fail-on-error"] && hasError ? 1 : 0);
+  const hasDriftNew = driftResult && driftResult.gained.count > 0;
+  process.exit(values["fail-on-error"] && (hasError || hasDriftNew) ? 1 : 0);
 }

package/scripts/check-scss.mjs

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+/**
+ * scripts/check-scss.mjs — SCSS 链路完整性检查
+ *
+ * 递归验证 styles/index.scss 的 @forward/@use 链，
+ * 确保所有被引入的 SCSS partial 文件真实存在。
+ * 跳过 sass: 内置模块和包自引用（@agile-team/... / wl-skills-ui/...）。
+ *
+ * 用法：npm run check:scss
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { join, dirname, resolve, basename } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, "..");
+const STYLES = join(ROOT, "styles");
+
+let errors = 0;
+
+/** 跳过包自引用和 sass 内置 */
+function shouldSkip(ref) {
+  if (ref.startsWith("sass:")) return true;
+  if (ref.startsWith("~")) return true;
+  if (ref.startsWith("@agile-team/")) return true;
+  if (ref.startsWith("wl-skills-ui/")) return true;
+  return false;
+}
+
+/** 解析 SCSS @forward/@use 引用到实际文件路径 */
+function resolveScssRef(dir, ref) {
+  // 已有 .scss 后缀
+  if (ref.endsWith(".scss")) {
+    const direct = join(dir, ref);
+    if (existsSync(direct)) return direct;
+    // _partial
+    const partial = join(dirname(direct), "_" + basename(direct));
+    if (existsSync(partial)) return partial;
+    return null;
+  }
+  // 无后缀：SCSS partial 解析规则
+  const name = basename(ref);
+  const refDir = dirname(ref);
+  const base = join(dir, refDir);
+  const candidates = [
+    join(base, name + ".scss"),
+    join(base, "_" + name + ".scss"),
+    join(base, name, "index.scss"),
+    join(base, name, "_index.scss"),
+  ];
+  return candidates.find((c) => existsSync(c)) || null;
+}
+
+function checkImportChain(filePath, visited = new Set()) {
+  const norm = resolve(filePath);
+  if (visited.has(norm)) return;
+  visited.add(norm);
+  if (!existsSync(norm)) {
+    console.error(`❌ 文件不存在: ${norm}`);
+    errors++;
+    return;
+  }
+  const content = readFileSync(norm, "utf8");
+  const re = /@(?:forward|use|import)\s+['"]([^'"]+)['"]/g;
+  let m;
+  while ((m = re.exec(content)) !== null) {
+    const ref = m[1];
+    if (shouldSkip(ref)) continue;
+    const resolved = resolveScssRef(dirname(norm), ref);
+    if (!resolved) {
+      console.error(`❌ ${norm} → "${ref}" 无法解析`);
+      errors++;
+    } else {
+      checkImportChain(resolved, visited);
+    }
+  }
+}
+
+// 入口
+const entryPoints = [
+  join(STYLES, "index.scss"),
+  join(STYLES, "presets", "skin.scss"),
+];
+
+for (const entry of entryPoints) {
+  if (!existsSync(entry)) {
+    console.error(`❌ 入口文件不存在: ${entry}`);
+    errors++;
+    continue;
+  }
+  checkImportChain(entry);
+}
+
+if (errors > 0) {
+  console.error(`\n❌ SCSS 链路检查失败: ${errors} 个错误`);
+  process.exit(1);
+} else {
+  console.log("✅ SCSS 链路检查通过");
+}

package/styles/vendors/_base-components.scss

@@ -508,13 +508,26 @@
   word-break: keep-all;
 }
 
-.el-form-item.is-required:not(.is-no-asterisk).asterisk-left > .el-form-item__label::before,
-.el-form-item.is-required:not(.is-no-asterisk).asterisk-right>.el-form-item__label::after,
-.el-form-item.is-required:not(.is-no-asterisk)>.el-form-item__label::before,
-.el-form-item.is-required:not(.is-no-asterisk)>.el-form-item__label::after {
+// 必填星号：只保留一颗 — 默认 asterisk-left（::before），asterisk-right 用 ::after
+// 旧写法同时 display:inline-block 两个伪元素导致 * * 重复
+.el-form-item.is-required:not(.is-no-asterisk)>.el-form-item__label::before {
   color: var(--el-color-danger, #f56c6c) !important;
   display: inline-block !important;
 }
+// asterisk-right 模式：显示 ::after，隐藏 ::before
+.el-form-item.is-required:not(.is-no-asterisk).asterisk-right>.el-form-item__label::before {
+  display: none !important;
+}
+
+.el-form-item.is-required:not(.is-no-asterisk).asterisk-right>.el-form-item__label::after {
+  color: var(--el-color-danger, #f56c6c) !important;
+  display: inline-block !important;
+}
+
+// 默认模式：隐藏 ::after 防止重复星号
+.el-form-item.is-required:not(.is-no-asterisk):not(.asterisk-right)>.el-form-item__label::after {
+  display: none !important;
+}
 
 .el-form-item.is-error {
   .el-form-item__label,

package/styles/vendors/_base-query-toolbar.scss

@@ -33,12 +33,21 @@
     }
   }
 
+    // ── 搜索区字号统一 12px（紧凑密度，与 label / button 一致）────────────────
+    .el-form-item__label {
+      font-size: 12px !important;
+    }
   .el-input__inner {
-    font-size: 13px;
+    font-size: 12px;
     color: var(--el-text-color-primary);
     &::placeholder { color: var(--el-text-color-placeholder); font-size: 12px; }
   }
 
+    .el-select__placeholder,
+    .el-select__tags-text,
+    .el-select .el-select__selected-item {
+      font-size: 12px;
+    }
   // ── 选择框 ────────────────────────────────────────────────────────────────
   .el-select .el-select__wrapper {
     border-radius: 6px !important;

package/styles/vendors/_jh-ui.scss

@@ -91,12 +91,9 @@
 }
 
 // 6) 必填星号兼容 jh-ui label 结构
-//    Element Plus 把 `::before` 放在 `.el-form-item__label` 上，
-//    jh-ui 没改这一点；但 label 自身是 inline-flex，部分浏览器下
-//    `::before` 会作为 flex 项参与排版，必须显式声明颜色/显示。
+//    颜色统一 danger 色；显示/隐藏由 _base-components.scss 总控，
+//    此处只负责颜色，不设 display，避免与总控冲突导致 * * 重复。
 .el-form-item.is-required:not(.is-no-asterisk) > .el-form-item__label::before,
-.el-form-item.is-required:not(.is-no-asterisk) > .el-form-item__label::after,
-.el-form-item.is-required:not(.is-no-asterisk) > .el-form-item__label > .com-text::before,
-.el-form-item.is-required:not(.is-no-asterisk) > .el-form-item__label > .com-text::after {
+.el-form-item.is-required:not(.is-no-asterisk)>.el-form-item__label>.com-text::before {
   color: var(--el-color-danger, #f56c6c) !important;
 }