@agile-team/wl-skills-ui 1.6.9 → 1.6.12

package/CHANGELOG.md

@@ -4,6 +4,37 @@ 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.6.12] - 2026-05-12
+
+### Fixed
+
+- 修复表单 label 单行省略样式覆盖后，必填星号、错误 label、错误提示和错误边框红色态不明显的问题。
+
+## [1.6.11] - 2026-05-11
+
+### Changed
+
+- 优化 BaseToolbar 下拉/分裂按钮组样式，统一高度、圆角、间距和下拉菜单 hover 可读性。
+- 优化 AG Grid 操作列内 `jh-op-*` 操作按钮，取消 active 缩放并提升选中行可读性。
+- 补齐输入控件 focus 品牌色边框、统一圆角、长表单 label 单行省略和弹窗图标居中尺寸规则。
+
+## [1.6.10] - 2026-05-11
+
+### Removed
+
+- 移除所有 `wk-skills-ui` / `wk-ui` / `wk-scan` / `wks_ui_*` / `.wk-snapshot` / `wk-exempt` 旧命名（运行时、注释、文档、headers、MCP 工具名、scanner、styles），未来不再兼容旧前缀。
+- `examples/wk-exempt.example.json` 重命名为 `examples/wl-exempt.example.json`。
+
+### Added
+
+- 新增 vendor 单一事实源 `skills/_meta/_compat/vendors.json`，承载 Base / jh / C / AG Grid / custom 的 id、priority、patterns、baseline、styles。`scanner/coverage.mjs` 启动时一次性 parse + 编译 RegExp，长生命周期复用，零运行时性能开销。
+- 新增 CLI 子命令 `wl-ui add-vendor <tag> [--family <id>] [--dry-run]`，一键生成专项 SCSS、`@forward` 注册、vendors.json baseline 追加、scanner 规则草稿。
+- `npm run docs:check` 扩展校验范围至 `.md/.mjs/.js/.ts/.scss/.css/.txt/.json/.vue`，新增 `wk-scan` / `.wk-snapshot` / `wk-exempt` / `wks_ui_` 禁忌词、vendor 优先级一致性、`jh-components` SKILL 全量通配语义校验。
+
+### Changed
+
+- MCP 工具前缀统一为 `wl_ui_*`（原 `wks_ui_*`），server name 同步为 `wl-skills-ui`。
+
 ## [1.6.9] - 2026-05-11
 
 ### Changed

package/README.md

@@ -193,7 +193,19 @@ yarn add @agile-team/wl-skills-ui
 
 ## 版本亮点
 
-当前 v1.6.9 版本重点强化“统一规则源 + 多编辑器分发 + 项目集群封装必覆盖 + UI 细节精准修复”的闭环：
+当前 v1.6.12 版本继续强化“统一规则源 + 单一事实源 + 项目集群封装必覆盖 + UI 细节精准修复”的闭环，并补齐销售报价页暴露出的通用 UI 细节：
+
+- 修复表单必填星号、错误 label、错误提示和错误边框红色态，避免校验反馈被通用 label/input 样式覆盖
+- 优化 BaseToolbar 下拉/分裂按钮组，让“主动作 + 下拉动作”按一个动作组展示，避免视觉割裂
+- 优化 AG Grid 操作列 `jh-op-*` 图标/胶囊/文字按钮，取消按压缩放抖动，并提升选中行下的可读性
+- 补齐输入控件 focus 品牌色边框、统一圆角、长 label 单行省略和自定义弹窗图标居中尺寸规则
+- 全量移除旧 `wk-` 前缀命名（包名 / CLI / 快照目录 / 豁免配置 / MCP 工具名），不再兼容（详见 CHANGELOG v1.6.10）
+- 新增 `skills/_meta/_compat/vendors.json` 作为 L2 Project Vendors 的单一事实源（id / priority / patterns / baseline / styles），`scanner/coverage.mjs` 启动时一次性编译 RegExp，零运行时开销
+- 新增 `wl-ui add-vendor <tag> [--family <id>] [--dry-run]` 脚手架命令：一键生成专项 SCSS、`@forward` 注册、`vendors.json` baseline 追加、scanner 规则草稿
+- MCP 工具前缀统一为 `wl_ui_*`（`wl_ui_check` / `wl_ui_scan` / `wl_ui_fix_dry_run` / `wl_ui_skill_prompt` / `wl_ui_route_intent` / `wl_ui_recommend_flow`）
+- `npm run docs:check` 扩展到全部代码与文档类型，新增禁忌词、vendor 优先级一致性、`jh-components` 全量通配语义防回归
+
+历史亮点（v1.6.9）：
 
 - `skills/**/*.md` 作为唯一规则源，`wl-ui init/update` 会按编辑器格式转换并覆盖写入目标 rules
 - `skills/_meta/_compat/editors.json` 作为 AI 编辑器安装配置唯一来源，CLI 不再维护第二份编辑器路径映射
