@lark-apaas/coding-template-nestjs-react-fullstack 0.1.42-alpha.20260916160525 → 0.1.42-alpha.20260917135900

package/README.md

@@ -29,22 +29,13 @@ MIAODA_APP_TYPE=3 npx @lark-apaas/miaoda-cli@<latest> app init \
 
 ## MCP UI 的类型与代码检查
 
-`server/mcp/ui` 是独立浏览器工程，主应用的 TypeScript 和 ESLint 配置排除该目录。
-`npm run lint` 通过现有 `scripts/lint.js` 统一调度检查：
+MCP UI 使用平台预设提供的浏览器检查默认值。`npm run lint` 和 `npm run type:check` 自动覆盖 `server/mcp/ui`，模板统一提供 UI 子命令与类型配置；`lint -- --files` 保留按文件选择检查范围。没有 UI 源码时跳过 UI 检查。
 
-| 命令 | 检查范围 |
-| --- | --- |
-| `npm run type:check` | 服务端、客户端、MCP UI 类型检查 |
-| `npm run type:check:mcp-ui` | 仅 MCP UI 类型检查 |
-| `npm run eslint:mcp-ui` | 仅 MCP UI ESLint 检查 |
-| `npm run lint -- --files <files...>` | 根据改动文件选择检查范围 |
+应用增加 `type:check:mcp-ui` 子命令，与 `type:check:client`、`type:check:server` 一起由 `type:check` 聚合。`scripts/typecheck-mcp-ui.js` 只在 UI 源码存在时调用应用安装的 `tsc --noEmit --project tsconfig.mcp-ui.json`；无 UI 或目录为空时成功跳过。根目录 `tsconfig.mcp-ui.json` 提供浏览器、React JSX 和严格类型检查配置，可按应用需要修改；sync 仅在该文件不存在时创建。已有 `server/mcp/ui/tsconfig.json` 的应用优先沿用原配置，保留自定义 paths/types。
 
-模板不预建 UI 目录。Agent 开发 MCP UI 时，按照 MCP 指南生成
-`server/mcp/ui/tsconfig.json` 和根目录 `eslint.mcp-ui.config.cjs`。
-没有 UI 源码时跳过独立检查；存在源码但配置缺失或未覆盖源码时明确报错。
+UI ESLint 默认配置由平台预设提供，也可用根目录 `eslint.mcp-ui.config.js` / `.cjs` / `.mjs` 定制。`npm run lint` 包含 UI 检查；`--files` 按影响范围检查，shared 变更触发三个环境的类型检查。应用脚本不使用 `node -e` 或 TypeScript 编译器 API。
 
