@agile-team/wl-skills-ui 1.8.16 → 1.9.0

package/CHANGELOG.md

@@ -4,6 +4,34 @@ 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.0] - 2026-07-18
+
+### Added
+
+- 统一 CLI 正式暴露 `audit`、`drift`、`exempt`、`snapshot`，`audit --refresh-baseline` 可建立和收敛问题基线。
+- 新增自动修复、快照路径边界、回退与 CLI 转发测试；新增包导出/运行时导入/规则目录与 fixer 一致性发布检查。
+- 新增独立闭环与 kit 可选协同说明，明确 page-spec 只作为约定输入而非硬依赖。
+
+### Fixed
+
+- `./runtime` package export 改为真实 `es/index.js` 与类型声明，不再错误导出包根目录。
+- runtime 构建入口改为完整 `runtime/index.ts`，`createPreset/installPreset` 与文档一致；删除指向未发布 TypeScript 源码的失效 presets 通配导出。
+- `add-preset` 改为在消费项目的 `src/wl-ui/presets` 安全生成，不再尝试写入安装包目录；名称和输出路径均做边界校验。
+- 快照创建失败改为失败关闭；修复写入中断自动恢复本轮文件；快照和回退拒绝路径穿越及符号链接越界。
+- `autoFixable` 与实际 fixer 能力收口：脚本配色、图标、loading-mask 和圆角等语义修复不再误标为自动修复。
+- `fix` 完成后自动复检，`--fail-on-error` 在仍有强制问题时正确返回非零状态。
+
+### Changed
+
+- 最低 Node.js 版本提升为 22；新增统一 `verify`、`release:check` 与 `prepublishOnly` 发布门禁。
+- npm 发布白名单排除 scanner 测试夹具与维护脚本，只保留运行时 scanner/rules，避免发布包污染。
+
+## [1.8.17] - 2026-07-15
+
+### Changed
+
+- **操作列状态辨识**：全局化妆层把可用图标默认色改为柔和主题蓝 `--el-color-primary-light-2`，hover 继续使用原有蓝/绿/红语义色；原生禁用态统一浅灰且不响应 hover，选中行不再自动改变按钮语义色。业务页面无需改造，升级样式包即可生效。
+
 ## [1.8.16] - 2026-07-01
 
 ### Fixed
@@ -109,7 +137,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 ### Notes
 
 - R013（Upload 嵌入 operations[]）由文档约束晋升为 `rules.json` 正式条目（`severity: review`，无 scanner 实现）。
-- 推荐业务项目跟进：跑一次 `npx wl-ui audit --target src --outFile .wl-baseline.json` 建立基线，配合 `--baseline` 增量门槛使用（详见 `docs/governance-long-term.md`）。
+- 推荐业务项目跟进：跑一次 `npx wl-ui audit --target src --refresh-baseline` 建立基线，配合 `--baseline` 增量门槛使用（详见 `docs/governance-long-term.md`）。
 
 ## [1.7.1] - 2026-05-12
 

package/README.md

