@agile-team/wl-skills-kit 2.7.2 → 2.8.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## [2.8.0] - 2026-05-16
+
+### Added
+
+- **`files/docs/mock-architecture.md`**（新文档）：Mock 架构规范，涵盖目录约定（按业务域分目录 `mock/[域]/[模块].ts`）、`_utils.ts` 共享工具、`ENV_MOCK` 开关机制、STORE 可变数组持久化模式、端点覆盖检查、一键清理流程。
+- **`files/mock/_utils.ts`**（种子文件）：`init`/`update` 自动写入目标项目 `mock/_utils.ts`，提供 `pageResult`/`ok`/`paginate`/`nowStr`/`pick` 五个共享工具，消除各 mock 模块重复定义。
+- **CLI `mock-clean` 命令**：`--domain <name>` 按域清理（如 `mock-clean --domain mdata`）、`--all` 全量清理（保留 `_utils.ts`）、支持 `--dry-run` 预览。清理后提示修改 `ENV_MOCK` 并运行 `validate`。
+
+### Changed
+
+- **`copilot-instructions.md`** 新增 Mock 架构节：目录结构约定、开关机制、URL 对齐、STORE 模式、模块自治原则、`mock-clean` CLI 用法。
+- **`page-codegen/SKILL.md`** 规则修正：规则 9 → `mock/[业务域]/[模块].ts` 按域分目录 + 强制 `import ../_utils`；规则 20 → 自检 `mock/_utils.ts` 存在；规则 21 → 路径格式对齐；禁止 14 → 引用 `docs/mock-architecture.md`。
+- **`validate` 增强**：新增 3 项 mock 架构质量检查 —— `_utils.ts` 存在性（warn）、mock 文件是否按域分目录（info）、是否引用共享工具（info）。输出新增 `ℹ` info 级别图标。
+- **`_best-practices.md`** 场景 6 扩展：从一句话描述 → 完整 mock 架构速览 + 目录树 + 开关/清理说明。
+- **`--domain` / `--all` 加入 `KNOWN_FLAGS`**；flag 校验兼容 `--domain=xxx` 等号格式。
+
+### Notes
+
+- Mock 架构为前端最佳实践固化，已在 wl-mdata 项目验证。新项目 `init` 后即获得 `mock/_utils.ts`；已有项目 `update` 后自动补充。
+
+## [2.7.3] - 2026-05-13
+
+### Added
+
+- **`tests/mcp-tools.test.js`**（30 个测试）：覆盖 `menuSync` 8 个纯函数（cleanCell / splitMarkdownRow / isDividerRow / parseBoolean / normalizeTree / flattenMenus / findExisting / parseReport）、`dictSync.extractModules`、`handleDictUpsert` 参数校验、`handleRoleUpsert` / `handleRoleAssignMenus` 参数校验，填补最易出 Bug 的 MCP 工具层零覆盖空白。
+- **`.gitattributes`**：统一 `eol=lf`，消除 Windows 开发者打开文件后 CRLF 行尾符变更噪音。
+
+### Changed
+
+- **`scripts/lint-skills.js`** 扩展 core/ops Skill 校验：有写操作的 5 个 Skill（page-codegen / convention-audit / business-doc-extract / template-extract / code-fix）必须包含 Pre-flight 声明 + standards 引用，防止关键约束被遗漏；同时清理旧版 AI-bypass 警告规则（误报率高，作用有限）。输出信息更新为"公共文件 N 个、sync Skill N 个、write Skill N 个全部合规"。
+- **`mcp/tools/menuSync.js` / `dictSync.js`**：新增 `_internal` 导出，暴露纯工具函数供单测调用，不影响运行时行为。
+- **`files/.github/skills/sync/permission-sync/SKILL.md`**：275 → 240 行（-13%），命名规范表从 9 行精简为 1 行覆盖范例、后端接口参考表删去冗余 Body 示例列、报告输出改为一句话描述。
+
+### Notes
+
+- 纯工程质量提升，无 Skill 行为变更、无 MCP API 变更，业务项目无需操作。
+
 ## [2.7.2] - 2026-05-13
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.7.2** — 一键将 13 条规范、10 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
+**AI Skill 模板包 v2.8.0** — 一键将 13 条规范、10 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
 
 让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / Qoder / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 
