@agile-team/wl-skills-ui 1.9.6 → 1.9.7

package/CHANGELOG.md

@@ -4,6 +4,19 @@ 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.9.7] - 2026-07-28
+
+### Added
+
+- 新增 R038 创建类主按钮门禁与自动修复：新增/新建/添加/创建类操作统一使用客户主题 `primary` 填充按钮，自动移除误用的 `plain`。
+- 新增 R039 表格长文本门禁与自动修复：原生 `el-table-column` 普通数据列统一补齐 `show-overflow-tooltip`。
+- `defineColumns()` 为 BaseTable/AG Grid 普通文本列递归补齐超长省略与悬停完整提示；结构列、自定义渲染列、换行列及显式配置保持业务声明。
+
+### Changed
+
+- 表格样式仅对启用 overflow tooltip 的单元格补齐单行省略，避免影响 Tag、操作列和自定义内容。
+- 列表页、按钮、Element Table、BaseTable 规范与模板同步声明主按钮和长文本交互契约。
+
 ## [1.9.6] - 2026-07-23
 
 ### Fixed

package/README.md

@@ -200,7 +200,7 @@ yarn add @agile-team/wl-skills-ui
 |---|---|---|
 | `element-plus` | **`2.2.6-prod.3`** | 集团 jh- 定制版；EP 2.3.0 起引入 `.el-input__wrapper`，与 jh-ui 3.x 不兼容 |
 | `@jhlc/jh-ui` | **`3.1.0`** | SCSS 皮肤包，`.com-text` label 包裹 + `.has-colon` 冒号注入（wl-skills-ui 已统一屏蔽表单冒号） |
-| `@agile-team/wl-skills-ui` | `^1.9.6` | 已对齐上述组合的 DOM 假设、客户主题锁、圆角契约与定制页样式边界 |
+| `@agile-team/wl-skills-ui` | `^1.9.7` | 已对齐上述组合的 DOM 假设、客户主题锁、圆角契约与定制页样式边界 |
 
 三种识别方式，任选其一：
 
@@ -214,8 +214,10 @@ yarn add @agile-team/wl-skills-ui
 
 ## 版本亮点
 
-当前 v1.9.6：
+当前 v1.9.7：
 
+- **主操作按钮不再漏色**：新增/新建/添加/创建类按钮强制使用客户主题 `primary` 填充样式，扫描器可识别并自动修复漏写 `type` 或误带 `plain` 的存量代码。
+- **长文本交互统一**：普通数据列在空间不足时单行省略，悬停显示完整内容；Tag、操作列、自定义渲染和主动换行列不被机械覆盖。
 - **Vite 4 运行时兼容**：浏览器 ESM 产物不再暴露可被开发转换误替换的 Node 环境变量成员链，预构建与直接加载均保持合法语法。
 - **登录页精准退出**：内置识别 `.lp-root` 与 `.session-login`，其内部表单、按钮、焦点和校验态保留登录页自身设计；业务页面仍由包高权重统一管控。
 - **通用定制页边界**：其他定制页在根节点增加 `.wl-ui-skin-exempt` 或 `data-wl-ui-skin="off"` 即可退出组件级强覆盖，不需要删除全局化妆包。
