@agile-team/wl-skills-kit 2.9.1 → 2.9.2

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [2.9.2] - 2026-05-17
+
+### Added
+
+- **`doctor-ui` 新增 C_Splitter 残留扫描（standards/14 一致性）**：
+  - 业务代码（`.vue / .ts / .scss / .js`）命中 → `✖ error`，列出文件:行号:片段
+  - 文档/规则（`.md / .mdc`）命中 → `⚠ warn`
+  - 自动豁免：上下文 ±1 行含 `已废弃 / DEPRECATED / 严禁 / 不再需要 / 已迁移 / deprecated`；`C_Splitter/` 组件目录自身豁免
+  - 明细分组打印，单次最多列 60 条，超出汇总"另有 X 处未列出"
+- **`standards/14-layout-containers.md` 扩充**：
+  - §6 lint/codegen 强制项追加 `validate` / `doctor-ui` 命令矩阵
+  - 新增 §7 FAQ（旧页面是否要改、阈值配置、嵌套性能、过渡期保留）
+- **`tests/doctor-ui.test.js`**：4 项新单测覆盖无残留、业务代码命中、豁免词、自身组件豁免
+
+### Notes
+
+- 测试矩阵：cli + lint-skills + doctor-ui + registry + version-tools 合计 **53 测试通过**
+- 升级路径：`npx @agile-team/wl-skills-kit@latest update` 同步 standards/14；CI 增挂 `wl-skills doctor-ui` 即可
+
 ## [2.9.1] - 2026-05-17
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.9.1 ** — 一键将 13 条规范、10 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
+**AI Skill 模板包 v2.9.2 ** — 一键将 13 条规范、10 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
 
 让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / Qoder / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 