@@ -23,6 +23,22 @@ npm run standards:init                   # 本包维护/业务项目均可复用
 
 ## 版本亮点
 
+**v2.8.0**：Mock 架构体系固化 + `mock-clean` CLI 命令。
+
+- 新增 `docs/mock-architecture.md` — Mock 目录约定、开关机制、模块化规范、一键清理流程
+- 新增 `mock/_utils.ts` 种子文件 — `init` 自动写入，提供 `pageResult`/`ok`/`paginate`/`nowStr`/`pick`
+- 新增 CLI `mock-clean` 命令 — `--domain <name>` 按域清理、`--all` 全量清理（保留 `_utils.ts`）、`--dry-run` 预览
+- `copilot-instructions.md` 新增 Mock 架构节（目录约定、开关、STORE 模式、URL 对齐）
+- `page-codegen/SKILL.md` 规则 9/20/21 修正为按域分目录 + 强制引用 `_utils`
+- `validate` 增强：检查 `_utils.ts` 存在、mock 文件是否按域分目录、是否引用共享工具
+
+**v2.7.3**：工程质量提升 — MCP tools 单测覆盖、lint-skills 扩展到 core Skill、.gitattributes 消除行尾符噪音、permission-sync SKILL.md 精简。
+
+- 新增 `tests/mcp-tools.test.js`（30 个测试）覆盖 menuSync/dictSync/permissionSync 核心纯函数与参数校验
+- `lint-skills` 新增 core/ops SKILL.md 规则：有写操作 Skill 必须含 Pre-flight + standards 引用
+- 新增 `.gitattributes` 统一 LF 行尾，消除 Windows 开发者提交噪音
+- `permission-sync/SKILL.md` 压缩 275 → 240 行，命名规范表与报告示例精简
+
 **v2.7.2**：sync 类 Skill 自愈闭环 + 场景索引路由。
 
 - 新增 `skills/_best-practices.md` 场景索引（AI 每轮默认加载，弱化关键词命中）
@@ -46,7 +62,7 @@ npm run standards:init                   # 本包维护/业务项目均可复用
 - **单元测试**：registry / CLI / version-tools 共 18 项覆盖，上面三项防护都有连动验证
 - **单一数据源加固**：`SKILL_COUNT` 从常量改为从 `_registry.md` 动态计算；copilot-instructions 删除内嵌 Skill 表改为指针；dict-sync / code-fix 补 USAGE.md
 