-存量应用通过本地 `miaoda app sync` 或沙箱 `fullstack-cli sync` 更新脚本、迁移已知模板命令，
-并保留现有 TS 排除项。自定义检查命令会保留，开发者需自行接入独立 UI 检查。
+存量 sync 不改写 ESLint 源码；UI 全局排除项由平台 ESLint 预设提供。TS 仅向已有显式 `exclude` 数组追加目录，保留注释和原项；依赖继承且未显式声明 `exclude` 的自定义配置保持不变并提示人工调整。自定义检查命令保留。请与包含这些入口的新版 fullstack-presets 一起升级，旧版预设没有上述入口。
 
 ## 包结构
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-template-nestjs-react-fullstack",
-  "version": "0.1.42-alpha.20260916160525",
+  "version": "0.1.42-alpha.20260917135900",
   "description": "NestJS + React fullstack template for miaoda coding",
   "type": "module",
   "files": [

package/template/eslint.config.js

@@ -9,8 +9,6 @@ module.exports = tseslint.config(
       'node_modules',
       'source_package',
       'client/src/api/gen',
-      // MCP UI 使用独立浏览器配置，由 lint.js 使用 eslint.mcp-ui.config.cjs 独立检查。
-      'server/mcp/ui/**',
       '**/*.d.ts',
       '**/*.js.map',
     ],

package/template/package-lock.json

@@ -8,7 +8,7 @@
       "name": "fullstack-nestjs-template",
       "version": "2.3.0",
       "dependencies": {
-        "@lark-apaas/fullstack-nestjs-core": "1.1.62-alpha.20260916155509",
+        "@lark-apaas/fullstack-nestjs-core": "1.1.62-alpha.20260917134431",
         "@nestjs/axios": "^4.0.1",
         "@nestjs/cache-manager": "^3.1.3",
         "@nestjs/common": "^10.4.20",
@@ -33,8 +33,8 @@
       "devDependencies": {
         "@hookform/resolvers": "^5.2.2",
         "@lark-apaas/client-toolkit": "^1.2.70",
-        "@lark-apaas/coding-preset-vite-react": "1.0.23-alpha.20260915164951",
-        "@lark-apaas/fullstack-presets": "^1.1.0",
+        "@lark-apaas/coding-preset-vite-react": "1.0.24-alpha.20260917134427",
+        "@lark-apaas/fullstack-presets": "1.1.24-alpha.20260917134434",
         "@nestjs/cli": "^10.4.9",
         "@radix-ui/react-accordion": "^1.2.12",
         "@radix-ui/react-alert-dialog": "^1.1.15",
@@ -1546,9 +1546,9 @@
       }
     },
     "node_modules/@lark-apaas/cache-service": {
-      "version": "0.1.2-alpha.20260916155513",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/cache-service/-/cache-service-0.1.2-alpha.20260916155513.tgz",
-      "integrity": "sha512-GFwWlTnHu/V5CnB2p171sgDZGPXcH9bRfHmTn6nTKTv1L04i9G8GenH0h9dZpfeMI/wAZj3BE1Lw0if3vKqTrA==",
+      "version": "0.1.2-alpha.20260917134428",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/cache-service/-/cache-service-0.1.2-alpha.20260917134428.tgz",
+      "integrity": "sha512-yOb8X6eKmP25/nGs7GACm51zkHERzwRCOSyKrSjbArK04GTv43ceq33hXW1yAbq824QbcnxHUSs7mA9wsd9djA==",
       "license": "MIT",
       "dependencies": {
         "@keyv/redis": "^5.1.6",
@@ -1562,7 +1562,7 @@
       },
       "peerDependencies": {
         "@lark-apaas/nestjs-common": "^0.1.9",
-        "@lark-apaas/nestjs-logger": "1.0.18-alpha.20260916155505",
+        "@lark-apaas/nestjs-logger": "1.0.18-alpha.20260917134424",
         "@lark-apaas/nestjs-observable": "^0.0.12",
         "@nestjs/common": "^10.0.0",
         "@nestjs/core": "^10.0.0"
@@ -1634,15 +1634,16 @@
       "license": "MIT"
     },
     "node_modules/@lark-apaas/coding-preset-vite-react": {
-      "version": "1.0.23-alpha.20260915164951",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/coding-preset-vite-react/-/coding-preset-vite-react-1.0.23-alpha.20260915164951.tgz",
-      "integrity": "sha512-5QRc/9rXGp9GYP7ISD9nN99Jt8/NHzro3BnSj3QezaAzBBzH5OMFQOySK3BKFVqvWvnXTNpTiAzt9EioGiVNWQ==",
+      "version": "1.0.24-alpha.20260917134427",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/coding-preset-vite-react/-/coding-preset-vite-react-1.0.24-alpha.20260917134427.tgz",
+      "integrity": "sha512-SYLR5P80cbKodxDDrM/zQ/aIYUP/oNqRAU3YxE22HZcoKSrmkfiSqGE/q90oLXzTpjSvZrtxKtD5VngkKKOriw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@babel/parser": "^7.28.0",
         "@babel/traverse": "^7.28.0",
         "@babel/types": "^7.28.0",
+        "@lark-apaas/fullstack-presets": "1.1.24-alpha.20260917134434",
         "@lark-apaas/vite-inspector-plugin": "^1.0.4",
         "@tailwindcss/vite": "^4.3.0",
         "@vitejs/plugin-react": "^6.0.0",
@@ -1655,8 +1656,6 @@
         "express": "^4.18.2",
         "html-minifier-terser": "^7.2.0",
         "magic-string": "~0.30.18",
-        "parse5": "^7.3.0",
-        "postcss-value-parser": "^4.2.0",
         "tailwind-merge": "^2.5.5"
       },
       "peerDependencies": {
@@ -1697,12 +1696,12 @@
       }
     },
     "node_modules/@lark-apaas/fullstack-nestjs-core": {
-      "version": "1.1.62-alpha.20260916155509",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-nestjs-core/-/fullstack-nestjs-core-1.1.62-alpha.20260916155509.tgz",
-      "integrity": "sha512-Bjdx84abQUxCu10Y98w7hUZt0QtLeJI2g9CtxE0mXCjy9mg5r/WgcKORgNPUdQayETrzDQbvJYWo2Bn3BstRiA==",
+      "version": "1.1.62-alpha.20260917134431",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-nestjs-core/-/fullstack-nestjs-core-1.1.62-alpha.20260917134431.tgz",
+      "integrity": "sha512-Ia1QwvIYJy+7nwJWyB5gc58rgYo2WrVSZF+U6GGxTPlc0Rvvy4CwEQYJN2sgVC3pIkRHi5LdQeGL431SFknmIQ==",
       "license": "MIT",
       "dependencies": {
-        "@lark-apaas/cache-service": "0.1.2-alpha.20260916155513",
+        "@lark-apaas/cache-service": "0.1.2-alpha.20260917134428",
         "@lark-apaas/file-service": "^0.1.2",
         "@lark-apaas/http-client": "^0.1.7",
         "@lark-apaas/nestjs-authnpaas": "^1.0.6",
@@ -1711,8 +1710,8 @@
         "@lark-apaas/nestjs-common": "^0.1.9",
         "@lark-apaas/nestjs-datapaas": "^1.0.21",
         "@lark-apaas/nestjs-http-forwarder": "^0.1.3",
-        "@lark-apaas/nestjs-logger": "1.0.18-alpha.20260916155505",
-        "@lark-apaas/nestjs-mcp": "0.1.1-alpha.20260916155510",
+        "@lark-apaas/nestjs-logger": "1.0.18-alpha.20260917134424",
+        "@lark-apaas/nestjs-mcp": "0.1.1-alpha.20260917134425",
         "@lark-apaas/nestjs-observable": "^0.0.12",
         "@lark-apaas/nestjs-openapi-devtools": "^1.0.10",
         "@lark-apaas/nestjs-trigger": "^0.0.3",
@@ -1735,12 +1734,14 @@
       }
     },
     "node_modules/@lark-apaas/fullstack-presets": {
-      "version": "1.1.23",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-presets/-/fullstack-presets-1.1.23.tgz",
-      "integrity": "sha512-hE1jr2kIs3H1AgU+EcBbT/lyjLFRrXVwEj72JT6t4TOLh7MYSR6IwTC4ZTdZE168utDlgx5n5GH53ttts7LdwA==",
+      "version": "1.1.24-alpha.20260917134434",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-presets/-/fullstack-presets-1.1.24-alpha.20260917134434.tgz",
+      "integrity": "sha512-gXQn+Gm5eeTDmoPPJBfBxlWQDFuLtRJ5UL8rIzC6aZR4IHgJv1n6yds22hxwe8xjgfpzJyxby5zyWCAPSy36Kg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
+        "@babel/parser": "^7.28.0",
+        "@babel/traverse": "^7.28.0",
         "@darraghor/eslint-plugin-nestjs-typed": "^6.9.1",
         "@eslint/js": "^9.35.0",
         "@types/node": "^22.19.1",
@@ -1751,12 +1752,20 @@
         "eslint-plugin-react": "^7.37.5",
         "eslint-plugin-react-hooks": "^5.2.0",
         "globals": "^16.4.0",
+        "parse5": "^7.3.0",
+        "postcss-value-parser": "^4.2.0",
         "stylelint": "^17.3.0",
         "tailwindcss-animate": "^1.0.7"
       },
       "peerDependencies": {
         "eslint": "^9.0.0",
-        "typescript-eslint": "^8.44.0"
+        "typescript-eslint": "^8.44.0",
+        "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+      },
+      "peerDependenciesMeta": {
+        "vite": {
+          "optional": true
+        }
       }
     },
     "node_modules/@lark-apaas/hey-api-custom-client-axios": {
@@ -1926,9 +1935,9 @@
       }
     },
     "node_modules/@lark-apaas/nestjs-logger": {
-      "version": "1.0.18-alpha.20260916155505",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-logger/-/nestjs-logger-1.0.18-alpha.20260916155505.tgz",
-      "integrity": "sha512-h+pNe2zobyku8PYxr49z64pr7rn/FyrPrF/Lb4KVcnnyvlxG5P+9ZMv0R4nFi24C1G5ZgZJ/JiSHgQGknpKmrw==",
+      "version": "1.0.18-alpha.20260917134424",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-logger/-/nestjs-logger-1.0.18-alpha.20260917134424.tgz",
+      "integrity": "sha512-o15uXqDlyov/L2iZmEuIzKKqvjZtebdisrYQo8goem241ZdJQYJEZvBLTstmVmaJsvHVSv7nVgpEwR3vG1fsqw==",
       "license": "MIT",
       "dependencies": {
         "@lark-apaas/nestjs-common": "^0.1.9",
@@ -1945,9 +1954,9 @@
       }
     },
     "node_modules/@lark-apaas/nestjs-mcp": {
-      "version": "0.1.1-alpha.20260916155510",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-mcp/-/nestjs-mcp-0.1.1-alpha.20260916155510.tgz",
-      "integrity": "sha512-J/cz53jY6nvzrsvVuV9/fsYwHKFbEjprAekPhB0sfPGp4839ycPULA3qFvkbqFzk8jSpXG9q0B3uyol4yI93ZQ==",
+      "version": "0.1.1-alpha.20260917134425",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-mcp/-/nestjs-mcp-0.1.1-alpha.20260917134425.tgz",
+      "integrity": "sha512-ddUclgr+QmUmq0IrM43BDMLdQyEEdbZ7qCn3X1UkxF0AgkfWgqEGEVpWUycAMRY9u123gEmufoN0pYV2qlhTlA==",
       "license": "MIT",
       "dependencies": {
         "@modelcontextprotocol/ext-apps": "^1.7.5",
@@ -9993,18 +10002,18 @@
       "license": "MIT"
     },
     "node_modules/array-includes": {
-      "version": "3.1.9",
-      "resolved": "https://registry.npmmirror.com/array-includes/-/array-includes-3.1.9.tgz",
-      "integrity": "sha512-FmeCCAenzH0KH381SPT5FZmiA/TmpndpcaShhfgEN9eCVjnFBqq3l1xrI42y8+PPLI6hypzou4GXw00WHmPBLQ==",
+      "version": "3.2.0",
+      "resolved": "https://registry.npmmirror.com/array-includes/-/array-includes-3.2.0.tgz",
+      "integrity": "sha512-VXY5eFRarnXcYxwBjJzPmEhH55+rmP79/+ueDhi0F+TuqfHCItagIHqxeUZrmgrOPa31QTh9H85DjX3FfJ0FTg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "call-bind": "^1.0.8",
+        "call-bind": "^1.0.9",
         "call-bound": "^1.0.4",
         "define-properties": "^1.2.1",
-        "es-abstract": "^1.24.0",
-        "es-object-atoms": "^1.1.1",
-        "get-intrinsic": "^1.3.0",
+        "es-abstract": "^1.24.2",
+        "es-object-atoms": "^1.1.2",
+        "es-shim-unscopables": "^1.1.0",
         "is-string": "^1.1.1",
         "math-intrinsics": "^1.1.0"
       },
@@ -12840,9 +12849,9 @@
       }
     },
     "node_modules/eslint-plugin-import/node_modules/brace-expansion": {
-      "version": "1.1.18",
-      "resolved": "https://registry.npmmirror.com/brace-expansion/-/brace-expansion-1.1.18.tgz",
-      "integrity": "sha512-Edep/X9fGqVNmzKBVsDYIOtD+z1tuezV70LBjdCst9Tqu76lsnvRiZ6oTic1n+/BIwX6QDGAO94PN4N2SADvtw==",
+      "version": "1.1.21",
+      "resolved": "https://registry.npmmirror.com/brace-expansion/-/brace-expansion-1.1.21.tgz",
+      "integrity": "sha512-9zeA+KLZNNzglF2TPKRQEDyx6Yby7daAkuy8MiPzpXPsYDWi/DRM8jmwUDxokQjYqBpv5DgPiwD4h4ZZSy1Ujw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -12896,16 +12905,6 @@
         "semver": "bin/semver.js"
       }
     },