@@ -676,7 +678,7 @@ export const myRules = [
 
 ## 规范清单
 
-### UI 规则（R001-R037，按 layer 自动分组）
+### UI 规则（R001-R039，按 layer 自动分组）
 
 | Rule | Layer | Vendor    | 说明                                 |
 | ---- | ----- | --------- | ------------------------------------ |
@@ -707,6 +709,8 @@ export const myRules = [
 | R035 | L1    | element   | el-upload 建议配置 tip/限制说明      |
 | R036 | L1    | element   | el-steps 建议明确状态来源            |
 | R037 | L1    | element   | 空/异常反馈建议统一操作入口          |
+| R038 | L1    | element   | 创建类主按钮缺 primary 填充主题色    |
+| R039 | L1    | element   | 普通数据列缺省略与悬停完整提示       |
 
 ### 工程规范
 

package/docs/compat-matrix.md

@@ -11,7 +11,7 @@
 | `element-plus` | **`2.2.6-prod.3`** | 集团 jh- 定制版，搭配 `@jhlc/jh-ui` 使用，DOM 仍为 `.el-input > .el-input__inner` 直挂结构（**EP 2.3.0 起才引入 `.el-input__wrapper`**） |
 | `@jhlc/jh-ui` | **`3.1.0`** | SCSS 皮肤包，`.com-text` label 包裹、`.has-colon ::after` 冒号注入、`.el-form-item--default { margin-bottom: 24px }` 等强约束 |
 | `@jhlc/common-core` | `3.1.0` 或 `3.1.0-prod.x` | 基础 util/types，`@jhlc/jh-ui` 间接依赖 |
-| `@agile-team/wl-skills-ui` | `^1.9.6` | 已对齐 jh-ui 3.1.0 + EP 2.2.6-prod.3 的 DOM 假设、客户主题锁、6px 基础圆角、定制页样式边界与 Vite 4 开发转换 |
+| `@agile-team/wl-skills-ui` | `^1.9.7` | 已对齐 jh-ui 3.1.0 + EP 2.2.6-prod.3 的 DOM 假设、客户主题锁、6px 基础圆角、定制页样式边界与 Vite 4 开发转换 |
 
 ## 项目集群当前实测
 
@@ -35,7 +35,7 @@
 
 ## 适配建议
 
-- 集团内项目：**统一锚定 `element-plus@2.2.6-prod.3` + `@jhlc/jh-ui@3.1.0`**，与 wl-skills-ui v1.9.6 三方对齐。
+- 集团内项目：**统一锚定 `element-plus@2.2.6-prod.3` + `@jhlc/jh-ui@3.1.0`**，与 wl-skills-ui v1.9.7 三方对齐。
 - 升级 `element-plus` 到 2.3+ 前，必须同步升级 `@jhlc/jh-ui` 到对应支持版本，否则 `.com-text` / `.el-input__inner` DOM 与 EP `__wrapper` 体系不兼容。
 - 新项目接入：见 README 「快速接入」章节，默认会按本表声明 peerDependency 范围。
 

package/es/{chunk-MPJ6QDYX.js → chunk-XDGTJ7LE.js}

@@ -279,24 +279,37 @@ function clearColumnAutoMap(name) {
 }
 function defineColumns(columns) {
   return columns.map((col) => {
-    const fieldName = col.name ?? col.label ?? "";
+    const normalized = Array.isArray(col.children) ? {
+      ...col,
+      children: defineColumns(col.children)
+    } : col;
+    const fieldName = normalized.name ?? normalized.label ?? "";
     const preset = COLUMN_AUTO_MAP[fieldName];
-    const hasRenderer = col.defaultNode !== void 0 || col.defaultSlot !== void 0;
-    if (hasRenderer) return col;
-    if (!preset && isDictColumn(col)) {
+    const hasRenderer = normalized.defaultNode !== void 0 || normalized.defaultSlot !== void 0;
+    if (hasRenderer) return normalized;
+    if (!preset && isDictColumn(normalized)) {
       return {
-        ...col,
-        defaultSlot: ({ row }) => renderDictClassifyTag(row?.[fieldName], String(col.logicValue))
+        ...normalized,
+        defaultSlot: ({ row }) => renderDictClassifyTag(
+          row?.[fieldName],
+          String(normalized.logicValue)
+        )
       };
     }
-    if (!preset) return col;
-    return { ...preset, ...col };
+    if (!preset) return withOverflowTooltip(normalized);
+    return withOverflowTooltip({ ...preset, ...normalized });
   });
 }
 function isDictColumn(col) {
   const logicType = String(col.logicType ?? "").toLowerCase();
   return Boolean(col.logicValue) && logicType.includes("dict");
 }
+function withOverflowTooltip(col) {
+  if (!col.name || col.showOverflowTooltip !== void 0 || col.tooltipValueGetter !== void 0 || col.wrapText === true || col.autoHeight === true || ["selection", "index", "radio", "expand"].includes(String(col.type ?? "")) || col.defaultNode !== void 0 || col.defaultSlot !== void 0) {
+    return col;
+  }
+  return { ...col, showOverflowTooltip: true };
+}
 registerColumnAutoMaps({
   enableStatus: {
     width: 80,

package/es/common-preset.js

@@ -1,5 +1,5 @@
-import { renderTagNode, renderClassifyTag, installBrandThemeLock, registerColumnAutoMaps, renderRatingLevel, renderBadge } from './chunk-MPJ6QDYX.js';
-export { registerDictColorMap, registerDictColorMaps, renderDictClassifyTag, setDictResolver } from './chunk-MPJ6QDYX.js';
+import { renderTagNode, renderClassifyTag, installBrandThemeLock, registerColumnAutoMaps, renderRatingLevel, renderBadge } from './chunk-XDGTJ7LE.js';
+export { registerDictColorMap, registerDictColorMaps, renderDictClassifyTag, setDictResolver } from './chunk-XDGTJ7LE.js';
 
 // runtime/presets/common.ts
 var RISK_LEVEL_MAP = {

package/es/index.js

@@ -1,5 +1,5 @@
-import { registerColumnAutoMaps } from './chunk-MPJ6QDYX.js';
-export { AUDIT_STATUS_MAP, BRAND_THEME_TOKENS, ENABLE_STATUS_MAP, RATING_LEVEL_COLORS, VERIFY_STATUS_MAP, clearColumnAutoMap, defineColumns, getColumnAutoMap, installBrandThemeLock, registerColumnAutoMap, registerColumnAutoMaps, registerDictColorMap, registerDictColorMaps, renderAuditStatus, renderBadge, renderClassifyTag, renderCountBadge, renderDangerText, renderDictClassifyTag, renderEnableStatus, renderOps, renderRatingLevel, renderTagNode, renderTagSlot, renderVerifyStatus, setDictResolver } from './chunk-MPJ6QDYX.js';
+import { registerColumnAutoMaps } from './chunk-XDGTJ7LE.js';
+export { AUDIT_STATUS_MAP, BRAND_THEME_TOKENS, ENABLE_STATUS_MAP, RATING_LEVEL_COLORS, VERIFY_STATUS_MAP, clearColumnAutoMap, defineColumns, getColumnAutoMap, installBrandThemeLock, registerColumnAutoMap, registerColumnAutoMaps, registerDictColorMap, registerDictColorMaps, renderAuditStatus, renderBadge, renderClassifyTag, renderCountBadge, renderDangerText, renderDictClassifyTag, renderEnableStatus, renderOps, renderRatingLevel, renderTagNode, renderTagSlot, renderVerifyStatus, setDictResolver } from './chunk-XDGTJ7LE.js';
 
 // runtime/presets/registry.ts
 var _installedPresets = /* @__PURE__ */ new Set();

package/es/presets/security.js

@@ -1,4 +1,4 @@
-import { renderTagNode, installBrandThemeLock, registerDictColorMaps, registerColumnAutoMaps } from '../chunk-MPJ6QDYX.js';
+import { renderTagNode, installBrandThemeLock, registerDictColorMaps, registerColumnAutoMaps } from '../chunk-XDGTJ7LE.js';
 
 // runtime/presets/security.ts
 var VIOLATION_STATUS_MAP = {

package/package.json

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

package/reference/define-columns.ts

@@ -172,14 +172,46 @@ export function defineColumns<T = any>(
   columns: TableColumnDesc<T>[]
 ): TableColumnDesc<T>[] {
   return columns.map((col) => {
+    const normalized = Array.isArray(col.children)
+      ? ({
+          ...col,
+          children: defineColumns(col.children),
+        } as TableColumnDesc<T>)
+      : 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 ((normalized as any).type === "selection" && !(normalized as any).width) {
+      return {
+        width: 55,
+        ...(normalized 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;
+    if (!normalized.name) return normalized;
+    const auto = COLUMN_AUTO_MAP[normalized.name as string];
+    if (!auto) return withOverflowTooltip(normalized);
     // 自动配置 < 手写配置（手写的属性不被覆盖）
-    return { ...auto, ...col } as TableColumnDesc<T>;
+    return withOverflowTooltip({
+      ...auto,
+      ...normalized,
+    } as TableColumnDesc<T>);
   });
 }
+
+function withOverflowTooltip<T>(
+  col: TableColumnDesc<T>
+): TableColumnDesc<T> {
+  if (
+    !col.name ||
+    col.showOverflowTooltip !== undefined ||
+    col.tooltipValueGetter !== undefined ||
+    col.wrapText === true ||
+    col.autoHeight === true ||
+    ["selection", "index", "radio", "expand"].includes(
+      String((col as any).type ?? "")
+    ) ||
+    col.defaultNode !== undefined ||
+    col.defaultSlot !== undefined
+  ) {
+    return col;
+  }
+  return { ...col, showOverflowTooltip: true };
+}

package/scanner/fix.mjs

@@ -7,6 +7,8 @@
  *   - el-input / el-select: 缺 size="small"     → 添加
  *   - el-date-picker: 缺 style="width:100%"     → 添加
  *   - el-table: 缺 empty-text="暂无数据"        → 添加
+ *   - 创建类主按钮: 缺 primary / 误用 plain    → 纠正
+ *   - el-table 普通数据列: 缺 overflow tooltip → 添加
  *   - <style>/<template> 内可映射 hex 颜色      → 替换为 var(--el-color-*)
  */
 import { readFileSync, writeFileSync, readdirSync } from "node:fs";
@@ -14,6 +16,15 @@ import { join, relative, resolve } from "node:path";
 import { createSnapshot } from "./snapshot.mjs";
 import { TOKEN_MAP } from "./rules/_shared.mjs";
 
+const CREATE_ACTION_LABEL =
+  /(?:新增|新建|添加|创建)(?:申请|记录|数据|客户|项目|任务|明细|行)?/;
+
+function hasTrueBooleanAttr(tagText, attr) {
+  return new RegExp(
+    `(?:^|\\s)(?::${attr}\\s*=\\s*["']true["']|${attr}(?:\\s*=\\s*["'](?:true|)["'])?)(?=\\s|/?>)`,
+  ).test(tagText);
+}
+
 const FIXES = {
   "el-input": [{ attr: "size", value: "small" }],
   "el-select": [{ attr: "size", value: "small" }],
@@ -37,6 +48,8 @@ export const FIXED_RULE_IDS = Object.freeze([
   "R016",
   "R017",
   "R021",
+  "R038",
+  "R039",
 ]);
 
 function parseTag(content, pos, tagName) {
@@ -57,10 +70,24 @@ function parseTag(content, pos, tagName) {
   return { text: content.slice(pos), end: content.length };
 }
 
-function addAttrIfMissing(tagText, tagName, attr, value, replaceStatic = false) {
+function addAttrIfMissing(
+  tagText,
+  tagName,
+  attr,
+  value,
+  replaceStatic = false,
+  booleanAttr = false,
+) {
   // 已存在（含动态绑定 :attr=）则跳过
+  const escapedAttr = attr.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  if (
+    booleanAttr &&
+    new RegExp(`(?:^|\\s):?${escapedAttr}(?=\\s|=|/?>)`).test(tagText)
+  ) {
+    return { text: tagText, changed: false };
+  }
   const re = new RegExp(
-    `:?${attr.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*=`,
+    `:?${escapedAttr}\\s*=`,
   );
   if (re.test(tagText)) {
     if (!replaceStatic) return { text: tagText, changed: false };
@@ -71,6 +98,12 @@ function addAttrIfMissing(tagText, tagName, attr, value, replaceStatic = false)
     const text = tagText.replace(staticRe, `$1"${value}"`);
     return { text, changed: text !== tagText };
   }
+  if (booleanAttr) {
+    return {
+      text: tagText.replace(`<${tagName}`, `<${tagName} ${attr}`),
+      changed: true,
+    };
+  }
   const newTag = tagText.replace(
     `<${tagName}`,
     `<${tagName} ${attr}="${value}"`,
@@ -105,8 +138,26 @@ function fixTemplateAttrs(content) {
     if (tagName === "el-table-column" && text.includes('type="selection"')) {
       fixes.push({ attr: "header-align", value: "center" });
     }
-    for (const { attr, value, replaceStatic } of fixes) {
-      const r = addAttrIfMissing(text, tagName, attr, value, replaceStatic);
+    if (
+      tagName === "el-table-column" &&
+      /(?:^|\s):?prop\s*=/.test(text) &&
+      !/(?:^|\s)type\s*=\s*["'](?:selection|index|expand)["']/.test(text)
+    ) {
+      fixes.push({
+        attr: "show-overflow-tooltip",
+        value: "",
+        booleanAttr: true,
+      });
+    }
+    for (const { attr, value, replaceStatic, booleanAttr } of fixes) {
+      const r = addAttrIfMissing(
+        text,
+        tagName,
+        attr,
+        value,
+        replaceStatic,
+        booleanAttr,
+      );
       text = r.text;
       if (r.changed) changes++;
     }
@@ -116,6 +167,44 @@ function fixTemplateAttrs(content) {
   return { content: result, changes };
 }
 
+function fixPrimaryActionButtons(content) {
+  let changes = 0;
+  const result = content.replace(
+    /<el-button\b[\s\S]*?<\/el-button>/g,
+    (button) => {
+      const openEnd = button.indexOf(">");
+      if (openEnd < 0) return button;
+      let opening = button.slice(0, openEnd + 1);
+      const label = button.slice(openEnd + 1, button.lastIndexOf("</el-button>"));
+      if (!CREATE_ACTION_LABEL.test(label)) return button;
+      if (/:type\s*=/.test(opening)) return button;
+      if (hasTrueBooleanAttr(opening, "link") || hasTrueBooleanAttr(opening, "text"))
+        return button;
+
+      const typeResult = addAttrIfMissing(
+        opening,
+        "el-button",
+        "type",
+        "primary",
+        true,
+      );
+      opening = typeResult.text;
+      if (typeResult.changed) changes++;
+
+      const withoutPlain = opening
+        .replace(/\s+:plain\s*=\s*["']true["']/g, "")
+        .replace(/\s+plain\s*=\s*["'](?:true|)["']/g, "")
+        .replace(/\s+plain(?=\s|\/?>)/g, "");
+      if (withoutPlain !== opening) {
+        opening = withoutPlain;
+        changes++;
+      }
+      return opening + button.slice(openEnd + 1);
+    },
+  );
+  return { content: result, changes };
+}
+
 function fixHexColors(content) {
   let changes = 0;
   let result = content;
@@ -180,9 +269,12 @@ export function runFix({
     const r1 = fixTemplateAttrs(content);
     content = r1.content;
     changes += r1.changes;
-    const r2 = fixHexColors(content);
+    const r2 = fixPrimaryActionButtons(content);
     content = r2.content;
     changes += r2.changes;
+    const r3 = fixHexColors(content);
+    content = r3.content;
+    changes += r3.changes;
     if (changes > 0 && content !== original) {
       pending.push({ filePath, original, content, changes });
       changedAbsPaths.push(filePath);

package/scanner/report.mjs

@@ -63,6 +63,8 @@ const RULE_NAME = {
   R018: "<script> 块硬编码 hex 颜色",
   R021: 'BaseTable 缺少 render-type="agGrid"',
   R022: "BaseTable 缺少唯一 cid",
+  R038: "创建类主操作缺少 primary 填充主题色",
+  R039: "普通数据列缺少超长省略与悬停完整提示",
   R031: "详情/统计卡片建议使用统一场景 class",
   R032: "el-tabs 建议明确页面场景",
   R033: "el-descriptions 建议使用 bordered 或统一容器",

package/scanner/rules/button.mjs

@@ -1,6 +1,20 @@
-/** scanner/rules/button.mjs — 按钮规则：R004 R005 R015 */
+/** scanner/rules/button.mjs — 按钮规则：R004 R005 R015 R038 */
 import { lineOf, issue, findTags } from "./_shared.mjs";
 
+const CREATE_ACTION_LABEL = /(?:新增|新建|添加|创建)(?:申请|记录|数据|客户|项目|任务|明细|行)?/;
+
+function buttonContent(template, tag) {
+  const start = tag.index + tag.text.length;
+  const end = template.indexOf("</el-button>", start);
+  return end < 0 ? "" : template.slice(start, end);
+}
+
+function hasTrueBooleanAttr(tagText, attr) {
+  return new RegExp(
+    `(?:^|\\s)(?::${attr}\\s*=\\s*["']true["']|${attr}(?:\\s*=\\s*["'](?:true|)["'])?)(?=\\s|/?>)`,
+  ).test(tagText);
+}
+
 export const buttonRules = [
   // R004: 操作列文字按钮
   {
@@ -59,6 +73,46 @@ export const buttonRules = [
     },
   },
 
+  // R038: 新增/新建/添加/创建类主操作必须使用填充主题色
+  {
+    id: "R038",
+    category: "button",
+    severity: "error",
+    name: "创建类主操作缺少 primary 填充主题色",
+    check(template, file, lineOffset) {
+      const issues = [];
+      for (const tag of findTags(template, "el-button")) {
+        const label = buttonContent(template, tag);
+        if (!CREATE_ACTION_LABEL.test(label)) continue;
+        if (/:type\s*=/.test(tag.text)) continue;
+        if (
+          hasTrueBooleanAttr(tag.text, "link") ||
+          hasTrueBooleanAttr(tag.text, "text")
+        ) {
+          continue;
+        }
+        const isPrimary = /(?:^|\s)type\s*=\s*["']primary["']/.test(
+          tag.text,
+        );
+        const isPlain = hasTrueBooleanAttr(tag.text, "plain");
+        if (!isPrimary || isPlain) {
+          issues.push(
+            issue(
+              file,
+              lineOf(template, tag.index, lineOffset),
+              "R038",
+              "button",
+              "error",
+              "新增/新建/添加/创建类主操作必须是 primary 填充按钮",
+              '设置 type="primary" 并移除 plain；行内次级操作应显式使用 link/text',
+            ),
+          );
+        }
+      }
+      return issues;
+    },
+  },
+
   // R015: 弹窗嵌套表格操作列用 el-button link
   {
     id: "R015",

package/scanner/rules/table.mjs

@@ -1,4 +1,4 @@
-/** scanner/rules/table.mjs — 表格相关规则：R001 R002 R003 R014 R021 R022 */
+/** scanner/rules/table.mjs — 表格相关规则：R001 R002 R003 R014 R021 R022 R039 */
 import { lineOf, issue, findTags } from "./_shared.mjs";
 
 export const tableRules = [
@@ -35,6 +35,41 @@ export const tableRules = [
     },
   },
 
+  // R039: 原生 el-table 普通数据列必须支持超长省略与悬停完整提示
+  {
+    id: "R039",
+    category: "table",
+    severity: "warning",
+    name: "el-table 普通数据列缺少 show-overflow-tooltip",
+    check(template, file, lineOffset) {
+      const issues = [];
+      for (const tag of findTags(template, "el-table-column")) {
+        if (!/(?:^|\s):?prop\s*=/.test(tag.text)) continue;
+        if (
+          /(?:^|\s)type\s*=\s*["'](?:selection|index|expand)["']/.test(
+            tag.text,
+          )
+        ) {
+          continue;
+        }
+        if (/(?:^|\s):?show-overflow-tooltip(?:\s|=|\/?>)/.test(tag.text))
+          continue;
+        issues.push(
+          issue(
+            file,
+            lineOf(template, tag.index, lineOffset),
+            "R039",
+            "table",
+            "warning",
+            "普通数据列缺少超长省略与悬停完整内容提示",
+            "添加 show-overflow-tooltip；BaseTable/AG Grid 列统一使用 defineColumns() 自动补齐",
+          ),
+        );
+      }
+      return issues;
+    },
+  },
+
   // R002: el-table 缺少 empty-text
   {
     id: "R002",

package/skills/element/el-table/SKILL.md

@@ -1,7 +1,7 @@
 ---
 description: |
   表格组件规范 Skill — el-table / BaseTable / el-table-column 的对齐、空状态、selection 列标准。
-  覆盖规则：R001 R002 R003 R014。
+  覆盖规则：R001 R002 R003 R014 R039。
 applyTo: "**/*.vue"
 ---
 
@@ -55,6 +55,19 @@ applyTo: "**/*.vue"
 
 ---
 
+## R039 — 普通数据列必须超长省略并悬停显示完整内容 【中危】
+
+```diff
+- <el-table-column prop="customerName" label="客户名称" align="center" />
++ <el-table-column prop="customerName" label="客户名称" align="center" show-overflow-tooltip />
+```
+
+BaseTable / AG Grid 使用 `defineColumns()` 后由 runtime 自动为普通文本列补齐
+`showOverflowTooltip: true`。自定义渲染、结构列、换行列不强制；需要主动关闭时
+显式声明 `showOverflowTooltip: false`。
+
+---
+
 ## 完整标准写法示例
 
 ```html
@@ -67,7 +80,13 @@ applyTo: "**/*.vue"
     header-align="center"
   />
   <el-table-column type="index" align="center" width="60" label="序号" />
-  <el-table-column align="center" prop="name" label="名称" min-width="120" />
+  <el-table-column
+    align="center"
+    prop="name"
+    label="名称"
+    min-width="120"
+    show-overflow-tooltip
+  />
   <el-table-column align="center" prop="status" label="状态" width="90">
     <template #default="{ row }">
       <!-- 使用 renderTagSlot 渲染彩色 Tag，见 tag-status/SKILL.md -->

package/skills/layouts/list-page/SKILL.md

@@ -53,6 +53,8 @@ applyTo: "**/*.vue"
 
 - R001 ~ R003：表格列对齐 + empty-text
 - R005：工具栏按钮缺 icon
+- R038：新增/新建/添加/创建类主按钮缺 primary 填充主题色
+- R039：普通数据列缺少省略号与悬停完整内容提示
 - R006：搜索区输入框缺 `size="small"`
 - R011：分页在 footer 内（严重）
 
@@ -97,6 +99,10 @@ applyTo: "**/*.vue"
 </template>
 ```
 
+“新增”类按钮必须保持 `type="primary"` 且不得带 `plain`；生成完成后运行
+`wl-ui scan` / `wl-ui fix` 复核 R038。表格列统一由 `defineColumns()` 包裹，
+普通文本列的 R039 行为由 runtime 自动补齐。
+
 ### SCSS 对应（由 styles/layouts/\_list-page.scss 提供）
 
 ```scss

package/skills/vendors/base-table/SKILL.md

@@ -28,12 +28,14 @@ applyTo: "**/*.vue"
 - ❌ 用 `<el-button type="primary">` 当操作按钮（应用 `is-text` 文字按钮，沿用 R004）
 - ❌ 列头未居中（同 R001）
 - ❌ 缺 `empty-text="暂无数据"`（同 R003）
+- ❌ 普通文本列未通过 `defineColumns()` 获得超长省略与悬停完整提示（同 R039）
 - ❌ 在 `<BaseTable>` 外层包裹自定义 padding 容器，破坏整体节奏
 
 ## Repair（修复）
 
 ### A 类（自动修）
 - 缺失 `empty-text` → 补 `empty-text="暂无数据"`
+- 普通文本列统一经 `defineColumns()` 自动补 `showOverflowTooltip: true`
 - 操作列按钮 `type="primary"` → 改为 `link` + `is-text`
 - 内联 hex → CSS 变量
 
@@ -51,7 +53,8 @@ applyTo: "**/*.vue"
 
 ## 全局样式来源
 
-`styles/vendors/_base-table.scss` — 已注入容器圆角、表头颜色、操作按钮间距。
+`styles/vendors/_base-table.scss` — 已注入容器圆角、表头颜色、操作按钮间距；
+`runtime.defineColumns()` 统一控制普通文本列的 overflow tooltip。
 项目侧无需重复写样式，遵循 DOM 约定即可。
 
 ## 未来源码迁移

package/standards/rules.json

@@ -107,6 +107,17 @@
       "scanner": "scanner/rules/button.mjs",
       "skills": ["layouts/list-page"]
     },
+    {
+      "id": "R038",
+      "category": "button",
+      "severity": "error",
+      "title": "新增/新建/添加/创建类主操作必须使用 primary 填充按钮",
+      "rationale": "创建类动作是列表页首要操作，必须稳定使用客户主题深蓝填充，禁止漏写 type 或误用 plain 退化为线框。",
+      "appliesTo": ["el-button[label~=新增|新建|添加|创建]"],
+      "autoFixable": true,
+      "scanner": "scanner/rules/button.mjs",
+      "skills": ["layouts/list-page"]
+    },
     {
       "id": "R006",
       "category": "form",
@@ -313,6 +324,20 @@
       "scanner": "scanner/rules/table.mjs",
       "skills": ["vendors/base-table"]
     },
+    {
+      "id": "R039",
+      "category": "table",
+      "severity": "warning",
+      "title": "普通数据列必须支持超长省略与悬停完整提示",
+      "rationale": "列宽不足时统一单行省略，悬停显示完整内容，避免长名称撑破布局或信息不可读。",
+      "appliesTo": [
+        "el-table-column[prop]",
+        "BaseTable defineColumns ordinary data column"
+      ],
+      "autoFixable": true,
+      "scanner": "scanner/rules/table.mjs",
+      "skills": ["element/el-table", "vendors/base-table"]
+    },
     {
       "id": "R031",
       "category": "family",

package/standards/ui/01-table.md

@@ -32,6 +32,27 @@
 
 ---
 
+## 规则 R039：长文本统一省略并悬停显示完整内容
+
+原生 Element Plus 普通数据列必须声明 `show-overflow-tooltip`：
+
+```vue
+<el-table-column
+  prop="customerName"
+  label="客户名称"
+  min-width="160"
+  align="center"
+  show-overflow-tooltip
+/>
+```
+
+BaseTable / AG Grid 列必须通过 `defineColumns()` 声明。普通文本列会自动补
+`showOverflowTooltip: true`；自定义渲染列、selection/index/expand、`wrapText`
+或 `autoHeight` 列不会被强制。业务可显式设置 `showOverflowTooltip: false`
+退出。
+
+---
+
 ## 规则 R004：操作列使用 renderOps / jh-op-btn
 
 操作列按钮**不得**直接使用 `<el-button>` 或裸文本，必须通过 `renderOps` 渲染：

package/standards/ui/02-button.md

@@ -11,6 +11,11 @@
 
 ### 类型规则
 
+**R038 强制约束**：凡按钮文案表达“新增 / 新建 / 添加 / 创建”主操作，
+必须使用 `type="primary"` 的填充样式，不得漏写 `type`，也不得同时设置
+`plain`。只有明确属于行内次级交互时，才允许显式改用 `link` / `text`。
+`wl-ui scan` 会报错，`wl-ui fix` 可机械纠正静态按钮。
+
 主按钮色值严格遵循客户 UI 规范，禁止使用 `#2254F4`、`#4368FF` 或 Element Plus 默认蓝替代：
 
 | 状态          | Token                        | 规范色值  |
@@ -36,7 +41,7 @@
 
 ```vue
 <!-- ✅ 工具栏按钮组 -->
-<el-button type="primary" @click="handleCreate">新增</el-button>
+<el-button type="primary" icon="Plus" @click="handleCreate">新增</el-button>
 <el-button type="warning" plain icon="Edit" @click="handleEdit">修改</el-button>
 <el-button type="success" icon="Save" @click="handleSave">保存</el-button>
 <el-button icon="Download" @click="handleExport">导出</el-button>

package/styles/element/_table.scss

@@ -12,6 +12,14 @@ html body .el-table {
     --el-table-tr-bg-color: var(--el-fill-color-lighter, #fafafa);
   }
 
+  // 仅命中 show-overflow-tooltip 生成的单元格，不压制 Tag/操作列等自定义内容。
+  .el-table__body .cell.el-tooltip {
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
   .el-table__empty-block {
     display: flex;
     align-items: center;

package/templates/ag-grid-page/TPL-AG-GRID.md

@@ -24,7 +24,7 @@ columnsDef(): TableColumnDesc<any>[] {
 
     // ── 数据列（已注册字段自动映射，无需 defaultNode）──
     { name: 'riskNo',    label: '编号',     width: 100 },  // → renderBadge
-    { name: 'name',      label: '名称',     minWidth: 150 },
+    { name: 'name',      label: '名称',     minWidth: 150 }, // → 自动省略 + 悬停完整提示
     { name: 'riskLevel', label: '风险分级', width: 90 },   // → renderRiskLevel Tag
     { name: 'riskStatus', label: '状态',   width: 90 },    // → renderRiskStatus Tag
 
@@ -74,3 +74,4 @@ toolbarDef() {
 2. 操作列用 `renderOps([...])` — 图标按钮 + 自动 stopPropagation
 3. selection 列必须同时设置 `align: 'center'` + `headerAlign: 'center'`（R014）
 4. 分类字段（type/level）用 `renderClassifyTag`，状态字段用 `renderTagNode`
+5. `defineColumns()` 自动为普通文本列补 `showOverflowTooltip: true`；自定义渲染、结构列和换行列除外

package/templates/list-page/TPL-LIST.md

@@ -107,6 +107,7 @@ const modal = ref();
 function columnsDef() {
   return defineColumns([
     { type: "index", label: "序号", width: 60, align: "center" },
+    // 普通文本列由 defineColumns 自动补 showOverflowTooltip: true
     { name: "name", label: "名称", minWidth: 120 },
     { name: "status", label: "状态", width: 80 }, // enableStatus 已自动映射
     { name: "remark", label: "备注", minWidth: 160 },
@@ -141,3 +142,5 @@ async function handleDel(id: string) {
 3. `enableStatus` 字段在 `installCommonPreset()` 后自动渲染为彩色 Tag，无需手写 defaultNode
 4. 工具栏按钮必须带 `icon`（R005 规则）
 5. 标准顺序固定为“查询区 → 工具栏 → 列表标题 → 表格 → 分页器”；工具栏不得放到标题右侧或标题下方
+6. 新增/新建/添加/创建类主按钮必须 `type="primary"` 且不得使用 `plain`（R038）
+7. 普通文本列由 `defineColumns()` 自动启用省略号与悬停完整提示；原生 `el-table-column` 必须加 `show-overflow-tooltip`（R039）