@agile-team/wl-skills-ui 1.6.2

package/reference/define-columns.ts

@@ -0,0 +1,185 @@
+/**
+ * defineColumns — 全局列自动渲染器
+ *
+ * 原理：维护一张「字段名 → 渲染配置」的全局映射表（COLUMN_AUTO_MAP）。
+ *      调用 defineColumns(colList) 时，对每一列检查 name 是否命中映射：
+ *        - 命中 → 自动补充 width / fixed / defaultNode / defaultSlot
+ *        - 未命中 → 原样返回
+ *        - 用户在列定义里手写了对应属性 → 手写优先（不会被覆盖）
+ *
+ * 使用方式（替换原来的 return [...]）：
+ *   import { defineColumns } from '@/util/define-columns';
+ *
+ *   columnsDef(): TableColumnDesc<any>[] {
+ *     return defineColumns([
+ *       { label: '启用状态', name: 'enableStatus' },   // 自动：width=80 fixed=right 彩色Tag
+ *       { label: '风险分级', name: 'riskLevel' },       // 自动：width=90 fixed=right 彩色Tag
+ *       { label: '风险编号', name: 'riskNo' },          // 自动：蓝色圆角徽标
+ *       { label: '评价级别', name: 'ratingLevel' },     // 自动：彩色圆形徽标
+ *       { label: '审批状态', name: 'approvalStatus' },  // 自动：彩色Tag
+ *     ]);
+ *   }
+ *
+ * 如需某列不走自动逻辑，手写 defaultNode/defaultSlot 即可覆盖自动配置：
+ *   { label: '风险分级', name: 'riskLevel', defaultNode: ({ row }: { row: any }) => myCustomRender(row) }
+ *
+ * 新增全局字段映射 → 只改本文件的 COLUMN_AUTO_MAP，全项目所有页面立即生效。
+ */
+import type { TableColumnDesc } from "@jhlc/common-core/src/components/table/base-table/type";
+import {
+  renderEnableStatus,
+  renderAuditStatus,
+  renderVerifyStatus,
+  renderRiskLevel,
+  renderBadge,
+  renderRatingLevel,
+  renderTaskStatus,
+  renderPlanStatus,
+  renderFlagNormal,
+  renderRiskStatus,
+  renderCorrectStatus,
+  renderPermitStatus,
+  renderTrainStatus,
+  renderCredentialStatus,
+  renderQuestionStatus
+} from "./ag-cell-renders";
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 全局字段渲染映射表
+// key   = 字段名（与 columnsDef 中的 name 完全匹配）
+// value = 要自动补充的列配置（不含 label，label 由页面自定义）
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+const COLUMN_AUTO_MAP: Record<string, Partial<TableColumnDesc<any>>> = {
+  // ── 启用/停用 ────────────────────────────────────────────────────────────
+  enableStatus: {
+    width: 80,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) =>
+      renderEnableStatus(row.enableStatus),
+  },
+
+  // ── 审批状态 ─────────────────────────────────────────────────────────────
+  approvalStatus: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) =>
+      renderAuditStatus(row.approvalStatus),
+  },
+
+  // ── 核实状态 ─────────────────────────────────────────────────────────────
+  verifyStatus: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) =>
+      renderVerifyStatus(row.verifyStatus),
+  },
+
+  // ── 风险分级（aq_risk_level 字典：1重大/2较大/3一般/4低）──────────────────
+  riskLevel: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) => renderRiskLevel(row.riskLevel),
+  },
+
+  // ── 风险编号：蓝色圆角徽标 ───────────────────────────────────────────────
+  riskNo: {
+    defaultSlot: ({ row }: { row: any }) => renderBadge(row.riskNo),
+  },
+
+  // ── 检查表编号：蓝色圆角徽标 ─────────────────────────────────────────────
+  checkNo: {
+    defaultSlot: ({ row }: { row: any }) => renderBadge(row.checkNo),
+  },
+
+  // ── 评价级别（LEC/MES 等）：彩色圆形徽标 ────────────────────────────────
+  ratingLevel: {
+    width: 80,
+    defaultSlot: ({ row }: { row: any }) => renderRatingLevel(row.ratingLevel),
+  },
+
+  // ── 排查/检查任务状态（aq_task_check_status / aq_check_info_status）────────
+  taskStatus: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) => renderTaskStatus(row.taskStatus),
+  },
+
+  // ── 计划状态（aq_plan_status: 1=启用, 0=停用）────────────────────────────
+  planStatus: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) => renderPlanStatus(row.planStatus),
+  },
+
+  // ── 排查/检查结果（aq_handle_result: 1=正常, 2=异常）────────────────────
+  flagNormal: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) => renderFlagNormal(row.flagNormal),
+  },
+
+  // ── 隐患状态（aq_risk_status）────────────────────────────────────────────
+  riskStatus: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) => renderRiskStatus(row.riskStatus),
+  },
+
+  // ── 整改状态（aq_correct_status）──────────────────────────────────────────
+  correctStatus: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) =>
+      renderCorrectStatus(row.correctStatus),
+  },
+
+  // ── 危险作业票状态（permitStatus: 1=草稿, 2=待审批, 3=作业中, 4=已完工, 5=已撤销）──
+  permitStatus: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) =>
+      renderPermitStatus(row.permitStatus),
+  },
+
+  // ── 培训状态（trainStatus: 1=未完成, 2=已完成）────────────────────────────
+  trainStatus: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) => renderTrainStatus(row.trainStatus),
+  },
+
+  // ── 证书状态（credentialStatus: 1=有效, 2=即将过期, 3=已过期）──────────────
+  credentialStatus: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) =>
+      renderCredentialStatus(row.credentialStatus),
+  },
+
+  // ── 题库状态（unifyQuestionStatus: 1=草稿, 2=已发布, 3=已停用）──────────────
+  unifyQuestionStatus: {
+    width: 90,
+    fixed: "right",
+    defaultNode: ({ row }: { row: any }) =>
+      renderQuestionStatus(row.unifyQuestionStatus),
+  },
+};
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 主函数
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+export function defineColumns<T = any>(
+  columns: TableColumnDesc<T>[]
+): TableColumnDesc<T>[] {
+  return columns.map((col) => {
+    // 多选列：统一宽度 55px（页面已手写 width 时不覆盖）
+    if ((col as any).type === "selection" && !(col as any).width) {
+      return { width: 55, ...(col as any) } as unknown as TableColumnDesc<T>;
+    }
+    if (!col.name) return col;
+    const auto = COLUMN_AUTO_MAP[col.name as string];
+    if (!auto) return col;
+    // 自动配置 < 手写配置（手写的属性不被覆盖）
+    return { ...auto, ...col } as TableColumnDesc<T>;
+  });
+}