-    "node_modules/eslint-plugin-import/node_modules/strip-bom": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmmirror.com/strip-bom/-/strip-bom-3.0.0.tgz",
-      "integrity": "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=4"
-      }
-    },
     "node_modules/eslint-plugin-import/node_modules/tsconfig-paths": {
       "version": "3.15.0",
       "resolved": "https://registry.npmmirror.com/tsconfig-paths/-/tsconfig-paths-3.15.0.tgz",
@@ -12966,9 +12965,9 @@
       }
     },
     "node_modules/eslint-plugin-react/node_modules/brace-expansion": {
-      "version": "1.1.18",
-      "resolved": "https://registry.npmmirror.com/brace-expansion/-/brace-expansion-1.1.18.tgz",
-      "integrity": "sha512-Edep/X9fGqVNmzKBVsDYIOtD+z1tuezV70LBjdCst9Tqu76lsnvRiZ6oTic1n+/BIwX6QDGAO94PN4N2SADvtw==",
+      "version": "1.1.21",
+      "resolved": "https://registry.npmmirror.com/brace-expansion/-/brace-expansion-1.1.21.tgz",
+      "integrity": "sha512-9zeA+KLZNNzglF2TPKRQEDyx6Yby7daAkuy8MiPzpXPsYDWi/DRM8jmwUDxokQjYqBpv5DgPiwD4h4ZZSy1Ujw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -13541,9 +13540,9 @@
       "license": "MIT"
     },
     "node_modules/fast-uri": {
-      "version": "3.1.7",
-      "resolved": "https://registry.npmmirror.com/fast-uri/-/fast-uri-3.1.7.tgz",
-      "integrity": "sha512-dOvZVzjdZdz7phd9v6jCbwxrBW3fK6n8Rc0CtdmM4bumzMnxywBYhuph6J819RRw/ku+rLbelwfMunktuzVVHg==",
+      "version": "3.1.8",
+      "resolved": "https://registry.npmmirror.com/fast-uri/-/fast-uri-3.1.8.tgz",
+      "integrity": "sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg==",
       "funding": [
         {
           "type": "github",
@@ -14291,9 +14290,9 @@
       }
     },
     "node_modules/glob/node_modules/brace-expansion": {
-      "version": "5.0.9",
-      "resolved": "https://registry.npmmirror.com/brace-expansion/-/brace-expansion-5.0.9.tgz",
-      "integrity": "sha512-ScQ4IuvIEF1TMlP7Zt+vjJ//9zlPb2SDcxWxM3bk8s6t6GGdJ7KO1dCcTidOPJKePW30LE/2cT7wCyPho9/Wxg==",
+      "version": "5.0.12",
+      "resolved": "https://registry.npmmirror.com/brace-expansion/-/brace-expansion-5.0.12.tgz",
+      "integrity": "sha512-YovQ3rzhaLMIrDjNDMkNS01tea93qhEhG5xy8f6+R0l+dw3Ki+5sCoIoI942iuLZTHWogWktgwVDhU09iNEimQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -14685,9 +14684,9 @@
       }
     },
     "node_modules/hono": {
-      "version": "4.13.7",
-      "resolved": "https://registry.npmmirror.com/hono/-/hono-4.13.7.tgz",
-      "integrity": "sha512-c8/gF9ac8Y78/agExVocyLevgR+JlpNB444Py0FSX8pJoPdYUfUzRcXtYEYGwt6l19qIlVZPN5Mfsw9jFShmQQ==",
+      "version": "4.13.8",
+      "resolved": "https://registry.npmmirror.com/hono/-/hono-4.13.8.tgz",
+      "integrity": "sha512-/Gng7NfoykZl2pjukW5Z6+8Yxm3BPRf86GTbQnt0SbySkvax4fyL4H3HhY1cCpBGmiW9XDRFzRV+CXK2W8QudQ==",
       "license": "MIT",
       "engines": {
         "node": ">=16.9.0"
@@ -15026,9 +15025,9 @@
       }
     },
     "node_modules/ip-address": {
-      "version": "10.7.0",
-      "resolved": "https://registry.npmmirror.com/ip-address/-/ip-address-10.7.0.tgz",
-      "integrity": "sha512-BGFsyJd5mpXp3rK6jIdADLNgpJUK1jnjzvYF8lK+VyDab9JAmqN0YOKDdP17HlgKb2+ehPgDc8EtnRLbGCAMhA==",
+      "version": "10.7.2",
+      "resolved": "https://registry.npmmirror.com/ip-address/-/ip-address-10.7.2.tgz",
+      "integrity": "sha512-7H/2gFSIitxc0hG3nOI1glS8QLo/EHBFFLk8vEUjXY/xu0AdL8jZ9U1IzO2PUm0d2D/ofQcAifb0g6OBkt8U7w==",
       "license": "MIT",
       "engines": {
         "node": ">= 12"
@@ -16400,6 +16399,16 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/lru-cache": {
+      "version": "11.5.2",
+      "resolved": "https://registry.npmmirror.com/lru-cache/-/lru-cache-11.5.2.tgz",
+      "integrity": "sha512-4pfM1Ff0x50o0tQwb5ucw/RzNyD0/YJME6IVcStalZuMWxdt3sR3huStTtxz4PUmvZfRguvDejasvQ2kifR11g==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
     "node_modules/lucide-react": {
       "version": "0.577.0",
       "resolved": "https://registry.npmmirror.com/lucide-react/-/lucide-react-0.577.0.tgz",
@@ -18472,16 +18481,6 @@
         "url": "https://github.com/sponsors/isaacs"
       }
     },
-    "node_modules/path-scurry/node_modules/lru-cache": {
-      "version": "11.5.2",
-      "resolved": "https://registry.npmmirror.com/lru-cache/-/lru-cache-11.5.2.tgz",
-      "integrity": "sha512-4pfM1Ff0x50o0tQwb5ucw/RzNyD0/YJME6IVcStalZuMWxdt3sR3huStTtxz4PUmvZfRguvDejasvQ2kifR11g==",
-      "dev": true,
-      "license": "BlueOak-1.0.0",
-      "engines": {
-        "node": "20 || >=22"
-      }
-    },
     "node_modules/path-to-regexp": {
       "version": "3.3.0",
       "resolved": "https://registry.npmmirror.com/path-to-regexp/-/path-to-regexp-3.3.0.tgz",
@@ -21247,6 +21246,16 @@
         "node": ">=8"
       }
     },