@@ -508,20 +520,20 @@ export const myRules = [
 
 | MCP Tool                | 作用                                                       |
 | ----------------------- | ---------------------------------------------------------- |
-| `wks_ui_check`          | 检查 tokens/styles/runtime 接入完整性                      |
-| `wks_ui_scan`           | 扫描 UI 风格偏差，输出 Markdown 或 JSON                    |
-| `wks_ui_fix_dry_run`    | 预览自动修复，不实际写入                                   |
-| `wks_ui_skill_prompt`   | 输出 AI 触发提示                                           |
-| `wks_ui_route_intent`   | 根据自然语言识别 UI 治理意图并推荐 flow/tool/skill         |
-| `wks_ui_recommend_flow` | 根据扫描 JSON 推荐 nextActions 和 `wl-skills-kit` 桥接动作 |
+| `wl_ui_check`          | 检查 tokens/styles/runtime 接入完整性                      |
+| `wl_ui_scan`           | 扫描 UI 风格偏差，输出 Markdown 或 JSON                    |
+| `wl_ui_fix_dry_run`    | 预览自动修复，不实际写入                                   |
+| `wl_ui_skill_prompt`   | 输出 AI 触发提示                                           |
+| `wl_ui_route_intent`   | 根据自然语言识别 UI 治理意图并推荐 flow/tool/skill         |
+| `wl_ui_recommend_flow` | 根据扫描 JSON 推荐 nextActions 和 `wl-skills-kit` 桥接动作 |
 
 推荐智能体流程：
 
 ```text
 用户自然语言
-  → wks_ui_route_intent
-  → wks_ui_scan --output json
-  → wks_ui_recommend_flow
+  → wl_ui_route_intent
+  → wl_ui_scan --output json
+  → wl_ui_recommend_flow
   → 先保证样式统一
   → 如需规范化，再桥接 wl-skills-kit validate-page / doctor-ui
 ```

package/SKILL.md

@@ -25,7 +25,7 @@ npx wl-ui clean --project . --dry-run
 npx wl-ui prompts
 ```
 
-可选编辑器：`github-copilot`、`cursor`、`windsurf`、`kiro`、`trae`、`claude-code`、`cline`、`agents-generic`、`qoder`、`all`。`update` 未指定编辑器时会刷新 manifest 与项目中已存在的编辑器规则目录；修复前优先使用 `--dry-run` 或 MCP 工具 `wks_ui_fix_dry_run`。
+可选编辑器：`github-copilot`、`cursor`、`windsurf`、`kiro`、`trae`、`claude-code`、`cline`、`agents-generic`、`qoder`、`all`。`update` 未指定编辑器时会刷新 manifest 与项目中已存在的编辑器规则目录；修复前优先使用 `--dry-run` 或 MCP 工具 `wl_ui_fix_dry_run`。
 
 
 ## 一、适用场景

package/bin/wl-ui.js

@@ -57,6 +57,7 @@ const SUBCOMMANDS = new Set([
   "fix",
   "all",
   "add-preset",
+  "add-vendor",
   "snapshot",
 ]);
 let subcommand = "help";
@@ -231,6 +232,28 @@ if (subcommand === "add-preset") {
   process.exit(0);
 }
 
+// ── add-vendor ─────────────────────────────────────────────────────────────────
+if (subcommand === "add-vendor") {
+  const tag = rawArgs[0];
+  if (!tag) {
+    console.error(
+      "[wl-ui add-vendor] 请提供 vendor 标签名，例如：wl-ui add-vendor jh-upload --family jh",
+    );
+    process.exit(1);
+  }
+  const { values } = parseArgs({
+    args: rawArgs.slice(1),
+    options: {
+      family: { type: "string", default: "" },
+      "dry-run": { type: "boolean", default: false },
+    },
+    strict: false,
+  });
+  const family = values.family || inferVendorFamily(tag);
+  scaffoldVendor({ tag, family, dryRun: values["dry-run"] });
+  process.exit(0);
+}
+
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 // 工具函数
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -557,6 +580,149 @@ function capitalize(s) {
   return s.charAt(0).toUpperCase() + s.slice(1);
 }
 
+/** 根据 tag 名推断 vendor family（jh / base / c / ag-grid / custom） */
+function inferVendorFamily(tag) {
+  if (/^jh-/i.test(tag)) return "jh";
+  if (/^Base[A-Z]|^base-/.test(tag)) return "base";
+  if (/^C_|^c-/.test(tag)) return "c";
+  if (/ag[-_]?grid/i.test(tag)) return "ag-grid";
+  return "custom";
+}
+
+/** 脚手架新 vendor 专项覆盖：生成 SCSS、scanner 规则草稿、Skill 基线追加 */
+function scaffoldVendor({ tag, family, dryRun }) {
+  const safe = tag.replace(/[^a-zA-Z0-9_-]/g, "-").toLowerCase();
+  const VENDORS_JSON = join(
+    PKG_ROOT,
+    "skills",
+    "_meta",
+    "_compat",
+    "vendors.json",
+  );
+  const SCSS_PATH = join(PKG_ROOT, "styles", "vendors", `_${safe}.scss`);
+  const VENDORS_INDEX = join(PKG_ROOT, "styles", "vendors", "index.scss");
+  const SKILL_DIR = join(
+    PKG_ROOT,
+    "skills",
+    "vendors",
+    family === "jh" ? "jh-components" : `${family}-components`,
+  );
+  const SKILL_FILE = join(SKILL_DIR, "SKILL.md");
+
+  const actions = [];
+
+  // 1) SCSS 模板
+  if (existsSync(SCSS_PATH)) {
+    console.warn(`[wl-ui add-vendor] 已存在，跳过：${SCSS_PATH}`);
+  } else {
+    const scss = `// styles/vendors/_${safe}.scss — ${tag} 专项视觉覆盖
+// family: ${family}
+//
+// 准入条件（详见 standards/architecture/01-layer-boundaries.md）：
+//   - 复杂 DOM / 多 Element Plus 组合
+//   - 默认样式偏离 tokens（颜色/间距/圆角/密度）
+//   - 高频出现于核心页面
+//   - scanner 反复反馈或 AI 修复不稳定
+//
+// 约束：
+//   - 仅使用 design/tokens/base.css 中的 CSS 变量
+//   - 不写死颜色/间距/圆角；不污染全局选择器
+//   - 选择器范围必须收敛到 .${safe}__root 或 ${tag} 标签
+
+.${safe},
+${tag} {
+  // TODO: 用 var(--el-*) / var(--wl-*) tokens 替换硬编码
+}
+`;
+    actions.push({ type: "create", path: SCSS_PATH, content: scss });
+  }
+
+  // 2) styles/vendors/index.scss 追加 @forward
+  const idx = readFileSync(VENDORS_INDEX, "utf8");
+  if (!idx.includes(`'./_${safe}'`) && !idx.includes(`"./_${safe}"`)) {
+    const insertLine = `@forward './_${safe}';            // ${tag} 专项覆盖（${family}）\n`;
+    const anchor = "@forward './_base-table';";
+    const next = idx.includes(anchor)
+      ? idx.replace(anchor, insertLine + anchor)
+      : idx + "\n" + insertLine;
+    actions.push({ type: "update", path: VENDORS_INDEX, content: next });
+  }
+
+  // 3) vendors.json baseline 追加
+  const reg = JSON.parse(readFileSync(VENDORS_JSON, "utf8"));
+  const entry = reg.vendors.find((v) => v.id === family);
+  if (entry && !entry.baseline.includes(tag)) {
+    entry.baseline.push(tag);
+    if (!entry.styles.includes(`_${safe}.scss`))
+      entry.styles.push(`_${safe}.scss`);
+    actions.push({
+      type: "update",
+      path: VENDORS_JSON,
+      content: JSON.stringify(reg, null, 2) + "\n",
+    });
+  }
+
+  // 4) Skill 文档代表性基线追加（仅 jh family 自动追加，其它给提示）
+  if (family === "jh" && existsSync(SKILL_FILE)) {
+    const skill = readFileSync(SKILL_FILE, "utf8");
+    if (!skill.includes(tag)) {
+      const hint = `\n<!-- add-vendor: 建议在「代表性基线」表中补充一行 ${tag} -->\n`;
+      actions.push({ type: "update", path: SKILL_FILE, content: skill + hint });
+    }
+  }
+
+  // 5) scanner 规则草稿（仅生成模板，不强制注册）
+  const RULE_PATH = join(
+    PKG_ROOT,
+    "scanner",
+    "rules",
+    `vendor-${safe}.draft.mjs`,
+  );
+  if (!existsSync(RULE_PATH)) {
+    const rule = `/**
+ * scanner/rules/vendor-${safe}.draft.mjs — ${tag} 专项规则草稿
+ *
+ * 启用方式：
+ *   1) 改名为 vendor-${safe}.mjs
+ *   2) 在 scanner/rules/index.mjs 中 import 并 push 到 BUILT_IN_RULES
+ */
+export const ${safe.replace(/-/g, "_")}Rules = [
+  {
+    id: "V-${safe.toUpperCase()}-001",
+    category: "vendor",
+    severity: "warning",
+    description: "${tag} 视觉应统一覆盖到 tokens（草稿规则）",
+    check(ctx) {
+      // ctx: { file, content, addIssue(...) }
+      // TODO: 实现检测逻辑
+      return [];
+    },
+  },
+];
+`;
+    actions.push({ type: "create", path: RULE_PATH, content: rule });
+  }
+
+  // 执行 / 预览
+  for (const act of actions) {
+    const rel = relative(PKG_ROOT, act.path).replace(/\\/g, "/");
+    if (dryRun) {
+      console.log(`[dry-run] ${act.type}: ${rel}`);
+    } else {
+      writeFileSync(act.path, act.content, "utf8");
+      console.log(`[wl-ui add-vendor] ${act.type}: ${rel}`);
+    }
+  }
+  if (actions.length === 0) {
+    console.log("[wl-ui add-vendor] 无变更（已存在）");
+  } else if (!dryRun) {
+    console.log("\n下一步：");
+    console.log(`  1. 编辑 styles/vendors/_${safe}.scss 用 tokens 覆盖样式`);
+    console.log("  2. 如需检测规则，把 vendor-*.draft.mjs 改名并在 rules/index.mjs 注册");
+    console.log("  3. 运行 npm run docs:check && npm run lint && npm run build");
+  }
+}
+
 function installSupportFiles({ projectRoot, dryRun }) {
   const files = [
     {
@@ -604,9 +770,9 @@ function triggerPrompts() {
 
 ## 智能触发
 
-- 用户说"样式乱 / 不统一 / 老项目化妆"：先调用 wks_ui_route_intent，再调用 wks_ui_scan --mode skin
+- 用户说"样式乱 / 不统一 / 老项目化妆"：先调用 wl_ui_route_intent，再调用 wl_ui_scan --mode skin
 - 用户说"卡片 / Tab / 详情 / 树 / 抽屉 / 上传 / 步骤条 / 更多操作"：触发对应 Element Plus 组件族 skill
-- 扫描 JSON 返回后：调用 wks_ui_recommend_flow 判断 recommendedFlows、nextActions 和 kitBridge
+- 扫描 JSON 返回后：调用 wl_ui_recommend_flow 判断 recommendedFlows、nextActions 和 kitBridge
 
 ## 单点触发
 
@@ -625,7 +791,7 @@ function triggerPrompts() {
 
 - 扫描只读，修复前必须等待用户确认
 - skin 模式只处理 L0/L1/L2，不改业务布局和 runtime
-- fix 前建议先 dry-run 或通过 MCP 调用 wks_ui_fix_dry_run
+- fix 前建议先 dry-run 或通过 MCP 调用 wl_ui_fix_dry_run
 - 涉及 BaseTable render-type/cid、renderOps 或页面结构规范时，视觉统一后再桥接 wl-skills-kit validate-page / doctor-ui
 `;
 }
@@ -825,6 +991,8 @@ wl-ui — @agile-team/wl-skills-ui 统一 CLI v${PKG.version}
   wl-ui snapshot clean    [--keep <N>]             清理旧快照
 
   wl-ui add-preset <name>   脚手架一个新的业务预设文件
+  wl-ui add-vendor <tag> [--family <id>] [--dry-run]
+                           脚手架新 vendor 专项覆盖（SCSS + scanner 草稿 + vendors.json 注册）
 
 参数：
   --project       项目根目录（默认 .）
@@ -833,7 +1001,7 @@ wl-ui — @agile-team/wl-skills-ui 统一 CLI v${PKG.version}
                   scan: skin(只看L0/L1/L2) | native(全量)
   --layer         scan 过滤：L0/L1/L2/L3/L4（逗号分隔）
   --vendor        scan 过滤：element/base-table/jh-components/...（逗号分隔）
-  --exempt        豁免配置文件路径（默认 .wk-exempt.json）
+  --exempt        豁免配置文件路径（默认 .wl-exempt.json）
   --dry-run       预览模式，不实际写入文件
   --no-snapshot   fix 时跳过快照创建
   --skills-only   仅安装 skill 文件，不处理 index.html

package/design/tokens/index.css

@@ -1,7 +1,7 @@
 /* design/tokens/index.css — 设计系统 Token 入口
  *
  * 在 index.html 中最先加载：
- *   <link rel="stylesheet" href="/node_modules/@agile-team/wk-skills-ui/design/tokens/index.css" />
+ *   <link rel="stylesheet" href="/node_modules/@agile-team/wl-skills-ui/design/tokens/index.css" />
  *
  * 注意：dist/tokens.css 保留用于兼容旧版本引用路径，内容与此文件相同。
  */

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

@@ -98,10 +98,10 @@ Scanner 规则 R013 会自动检测旧格式 `operations: [...]`。
 
 ```bash
 # 扫描所有旧格式
-npx wk-scan scan --target src --layer L4
+npx wl-scan scan --target src --layer L4
 
 # 查看影响文件
-npx wk-scan scan --target src --output json | jq '.issues[] | select(.rule == "R013") | .file'
+npx wl-scan scan --target src --output json | jq '.issues[] | select(.rule == "R013") | .file'
 ```
 
 > 注意：operations → renderOps 不可自动修复，需要人工确认每个操作的图标类型和回调。

package/mcp/server.js

@@ -12,9 +12,9 @@ const PKG = require("../package.json");
 
 const TOOLS = [
   {
-    name: "wks_ui_check",
+    name: "wl_ui_check",
     description:
-      "检查当前项目是否已正确接入 @agile-team/wk-skills-ui 的 tokens/styles/runtime。",
+      "检查当前项目是否已正确接入 @agile-team/wl-skills-ui 的 tokens/styles/runtime。",
     inputSchema: {
       type: "object",
       properties: {
@@ -27,7 +27,7 @@ const TOOLS = [
     },
   },
   {
-    name: "wks_ui_scan",
+    name: "wl_ui_scan",
     description:
       "扫描 Vue 项目的 UI 风格偏差，支持 skin/native、layer、vendor、exempt 过滤。",
     inputSchema: {
@@ -51,8 +51,8 @@ const TOOLS = [
     },
   },
   {
-    name: "wks_ui_fix_dry_run",
-    description: "预览 wk-skills-ui 自动修复会修改哪些文件，不实际写入。",
+    name: "wl_ui_fix_dry_run",
+    description: "预览 wl-skills-ui 自动修复会修改哪些文件，不实际写入。",
     inputSchema: {
       type: "object",
       properties: {
@@ -66,15 +66,15 @@ const TOOLS = [
     },
   },
   {
-    name: "wks_ui_skill_prompt",
+    name: "wl_ui_skill_prompt",
     description:
-      "输出 wk-skills-ui 推荐触发语和下一步操作，引导 AI 加载正确 Skill/Flow。",
+      "输出 wl-skills-ui 推荐触发语和下一步操作，引导 AI 加载正确 Skill/Flow。",
     inputSchema: { type: "object", properties: {}, required: [] },
   },
   {
-    name: "wks_ui_route_intent",
+    name: "wl_ui_route_intent",
     description:
-      "根据用户自然语言判断 UI 样式治理意图，并推荐 wk-skills-ui flow/tool/skill。",
+      "根据用户自然语言判断 UI 样式治理意图，并推荐 wl-skills-ui flow/tool/skill。",
     inputSchema: {
       type: "object",
       properties: {
@@ -84,9 +84,9 @@ const TOOLS = [
     },
   },
   {
-    name: "wks_ui_recommend_flow",
+    name: "wl_ui_recommend_flow",
     description:
-      "根据 wks_ui_scan --output json 的扫描结果推荐后续 flow、tool 和 wl-skills-kit 桥接动作。",
+      "根据 wl_ui_scan --output json 的扫描结果推荐后续 flow、tool 和 wl-skills-kit 桥接动作。",
     inputSchema: {
       type: "object",
       properties: {
@@ -143,14 +143,14 @@ function runScanner(command, args = {}) {
 }
 
 function skillPrompt() {
-  return "# wk-skills-ui Skill 触发提示\n\n核心原则：wk-skills-ui 优先保证样式绝对管控，覆盖纯 Element Plus、老项目封装、Base*/jh*/C_* 以及 wl-skills-kit 最佳写法。\n\n推荐触发语：\n\n- 新项目：用 wk-ui 的 new-project-init 流程接入统一 UI 风格\n- 老项目：用 wk-ui 的 legacy-skin-align 流程做老项目化妆对齐\n- 只审计：用 wk-ui 的 full-audit 流程扫描当前项目，不修改代码\n- 渐进迁移：用 wk-ui 的 progressive-migrate 流程从 skin 迁移到 runtime\n- 表格/弹窗/卡片/Tab/详情/树/抽屉/上传/步骤条/更多操作样式不统一：先调用 wks_ui_route_intent，再调用 wks_ui_scan\n- 单点修复：用 wk-ui 的 vendors/base-table、element/el-table 或 element 组件族 skill 检查当前文件\n\n执行约束：\n\n- 扫描只读，修复前必须先给用户摘要并等待确认\n- 老项目 skin 模式只处理 L0/L1/L2，不改业务布局和 runtime\n- 若扫描结果涉及页面结构、BaseTable render-type/cid 或 renderOps，视觉统一后再建议 wl-skills-kit validate-page / doctor-ui。";
+  return "# wl-skills-ui Skill 触发提示\n\n核心原则：wl-skills-ui 优先保证样式绝对管控，覆盖纯 Element Plus、老项目封装、Base*/jh*/C_* 以及 wl-skills-kit 最佳写法。\n\n推荐触发语：\n\n- 新项目：用 wl-ui 的 new-project-init 流程接入统一 UI 风格\n- 老项目：用 wl-ui 的 legacy-skin-align 流程做老项目化妆对齐\n- 只审计：用 wl-ui 的 full-audit 流程扫描当前项目，不修改代码\n- 渐进迁移：用 wl-ui 的 progressive-migrate 流程从 skin 迁移到 runtime\n- 表格/弹窗/卡片/Tab/详情/树/抽屉/上传/步骤条/更多操作样式不统一：先调用 wl_ui_route_intent，再调用 wl_ui_scan\n- 单点修复：用 wl-ui 的 vendors/base-table、element/el-table 或 element 组件族 skill 检查当前文件\n\n执行约束：\n\n- 扫描只读，修复前必须先给用户摘要并等待确认\n- 老项目 skin 模式只处理 L0/L1/L2，不改业务布局和 runtime\n- 若扫描结果涉及页面结构、BaseTable render-type/cid 或 renderOps，视觉统一后再建议 wl-skills-kit validate-page / doctor-ui。";
 }
 
 function routeIntent(args = {}) {
   const text = String(args.text || "").toLowerCase();
   const matchedComponents = [];
   const recommendedSkills = [];
-  const recommendedTools = ["wks_ui_scan"];
+  const recommendedTools = ["wl_ui_scan"];
   let intent = "full-audit";
   let recommendedFlow = "full-audit";
 
@@ -196,14 +196,14 @@ function routeIntent(args = {}) {
   if (/老项目|旧项目|样式乱|不统一|化妆|统一视觉|skin/.test(text)) {
     intent = "legacy-skin-align";
     recommendedFlow = "legacy-skin-align";
-    recommendedTools.push("wks_ui_fix_dry_run");
+    recommendedTools.push("wl_ui_fix_dry_run");
   } else if (/迁移|runtime|token|硬编码|颜色/.test(text)) {
     intent = "progressive-migrate";
     recommendedFlow = "progressive-migrate";
   } else if (/新项目|初始化|接入/.test(text)) {
     intent = "new-project-init";
     recommendedFlow = "new-project-init";
-    recommendedTools.unshift("wks_ui_check");
+    recommendedTools.unshift("wl_ui_check");
   }
 
   const shouldUseKit =
@@ -218,11 +218,11 @@ function routeIntent(args = {}) {
     recommendedTools: [...new Set(recommendedTools)],
     shouldUseKit,
     nextActions: [
-      "先执行 wks_ui_scan 做只读扫描，确认 componentCoverage 与 issues",
-      "如需修复，先执行 wks_ui_fix_dry_run 预览，不直接写入",
+      "先执行 wl_ui_scan 做只读扫描，确认 componentCoverage 与 issues",
+      "如需修复，先执行 wl_ui_fix_dry_run 预览，不直接写入",
       shouldUseKit
         ? "若要规范化页面结构，再桥接 wl-skills-kit validate-page / doctor-ui"
-        : "优先由 wk-skills-ui skin/native 样式层完成视觉统一",
+        : "优先由 wl-skills-ui skin/native 样式层完成视觉统一",
     ],
   };
 }
@@ -244,7 +244,7 @@ function buildKitBridge(needed) {
     needed,
     reason: needed
       ? "扫描结果涉及页面结构、BaseTable 或操作列规范，建议视觉统一后桥接 wl-skills-kit。"
-      : "当前由 wk-skills-ui 负责样式绝对管控即可，不强制桥接 wl-skills-kit。",
+      : "当前由 wl-skills-ui 负责样式绝对管控即可，不强制桥接 wl-skills-kit。",
     commands: needed
       ? ["wl-skills validate-page <page>", "wl-skills doctor-ui <project>"]
       : [],
@@ -267,7 +267,7 @@ function recommendFromScan(args = {}) {
     nextActions.add(
       "先用 skin/native 样式层完成视觉统一，再判断是否需要代码级修复",
     );
-    nextActions.add("修复前调用 wks_ui_fix_dry_run 并向用户展示摘要");
+    nextActions.add("修复前调用 wl_ui_fix_dry_run 并向用户展示摘要");
   } else {
     recommendedFlows.add("full-audit");
     nextActions.add("当前扫描未发现规则问题，建议保留周期性 full-audit");
@@ -276,7 +276,7 @@ function recommendFromScan(args = {}) {
   if (categories.has("color") || categories.has("token")) {
     recommendedFlows.add("progressive-migrate");
     nextActions.add(
-      "硬编码色值应迁移为 wk-skills-ui tokens 或 Element Plus 变量",
+      "硬编码色值应迁移为 wl-skills-ui tokens 或 Element Plus 变量",
     );
   }
 
@@ -288,8 +288,8 @@ function recommendFromScan(args = {}) {
     componentCoverage: coverage,
     recommendedTools:
       issues.length > 0
-        ? ["wks_ui_scan", "wks_ui_fix_dry_run"]
-        : ["wks_ui_scan"],
+        ? ["wl_ui_scan", "wl_ui_fix_dry_run"]
+        : ["wl_ui_scan"],
     kitBridge: buildKitBridge(shouldUseKit),
     nextActions: [...nextActions].sort(),
   };
@@ -297,7 +297,7 @@ function recommendFromScan(args = {}) {
 
 async function dispatchTool(id, name, args) {
   try {
-    if (name === "wks_ui_check") {
+    if (name === "wl_ui_check") {
       const result = await runScanner("check", args);
       sendResult(id, {
         content: [{ type: "text", text: result.text }],
@@ -305,7 +305,7 @@ async function dispatchTool(id, name, args) {
       });
       return;
     }
-    if (name === "wks_ui_scan") {
+    if (name === "wl_ui_scan") {
       const result = await runScanner("scan", args);
       sendResult(id, {
         content: [{ type: "text", text: result.text }],
@@ -313,7 +313,7 @@ async function dispatchTool(id, name, args) {
       });
       return;
     }
-    if (name === "wks_ui_fix_dry_run") {
+    if (name === "wl_ui_fix_dry_run") {
       const result = await runScanner("fix", args);
       sendResult(id, {
         content: [{ type: "text", text: result.text }],
@@ -321,11 +321,11 @@ async function dispatchTool(id, name, args) {
       });
       return;
     }
-    if (name === "wks_ui_skill_prompt") {
+    if (name === "wl_ui_skill_prompt") {
       sendResult(id, { content: [{ type: "text", text: skillPrompt() }] });
       return;
     }
-    if (name === "wks_ui_route_intent") {
+    if (name === "wl_ui_route_intent") {
       sendResult(id, {
         content: [
           { type: "text", text: JSON.stringify(routeIntent(args), null, 2) },
@@ -333,7 +333,7 @@ async function dispatchTool(id, name, args) {
       });
       return;
     }
-    if (name === "wks_ui_recommend_flow") {
+    if (name === "wl_ui_recommend_flow") {
       sendResult(id, {
         content: [
           {
@@ -379,7 +379,7 @@ process.stdin.on("data", (chunk) => {
       sendResult(id, {
         protocolVersion: "2024-11-05",
         capabilities: { tools: {} },
-        serverInfo: { name: "wk-skills-ui", version: PKG.version },
+        serverInfo: { name: "wl-skills-ui", version: PKG.version },
       });
     } else if (method === "tools/list") {
       sendResult(id, { tools: TOOLS });

package/package.json

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

package/scanner/coverage.mjs

@@ -1,3 +1,34 @@
+import { readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const VENDOR_REGISTRY_PATH = resolve(
+  __dirname,
+  "..",
+  "skills",
+  "_meta",
+  "_compat",
+  "vendors.json",
+);
+
+// 启动时一次性 parse + 编译 RegExp，复用整个进程生命周期；不引入运行时性能开销
+const VENDOR_REGISTRY = (() => {
+  const raw = JSON.parse(readFileSync(VENDOR_REGISTRY_PATH, "utf8"));
+  return raw.vendors
+    .filter((v) => Array.isArray(v.patterns) && v.patterns.length > 0)
+    .map((v) => ({
+      id: v.id,
+      label: v.label,
+      vendor: v.label,
+      skill: v.skill,
+      baseline: v.baseline || [],
+      pattern: new RegExp(v.patterns.join("|"), "g"),
+    }));
+})();
+
+const VENDOR_PATTERNS = VENDOR_REGISTRY;
+
 const ELEMENT_SKILL_MAP = {
   "el-table": "element/el-table",
   "el-table-column": "element/el-table",
@@ -37,26 +68,7 @@ const ELEMENT_SKILL_MAP = {
   "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",
-  },
-];
+// VENDOR_PATTERNS 现由 vendors.json 单一事实源驱动（见文件顶部 VENDOR_REGISTRY）
 
 const LAYOUT_PATTERNS = [
   {
@@ -233,13 +245,13 @@ export function recommendFlows({ issues = [], coverage = {} } = {}) {
   if (issues.length === 0) {
     flows.push("full-audit");
     nextActions.push(
-      "保持 wk-skills-ui 样式入口，定期运行 wks_ui_scan 做只读审计",
+      "保持 wl-skills-ui 样式入口，定期运行 wl_ui_scan 做只读审计",
     );
   } else {
     flows.push("legacy-skin-align");
-    nextActions.push("先运行 wks_ui_scan --mode skin 确认 L0/L1/L2 样式偏差");
+    nextActions.push("先运行 wl_ui_scan --mode skin 确认 L0/L1/L2 样式偏差");
     nextActions.push(
-      "修复前运行 wks_ui_fix_dry_run 预览改动，不直接写入业务文件",
+      "修复前运行 wl_ui_fix_dry_run 预览改动，不直接写入业务文件",
     );
   }
 
@@ -278,7 +290,7 @@ export function recommendFlows({ issues = [], coverage = {} } = {}) {
       needed: shouldUseKit,
       reason: shouldUseKit
         ? "扫描结果涉及页面结构、BaseTable 或操作列规范，建议在视觉统一后使用 wl-skills-kit 做规范化生成/修复。"
-        : "当前更适合由 wk-skills-ui 先完成样式绝对管控，无需强制切换到 wl-skills-kit。",
+        : "当前更适合由 wl-skills-ui 先完成样式绝对管控，无需强制切换到 wl-skills-kit。",
       commands: shouldUseKit
         ? ["wl-skills validate-page <page>", "wl-skills doctor-ui <project>"]
         : [],