-当前 2.6.x 重点补齐业务理解闭环：原型/详设 → 业务文档 → 接口契约 → 页面代码 → 复扫。
+2.6.x 以来重点补齐业务理解闭环：原型/详设 → 业务文档 → 接口契约 → 页面代码 → 复扫。
 
 - **新增 `business-doc-extract` Skill**：语义级智能触发（不依赖固定关键词），在资料达模块/项目级完整度时建议生成业务文档：
   ```text
@@ -118,16 +134,17 @@ wl-skills-kit/                            ← 你正看的这个仓库
 ├── package.json                          name: @agile-team/wl-skills-kit
 │
 ├── bin/
-│   └── wl-skills.js                      CLI 实现（init / update / clean / check / diff / validate / validate-page / doctor-ui / export）
+│   └── wl-skills.js                      CLI 实现（init / update / clean / check / diff / validate / validate-page / doctor-ui / export / mock-clean）
 │
 ├── files/                                ★★★ 真正会被打包并复制到业务项目的内容 ★★★
-│   └── .github/
-│       ├── copilot-instructions.md       源 AI 主入口（编辑这里，不要编辑业务项目里的副本）
-│       ├── standards/                    13 条规范
-│       ├── skills/                       Skill 目录（含 _compat/ 多编辑器适配源）
-│       ├── guides/                       人读指南
-│       └── reports/                      领域基线模板（菜单/字典/权限）
-│   ├── docs/                             组件 API 文档
+│   ├── .github/
+│   │   ├── copilot-instructions.md       源 AI 主入口（编辑这里，不要编辑业务项目里的副本）
+│   │   ├── standards/                    13 条规范
+│   │   ├── skills/                       Skill 目录（含 _compat/ 多编辑器适配源）
+│   │   ├── guides/                       人读指南
+│   │   └── reports/                      领域基线模板（菜单/字典/权限）
+│   ├── docs/                             组件 API 文档 + Mock 架构规范
+│   ├── mock/                             Mock 共享工具种子（_utils.ts）
 │   └── demo/                             领域样例
 │
 ├── kit-internal/                         ★★ 仅仓库可见，不会安装到业务项目 ★★
@@ -156,7 +173,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 你的业务项目/
 │
 ├── .github/                              ← 来自本包 files/.github/
-│   ├── copilot-instructions.md           Copilot 主入口（精简 ~320 行）
+│   ├── copilot-instructions.md           Copilot 主入口（精简 ~340 行）
 │   ├── standards/                        13 条模块化规范 + index.md 门控
 │   │   ├── 01-toolchain.md
 │   │   ├── 02-code-structure.md
@@ -197,7 +214,11 @@ wl-skills-kit/                            ← 你正看的这个仓库
 ├── .trae/rules/conventions.md            Trae（含 alwaysApply frontmatter）
 ├── .qoder/rules/conventions.md           Qoder
 │
-├── docs/                                 12 个组件 API 文档
+├── mock/                                 ← 来自本包 files/mock/（init 自动写入）
+│   ├── _utils.ts                         共享工具（pageResult / ok / paginate / nowStr / pick）
+│   └── [业务域]/[模块].ts               按域分目录，page-codegen 自动生成
+│
+├── docs/                                 12 个组件 API 文档 + mock-architecture.md
 ├── demo/                                 13 个领域样例
 └── src/
     ├── components/                       全局/局部/远程组件
@@ -247,6 +268,12 @@ npx @agile-team/wl-skills-kit clean
 # 清理但保留 reports/（菜单/字典/权限累积数据）
 npx @agile-team/wl-skills-kit clean --keep-reports
 
+# 清理指定业务域的 mock 文件（保留 _utils.ts）
+npx @agile-team/wl-skills-kit mock-clean --domain mdata
+
+# 清理全部 mock（保留 _utils.ts）
+npx @agile-team/wl-skills-kit mock-clean --all
+
 # 任何命令都可加 --dry-run 预览
 npx @agile-team/wl-skills-kit update --dry-run
 ```
@@ -306,6 +333,7 @@ npx @agile-team/wl-skills-kit update
 | `api-contract`     | ✅ 启用 | `skills/core/api-contract/`     | 生成 api.md 前后端契约                      |
 | `page-codegen`     | ✅ 启用 | `skills/core/page-codegen/`     | 页面骨架生成 + 模板调度                     |
 | `convention-audit` | ✅ 启用 | `skills/core/convention-audit/` | 13 条规范扫描 + 双报告                      |
+| `business-doc-extract` | ✅ 启用 | `skills/core/business-doc-extract/` | 语义触发，业务文档抽取与维护            |
 | `template-extract` | ✅ 启用 | `skills/core/template-extract/` | 现有页面 → 领域模板                         |
 | `menu-sync`        | ✅ 启用 | `skills/sync/menu-sync/`        | 菜单基线 ↔ 后端接口                         |
 | `dict-sync`        | ✅ 启用 | `skills/sync/dict-sync/`        | 字典基线 ↔ 后端接口                         |

package/bin/wl-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v2.7.2
+ * wl-skills-kit CLI v2.8.0
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）
@@ -13,6 +13,7 @@
  *   validate-page validate 的别名，适用于单页/目录检查
  *   doctor-ui 检查 @agile-team/wk-skills-ui 接入完整性
  *   export    导出 SYS_MENU / SYS_DICT / SYS_PERMISSION 为 xlsx
+ *   mock-clean 清理 mock 文件（按域或全部），保留 _utils.ts
  *   --help    帮助
  *   --dry-run 预览模式（所有命令均支持）
  */