+    "node_modules/strip-bom": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmmirror.com/strip-bom/-/strip-bom-3.0.0.tgz",
+      "integrity": "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
     "node_modules/strip-dirs": {
       "version": "3.0.0",
       "resolved": "https://registry.npmmirror.com/strip-dirs/-/strip-dirs-3.0.0.tgz",
@@ -22201,16 +22210,6 @@
         "node": ">=10.13.0"
       }
     },
-    "node_modules/tsconfig-paths/node_modules/strip-bom": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmmirror.com/strip-bom/-/strip-bom-3.0.0.tgz",
-      "integrity": "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=4"
-      }
-    },
     "node_modules/tslib": {
       "version": "2.8.1",
       "resolved": "https://registry.npmmirror.com/tslib/-/tslib-2.8.1.tgz",
@@ -22302,19 +22301,18 @@
       }
     },
     "node_modules/typed-array-byte-offset": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmmirror.com/typed-array-byte-offset/-/typed-array-byte-offset-1.0.4.tgz",
-      "integrity": "sha512-bTlAFB/FBYMcuX81gbL4OcpH5PmlFHqlCCpAl8AlEzMz5k53oNDvN8p1PNOWLEmI2x4orp3raOFB51tv9X+MFQ==",
+      "version": "1.0.5",
+      "resolved": "https://registry.npmmirror.com/typed-array-byte-offset/-/typed-array-byte-offset-1.0.5.tgz",
+      "integrity": "sha512-0FHJvLPqZ7KJzp17O13jfsAjsqazgrxBu2zEK95PmUz8lv2+GjRuxUInCr2Rk9Dms3ihN21zJ929ZO43yJ95QQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "available-typed-arrays": "^1.0.7",
-        "call-bind": "^1.0.8",
-        "for-each": "^0.3.3",
+        "call-bind": "^1.0.9",
+        "for-each": "^0.3.5",
         "gopd": "^1.2.0",