package/reference/jhlc.d.ts

@@ -0,0 +1 @@
+// Type stubs moved to types/jhlc.d.ts

package/scanner/coverage.mjs

@@ -0,0 +1,287 @@
+const ELEMENT_SKILL_MAP = {
+  "el-table": "element/el-table",
+  "el-table-column": "element/el-table",
+  "el-form": "element/el-form",
+  "el-form-item": "element/el-form",
+  "el-input": "element/el-form",
+  "el-select": "element/el-form",
+  "el-date-picker": "element/el-form",
+  "el-button": "element/el-button",
+  "el-dialog": "element/el-dialog",
+  "el-message-box": "element/el-dialog",
+  "el-tag": "element/el-tag",
+  "el-pagination": "element/el-pagination",
+  "el-card": "element/el-card",
+  "el-tabs": "element/el-tabs",
+  "el-tab-pane": "element/el-tabs",
+  "el-descriptions": "element/el-descriptions",
+  "el-descriptions-item": "element/el-descriptions",
+  "el-tree": "element/el-tree",
+  "el-drawer": "element/el-drawer",
+  "el-upload": "element/el-upload",
+  "el-steps": "element/el-steps",
+  "el-step": "element/el-steps",
+  "el-popover": "element/el-overlay",
+  "el-tooltip": "element/el-overlay",
+  "el-dropdown": "element/el-overlay",
+  "el-menu": "element/el-navigation",
+  "el-menu-item": "element/el-navigation",
+  "el-sub-menu": "element/el-navigation",
+  "el-breadcrumb": "element/el-navigation",
+  "el-empty": "element/el-feedback",
+  "el-result": "element/el-feedback",
+  "el-alert": "element/el-feedback",
+  "el-badge": "element/el-feedback",
+  "el-avatar": "element/el-feedback",
+  "el-timeline": "element/el-feedback",
+  "el-collapse": "element/el-feedback",
+};
+
+const VENDOR_PATTERNS = [
+  {
+    pattern: /<\/?Base[A-Z][\w-]*/g,
+    vendor: "Base*",
+    skill: "vendors/base-table",
+  },
+  {
+    pattern: /<\/?base-[\w-]+/g,
+    vendor: "base-*",
+    skill: "vendors/base-table",
+  },
+  { pattern: /<\/?jh-[\w-]+/g, vendor: "jh-*", skill: "vendors/jh-components" },
+  { pattern: /<\/?C_[\w-]+/g, vendor: "C_*", skill: "vendors/c-components" },
+  { pattern: /<\/?c-[\w-]+/g, vendor: "c-*", skill: "vendors/c-components" },
+  {
+    pattern: /ag-grid|agGrid|\.ag-root-wrapper/g,
+    vendor: "AG Grid",
+    skill: "vendors/ag-grid",
+  },
+];
+
+const LAYOUT_PATTERNS = [
+  {
+    pattern: /class=["'][^"']*list-page[^"']*["']/g,
+    layout: "list-page",
+    skill: "layouts/list-page",
+  },
+  {
+    pattern: /class=["'][^"']*(tree-list|drag-col-container)[^"']*["']/g,
+    layout: "tree-list",
+    skill: "layouts/tree-list",
+  },
+  {
+    pattern: /<el-dialog[\s\S]*?<el-form\b/g,
+    layout: "form-dialog",
+    skill: "layouts/form-dialog",
+  },
+  {
+    pattern: /<el-descriptions\b|class=["'][^"']*detail-page[^"']*["']/g,
+    layout: "detail-page",
+    skill: "layouts/detail-page",
+  },
+];
+
+const BUSINESS_SCENARIO_PATTERNS = [
+  {
+    pattern: /<el-form[\s\S]*?<el-table\b|<BaseQuery\b|<base-query\b/g,
+    scenario: "query-table",
+    skill: "layouts/list-page",
+  },
+  {
+    pattern:
+      /<BaseToolbar\b|<base-toolbar\b|class=["'][^"']*(toolbar|operation-bar|table-tools)[^"']*["']/g,
+    scenario: "toolbar-actions",
+    skill: "layouts/list-page",
+  },
+  {
+    pattern: /<el-tree[\s\S]*?(<el-table\b|<BaseTable\b|<base-table\b)/g,
+    scenario: "tree-table",
+    skill: "layouts/tree-list",
+  },
+  {
+    pattern: /<el-dialog[\s\S]*?<el-form\b/g,
+    scenario: "dialog-form",
+    skill: "layouts/form-dialog",
+  },
+  {
+    pattern: /<el-drawer[\s\S]*?(<el-form\b|<el-descriptions\b)/g,
+    scenario: "drawer-detail",
+    skill: "layouts/detail-page",
+  },
+  {
+    pattern:
+      /<el-descriptions\b[\s\S]*?<el-card\b|<el-card\b[\s\S]*?<el-descriptions\b/g,
+    scenario: "detail-card",
+    skill: "layouts/detail-page",
+  },
+  {
+    pattern: /<el-tabs[\s\S]*?(<el-table\b|<el-descriptions\b|<el-form\b)/g,
+    scenario: "tab-workbench",
+    skill: "element/component-family",
+  },
+  {
+    pattern: /<el-upload\b/g,
+    scenario: "attachment-upload",
+    skill: "element/component-family",
+  },
+  {
+    pattern: /<el-steps\b|<el-timeline\b/g,
+    scenario: "process-flow",
+    skill: "element/component-family",
+  },
+  {
+    pattern: /<el-empty\b|<el-result\b|<el-alert\b/g,
+    scenario: "feedback-state",
+    skill: "element/component-family",
+  },
+];
+
+function uniqueSorted(values) {
+  return [...new Set(values)].sort();
+}
+
+function collectElementTags(template) {
+  const tags = [];
+  const re = /<\/?(el-[a-z0-9-]+)/g;
+  let match;
+  while ((match = re.exec(template)) !== null) tags.push(match[1]);
+  return tags;
+}
+
+export function createCoverageCollector() {
+  const files = {};
+  const element = [];
+  const vendors = [];
+  const layouts = [];
+  const businessScenarios = [];
+  const skills = [];
+
+  function addFile(file, template, content = template) {
+    const fileElement = collectElementTags(template);
+    const fileVendors = [];
+    const fileLayouts = [];
+    const fileBusinessScenarios = [];
+    const fileSkills = [];
+
+    for (const tag of fileElement) {
+      element.push(tag);
+      if (ELEMENT_SKILL_MAP[tag]) {
+        skills.push(ELEMENT_SKILL_MAP[tag]);
+        fileSkills.push(ELEMENT_SKILL_MAP[tag]);
+      }
+    }
+
+    for (const item of VENDOR_PATTERNS) {
+      item.pattern.lastIndex = 0;
+      if (item.pattern.test(content)) {
+        vendors.push(item.vendor);
+        skills.push(item.skill);
+        fileVendors.push(item.vendor);
+        fileSkills.push(item.skill);
+      }
+    }
+
+    for (const item of LAYOUT_PATTERNS) {
+      item.pattern.lastIndex = 0;
+      if (item.pattern.test(template)) {
+        layouts.push(item.layout);
+        skills.push(item.skill);
+        fileLayouts.push(item.layout);
+        fileSkills.push(item.skill);
+      }
+    }
+
+    for (const item of BUSINESS_SCENARIO_PATTERNS) {
+      item.pattern.lastIndex = 0;
+      if (item.pattern.test(template)) {
+        businessScenarios.push(item.scenario);
+        skills.push(item.skill);
+        fileBusinessScenarios.push(item.scenario);
+        fileSkills.push(item.skill);
+      }
+    }
+
+    files[file] = {
+      element: uniqueSorted(fileElement),
+      vendors: uniqueSorted(fileVendors),
+      layouts: uniqueSorted(fileLayouts),
+      businessScenarios: uniqueSorted(fileBusinessScenarios),
+      recommendedSkills: uniqueSorted(fileSkills),
+    };
+  }
+
+  function result() {
+    return {
+      element: uniqueSorted(element),
+      vendors: uniqueSorted(vendors),
+      layouts: uniqueSorted(layouts),
+      businessScenarios: uniqueSorted(businessScenarios),
+      recommendedSkills: uniqueSorted(skills),
+      files,
+    };
+  }
+
+  return { addFile, result };
+}
+
+export function recommendFlows({ issues = [], coverage = {} } = {}) {
+  const categories = new Set(issues.map((i) => i.category));
+  const rules = new Set(issues.map((i) => i.rule));
+  const flows = [];
+  const nextActions = [];
+
+  if (issues.length === 0) {
+    flows.push("full-audit");
+    nextActions.push(
+      "保持 wk-skills-ui 样式入口，定期运行 wks_ui_scan 做只读审计",
+    );
+  } else {
+    flows.push("legacy-skin-align");
+    nextActions.push("先运行 wks_ui_scan --mode skin 确认 L0/L1/L2 样式偏差");
+    nextActions.push(
+      "修复前运行 wks_ui_fix_dry_run 预览改动，不直接写入业务文件",
+    );
+  }
+
+  if (categories.has("color") || categories.has("token")) {
+    flows.push("progressive-migrate");
+    nextActions.push(
+      "将硬编码颜色迁移到 runtime/design-tokens 或 Element Plus token",
+    );
+  }
+
+  if (rules.has("R013") || rules.has("R021") || rules.has("R022")) {
+    flows.push("progressive-migrate");
+    nextActions.push(
+      "表格列定义建议升级为 defineColumns + renderOps，并补齐 BaseTable render-type/cid",
+    );
+  }
+
+  if (coverage.businessScenarios?.length > 0) {
+    nextActions.push(
+      `已识别 B 端业务场景：${coverage.businessScenarios.join(", ")}，建议按场景加载对应 layout/element Skill 做统一治理`,
+    );
+  }
+
+  const shouldUseKit =
+    rules.has("R013") ||
+    rules.has("R021") ||
+    rules.has("R022") ||
+    coverage.layouts?.length > 0 ||
+    (coverage.businessScenarios || []).some((item) =>
+      ["query-table", "tree-table", "dialog-form"].includes(item),
+    );
+  return {
+    recommendedFlows: uniqueSorted(flows),
+    nextActions: uniqueSorted(nextActions),
+    kitBridge: {
+      needed: shouldUseKit,
+      reason: shouldUseKit
+        ? "扫描结果涉及页面结构、BaseTable 或操作列规范，建议在视觉统一后使用 wl-skills-kit 做规范化生成/修复。"
+        : "当前更适合由 wk-skills-ui 先完成样式绝对管控，无需强制切换到 wl-skills-kit。",
+      commands: shouldUseKit
+        ? ["wl-skills validate-page <page>", "wl-skills doctor-ui <project>"]
+        : [],
+    },
+  };
+}

package/scanner/exempt.mjs

@@ -0,0 +1,127 @@
+/**
+ * scanner/exempt.mjs — 豁免配置
+ *
+ * 支持两种配置方式：
+ *   1. 项目根目录下 .wk-exempt.json
+ *   2. CLI --exempt <path> 指定配置文件
+ *
+ * 配置格式：
+ * {
+ *   "exemptPaths": [
+ *     "src/views/security/big-screen/**",
+ *     "src/views/security/map-view/**",
+ *     "src/views/security/flow-designer/**",
+ *     "src/views/security/topology/**",
+ *     "src/views/security/dashboard/**"
+ *   ],
+ *   "exemptRules": {
+ *     "R016": ["src/views/security/big-screen/**"],
+ *     "R017": ["src/views/security/big-screen/**"]
+ *   },
+ *   "exemptCategories": ["dashboard", "big-screen", "map", "chart", "topology", "flow-designer", "3d", "canvas", "report-designer", "rich-editor"],
+ *   "description": "大屏、地图、图谱、流程设计器等强个性化页面豁免风格统一扫描"
+ * }
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+
+/**
+ * 简易 glob 匹配（仅支持 ** 和 * 通配符）
+ */
+function matchGlob(filePath, pattern) {
+  const normalized = filePath.replace(/\\/g, "/");
+  const escaped = pattern
+    .replace(/\\/g, "/")
+    .replace(/[.+^${}()|[\]]/g, "\\$&")
+    .replace(/\*\*/g, "{{GLOBSTAR}}")
+    .replace(/\*/g, "[^/]*")
+    .replace(/\{\{GLOBSTAR\}\}/g, ".*");
+  return new RegExp(`^${escaped}$`).test(normalized);
+}
+
+/**
+ * 加载豁免配置
+ * @param {string} projectRoot
+ * @param {string} [exemptPath]  CLI 指定的配置文件路径
+ * @returns {object} { exemptPaths, exemptRules, exemptCategories, isExempt(file, rule?) }
+ */
+export function loadExemptConfig(projectRoot, exemptPath) {
+  const defaultPath = join(projectRoot, ".wk-exempt.json");
+  const configPath = exemptPath ? resolve(exemptPath) : defaultPath;
+
+  const empty = {
+    exemptPaths: [],
+    exemptRules: {},
+    exemptCategories: [],
+    isExempt: () => false,
+  };
+
+  if (!existsSync(configPath)) return empty;
+
+  let config;
+  try {
+    config = JSON.parse(readFileSync(configPath, "utf8"));
+  } catch {
+    console.warn(`[wk-scan] 豁免配置解析失败: ${configPath}`);
+    return empty;
+  }
+
+  const exemptPaths = config.exemptPaths || [];
+  const exemptRules = config.exemptRules || {};
+  const exemptCategories = config.exemptCategories || [];
+
+  /**
+   * 判断文件+规则是否被豁免
+   * @param {string} relFile  相对路径
+   * @param {string} [ruleId] 规则 ID
+   */
+  function isExempt(relFile, ruleId) {
+    // 全局路径豁免
+    if (exemptPaths.some((p) => matchGlob(relFile, p))) return true;
+    // 规则级路径豁免
+    if (ruleId && exemptRules[ruleId]) {
+      if (exemptRules[ruleId].some((p) => matchGlob(relFile, p))) return true;
+    }
+    return false;
+  }
+
+  return { exemptPaths, exemptRules, exemptCategories, isExempt };
+}
+
+/**
+ * 生成默认豁免配置模板
+ */
+export function generateExemptTemplate() {
+  return JSON.stringify(
+    {
+      exemptPaths: [
+        "src/views/**/big-screen/**",
+        "src/views/**/dashboard/**",
+        "src/views/**/map-view/**",
+        "src/views/**/topology/**",
+        "src/views/**/flow-designer/**",
+        "src/views/**/report-designer/**",
+        "src/views/**/chart/**",
+        "src/views/**/3d/**",
+        "src/views/**/canvas/**",
+      ],
+      exemptRules: {},
+      exemptCategories: [
+        "dashboard",
+        "big-screen",
+        "map",
+        "chart",
+        "topology",
+        "flow-designer",
+        "3d",
+        "canvas",
+        "report-designer",
+        "rich-editor",
+      ],
+      description:
+        "大屏、地图、图谱、流程设计器等强个性化页面豁免风格统一扫描",
+    },
+    null,
+    2,
+  );
+}