@@ -39,6 +40,7 @@ const KNOWN_COMMANDS = new Set([
   "validate-page",
   "doctor-ui",
   "export",
+  "mock-clean",
 ]);
 const KNOWN_FLAGS = new Set([
   "--dry-run",
@@ -46,6 +48,8 @@ const KNOWN_FLAGS = new Set([
   "--force",
   "--help",
   "-h",
+  "--domain",
+  "--all",
 ]);
 
 const dryRun = args.includes("--dry-run");
@@ -56,7 +60,10 @@ const force = args.includes("--force");
 // 校验所有 flag 是否已知（--help 优先，跳过校验直接显示帮助）
 if (!showHelp) {
   const unknownFlags = args.filter(
-    (a) => a.startsWith("-") && !KNOWN_FLAGS.has(a),
+    (a) =>
+      a.startsWith("-") &&
+      !KNOWN_FLAGS.has(a) &&
+      !KNOWN_FLAGS.has(a.split("=")[0]),
   );
   if (unknownFlags.length > 0) {
     console.error("");
@@ -96,11 +103,14 @@ if (showHelp) {
     validate-page validate 的别名，适用于单页/目录检查
     doctor-ui  检查 @agile-team/wk-skills-ui 接入完整性
     export     导出 reports/SYS_* 数据为 xlsx
+    mock-clean 清理 mock 文件（按域或全部），保留 _utils.ts
 
   选项:
     --dry-run        预览模式，不实际写入/删除任何文件
     --keep-reports   clean 命令保留 .github/reports/（默认一起删除）
     --force          强制执行，跳过同版本检测（忽略已安装状态）
+    --domain <name>  mock-clean 指定要清理的业务域（如 sale、mdata）
+    --all            mock-clean 清理全部 mock（保留 _utils.ts）
     --help           显示帮助
 
   示例:
@@ -116,6 +126,9 @@ if (showHelp) {
     npx @agile-team/wl-skills-kit clean                 清理开发期文件
     npx @agile-team/wl-skills-kit clean --keep-reports  保留 reports/中的菜单/字典数据
     npx @agile-team/wl-skills-kit clean --dry-run       预览将要清理哪些文件
+    npx @agile-team/wl-skills-kit mock-clean --domain mdata  清理 mdata 域 mock
+    npx @agile-team/wl-skills-kit mock-clean --all           清理全部 mock
+    npx @agile-team/wl-skills-kit mock-clean --all --dry-run 预览将要清理的 mock 文件
 
   保护路径（init / update 不覆盖已存在的）:
     .github/reports/   AI 生成报告（团队累积数据，存在则跳过）
@@ -853,6 +866,54 @@ function runValidate() {
   const mockContent = mockFiles
     .map((rel) => fs.readFileSync(path.join(TARGET_DIR, rel), "utf8"))
     .join("\n");
+
+  // ── Mock 架构质量检查 ──────────────────────────────────────────────
+  const mockDir = path.join(TARGET_DIR, "mock");
+  const hasMockDir = fs.existsSync(mockDir);
+  const hasUtilsTs =
+    hasMockDir &&
+    (fs.existsSync(path.join(mockDir, "_utils.ts")) ||
+      fs.existsSync(path.join(mockDir, "_utils.js")));
+  if (hasMockDir && mockFiles.length > 0 && !hasUtilsTs) {
+    issues.push({
+      level: "warn",
+      dir: "mock/",
+      text: "缺少 mock/_utils.ts 共享工具文件（建议 wl-skills init 补充）",
+    });
+  }
+  // 检查 mock 文件是否按域分目录（非 _utils 的 ts/js 文件不应直接放在 mock/ 根）
+  for (const rel of mockFiles) {
+    const parts = rel
+      .replace(/\\/g, "/")
+      .replace(/^mock\//, "")
+      .split("/");
+    const basename = parts[parts.length - 1];
+    if (parts.length === 1 && !basename.startsWith("_")) {
+      issues.push({
+        level: "info",
+        dir: "mock/",
+        text:
+          basename +
+          " 直接放在 mock/ 根目录，建议按业务域分子目录（如 mock/sale/" +
+          basename +
+          "）",
+      });
+    }
+  }
+  // 检查 mock 模块文件是否 import _utils
+  for (const rel of mockFiles) {
+    const basename = path.basename(rel);
+    if (basename.startsWith("_")) continue;
+    const content = fs.readFileSync(path.join(TARGET_DIR, rel), "utf8");
+    if (hasUtilsTs && !/_utils/.test(content)) {
+      issues.push({
+        level: "info",
+        dir: rel,
+        text: "未引用 mock/_utils 共享工具，建议统一使用 pageResult/ok/paginate",
+      });
+    }
+  }
+
   for (const page of pages) {
     if (!page.hasDataTs)
       issues.push({
@@ -933,7 +994,8 @@ function runValidate() {
   console.log("");
   const errors = issues.filter((issue) => issue.level === "error").length;
   for (const issue of issues) {
-    const icon = issue.level === "error" ? "✖" : "⚠";
+    const icon =
+      issue.level === "error" ? "✖" : issue.level === "info" ? "ℹ" : "⚠";
     console.log("  " + icon + " " + issue.dir + " — " + issue.text);
   }
   if (issues.length === 0) console.log("  ✔ 页面文件完整性检查通过");
@@ -1106,6 +1168,85 @@ function runExport() {
   console.log("");
 }
 
+// ─── mock-clean ──────────────────────────────────────────────────────────
+
+function runMockClean() {
+  console.log("");
+  console.log("  wl-skills-kit v" + PKG.version + "  [mock-clean]");
+  console.log("");
+
+  const mockDir = path.join(TARGET_DIR, "mock");
+  if (!fs.existsSync(mockDir)) {
+    console.log("  ⚠ mock/ 目录不存在，无需清理");
+    console.log("");
+    return;
+  }
+
+  const domainArg = args.find((a) => a.startsWith("--domain"));
+  const cleanAll = args.includes("--all");
+  let domain = "";
+  if (domainArg) {
+    // 支持 --domain=xxx 和 --domain xxx
+    if (domainArg.includes("=")) {
+      domain = domainArg.split("=")[1];
+    } else {
+      const idx = args.indexOf(domainArg);
+      domain = args[idx + 1] || "";
+    }
+  }
+
+  if (!domain && !cleanAll) {
+    console.error("  ✖ 请指定 --domain <name> 或 --all");
+    console.error("  示例: wl-skills mock-clean --domain mdata");
+    console.error("        wl-skills mock-clean --all");
+    console.error("");
+    process.exit(1);
+  }
+
+  // 收集要删除的文件/目录
+  const toRemove = [];
+  if (cleanAll) {
+    // 删除 mock/ 下除 _utils.ts/_utils.js 之外的所有文件和子目录
+    const entries = fs.readdirSync(mockDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.name.startsWith("_")) continue; // 保留 _utils.ts 等
+      toRemove.push(path.join(mockDir, entry.name));
+    }
+  } else {
+    // 删除指定域目录
+    const domainDir = path.join(mockDir, domain);
+    if (!fs.existsSync(domainDir)) {
+      console.log('  ⚠ mock/' + domain + '/ 不存在');
+      console.log("");
+      return;
+    }
+    toRemove.push(domainDir);
+  }
+
+  if (toRemove.length === 0) {
+    console.log("  ✔ 无需清理（仅剩 _utils.ts）");
+    console.log("");
+    return;
+  }
+
+  for (const target of toRemove) {
+    const rel = path.relative(TARGET_DIR, target);
+    if (dryRun) {
+      console.log("  [dry-run] 将删除: " + rel);
+    } else {
+      fs.rmSync(target, { recursive: true, force: true });
+      console.log("  ✔ 已删除: " + rel);
+    }
+  }
+
+  console.log("");
+  if (!dryRun) {
+    console.log("  建议：将 .env.dev 中 ENV_MOCK 改为 false");
+    console.log("  然后运行 wl-skills validate 检查页面无 mock 依赖残留");
+    console.log("");
+  }
+}
+
 // ─── 主路由 ─────────────────────────────────────────────────────────────
 
 switch (command) {
@@ -1134,6 +1275,9 @@ switch (command) {
   case "export":
     runExport();
     break;
+  case "mock-clean":
+    runMockClean();
+    break;
   default:
     console.error(
       '  ✖ 未知命令: "' + command + '"，请使用 --help 查看可用命令',

package/files/.github/copilot-instructions.md

@@ -28,6 +28,24 @@ src/views/[域]/[模块]/[子模块]/[kebab-case目录]/
 - **通用弹窗**（新增/编辑表单，2+ 页面可复用）→ 提取到 `src/components/local/c_xxxModal/`
 - **极个性弹窗**（仅单页面使用，c_modal 无法满足）→ 放在页面 `components/xxxModal.vue`
 
+## Mock 架构（与页面完全解耦）
+
+> 详细规范见 `docs/mock-architecture.md`
+
+```
+mock/
+├── _utils.ts              ← 共享工具（pageResult / ok / paginate / nowStr / pick）
+└── [业务域]/              ← 镜像 src/views 第一级目录
+    └── [模块].ts          ← 每个模块一个文件，export default MockMethod[]
+```
+
+- **开关**：`.env.dev` 中 `ENV_MOCK=true/false`，`vite.config.ts` 中 `viteMockServe({ enable: command === "serve" && config.ENV_MOCK !== "false" })`
+- **解耦**：mock 文件放在项目根 `mock/` 目录，不在 `src/views` 中 import 任何 mock
+- **URL 对齐**：`API_CONFIG` 保持真实路径（如 `/mdata/mdataModel/list`），mock 端点带 `/dev-api` 前缀，关闭 mock 后无需改页面代码
+- **STORE 模式**：`let STORE = Array.from({ length: N }, genRecord)` 可变数组，CRUD 直接修改内存，查询立即可见
+- **按模块自治**：删某业务 mock 只删对应文件，不影响其他模块
+- **一键清理**：`wl-skills mock-clean --domain [域]` 或 `--all`
+
 ## data.ts 核心模式
 
 > 配置化驱动，通过 `API_CONFIG` + `class extends AbstractPageQueryHook` 实现零 API 层开发。

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

@@ -2,7 +2,7 @@
 
 > **读者**：团队技术负责人 / wl-skills-kit 维护者 / 对体系设计感兴趣的团队成员
 > **更新方式**：重大架构变更后追加对应章节，旧章节原文保留（历史可溯）
-> **当前版本**：v2.7.2（2026-05-13）
+> **当前版本**：v2.8.0（2026-05-16）
 
 ---
 
@@ -478,9 +478,11 @@ AI "假执行"——声称读了规范，实际按惯性输出。没有强制约
 | ---- | ----------------------------------------------------------------------------------------------------------------------------------------- | --------- |
 | v1.x | 5 个 Skill 平铺 + 9 个 TPL 平铺 + 单一超长 copilot-instructions                                                                           | ✅ 已发布 |
 | v2.0 | 规范模块化（13 条）+ 模板分层（universal/domains）+ 报告分类 + Pre-flight + 工具链门控                                                    | ✅ 已发布 |
-| v2.1 | Skill 分级目录（core/sync/ops/domain）+ 多 AI 适配解耦（editors.json）+ 各 Skill USAGE.md + api-contract 真实响应 + 3 个 PLANNED 草稿补全 | ✅ 当前   |
-| v2.2 | dict-sync / permission-sync / code-fix 从 PLANNED → 转正（视后端接口稳定情况）                                                            | ⏳ 规划中 |
-| v2.3 | CI 流水线接入（convention-audit 报告注入 PR 评论）+ Skill 版本感知                                                                        | ⏳ 规划中 |
+| v2.1 | Skill 分级目录（core/sync/ops/domain）+ 多 AI 适配解耦（editors.json）+ 各 Skill USAGE.md + api-contract 真实响应 + 3 个 PLANNED 草稿补全 | ✅ 已发布 |
+| v2.2–2.3 | dict-sync / permission-sync / code-fix 从 PLANNED → 转正 + lint-skills 静态护栏 + MCP 自愈闭环                                      | ✅ 已发布 |
+| v2.6 | business-doc-extract 语义触发 + 业务文档体系 + AGGrid/cid/defineColumns/renderOps 最终标准 + doctor-ui / validate 增强                     | ✅ 已发布 |
+| v2.7 | JH 组件文档全面修正 + MCP tools 单测覆盖 + 场景索引路由 + _mcp-guardrail 自愈闭环 + .gitattributes + 版本一致性自检                       | ✅ 已发布 |
+| v2.8 | Mock 架构体系固化（mock-architecture.md + _utils.ts 种子 + mock-clean CLI + validate mock 质量检查 + 规则修正）                            | ✅ 当前   |
 
 ---