-        "has-proto": "^1.2.0",
         "is-typed-array": "^1.1.15",
-        "reflect.getprototypeof": "^1.0.9"
+        "reflect.getprototypeof": "^1.0.10"
       },
       "engines": {
         "node": ">= 0.4"
@@ -23416,9 +23414,9 @@
       }
     },
     "node_modules/which-typed-array": {
-      "version": "1.1.22",
-      "resolved": "https://registry.npmmirror.com/which-typed-array/-/which-typed-array-1.1.22.tgz",
-      "integrity": "sha512-fvO4ExWMFsqyhG3AiPAObMuY1lxaqgYcxbc49CNdWDDECOJNgQyvsOWVwbZc+qf3rzRtxojBK+CMEv0Ld5CYpw==",
+      "version": "1.1.23",
+      "resolved": "https://registry.npmmirror.com/which-typed-array/-/which-typed-array-1.1.23.tgz",
+      "integrity": "sha512-JMh8aK+1B/0bk/YNupICmH5MgCq6yNLKYQUfsZtSDLLCCmxUkHjUY+oOlIa90lO7lHN1woAfpenLdlKpXy9o+A==",
       "dev": true,
       "license": "MIT",
       "dependencies": {

package/template/package.json

@@ -18,19 +18,18 @@
     "build:server": "NODE_ENV=production nest build",
     "build:client": "NODE_ENV=production vite build --config vite.config.ts",
     "start": "NODE_ENV=production node main.js",
-    "eslint": "eslint . --quiet --ignore-pattern \"server/mcp/ui/**\"",
+    "eslint": "eslint . --quiet",
     "stylelint": "stylelint client/src/**/*.css --quiet",
-    "type:check": "node ./scripts/lint.js --typecheck",
+    "type:check": "concurrently -n \"server,client,mcp-ui\" -c \"blue,green,magenta\" \"npm run type:check:server\" \"npm run type:check:client\" \"npm run type:check:mcp-ui\"",
     "type:check:client": "tsc --noEmit --project tsconfig.app.json",
     "type:check:server": "tsc --noEmit --project tsconfig.node.json",
     "lint": "node ./scripts/lint.js",
     "precommit": "node scripts/hooks/run-precommit.js",
     "upgrade": "npx -y @lark-apaas/fullstack-cli sync --disable-gen-openapi",
-    "type:check:mcp-ui": "node ./scripts/lint.js --typecheck-mcp-ui",
-    "eslint:mcp-ui": "node ./scripts/lint.js --eslint-mcp-ui"
+    "type:check:mcp-ui": "node ./scripts/typecheck-mcp-ui.js"
   },
   "dependencies": {
-    "@lark-apaas/fullstack-nestjs-core": "1.1.62-alpha.20260916155509",
+    "@lark-apaas/fullstack-nestjs-core": "1.1.62-alpha.20260917134431",
     "@nestjs/axios": "^4.0.1",
     "@nestjs/cache-manager": "^3.1.3",
     "@nestjs/common": "^10.4.20",
@@ -55,8 +54,8 @@
   "devDependencies": {
     "@hookform/resolvers": "^5.2.2",
     "@lark-apaas/client-toolkit": "^1.2.70",
-    "@lark-apaas/coding-preset-vite-react": "1.0.23-alpha.20260915164951",
-    "@lark-apaas/fullstack-presets": "^1.1.0",
+    "@lark-apaas/coding-preset-vite-react": "1.0.24-alpha.20260917134427",
+    "@lark-apaas/fullstack-presets": "1.1.24-alpha.20260917134434",
     "@nestjs/cli": "^10.4.9",
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-alert-dialog": "^1.1.15",

package/template/scripts/lint.js

@@ -1,41 +1,11 @@
 #!/usr/bin/env node
 
 const path = require('node:path');
-const { spawn } = require('node:child_process');
 const fs = require('node:fs');
+const { spawn } = require('node:child_process');
 
 const cwd = process.cwd();
 
-function getBinName(name) {
-  return process.platform === 'win32' ? `${name}.cmd` : name;
-}
-
-function runCommand(command, args) {
-  return new Promise((resolve) => {
-    const child = spawn(command, args, {
-      cwd,
-      stdio: 'inherit',
-      shell: false,
-    });
-
-    child.on('close', (code) => resolve(code ?? 1));
-    child.on('error', () => resolve(1));
-  });
-}
-
-// 串行依次执行每个任务，全部跑完后再聚合退出码：
-// 降低并发资源占用、让各任务输出按顺序清晰可读，同时保留“一次暴露所有 lint 问题”的行为。
-async function runTasksSerially(taskSpecs) {
-  let exitCode = 0;
-  for (const [command, args] of taskSpecs) {
-    const code = await runCommand(command, args);
-    if (code !== 0) {
-      exitCode = 1;
-    }
-  }
-  return exitCode;
-}
-
 function normalizeProjectFile(filePath) {
   const absolutePath = path.isAbsolute(filePath)
     ? filePath
@@ -46,7 +16,11 @@ function normalizeProjectFile(filePath) {
   }
 
   const relativePath = path.relative(cwd, absolutePath);
-  if (relativePath.startsWith('..')) {
+  if (
+    relativePath === '..' ||
+    relativePath.startsWith(`..${path.sep}`) ||
+    path.isAbsolute(relativePath)
+  ) {
     console.warn(`[lint] Skip file outside project: ${filePath}`);
     return null;
   }
@@ -103,16 +77,43 @@ function canRunStylelint() {
 
   if (!pkg.scripts || !pkg.scripts.stylelint) return false;
 
-  return STYLELINT_CONFIG_FILES.some(file => fs.existsSync(path.join(cwd, file)));
+  return STYLELINT_CONFIG_FILES.some(file =>
+    fs.existsSync(path.join(cwd, file))
+  );
 }
 
-const UI_DIR = 'server/mcp/ui';
-const UI_TYPECHECK = 'node ./scripts/lint.js --typecheck';
+function getBinName(name) {
+  return process.platform === 'win32' ? `${name}.cmd` : name;
+}
 
-function isUiFile(file) {
-  return file.startsWith(`${UI_DIR}/`);
+function runCommand(command, args) {
+  return new Promise(resolve => {
+    const child = spawn(command, args, {
+      cwd,
+      stdio: 'inherit',
+      shell: false,
+    });
+
+    child.on('close', code => resolve(code ?? 1));
+    child.on('error', () => resolve(1));
+  });
 }
 
+// 串行依次执行每个任务，全部跑完后再聚合退出码：
+// 降低并发资源占用、让各任务输出按顺序清晰可读，同时保留“一次暴露所有 lint 问题”的行为。
+async function runTasksSerially(taskSpecs) {
+  let exitCode = 0;
+  for (const [command, args] of taskSpecs) {
+    const code = await runCommand(command, args);
+    if (code !== 0) {
+      exitCode = 1;
+    }
+  }
+  return exitCode;
+}
+
+const UI_DIR = 'server/mcp/ui';
+
 function uiSourceFiles() {
   const files = [];
   function visit(relative) {
@@ -124,9 +125,11 @@ function uiSourceFiles() {
     for (const entry of fs.readdirSync(absolute, { withFileTypes: true })) {
       if (['node_modules', 'dist', '.git'].includes(entry.name)) continue;
       const file = `${relative}/${entry.name}`;
-      if (entry.isSymbolicLink()) throw new Error(`MCP UI 检查不支持符号链接: ${file}`);
+      if (entry.isSymbolicLink())
+        throw new Error(`MCP UI 检查不支持符号链接: ${file}`);
       if (entry.isDirectory()) visit(file);
-      else if (isEslintTarget(file) && !/\.d\.(?:ts|mts|cts)$/.test(file)) files.push(file);
+      else if (isEslintTarget(file) && !/\.d\.(?:ts|mts|cts)$/.test(file))
+        files.push(file);
     }
   }
   visit(UI_DIR);
@@ -137,43 +140,50 @@ function uiTasks({ types = true, eslint = true } = {}) {
   const sources = uiSourceFiles();
   if (!sources.length) return [];
   const tasks = [];
-  if (types) {
-    const config = `${UI_DIR}/tsconfig.json`;
-    if (!fs.existsSync(path.join(cwd, config))) {
-      throw new Error(`MCP UI 缺少 ${config}，请按 mcp-guide 补齐独立浏览器 TypeScript 配置。`);
-    }
-    const ts = require('typescript');
-    const parsed = ts.getParsedCommandLineOfConfigFile(path.join(cwd, config), {}, {
-      ...ts.sys,
-      onUnRecoverableConfigFileDiagnostic: d => { throw new Error(ts.flattenDiagnosticMessageText(d.messageText, '\n')); },
-    });
-    if (!parsed || parsed.errors.length) throw new Error(`MCP UI TypeScript 配置无效: ${config}`);
-    const included = new Set(parsed.fileNames.map(file => path.resolve(file)));
-    const missing = sources.filter(file => !included.has(path.resolve(cwd, file)));
-    if (missing.length) throw new Error(`MCP UI TypeScript 配置未覆盖源码: ${missing.join(', ')}；请检查 include/exclude，JS 源码需开启 allowJs。`);
-    tasks.push([getBinName('npx'), ['--no-install', 'tsc', '--noEmit', '-p', config]]);
-  }
+  if (types) tasks.push([getBinName('npm'), ['run', 'type:check:mcp-ui']]);
   if (eslint) {
-    const config = ['eslint.mcp-ui.config.js', 'eslint.mcp-ui.config.cjs', 'eslint.mcp-ui.config.mjs']
-      .find(file => fs.existsSync(path.join(cwd, file)));
-    if (!config) throw new Error('MCP UI 缺少独立 ESLint 配置，请按 mcp-guide 创建 eslint.mcp-ui.config.cjs。');
-    tasks.push([getBinName('npx'), ['--no-install', 'eslint', '--config', config, '--quiet', '--max-warnings', '0', ...sources]]);
+    const config = [
+      'eslint.mcp-ui.config.js',
+      'eslint.mcp-ui.config.cjs',
+      'eslint.mcp-ui.config.mjs',
+    ].find(file => fs.existsSync(path.join(cwd, file)));
+    let resolvedConfig = config;
+    if (!resolvedConfig) {
+      try {
+        resolvedConfig =
+          require.resolve('@lark-apaas/fullstack-presets/lib/mcp/eslint-ui.js');
+      } catch {
+        throw new Error(
+          '请升级 @lark-apaas/fullstack-presets 以使用 MCP UI 默认 ESLint 配置，或提供 eslint.mcp-ui.config.cjs'
+        );
+      }
+    }
+    tasks.push([
+      getBinName('npx'),
+      [
+        '--no-install',
+        'eslint',
+        '--config',
+        resolvedConfig,
+        '--quiet',
+        '--max-warnings',
+        '0',
+        ...sources,
+      ],
+    ]);
   }
   return tasks;
 }
 
 function packageScripts() {
-  return JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8')).scripts || {};
+  return (
+    JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'))
+      .scripts || {}
+  );
 }
 
-async function runTypeCheck() {
-  const scripts = packageScripts();
-  const tasks = ['type:check:server', 'type:check:client'].map(name => {
-    if (!scripts[name]) throw new Error(`缺少 scripts.${name}，请保留应用原有类型检查命令。`);
-    return [getBinName('npm'), ['run', name]];
-  });
-  tasks.push(...uiTasks({ eslint: false }));
-  process.exit(await runTasksSerially(tasks));
+function isUiFile(file) {
+  return file.startsWith('server/mcp/ui/');
 }
 
 async function runDefaultLint() {
@@ -182,13 +192,21 @@ async function runDefaultLint() {
     [getBinName('npm'), ['run', 'type:check']],
   ];
 
-  // Customized type:check remains untouched; ensure full lint still checks UI.
-  taskSpecs.push(...uiTasks({ types: packageScripts()['type:check'] !== UI_TYPECHECK }));
+  // 保留用户的 type:check；未聚合 UI 时由 lint 补查。
+  taskSpecs.push(
+    ...uiTasks({
+      types: !/\bnpm\s+run\s+type:check:mcp-ui(?=[\s"';&|)]|$)/.test(
+        packageScripts()['type:check'] || ''
+      ),
+    })
+  );
 
   if (canRunStylelint()) {
     taskSpecs.push([getBinName('npm'), ['run', 'stylelint']]);
   } else {
-    console.warn('[lint] Skip stylelint: missing scripts.stylelint or stylelint config');
+    console.warn(
+      '[lint] Skip stylelint: missing scripts.stylelint or stylelint config'
+    );
   }
 
   process.exit(await runTasksSerially(taskSpecs));
@@ -196,7 +214,7 @@ async function runDefaultLint() {
 
 async function runSelectiveLint(inputFiles) {
   const normalizedFiles = Array.from(
-    new Set(inputFiles.map(normalizeProjectFile).filter(Boolean)),
+    new Set(inputFiles.map(normalizeProjectFile).filter(Boolean))
   );
 
   if (normalizedFiles.length === 0) {
@@ -204,15 +222,36 @@ async function runSelectiveLint(inputFiles) {
     process.exit(0);
   }
 
-  const eslintFiles = normalizedFiles.filter(file => fs.existsSync(path.join(cwd, file)) && isEslintTarget(file) && !isUiFile(file) && !file.startsWith('eslint.mcp-ui.config.'));
-  const stylelintFiles = normalizedFiles.filter(file => fs.existsSync(path.join(cwd, file)) && isStylelintTarget(file));
+  const eslintFiles = normalizedFiles.filter(
+    file =>
+      fs.existsSync(path.join(cwd, file)) &&
+      isEslintTarget(file) &&
+      !isUiFile(file) &&
+      !file.startsWith('eslint.mcp-ui.config.')
+  );
+  const stylelintFiles = normalizedFiles.filter(
+    file => fs.existsSync(path.join(cwd, file)) && isStylelintTarget(file)
+  );
   const typeCheckFiles = normalizedFiles.filter(isTypeCheckTarget);
 
   const clientTypeFiles = [];
   const serverTypeFiles = [];
-  const rootConfigChanged = normalizedFiles.some(file => /^tsconfig(?:\.[^/]*)?\.json$/.test(file));
-  if (rootConfigChanged) { clientTypeFiles.push('config'); serverTypeFiles.push('config'); }
-  let checkUi = rootConfigChanged || normalizedFiles.some(file => isUiFile(file) || file.startsWith('shared/') || file.startsWith('eslint.mcp-ui.config.'));
+  const rootConfigChanged = normalizedFiles.some(file =>
+    /^tsconfig(?:\.[^/]*)?\.json$/.test(file)
+  );
+  if (rootConfigChanged) {
+    clientTypeFiles.push('config');
+    serverTypeFiles.push('config');
+  }
+  let checkUi =
+    rootConfigChanged ||
+    normalizedFiles.some(
+      file =>
+        isUiFile(file) ||
+        file.startsWith('shared/') ||
+        file.startsWith('eslint.mcp-ui.config.') ||
+        file === 'package.json'
+    );
 
   for (const filePath of typeCheckFiles) {
     if (isUiFile(filePath)) {
@@ -234,9 +273,14 @@ async function runSelectiveLint(inputFiles) {
   }
 
   if (stylelintFiles.length > 0 && !canRunStylelint()) {
-    console.warn('[lint] Skip stylelint: missing scripts.stylelint or stylelint config');
+    console.warn(
+      '[lint] Skip stylelint: missing scripts.stylelint or stylelint config'
+    );
   } else if (stylelintFiles.length > 0) {
-    taskSpecs.push([getBinName('npx'), ['stylelint', '--quiet', ...stylelintFiles]]);
+    taskSpecs.push([
+      getBinName('npx'),
+      ['stylelint', '--quiet', ...stylelintFiles],
+    ]);
   }
 
   if (clientTypeFiles.length > 0) {
@@ -259,14 +303,15 @@ async function runSelectiveLint(inputFiles) {
 
 async function main() {
   const args = process.argv.slice(2);
-  const modes = ['--typecheck', '--typecheck-mcp-ui', '--eslint-mcp-ui'];
-  if (args.length && !(args[0] === '--files' && args.length > 1) && !(args.length === 1 && modes.includes(args[0]))) {
-    throw new Error('用法: lint.js [--files <paths...> | --typecheck | --typecheck-mcp-ui | --eslint-mcp-ui]');
+  if (args.length === 1 && args[0] === '--eslint-mcp-ui') {
+    process.exit(await runTasksSerially(uiTasks({ types: false })));
+    return;
+  }
+  if (args.length && !(args[0] === '--files' && args.length > 1)) {
+    throw new Error('用法: lint.js [--files <paths...>]');
   }
-  if (args[0] === '--files' && args.slice(1).some(arg => arg.startsWith('--'))) throw new Error('--files 不可与其他检查模式混用');
-  if (args.includes('--typecheck')) return runTypeCheck();
-  if (args.includes('--typecheck-mcp-ui')) return process.exit(await runTasksSerially(uiTasks({ eslint: false })));
-  if (args.includes('--eslint-mcp-ui')) return process.exit(await runTasksSerially(uiTasks({ types: false })));
+  if (args[0] === '--files' && args.slice(1).some(arg => arg.startsWith('--')))
+    throw new Error('--files 不可与其他检查模式混用');
   const files = parseFilesArg(process.argv.slice(2));
   if (files === null) {
     await runDefaultLint();
@@ -281,7 +326,7 @@ async function main() {
   await runSelectiveLint(files);
 }
 
-main().catch((error) => {
+main().catch(error => {
   const message = error instanceof Error ? error.message : String(error);
   console.error(`[lint] Failed to run lint: ${message}`);
   process.exit(1);

package/template/scripts/typecheck-mcp-ui.js

@@ -0,0 +1,32 @@
+// MCP UI 是可选浏览器工程；没有源码时跳过，否则直接交给 tsc。
+const fs = require('node:fs');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+function hasSource(dir) {
+  if (!fs.existsSync(dir)) return false;
+  return fs.readdirSync(dir, { withFileTypes: true }).some(entry => {
+    if (['node_modules', 'dist'].includes(entry.name)) return false;
+    if (entry.isDirectory()) return hasSource(path.join(dir, entry.name));
+    return entry.isFile() && /\.(?:[cm]?[jt]sx?)$/.test(entry.name);
+  });
+}
+
+if (hasSource('server/mcp/ui')) {
+  // 已有应用的独立 UI 配置继续生效，避免升级覆盖自定义 paths/types。
+  const config = fs.existsSync('server/mcp/ui/tsconfig.json')
+    ? 'server/mcp/ui/tsconfig.json'
+    : 'tsconfig.mcp-ui.json';
+  const result = spawnSync(
+    process.execPath,
+    [
+      require.resolve('typescript/bin/tsc'),
+      '--noEmit',
+      '--project',
+      config,
+    ],
+    { stdio: 'inherit' }
+  );
+  if (result.error) console.error(result.error.message);
+  process.exitCode = result.status ?? 1;
+}

package/template/tsconfig.mcp-ui.json

@@ -0,0 +1,33 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "types": [],
+    "strict": true,
+    "checkJs": true,
+    "lib": [
+      "ES2020",
+      "DOM",
+      "DOM.Iterable"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "noEmit": true,
+    "baseUrl": ".",
+    "paths": {
+      "@shared/*": [
+        "shared/*"
+      ]
+    }
+  },
+  "include": [
+    "server/mcp/ui/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}