package/bin/wl-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v2.9.1 
+ * wl-skills-kit CLI v2.9.2 
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）
@@ -1106,11 +1106,75 @@ function runDoctorUi() {
   );
   add("renderOps", /renderOps\s*\(/.test(allSource), "操作列需使用 renderOps");
 
+  // —— C_Splitter 残留扫描（standards/14 一致性）——
+  // 业务代码（.vue / .scss / .ts）禁止任何 C_Splitter；文档/规则（.md / .mdc）只允许"废弃说明"句式
+  const EXEMPT_KEYWORDS =
+    /已废弃|DEPRECATED|严禁|不再需要|已迁移|deprecated/i;
+  const splitterFiles = files.filter(
+    (rel) =>
+      /\.(ts|vue|scss|js|tsx|md|mdc)$/.test(rel) &&
+      !rel.startsWith("node_modules/") &&
+      !rel.startsWith("dist/") &&
+      !rel.startsWith(".git/"),
+  );
+  const codeHits = [];
+  const docHits = [];
+  for (const rel of splitterFiles) {
+    if (
+      rel.includes("/C_Splitter/") ||
+      rel.endsWith("/C_Splitter/index.vue") ||
+      rel.endsWith("/C_Splitter/index.scss")
+    )
+      continue; // 组件自身保留（带 deprecation warning）
+    const full = path.join(TARGET_DIR, rel);
+    let content;
+    try {
+      content = fs.readFileSync(full, "utf8");
+    } catch {
+      continue;
+    }
+    if (!/C_Splitter/.test(content)) continue;
+    const lines = content.split(/\r?\n/);
+    lines.forEach((line, idx) => {
+      if (!/C_Splitter/.test(line)) return;
+      // 取上下文 ±1 行做豁免判断
+      const ctx = [lines[idx - 1] || "", line, lines[idx + 1] || ""].join("\n");
+      if (EXEMPT_KEYWORDS.test(ctx)) return;
+      const item = { rel, line: idx + 1, text: line.trim().slice(0, 100) };
+      if (/\.(vue|ts|scss|js|tsx)$/.test(rel)) codeHits.push(item);
+      else docHits.push(item);
+    });
+  }
+  add(
+    "C_Splitter 业务代码残留",
+    codeHits.length === 0,
+    codeHits.length === 0
+      ? "无"
+      : codeHits.length + " 处（详见下方明细，需改 jh-drag-col/-row）",
+  );
+  add(
+    "C_Splitter 文档/规则残留",
+    docHits.length === 0,
+    docHits.length === 0
+      ? "无"
+      : docHits.length + " 处（详见下方明细，建议同步说明）",
+  );
+
   for (const item of checks) {
     console.log(
       "  " + statusIcon(item.ok) + " " + item.name + " — " + item.detail,
     );
   }
+  if (codeHits.length || docHits.length) {
+    console.log("");
+    console.log("  ── C_Splitter 残留明细 ──");
+    for (const h of codeHits.slice(0, 30))
+      console.log("  ✖ " + h.rel + ":" + h.line + "  " + h.text);
+    for (const h of docHits.slice(0, 30))
+      console.log("  ⚠ " + h.rel + ":" + h.line + "  " + h.text);
+    const overflow = codeHits.length + docHits.length - 60;
+    if (overflow > 0) console.log("  … 另有 " + overflow + " 处未列出");
+  }
   const failed = checks.filter((item) => !item.ok).length;
   console.log("");
   console.log(

package/files/.github/guides/architecture.md

@@ -2,7 +2,7 @@
 
 > **读者**：团队技术负责人 / wl-skills-kit 维护者 / 对体系设计感兴趣的团队成员
 > **更新方式**：重大架构变更后追加对应章节，旧章节原文保留（历史可溯）
-> **当前版本**：v2.9.1 （2026-05-17）
+> **当前版本**：v2.9.2（2026-05-17）
 
 ---
 

package/files/.github/standards/14-layout-containers.md

@@ -129,6 +129,26 @@ done
 - `prototype-scan` / `page-codegen` 生成的模板**禁止**包含 `C_Splitter`
 - TPL-TREE-LIST、TPL-DETAIL-TABS 等模板必须使用 `jh-drag-col` / `jh-drag-row`
 - `wl-skills validate-page` 扫到 `C_Splitter` 直接 fail
+- `wl-skills validate src/views`：业务页面扫描 `<C_Splitter` / `import C_Splitter` / 过时注释（error / info 三级）
+- `wl-skills doctor-ui`：全仓扫描 `.vue/.ts/.scss/.md/.mdc`，区分**业务代码残留（error）**与**文档/规则残留（warn）**；含 `已废弃|DEPRECATED|严禁|不再需要|已迁移` 关键词的上下文自动豁免；`C_Splitter/` 组件目录自身豁免
+
+> 推荐在 CI 非阻断阶段挂 `wl-skills doctor-ui`，残留明细一目了然；提交前 pre-commit 由 `lint-skills` 兜底，禁止任何新增引用流入仓库。
+
+---
+
+## 7. FAQ
+
+**Q1：旧页面跑得好好的，为什么也要改？**
+现状只是"还没踩到 ref 变更的场景"。一旦页面后续接入树节点切换 / 全屏刷新 / 编辑回填，就会出现 ref 改了 UI 不动的灵异 bug，排查成本远大于一次性迁移。
+
+**Q2：`jh-drag-col` 没有 `min-left-width` 怎么办？**
+内部默认 200~600 阈值已可用；如需自定义，传 `:minLeftWidth` / `:maxLeftWidth`（数值，单位 px）。
+
+**Q3：嵌套两层分栏会有性能问题吗？**
+不会。`jh-drag-col` / `jh-drag-row` 都是直接 `<slot />`，没有 vnode 缓存或额外 watcher，嵌套层数与原生 div 等价。
+
+**Q4：必须保留 `C_Splitter` 组件文件吗？**
+保留一段过渡期（带 deprecation warning）即可。等仓库扫描 0 命中后，下一个大版本直接删除 `src/components/global/C_Splitter/`。
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.9.1",
-  "description": "AI Skill 模板包 v2.9.1  — 13 条编码规范 + 10 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目",
+  "version": "2.9.2",
+  "description": "AI Skill 模板包 v2.9.2 — 13 条编码规范 + 10 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目",
   "main": "./bin/wl-skills.js",
   "bin": {
     "wl-skills": "bin/wl-skills.js"