@@ -3,7 +3,7 @@
 > **企业级 UI 风格对齐框架** — 让 Vue + Element Plus 业务系统获得一致的视觉、可被 AI 精确识别和修复的设计规范，以及可演进的工程能力。
 
 [![npm version](https://img.shields.io/npm/v/@agile-team/wl-skills-ui.svg)](https://www.npmjs.com/package/@agile-team/wl-skills-ui)
-[![Node](https://img.shields.io/badge/node-%3E%3D18-green.svg)]()
+[![Node](https://img.shields.io/badge/node-%3E%3D22-green.svg)]()
 
 ---
 
@@ -187,7 +187,7 @@ npm i @agile-team/wl-skills-ui
 yarn add @agile-team/wl-skills-ui
 ```
 
-要求：Node ≥ 18，Vue ≥ 3.2，Element Plus ≥ 2.2。
+要求：Node ≥ 22，Vue ≥ 3.2，Element Plus ≥ 2.2。
 
 ---
 
@@ -199,7 +199,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.7.0` | 已对齐上述组合的 DOM 假设 |
+| `@agile-team/wl-skills-ui` | `^1.9.0` | 已对齐上述组合的 DOM 假设 |
 
 三种识别方式，任选其一：
 
@@ -213,7 +213,18 @@ yarn add @agile-team/wl-skills-ui
 
 ## 版本亮点
 
-当前 v1.8.16：
+当前 v1.9.0：
+
+- **独立闭环**：不依赖 kit/design/bd 即可安装、审计、修复、复检、快照和回退；存在 kit 的 page-spec 时只复用页面模式与组件命名约定，不形成运行时硬依赖。
+- **CLI 真实一致**：统一入口正式支持 `audit/drift/exempt/snapshot`，未知命令非零退出，`audit --refresh-baseline` 可维护增量治理基线。
+- **修复失败安全**：快照失败即停止写入；快照与回退拒绝路径越界/符号链接越界；写入中断自动恢复本轮已写文件，修复结束自动复检。
+- **发布面闭环**：修复 `./runtime` 导出，新增构建产物导入烟测、规则/fixer 一致性校验和 `verify/release:check/prepublishOnly` 门禁。
+
+上一版 v1.8.17：
+
+- **操作列状态辨识**：可用图标默认使用柔和主题蓝，hover 保留蓝/绿/红语义色；禁用态统一浅灰且不响应 hover，选中行不再改变按钮语义色
+
+上一版 v1.8.16：
 
 - **label 冒号通杀（根治"就它带冒号"）**：jh-* 组件的 `showColon` 默认 true，渲染冒号走 `.com-text` 但不带 `.has-colon`，旧规则（仅 `.has-colon` 限定）命不中。新增不限 `.has-colon` 的通杀规则，咔嚓所有 `.el-form-item__label` 内冒号伪元素
 
@@ -400,7 +411,7 @@ npx wl-ui doctor --project .
 {
   "scripts": {
     "ui:check": "wl-ui check --project .",
-    "ui:audit": "wl-ui scan --target src --outFile ui-audit.md",
+    "ui:audit": "wl-ui audit --target src --outFile ui-audit.md",
     "ui:fix": "wl-ui fix --target src --dry-run"
   }
 }
@@ -420,9 +431,13 @@ wl-ui doctor  [--project .]
 wl-ui prompts
 wl-ui scan    --target src  [--layer L0,L1,L2] [--vendor base-table,jh]
                             [--mode skin|native] [--outFile report.md]
+wl-ui audit   --target src  [--output json] [--refresh-baseline]
 wl-ui check   --project .
 wl-ui fix     --target src  [--dry-run]
 wl-ui all     --project .
+wl-ui drift   --baseline .wl-baseline.json --current .wl-current.json
+wl-ui exempt init --project . --target src
+wl-ui snapshot list|diff|rollback|clean
 wl-ui add-preset <name>     # 脚手架新业务 preset
 ```
 
@@ -437,6 +452,8 @@ wl-ui add-preset <name>     # 脚手架新业务 preset
 
 > 可选桥接：如项目也安装了 `@agile-team/wl-skills-kit`，两者保持独立分工，不互相强依赖。kit 负责编码规范/页面生成/菜单字典权限，wl-skills-ui 负责 UI 风格/化妆层/Runtime 渲染。
 
+具体独立使用、可选 page-spec 协同和验证边界见 [`docs/delivery-compatibility.md`](docs/delivery-compatibility.md)。
+
 > 规范插件建议：项目可执行 `npx @robot-admin/git-standards init` 接入 ESLint/Prettier/Husky/提交规范，形成代码质量闭环。
 
 ---
@@ -481,12 +498,12 @@ Base* > jh-* > C_*/c_* > AG Grid > custom wrappers
 
 ```bash
 npx wl-ui add-preset my-biz
-# 生成 runtime/presets/my-biz.ts，按提示填字段映射，然后：
+# 在消费项目生成 src/wl-ui/presets/my-biz.ts，按提示填字段映射，然后：
 ```
 
 ```ts
 // main.ts
-import { installMyBizPreset } from "@agile-team/wl-skills-ui/runtime/presets/my-biz";
+import { installMyBizPreset } from "@/wl-ui/presets/my-biz";
 installMyBizPreset();
 ```
 

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 description: |
   UI 风格对齐 Skill —— 扫描 Vue SFC 文件，识别与 wl-skills-ui 五层规范不一致的控件写法，
-  生成整改清单，经用户确认后执行全量自动修复，最终验证归零。
+  生成整改清单，经用户确认后执行安全自动修复与语义人工修复，最终复检并记录未决项。
   支持老项目 Skin 化妆模式（不改布局）和新项目 Native 原生模式（完整接入）。
 applyTo: "**/*.vue"
 ---
@@ -79,7 +79,7 @@ npx wl-ui check --project [项目根目录]
 
 询问用户：
 1. 是否全量修复，还是指定规则/文件？
-2. 对于无法自动修复的问题（R009/R012），是否手动处理？
+2. 对于 `standards/rules.json` 标记为不可自动修复的问题，是否逐项人工处理？
 
 **未经确认，禁止修改任何文件。**
 
@@ -93,7 +93,7 @@ npx wl-ui check --project [项目根目录]
 
 ### Phase 5 — 验证
 
-重新运行 Phase 1 的扫描命令，验证 issue 数量归零或达到预期水平。
+`fix` 会自动复检；再运行 Phase 1 生成留档报告，验证强制问题归零，无法处理的偏差必须有显式豁免或未决记录。
 
 ---
 
@@ -401,7 +401,7 @@ npx wl-ui check --project [项目根目录]
 
 ## 八、新系统快速接入方案（推荐）
 
-对于**全新业务系统**，使用本方案可让所有业务页面从第一行代码就符合风格标准，彻底无需事后补丁。
+对于**全新业务系统**，使用本方案可让页面从第一行代码就采用统一基线，并通过持续扫描避免事后积累补丁。
 
 > 详细接入步骤见 [README — 快速开始](../README.md#快速开始)，以下仅列核心要点。
 
@@ -454,7 +454,7 @@ columnsDef(): TableColumnDesc<any>[] {
 |---|---|
 | 状态列彩色 Tag | `defineColumns` COLUMN_AUTO_MAP 自动配置 |
 | 操作列图标按钮 | `renderOps([...])` 统一渲染系统 |
-| 操作列条件显示 | `show: condition` 替代 `disabled: (row) => !condition` |
+| 操作列条件显示 | `show: condition` 控制按钮显隐 |
 | 自动分隔线 | 图标组与文字组之间 `renderOps` 自动插入 |
 | 点击阻止冒泡 | `renderOps` 内部自动 `e.stopPropagation()` |
 

package/bin/wl-ui.js

@@ -9,6 +9,7 @@
  *   wl-ui check  → 委托给 scanner/index.mjs
  *   wl-ui fix    → 委托给 scanner/index.mjs
  *   wl-ui all    → 委托给 scanner/index.mjs
+ *   wl-ui audit/drift/exempt/snapshot → 委托给 scanner/index.mjs
  *
  * 向后兼容：wl-scan 仍可用（直接调用 scanner/index.mjs）
  */
@@ -22,7 +23,7 @@ import {
   rmSync,
   unlinkSync,
 } from "node:fs";
-import { join, resolve, dirname, relative } from "node:path";
+import { join, resolve, dirname, relative, isAbsolute } from "node:path";
 import { fileURLToPath } from "node:url";
 import { parseArgs } from "node:util";
 import { createRequire } from "node:module";
@@ -53,12 +54,15 @@ const SUBCOMMANDS = new Set([
   "doctor",
   "prompts",
   "scan",
+  "audit",
   "check",
   "fix",
   "all",
   "add-preset",
   "add-vendor",
   "snapshot",
+  "drift",
+  "exempt",
 ]);
 let subcommand = "help";
 
@@ -66,10 +70,25 @@ if (rawArgs.length > 0 && SUBCOMMANDS.has(rawArgs[0])) {
   subcommand = rawArgs.shift();
 } else if (rawArgs.length === 0) {
   subcommand = "help";
+} else if (["--help", "-h", "--version", "-v"].includes(rawArgs[0])) {
+  subcommand = "help";
+} else {
+  console.error(`[wl-ui] 未知命令：${rawArgs[0]}`);
+  console.error("运行 wl-ui --help 查看可用命令。");
+  process.exit(1);
 }
 
 // 非 init 子命令：直接委托给 scanner/index.mjs
-const SCANNER_CMDS = new Set(["scan", "check", "fix", "all", "snapshot"]);
+const SCANNER_CMDS = new Set([
+  "scan",
+  "audit",
+  "check",
+  "fix",
+  "all",
+  "snapshot",
+  "drift",
+  "exempt",
+]);
 if (SCANNER_CMDS.has(subcommand)) {
   const scannerBin = join(PKG_ROOT, "scanner", "index.mjs");
   try {
@@ -88,6 +107,10 @@ if (
   rawArgs.includes("--help") ||
   rawArgs.includes("-h")
 ) {
+  if (rawArgs.includes("--version") || rawArgs.includes("-v")) {
+    console.log(PKG.version);
+    process.exit(0);
+  }
   printHelp();
   process.exit(0);
 }
@@ -235,7 +258,21 @@ if (subcommand === "add-preset") {
     );
     process.exit(1);
   }
-  scaffoldPreset(presetName);
+  const { values } = parseArgs({
+    args: rawArgs.slice(1),
+    options: {
+      project: { type: "string", default: "." },
+      output: { type: "string", default: "src/wl-ui/presets" },
+      "dry-run": { type: "boolean", default: false },
+    },
+    strict: true,
+  });
+  scaffoldPreset({
+    name: presetName,
+    projectRoot: resolve(values.project),
+    outputDir: values.output,
+    dryRun: values["dry-run"],
+  });
   process.exit(0);
 }
 
@@ -542,19 +579,28 @@ ${
 }
 
 /** 脚手架新预设文件 */
-function scaffoldPreset(name) {
-  const outPath = join(PKG_ROOT, "runtime", "presets", `${name}.ts`);
+function scaffoldPreset({ name, projectRoot, outputDir, dryRun }) {
+  if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+    console.error("[wl-ui add-preset] 名称必须是小写 kebab-case");
+    process.exit(1);
+  }
+  const outPath = resolve(projectRoot, outputDir, `${name}.ts`);
+  const relPath = relative(projectRoot, outPath);
+  if (relPath.startsWith("..") || isAbsolute(relPath)) {
+    console.error("[wl-ui add-preset] 输出目录必须位于目标项目内");
+    process.exit(1);
+  }
   if (existsSync(outPath)) {
     console.error(`[wl-ui add-preset] 文件已存在：${outPath}`);
     process.exit(1);
   }
+  const symbol = toPascalCase(name);
   const template = `/**
- * runtime/presets/${name}.ts — ${name} 业务预设
- * 使用：import { install${capitalize(name)}Preset } from '@agile-team/wl-skills-ui/runtime/presets/${name}';
+ * ${relPath.replace(/\\/g, "/")} — ${name} 业务预设
+ * 使用：import { install${symbol}Preset } from '@/wl-ui/presets/${name}';
  */
-import type { TagMapItem } from '../core/types';
-import { renderTagNode } from '../core/renderers';
-import { registerColumnAutoMaps } from '../core/registry';
+import type { TagMapItem } from '@agile-team/wl-skills-ui/runtime';
+import { registerColumnAutoMaps, renderTagNode } from '@agile-team/wl-skills-ui/runtime';
 
 // ── 状态映射 ──────────────────────────────────────────────────────────────────
 export const MY_STATUS_MAP: Record<string | number, TagMapItem> = {
@@ -568,7 +614,7 @@ export const renderMyStatus = (v: string | number | null | undefined) =>
   renderTagNode(v, MY_STATUS_MAP);
 
 // ── 安装 ──────────────────────────────────────────────────────────────────────
-export function install${capitalize(name)}Preset(): void {
+export function install${symbol}Preset(): void {
   registerColumnAutoMaps({
     myStatus: {
       width: 90,
@@ -578,13 +624,22 @@ export function install${capitalize(name)}Preset(): void {
   });
 }
 `;
+  if (dryRun) {
+    console.log(`[wl-ui add-preset] [DRY-RUN] 将创建：${outPath}`);
+    return;
+  }
+  mkdirSync(dirname(outPath), { recursive: true });
   writeFileSync(outPath, template, "utf8");
   console.log(`[wl-ui add-preset] ✔ 创建预设文件：${outPath}`);
-  console.log(`  在 main.ts 中引入：install${capitalize(name)}Preset()`);
+  console.log(`  在 main.ts 中引入并调用：install${symbol}Preset()`);
 }
 
-function capitalize(s) {
-  return s.charAt(0).toUpperCase() + s.slice(1);
+function toPascalCase(value) {
+  return value
+    .split("-")
+    .filter(Boolean)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join("");
 }
 
 /** 根据 tag 名推断 vendor family（jh / base / c / ag-grid / custom） */
@@ -1023,6 +1078,8 @@ wl-ui — @agile-team/wl-skills-ui 统一 CLI v${PKG.version}
   wl-ui scan   --target <src> [--layer L0,L1,L2] [--vendor base-table,jh]
                               [--mode skin|native] [--outFile report.md]
                               [--exempt <config.json>]
+  wl-ui audit  --target <src> [--output json] [--refresh-baseline]
+                scan 的只读审计别名；可显式刷新项目问题基线
   wl-ui check  --project <项目根目录>
   wl-ui fix    --target <src目录> [--dry-run] [--no-snapshot]
   wl-ui all    --project <项目根目录> [--outFile report.md]
@@ -1031,8 +1088,11 @@ wl-ui — @agile-team/wl-skills-ui 统一 CLI v${PKG.version}
   wl-ui snapshot rollback [--id <id>] [--dry-run]  回退到快照（默认最新）
   wl-ui snapshot diff     [--id <id>]              查看快照与当前差异
   wl-ui snapshot clean    [--keep <N>]             清理旧快照
+  wl-ui drift --baseline <基线.json> --current <当前.json> [--fail-on-error]
+  wl-ui exempt init --project . --target src        生成豁免候选，需人工确认
 
-  wl-ui add-preset <name>   脚手架一个新的业务预设文件
+  wl-ui add-preset <name> [--project .] [--output src/wl-ui/presets] [--dry-run]
+                           在消费项目内脚手架业务预设文件
   wl-ui add-vendor <tag> [--family <id>] [--dry-run]
                            脚手架新 vendor 专项覆盖（SCSS + scanner 草稿 + vendors.json 注册）
 

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.7.0` | 已对齐 jh-ui 3.1.0 + EP 2.2.6-prod.3 的 DOM 假设 |
+| `@agile-team/wl-skills-ui` | `^1.9.0` | 已对齐 jh-ui 3.1.0 + EP 2.2.6-prod.3 的 DOM 假设 |
 
 ## 项目集群当前实测
 

package/docs/delivery-compatibility.md

@@ -0,0 +1,31 @@
+# 独立闭环与可选协同
+
+`wl-skills-ui` 是独立的 UI 工程包。它不要求业务项目安装 `wl-skills-design`、`wl-skills-kit` 或 `wl-skills-bd`，也不读取后端生成结果才能工作。
+
+## 独立闭环
+
+```text
+项目源码 → check/doctor → audit/scan → fix dry-run
+        → 自动快照 + fix → 自动复检 → 人工语义修复
+        → drift gate → snapshot rollback（需要时）
+```
+
+- `check/doctor` 验证接入、版本配对和样式入口。
+- `audit/scan` 只读输出结构化问题与覆盖率。
+- `fix` 只处理 `standards/rules.json` 明确标记的安全修复项，结束后自动复检。
+- 快照失败时不写代码；回退拒绝项目外路径。
+- `drift` 允许存量项目冻结历史欠债，只阻断新增污染。
+
+## 与 kit 的天然协同
+
+如果项目同时使用 `wl-skills-kit`，双方只共享稳定约定，不建立包依赖：
+
+- kit 的 `page-spec.mode` 对应 UI 的 list-page、tree-list、form-dialog、detail-page 等布局语义。
+- `platformComponents` 可用于选择 BaseTable、jh-*、Element Plus 等 vendor 规则，但 UI scanner 最终仍以实际源码为准。
+- kit 负责业务代码结构、API 契约和页面完整性；UI 负责 token、视觉规则、组件族和样式回归，两者验证结果互不替代。
+
+没有 page-spec 时，UI 通过源码、依赖和 DOM/组件族检测建立自己的审计上下文，能力不降级为“必须等待上游”。
+
+## 非僵化原则
+
+大屏、地图、流程设计器等特殊页面可以通过 `.wl-exempt.json` 做路径级或规则级豁免。豁免必须有原因、纳入版本控制并定期收敛；新增业务不能默认进入豁免区。

package/docs/governance-long-term.md

@@ -23,22 +23,22 @@
 
 ```bash
 # 在主干分支建立基线（团队第一次接入时执行一次）
-npx wl-ui audit --target src --output json --outFile .wl-baseline.json
+npx wl-ui audit --target src --refresh-baseline
 git add .wl-baseline.json && git commit -m "chore: wl-ui baseline snapshot"
 ```
 
-`.wl-baseline.json` 记录当前所有违规条目的 `(file, line, ruleId)` 指纹。后续：
+`.wl-baseline.json` 记录当前违规条目；漂移指纹使用 `(file, ruleId)` 和同类问题数量，行号变化不会制造假漂移。后续：
 
 ```bash
 # PR 检查（仅报新增违规）
-npx wl-ui scan --target src --baseline .wl-baseline.json --fail-on=new-issues
+npx wl-ui scan --target src --baseline .wl-baseline.json --fail-on-error
 ```
 
 - **历史条目不再阻塞构建**（团队按计划逐步消化）
 - **新代码引入新违规 → 立即红灯**
 - 团队修复历史条目后跑 `npx wl-ui audit --refresh-baseline` 收敛基线
 
-> 实现入口：`scanner/snapshot.mjs` 已具备文件级快照能力，issue 级 baseline 在 v1.8.0 起以 `audit --output json` 输出为契约，业务项目可自行 diff。
+> 实现入口：`audit --refresh-baseline` 生成问题基线，`scanner/drift.mjs` 负责增量比对；`scanner/snapshot.mjs` 是自动修复前的文件级回退快照，两种快照职责不同。
 
 ---
 
@@ -168,7 +168,7 @@ pnpm add -D @agile-team/wl-skills-ui
 npx wl-ui init --project . --mode skin
 
 # 3. 基线
-npx wl-ui audit --target src --outFile .wl-baseline.json --output json
+npx wl-ui audit --target src --refresh-baseline
 git add .wl-baseline.json
 
 # 4. 豁免（如有）
@@ -176,7 +176,7 @@ cp node_modules/@agile-team/wl-skills-ui/.wl-exempt.example.json .wl-exempt.json
 # 编辑为本项目实际豁免路径
 
 # 5. CI 加 PR gate
-#   npx wl-ui scan --target src --baseline .wl-baseline.json --fail-on=new-issues
+#   npx wl-ui scan --target src --baseline .wl-baseline.json --fail-on-error
 
 # 6. 每季度 / 每次升级
 npx wl-ui doctor --print-overrides     # 版本对齐

package/docs/team-intro.md

@@ -159,7 +159,7 @@ AI 会按照 6 个阶段依次执行：接入 tokens → 引入 skin preset →
 pnpm add @agile-team/wl-skills-ui
 ```
 
-要求：Node ≥ 18，Vue ≥ 3.2，Element Plus ≥ 2.2
+要求：Node ≥ 22，Vue ≥ 3.2，Element Plus ≥ 2.2
 
 NPM：[@agile-team/wl-skills-ui](https://www.npmjs.com/package/@agile-team/wl-skills-ui)
 

package/es/index.d.ts

@@ -29,4 +29,46 @@ declare function clearColumnAutoMap(name?: string): void;
  */
 declare function defineColumns<T extends ColumnLike>(columns: T[]): T[];
 
-export { ColumnLike, clearColumnAutoMap, defineColumns, getColumnAutoMap, registerColumnAutoMap, registerColumnAutoMaps };
+/**
+ * runtime/presets/registry.ts — 预设注册系统
+ *
+ * 允许各业务模块通过 installPreset() 向 COLUMN_AUTO_MAP 注入字段映射，
+ * 实现"按需安装、互不干扰"的插件化架构。
+ *
+ * 使用方式：
+ *   import { createPreset } from '@agile-team/wl-skills-ui/runtime';
+ *   const myPreset = createPreset('my-biz', () => {
+ *     registerColumnAutoMaps({ myField: { ... } });
+ *   });
+ *   myPreset.install();
+ */
+
+interface PresetConfig {
+    /** 预设名称（唯一标识） */
+    name: string;
+    /** 列字段映射 */
+    columns: Record<string, Partial<ColumnLike>>;
+    /** 安装钩子（可选，注册后执行一次） */
+    onInstall?: () => void;
+}
+/**
+ * 安装一个预设：把 columns 批量注册进 COLUMN_AUTO_MAP
+ * 重复安装同名预设时自动跳过（幂等）
+ */
+declare function installPreset(config: PresetConfig): void;
+/**
+ * 工厂：创建一个可延迟安装的预设对象
+ *
+ * @example
+ * const safePreset = createPreset({ name: 'safe', columns: { riskLevel: { ... } } });
+ * safePreset.install();   // 按需调用
+ */
+declare function createPreset(config: PresetConfig): {
+    name: string;
+    install: () => void;
+    isInstalled: () => boolean;
+};
+/** 获取已安装预设名称列表（调试用） */
+declare function getInstalledPresets(): ReadonlySet<string>;
+
+export { ColumnLike, type PresetConfig, clearColumnAutoMap, createPreset, defineColumns, getColumnAutoMap, getInstalledPresets, installPreset, registerColumnAutoMap, registerColumnAutoMaps };

package/es/index.js

@@ -1 +1,23 @@
+import { registerColumnAutoMaps } from './chunk-FMVZ54BY.js';
 export { AUDIT_STATUS_MAP, ENABLE_STATUS_MAP, RATING_LEVEL_COLORS, VERIFY_STATUS_MAP, clearColumnAutoMap, defineColumns, getColumnAutoMap, registerColumnAutoMap, registerColumnAutoMaps, registerDictColorMap, registerDictColorMaps, renderAuditStatus, renderBadge, renderClassifyTag, renderCountBadge, renderDangerText, renderDictClassifyTag, renderEnableStatus, renderOps, renderRatingLevel, renderTagNode, renderTagSlot, renderVerifyStatus, setDictResolver } from './chunk-FMVZ54BY.js';
+
+// runtime/presets/registry.ts
+var _installedPresets = /* @__PURE__ */ new Set();
+function installPreset(config) {
+  if (_installedPresets.has(config.name)) return;
+  registerColumnAutoMaps(config.columns);
+  config.onInstall?.();
+  _installedPresets.add(config.name);
+}
+function createPreset(config) {
+  return {
+    name: config.name,
+    install: () => installPreset(config),
+    isInstalled: () => _installedPresets.has(config.name)
+  };
+}
+function getInstalledPresets() {
+  return _installedPresets;
+}
+
+export { createPreset, getInstalledPresets, installPreset };

package/examples/migration-operations-to-renderOps.md

@@ -62,12 +62,12 @@ const columnsDef = [
 
 | type | 图标 | 标题 | 颜色 |
 |---|---|---|---|
-| `view` | Eye (View) | 查看 | 蓝色 |
-| `edit` | Edit | 编辑 | 绿色 |
-| `del` | Delete | 删除 | 红色 |
-| `log` | Document | 记录 | 灰色 |
-| `ok` | CircleCheck | 审核 | 绿色 |
-| `send` | Upload | 提交 | 蓝色 |
+| `view` | Eye (View) | 查看 | 默认主题淡蓝，hover 蓝色 |
+| `edit` | Edit | 编辑 | 默认主题淡蓝，hover 绿色 |
+| `del` | Delete | 删除 | 默认主题淡蓝，hover 红色 |
+| `log` | Document | 记录 | 默认主题淡蓝，hover 蓝色 |
+| `ok` | CircleCheck | 审核 | 默认主题淡蓝，hover 绿色 |
+| `send` | Upload | 提交 | 默认主题淡蓝，hover 蓝色 |
 
 ## 非预设操作（胶囊/文字）
 

package/package.json

@@ -1,15 +1,19 @@
 {
   "name": "@agile-team/wl-skills-ui",
-  "version": "1.8.16",
+  "version": "1.9.0",
   "description": "企业级 UI 风格对齐框架 — Vue + Element Plus 项目通用化妆/原生双模式（tokens / element / vendors / layouts / runtime / scanner / fixer / skills）",
   "type": "module",
   "main": "./es/index.js",
+  "types": "./es/index.d.ts",
   "exports": {
     ".": {
       "import": "./es/index.js",
       "types": "./es/index.d.ts"
     },
-    "./runtime": "./",
+    "./runtime": {
+      "import": "./es/index.js",
+      "types": "./es/index.d.ts"
+    },
     "./runtime/common-preset": {
       "import": "./es/common-preset.js",
       "types": "./es/common-preset.d.ts"
@@ -18,7 +22,6 @@
       "import": "./es/presets/security.js",
       "types": "./es/presets/security.d.ts"
     },
-    "./runtime/presets/*": "./runtime/presets/*",
     "./vite": "./runtime/vite/check.mjs",
     "./styles": "./styles/index.scss",
     "./styles/*": "./styles/*",
@@ -41,7 +44,7 @@
     "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",
+    "test": "node --test scanner/__tests__/*.test.mjs",
     "check:scss": "node scripts/check-scss.mjs",
     "docs:check": "node scripts/check-docs.mjs",
     "scan": "node scanner/index.mjs scan",
@@ -50,13 +53,19 @@
     "all": "node scanner/index.mjs all",
     "standards:init": "npx @robot-admin/git-standards init",
     "cz": "git-cz",
-    "lint": "eslint ."
+    "lint": "eslint . --max-warnings 0",
+    "verify:package": "node scripts/verify-package.mjs",
+    "verify": "npm run lint && npm test && npm run check:scss && npm run docs:check && npm run build && npm run verify:package",
+    "pack:dry": "npm pack --dry-run --ignore-scripts",
+    "release:check": "npm run verify && npm pack --dry-run --ignore-scripts",
+    "prepublishOnly": "npm run verify"
   },
   "files": [
     "dist",
     "es",
     "runtime/vite",
-    "scanner",
+    "scanner/*.mjs",
+    "scanner/rules",
     "standards",
     "styles",
     "design",
@@ -64,7 +73,6 @@
     "skills",
     "templates",
     "bin",
-    "scripts",
     "mcp",
     "reference",
     "examples",
@@ -105,7 +113,7 @@
     }
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "keywords": [
     "vue",

package/reference/ag-cell-renders.ts

@@ -382,7 +382,7 @@ export function renderRatingLevel(
 
 /**
  * 内置图标预设（type: 'view' | 'edit' | 'del'）
- * 渲染为 26×26px 纯图标按钮，默认灰色，hover 变语义色
+ * 渲染为 26×26px 纯图标按钮，默认主题淡蓝，hover 变语义色
  */
 const ICON_PRESETS = {
   view: { icon: View, cls: "jh-op-view", title: "查看" },
@@ -429,7 +429,7 @@ export type OpItem = OpPreset | OpChip | OpLink;
  * 渲染操作列按钮组（三层系统）
  *
  * 第一层 — 纯图标按钮（type: 'view'|'edit'|'del'|'log'|'ok'|'send'）
- *   26×26px，默认灰色，hover 变语义色，tooltip 兜底
+ *   26×26px，默认主题淡蓝，hover 变语义色，tooltip 兜底
  *
  * 第二层 — 胶囊按钮（type: 'chip'）
  *   圆角胶囊，图标+文字，hover 淡蓝背景 + 主色文字