@lark-apaas/coding-template-nestjs-react-fullstack 0.1.43-alpha.20260918074821 → 0.1.43

package/README.md

@@ -27,16 +27,6 @@ MIAODA_APP_TYPE=3 npx @lark-apaas/miaoda-cli@<latest> app init \
 - `SANDBOX_PUBLIC_URL` —— 沙箱公网域
 - `CLIENT_BASE_PATH=/app/<app_id>/` —— React Router basename + Vite base
 
-## MCP UI 的类型与代码检查
-
-创建 MCP UI 时，Agent 在 `server/mcp/ui` 中同时生成 `tsconfig.json` 和 `eslint.config.cjs`，修改 UI 或其 shared 依赖后主动运行独立检查。模板和 CLI 不生成 UI 配置，也不将 UI 检查接入主工程 lint/type:check。
-
-主工程保留原 client/server 检查。Agent 从工程根执行 `npx --no-install tsc --noEmit --project server/mcp/ui/tsconfig.json`，再执行 `npx --no-install eslint --config server/mcp/ui/eslint.config.cjs "server/mcp/ui/**/*.{ts,tsx,js,jsx}" --max-warnings 0`；必须检查退出码并修复错误。无需辅助脚本或新增 npm 命令。
-
-CLI 不注入 MCP UI 检查命令；主工程保留原有 client/server 检查，UI 由 Agent 按独立配置执行标准 tsc/eslint。
-
-存量 sync 不改写 ESLint 源码；UI 全局排除项由平台 ESLint 预设提供。TS 仅向已有显式 `exclude` 数组追加目录，保留注释和原项；依赖继承且未显式声明 `exclude` 的自定义配置保持不变并提示人工调整。自定义检查命令保留。UI ESLint 配置可显式引用 `fullstack-presets/lib/mcp/eslint-ui`。
-
 ## 包结构
 
 ```
@@ -49,11 +39,3 @@ CLI 不注入 MCP UI 检查命令；主工程保留原有 client/server 检查
 `template/` 内以下划线开头的占位文件（`_gitignore` / `_npmrc` / `_env.local`）在 `miaoda app init`
 渲染时会按 RENAME 映射改回正常名（npm pack 会特殊处理 `.gitignore`、且 `.npmrc` 直接放
 在包里会污染用户 `npm install` 行为，所以都要 underscore 前缀）。
-
-## MCP 版本与 UI 检查
-
-模板不生成 `mcp-build-id`，构建脚本沿用原流程。SDK 发布态使用 veFaaS 函数 ID 与发布 revision；开发态使用后端编译产物指纹，UI/Skill 内容继续独立计入修订。首次升级切换版本来源后，Host 应重新发现。
-
-MCP UI 的 `tsconfig.json` 和 `eslint.config.cjs` 由 Agent 随 UI 在 `server/mcp/ui` 中创建，执行命令与完整示例见 coding-steering 的 `mcp-ui-guide`。主工程的 TS/ESLint 排除该浏览器目录，不自动运行 UI 检查；不为无 UI 的应用创建配置或检查命令。
-
-`server/mcp/ui` 与 `server/mcp/skills` 变更应由平台判为后端发布；纯前端发布不替换已部署 MCP 产物，也不承诺热更 MCP UI。发布版本号仅在实际后端发布时更新。

package/package.json

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

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.63-alpha.20260918073530",
+        "@lark-apaas/fullstack-nestjs-core": "^1.1.63",
         "@nestjs/axios": "^4.0.1",
         "@nestjs/cache-manager": "^3.1.3",
         "@nestjs/common": "^10.4.20",
@@ -32,9 +32,9 @@
       },
       "devDependencies": {
         "@hookform/resolvers": "^5.2.2",
-        "@lark-apaas/client-toolkit": "^1.2.70",
-        "@lark-apaas/coding-preset-vite-react": "1.0.24-alpha.20260918073537",
-        "@lark-apaas/fullstack-presets": "1.1.24-alpha.20260918073533",
+        "@lark-apaas/client-toolkit": "^1.2.72",
+        "@lark-apaas/coding-preset-vite-react": "^1.0.24",
+        "@lark-apaas/fullstack-presets": "^1.1.24",
         "@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.20260918073529",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/cache-service/-/cache-service-0.1.2-alpha.20260918073529.tgz",
-      "integrity": "sha512-clbSkhhZ3iRRrvaE2KAtwYJwF1X1YlFgrb4LtJDnGss61PTWGNIrFJuz0HXZKTecLEzwTrro6xrdk5d8Jo1PTA==",
+      "version": "0.1.2",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/cache-service/-/cache-service-0.1.2.tgz",
+      "integrity": "sha512-0n24sTo1QyH/8lHs8GUcM/E+zeDau2d5Wqga8QY0A/VbjxctCtmDc8SwN1Zl8mioLNalF3QotnBsNWnOHuOw/A==",
       "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.20260918073532",
+        "@lark-apaas/nestjs-logger": "^1.0.18",
         "@lark-apaas/nestjs-observable": "^0.0.12",
         "@nestjs/common": "^10.0.0",
         "@nestjs/core": "^10.0.0"
@@ -1579,9 +1579,9 @@
       }
     },
     "node_modules/@lark-apaas/client-toolkit": {
-      "version": "1.2.70",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/client-toolkit/-/client-toolkit-1.2.70.tgz",
-      "integrity": "sha512-U6vGe1DF8gq/CGRQYG0Mjr42A3hlV3yPDmAs8UP6qttiFIdXPxovpP3aJ2e2Q1p58dZ03qxsuLKXQRprubz4Hg==",
+      "version": "1.2.72",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/client-toolkit/-/client-toolkit-1.2.72.tgz",
+      "integrity": "sha512-+oBqT1fGLESakZjQJ1MUULxsYkTEH8rBBenu0wG+r+aGm62Upd3RcstAKCkOPOTpohrV4jgiHOifyyU8mk2NFg==",
       "dev": true,
       "dependencies": {
         "@ant-design/colors": "^7.2.1",
@@ -1589,7 +1589,7 @@
         "@lark-apaas/aily-web-sdk": "^0.0.12",
         "@lark-apaas/auth-sdk": "^0.1.5",
         "@lark-apaas/client-capability": "^0.1.7",
-        "@lark-apaas/dataloom": "^0.1.4",
+        "@lark-apaas/dataloom": "^0.1.5",
         "@lark-apaas/internal-slardar": "^0.0.3",
         "@lark-apaas/miaoda-inspector": "^1.0.24",
         "@lark-apaas/observable-web": "^1.0.6",
@@ -1634,9 +1634,9 @@
       "license": "MIT"
     },
     "node_modules/@lark-apaas/coding-preset-vite-react": {
-      "version": "1.0.24-alpha.20260918073537",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/coding-preset-vite-react/-/coding-preset-vite-react-1.0.24-alpha.20260918073537.tgz",
-      "integrity": "sha512-LdMzK/qyS349cFYFlfzYFy51SMv8UuDp/EkJtFSJzW20A4CM/k7HzIR1WXL+9Nxv4/T5MNme77M60YIKqWLKpA==",
+      "version": "1.0.24",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/coding-preset-vite-react/-/coding-preset-vite-react-1.0.24.tgz",
+      "integrity": "sha512-GLha4NQ4yHYY6oRUYA0j4PryGrBjMGS5pN44+VVXSJgwbq7x9T4pFWyBQYIf+FmeYQBNbTIqg19oT7hr/CJ8OA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -1679,9 +1679,9 @@
       }
     },
     "node_modules/@lark-apaas/dataloom": {
-      "version": "0.1.4",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/dataloom/-/dataloom-0.1.4.tgz",
-      "integrity": "sha512-jiHACjhm1pYA+XsZxFdTCEvHC5SAZ7ygBCmfqVHAis/oYZIKw2sFtqNGaZaregFvOSVhSHViTXL4up67omwcJw==",
+      "version": "0.1.5",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/dataloom/-/dataloom-0.1.5.tgz",
+      "integrity": "sha512-pcVZeO7QtxjzcV1SXQtUSPHO88/f1rhc3Dp/ubXVHV92W+T65Z9Adlyh3f+OdGGMhhn2+hIUnYLsLyS9gS1vhA==",
       "dev": true,
       "dependencies": {
         "@lark-apaas/internal-slardar": "^0.0.3"
@@ -1697,12 +1697,12 @@
       }
     },
     "node_modules/@lark-apaas/fullstack-nestjs-core": {
-      "version": "1.1.63-alpha.20260918073530",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-nestjs-core/-/fullstack-nestjs-core-1.1.63-alpha.20260918073530.tgz",
-      "integrity": "sha512-j+6ZIVFu2LDPeDpm9zNhjNt8yepqwKodaau9RNcwLGLygLcurcclv+CWbuB/Qa2zY6GDUuU8vuGPrAhOU4VmRw==",
+      "version": "1.1.63",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-nestjs-core/-/fullstack-nestjs-core-1.1.63.tgz",
+      "integrity": "sha512-ymtOIAkqGzmGv2mcllHdthgCggJSKpY9slKYA4TMtpB/im9QJTnOeTZ1cgtKw0SJTL9Pqb3GJEGjlSqQk3/s9A==",
       "license": "MIT",
       "dependencies": {
-        "@lark-apaas/cache-service": "0.1.2-alpha.20260918073529",
+        "@lark-apaas/cache-service": "^0.1.2",
         "@lark-apaas/file-service": "^0.1.2",
         "@lark-apaas/http-client": "^0.1.7",
         "@lark-apaas/nestjs-authnpaas": "^1.0.6",
@@ -1711,8 +1711,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.20260918073532",
-        "@lark-apaas/nestjs-mcp": "0.1.1-alpha.20260918073534",
+        "@lark-apaas/nestjs-logger": "^1.0.18",
+        "@lark-apaas/nestjs-mcp": "^0.1.1",
         "@lark-apaas/nestjs-observable": "^0.0.12",
         "@lark-apaas/nestjs-openapi-devtools": "^1.0.10",
         "@lark-apaas/nestjs-trigger": "^0.0.3",
@@ -1735,9 +1735,9 @@
       }
     },
     "node_modules/@lark-apaas/fullstack-presets": {
-      "version": "1.1.24-alpha.20260918073533",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-presets/-/fullstack-presets-1.1.24-alpha.20260918073533.tgz",
-      "integrity": "sha512-UZfoFSgXYo0j9K40GvCusLj/Jp5SJCZJ9nDMj/T4rKkVkJLbgUbJEOzM9er5oQM/iIpr4FL1I56njg16WeFBSA==",
+      "version": "1.1.24",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/fullstack-presets/-/fullstack-presets-1.1.24.tgz",
+      "integrity": "sha512-Iq1Xsv65qAI555d7eJ+0PcuVUgmNnAjjBDNuHOmocFpqeXfpbNqgVN7cE6mZchjsSRtML762QFQLKxw9NyMsxw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -1926,9 +1926,9 @@
       }
     },
     "node_modules/@lark-apaas/nestjs-logger": {
-      "version": "1.0.18-alpha.20260918073532",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-logger/-/nestjs-logger-1.0.18-alpha.20260918073532.tgz",
-      "integrity": "sha512-Ds4swvHULFVmpmN6CHqwIZuDm74OnHm9SWIiDB+bBLuZEZMpxJPnNYTtB11zddpBq1Ahsbtyw0CIb0qqaMXVqQ==",
+      "version": "1.0.18",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-logger/-/nestjs-logger-1.0.18.tgz",
+      "integrity": "sha512-RjucJd+TmACoNfTFw20/ppAT3gaztm3qZagPDHEZabiZxg8UpF1twbmN/VLXTF/fgpyoRFS09CMxa7nfFnrT2A==",
       "license": "MIT",
       "dependencies": {
         "@lark-apaas/nestjs-common": "^0.1.9",
@@ -1945,9 +1945,9 @@
       }
     },
     "node_modules/@lark-apaas/nestjs-mcp": {
-      "version": "0.1.1-alpha.20260918073534",
-      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-mcp/-/nestjs-mcp-0.1.1-alpha.20260918073534.tgz",
-      "integrity": "sha512-tvDRUs1iE/1bIHx/76mKexi9cV7DlFXdQM1JkX2WJnhnd5Jx0AkbNHHOK2vvSV2wV0swMEd+gnaABfPVxbBrsQ==",
+      "version": "0.1.1",
+      "resolved": "https://registry.npmmirror.com/@lark-apaas/nestjs-mcp/-/nestjs-mcp-0.1.1.tgz",
+      "integrity": "sha512-l6b3Yn6yqSxf/mpTG4bF/FFZAZyXiK7G0vVF0V8GAXtaaToRu6tQ2KlWm6JF8M7S0RB+LAeUYjNd//Zs3WeIVw==",
       "license": "MIT",
       "dependencies": {
         "@modelcontextprotocol/ext-apps": "^1.7.5",

package/template/package.json

@@ -28,7 +28,7 @@
     "upgrade": "npx -y @lark-apaas/fullstack-cli sync --disable-gen-openapi"
   },
   "dependencies": {
-    "@lark-apaas/fullstack-nestjs-core": "1.1.63-alpha.20260918073530",
+    "@lark-apaas/fullstack-nestjs-core": "^1.1.63",
     "@nestjs/axios": "^4.0.1",
     "@nestjs/cache-manager": "^3.1.3",
     "@nestjs/common": "^10.4.20",
@@ -52,9 +52,9 @@
   },
   "devDependencies": {
     "@hookform/resolvers": "^5.2.2",
-    "@lark-apaas/client-toolkit": "^1.2.70",
-    "@lark-apaas/coding-preset-vite-react": "1.0.24-alpha.20260918073537",
-    "@lark-apaas/fullstack-presets": "1.1.24-alpha.20260918073533",
+    "@lark-apaas/client-toolkit": "^1.2.72",
+    "@lark-apaas/coding-preset-vite-react": "^1.0.24",
+    "@lark-apaas/fullstack-presets": "^1.1.24",
     "@nestjs/cli": "^10.4.9",
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-alert-dialog": "^1.1.15",

package/template/scripts/build.sh

@@ -3,7 +3,7 @@
 set -euo pipefail
 
 ROOT_DIR="$(pwd)"
-DIST_DIR="$ROOT_DIR/dist"
+OUT_DIR="$ROOT_DIR/dist/server"
 
 # 记录总开始时间
 TOTAL_START=$(node -e "console.log(Date.now())")
@@ -19,174 +19,94 @@ print_time() {
 }
 
 # ==================== 步骤 0 ====================
-echo "🗑️  [0/6] 安装插件"
+echo "🗑️  [0/5] 安装插件"
 STEP_START=$(node -e "console.log(Date.now())")
 npx fullstack-cli action-plugin init
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 1 ====================
-echo "📝 [1/6] 更新 openapi 代码"
+echo "📝 [1/5] 更新 openapi 代码"
 STEP_START=$(node -e "console.log(Date.now())")
 npm run gen:openapi
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 2 ====================
-echo "🗑️  [2/6] 清理 dist 目录"
+echo "🗑️  [2/5] 清理 dist 目录"
 STEP_START=$(node -e "console.log(Date.now())")
 rm -rf "$ROOT_DIR/dist"
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 3 ====================
-echo "🗺️  [3/6] 生成路由定义"
+echo "🔨 [3/5] 并行构建 server 和 client"
 STEP_START=$(node -e "console.log(Date.now())")
 
-# 在 client/server 构建之前生成到 dist/，供 DefinePlugin 注入前端 bundle
-# 注意：nest-cli.json 中 deleteOutDir 必须为 false（模板默认值），否则 nest build 会清掉 dist/
-echo "   ├─ 生成 API 路由定义..."
-npx generate-api-routes --server-dir ./server --out-dir ./dist > /tmp/gen-api-routes.log 2>&1 &
-API_ROUTES_PID=$!
+# 并行构建
+echo "   ├─ 启动 server 构建..."
+npm run build:server > /tmp/build-server.log 2>&1 &
+SERVER_PID=$!
 
-echo "   ├─ 生成页面路由定义..."
-npx generate-page-routes --app-path ./client/src/app.tsx --out-dir ./dist > /tmp/gen-page-routes.log 2>&1 &
-PAGE_ROUTES_PID=$!
+echo "   ├─ 启动 client 构建..."
+npm run build:client > /tmp/build-client.log 2>&1 &
+CLIENT_PID=$!
 
-API_ROUTES_EXIT=0
-PAGE_ROUTES_EXIT=0
+# 等待两个构建完成
+SERVER_EXIT=0
+CLIENT_EXIT=0
 
-wait $API_ROUTES_PID || API_ROUTES_EXIT=$?
-wait $PAGE_ROUTES_PID || PAGE_ROUTES_EXIT=$?
+wait $SERVER_PID || SERVER_EXIT=$?
+wait $CLIENT_PID || CLIENT_EXIT=$?
 
-if [ $API_ROUTES_EXIT -ne 0 ]; then
-  echo "   ⚠️  API 路由生成失败（不影响构建）"
-  cat /tmp/gen-api-routes.log
-else
-  echo "   ✅ API 路由生成完成"
+# 检查构建结果
+if [ $SERVER_EXIT -ne 0 ]; then
+  echo "   ❌ Server 构建失败"
+  cat /tmp/build-server.log
+  exit 1
 fi
 
-if [ $PAGE_ROUTES_EXIT -ne 0 ]; then
-  echo "   ⚠️  页面路由生成失败（不影响构建）"
-  cat /tmp/gen-page-routes.log
-else
-  echo "   ✅ 页面路由生成完成"
+if [ $CLIENT_EXIT -ne 0 ]; then
+  echo "   ❌ Client 构建失败"
+  cat /tmp/build-client.log
+  exit 1
 fi
+
+echo "   ✅ Server 构建完成"
+echo "   ✅ Client 构建完成"
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 4 ====================
-echo "🔨 [4/6] 并行构建 server 和 client"
+echo "📦 [4/5] 准备 server 依赖产物"
 STEP_START=$(node -e "console.log(Date.now())")
 
-# 给 server/client 构建子进程预留 8GB heap，缓解 vite build transform 阶段 OOM
-# （典型错误：Reached heap limit Allocation failed）。
-# 仅在外部未设置 NODE_OPTIONS 时注入，允许 CI / 用户通过外部环境变量完全覆盖
-BUILD_NODE_OPTIONS="${NODE_OPTIONS:---max-old-space-size=8192}"
-
-# 根据 only_frontend_change 决定是否构建 server
-if [[ "${only_frontend_change:-false}" == "true" ]]; then
-  echo "🔨 [4/6] 仅构建 client (only_frontend_change=true)"
-
-  echo "   ├─ 启动 client 构建..."
-  NODE_OPTIONS="$BUILD_NODE_OPTIONS" npm run build:client > /tmp/build-client.log 2>&1
-  CLIENT_EXIT=$?
-
-  if [ $CLIENT_EXIT -ne 0 ]; then
-    echo "   ❌ Client 构建失败"
-    cat /tmp/build-client.log
-    exit 1
-  fi
-
-  echo "   ✅ Client 构建完成"
-else
-  echo "🔨 [4/6] 并行构建 server 和 client"
-
-  # 并行构建
-  echo "   ├─ 启动 server 构建..."
-  NODE_OPTIONS="$BUILD_NODE_OPTIONS" npm run build:server > /tmp/build-server.log 2>&1 &
-  SERVER_PID=$!
-
-  echo "   ├─ 启动 client 构建..."
-  NODE_OPTIONS="$BUILD_NODE_OPTIONS" npm run build:client > /tmp/build-client.log 2>&1 &
-  CLIENT_PID=$!
-
-  # 等待两个构建完成
-  SERVER_EXIT=0
-  CLIENT_EXIT=0
-
-  wait $SERVER_PID || SERVER_EXIT=$?
-  wait $CLIENT_PID || CLIENT_EXIT=$?
-
-  # 检查构建结果
-  if [ $SERVER_EXIT -ne 0 ]; then
-    echo "   ❌ Server 构建失败"
-    cat /tmp/build-server.log
-    exit 1
-  fi
-
-  if [ $CLIENT_EXIT -ne 0 ]; then
-    echo "   ❌ Client 构建失败"
-    cat /tmp/build-client.log
-    exit 1
-  fi
-
-  echo "   ✅ Server 构建完成"
-  echo "   ✅ Client 构建完成"
-fi
-
-print_time $STEP_START
-echo ""
-
-# ==================== 步骤 5 ====================
-echo "📦 [5/6] 准备产物"
-STEP_START=$(node -e "console.log(Date.now())")
+mkdir -p "$OUT_DIR/dist/client"
 
-# 移动 client 下的 HTML 文件到 dist/dist/client，保证 views 路径在 dev/prod 下一致
-# 使用 mv 而非 cp：HTML 不能上传到公网 CDN，移走后 dist/client 中不再包含 HTML
-if [ -d "$DIST_DIR/client" ]; then
-  mkdir -p "$DIST_DIR/dist/client"
-  # public 先进（顶层 client 打包被排除；server setBaseViewsDir + 中间件同源 serve）
-  if [ -d "$ROOT_DIR/client/public" ]; then
-    cp -R "$ROOT_DIR/client/public/." "$DIST_DIR/dist/client/"
-  fi
-  # 构建产物 HTML 随后 move，覆盖 public 里的同名文件（保证入口页是构建版，不被 public 静默覆盖）
-  find "$DIST_DIR/client" -maxdepth 1 -name "*.html" -exec mv {} "$DIST_DIR/dist/client/" \;
+# public 先进（server setBaseViewsDir + nestjs-core 中间件同源 serve）
+if [ -d "$ROOT_DIR/client/public" ]; then
+  cp -R "$ROOT_DIR/client/public/." "$OUT_DIR/dist/client/"
 fi
 
-# server 相关产物准备（only_frontend_change=true 时跳过）
-if [[ "${only_frontend_change:-false}" == "true" ]]; then
-  echo "   [skip] 跳过 run.sh/.env 复制 (only_frontend_change=true)"
-else
-  # 拷贝 run.sh 到 dist/（prod 从 dist/ 启动，确保 cwd 一致性）
-  cp "$ROOT_DIR/scripts/run.sh" "$DIST_DIR/"
-
-  # 拷贝 .env 文件（如果存在）
-  if [ -f "$ROOT_DIR/.env" ]; then
-    cp "$ROOT_DIR/.env" "$DIST_DIR/"
-  fi
-fi
+# 构建产物 HTML 随后拷，覆盖 public 里的同名文件（保证入口页是构建版，不被 public 静默覆盖）
+cp "$ROOT_DIR/dist/client/"*.html "$OUT_DIR/dist/client/" || true
+
+# 拷贝 run.sh 文件
+cp "$ROOT_DIR/scripts/run.sh" "$OUT_DIR/"
 
 # 清理无用文件
-rm -rf "$DIST_DIR/scripts"
-rm -rf "$DIST_DIR/tsconfig.node.tsbuildinfo"
+rm -rf "$ROOT_DIR/dist/scripts"
+rm -rf "$ROOT_DIR/dist/tsconfig.node.tsbuildinfo"
 
 print_time $STEP_START
 echo ""
 
-# ==================== 步骤 6 ====================
-echo "✂️  [6/6] 智能依赖裁剪"
+# ==================== 步骤 5 ====================
+echo "✂️  [5/5] 智能依赖裁剪"
 STEP_START=$(node -e "console.log(Date.now())")
 
-# 智能依赖裁剪（仅全量构建时执行，纯前端场景不打包 server，无需裁剪）
-if [[ "${only_frontend_change:-false}" == "true" ]]; then
-  echo "✂️  [6/6] 跳过智能依赖裁剪 (only_frontend_change=true)"
-else
-  echo "✂️  [6/6] 智能依赖裁剪"
-
-  # 分析实际依赖、复制并裁剪 node_modules、生成精简的 package.json
-  node "$ROOT_DIR/scripts/prune-smart.js"
-fi
+# 分析实际依赖、复制并裁剪 node_modules、生成精简的 package.json
+node "$ROOT_DIR/scripts/prune-smart.js"
 
 print_time $STEP_START
 echo ""
@@ -196,17 +116,10 @@ echo "构建完成"
 print_time $TOTAL_START
 
 # 输出产物信息
-DIST_SIZE=$(du -sh "$DIST_DIR" | cut -f1)
-if [[ "${only_frontend_change:-false}" == "true" ]]; then
-  echo ""
-  echo "📊 构建产物统计:"
-  echo "   产物大小:        $DIST_SIZE"
-  echo ""
-else
-  NODE_MODULES_SIZE=$(du -sh "$DIST_DIR/node_modules" | cut -f1)
-  echo ""
-  echo "📊 构建产物统计:"
-  echo "   产物大小:        $DIST_SIZE"
-  echo "   node_modules: $NODE_MODULES_SIZE"
-  echo ""
-fi
+DIST_SIZE=$(du -sh "$OUT_DIR" | cut -f1)
+NODE_MODULES_SIZE=$(du -sh "$OUT_DIR/node_modules" | cut -f1)
+echo ""
+echo "📊 构建产物统计:"
+echo "   总大小:        $DIST_SIZE"
+echo "   node_modules: $NODE_MODULES_SIZE"
+echo ""

package/template/scripts/prune-smart.js

@@ -6,53 +6,15 @@ const fs = require('fs');
 const path = require('path');
 
 const ROOT_DIR = path.resolve(__dirname, '..');
-
-// 加载提交的 .env，供读取构建期配置（如 MIAODA_RUNTIME_ENTRIES）。dotenv 不一定安装 → 静默降级。
-try {
-  require('dotenv').config({ path: path.join(ROOT_DIR, '.env') });
-} catch {
-  // dotenv 未安装：跳过；MIAODA_RUNTIME_ENTRIES 仍可来自真实环境变量
-}
-const DIST_DIR = path.join(ROOT_DIR, 'dist');
-const DIST_SERVER_DIR = path.join(DIST_DIR, 'server');
+const DIST_SERVER_DIR = path.join(ROOT_DIR, 'dist/server');
 const ROOT_PACKAGE_JSON = path.join(ROOT_DIR, 'package.json');
 const ROOT_NODE_MODULES = path.join(ROOT_DIR, 'node_modules');
-const OUT_NODE_MODULES = path.join(DIST_DIR, 'node_modules');
-const OUT_PACKAGE_JSON = path.join(DIST_DIR, 'package.json');
+const OUT_NODE_MODULES = path.join(DIST_SERVER_DIR, 'node_modules');
+const OUT_PACKAGE_JSON = path.join(DIST_SERVER_DIR, 'package.json');
 
 // Server 入口文件
 const SERVER_ENTRY = path.join(DIST_SERVER_DIR, 'main.js');
 
-// nest sourceRoot（源码根，默认 server）：把 .env 里声明的源码路径映射到构建产物位置
-let SOURCE_ROOT = 'server';
-try {
-  const nestCli = JSON.parse(fs.readFileSync(path.join(ROOT_DIR, 'nest-cli.json'), 'utf8'));
-  if (nestCli.sourceRoot) SOURCE_ROOT = nestCli.sourceRoot;
-} catch {
-  // 读不到 nest-cli.json 则用默认 server
-}
-const SRC_TO_OUT_EXT = { '.mts': '.mjs', '.cts': '.cjs', '.ts': '.js' };
-
-// 额外 trace 入口：经 new Function/动态 import 加载、nft 无法从 main.js 静态发现的 ESM runtime。
-// 应用在提交的 .env 里用 MIAODA_RUNTIME_ENTRIES 声明【源码路径】（相对项目根，逗号分隔），例如：
-//   MIAODA_RUNTIME_ENTRIES=server/modules/ethics/runtime/review-run.mjs,server/modules/ethics/runtime/parse-core.mjs
-// 脚本按 nest sourceRoot 自动映射到 dist/server 下的构建产物（并重写 .mts→.mjs / .ts→.js）。
-const RUNTIME_ENTRIES = (process.env.MIAODA_RUNTIME_ENTRIES || '')
-  .split(',')
-  .map((s) => s.trim())
-  .filter(Boolean)
-  .map((srcRel) => {
-    const fromSrc = path.relative(SOURCE_ROOT, srcRel); // 去掉 sourceRoot 前缀
-    const ext = path.extname(fromSrc);
-    const outRel = SRC_TO_OUT_EXT[ext] ? fromSrc.slice(0, -ext.length) + SRC_TO_OUT_EXT[ext] : fromSrc;
-    return path.join(DIST_SERVER_DIR, outRel);
-  })
-  .filter((p) => {
-    if (fs.existsSync(p)) return true;
-    console.warn(`⚠️  MIAODA_RUNTIME_ENTRIES 入口在构建产物中不存在，已忽略: ${path.relative(ROOT_DIR, p)}`);
-    return false;
-  });
-
 // Node.js 内置模块列表
 const BUILTIN_MODULES = new Set([
   'assert', 'buffer', 'child_process', 'cluster', 'crypto', 'dgram', 'dns',
@@ -182,15 +144,12 @@ async function smartPrune() {
   }
 
   console.log(`📂 分析入口文件: ${path.relative(ROOT_DIR, SERVER_ENTRY)}`);
-  if (RUNTIME_ENTRIES.length) {
-    console.log(`📎 额外 trace 入口 (${RUNTIME_ENTRIES.length}): ${RUNTIME_ENTRIES.map((p) => path.relative(DIST_SERVER_DIR, p)).join(', ')}`);
-  }
 
   // 2. 使用 @vercel/nft 追踪依赖
   console.log('🔎 追踪实际依赖...');
   const analyzeStart = Date.now();
 
-  const { fileList } = await nodeFileTrace([SERVER_ENTRY, ...RUNTIME_ENTRIES], {
+  const { fileList } = await nodeFileTrace([SERVER_ENTRY], {
     base: ROOT_DIR,
     processCwd: ROOT_DIR,
     ts: false, // 禁用 TS 解析
@@ -221,59 +180,8 @@ async function smartPrune() {
 
   console.log(`📦 静态分析需要 ${requiredPackages.size} 个 npm 包`);
 
-  // 4. 从 nft 结果递归收集子依赖（处理动态 require 无法被静态分析追踪的问题）
-  // 某些包（如 pdf-parse）使用 try-catch 动态加载依赖（如 @napi-rs/canvas），
-  // @vercel/nft 无法追踪这类依赖，需要基于 package.json 声明补充
-  // 策略：只对 nft 已追踪到的包递归，避免收集无关依赖
+  // 4. 处理 actionPlugins（动态加载的插件，无法被静态分析追踪）
   const originalPackage = JSON.parse(fs.readFileSync(ROOT_PACKAGE_JSON, 'utf8'));
-
-  let addedSubDeps = 0;
-  const visited = new Set(); // 防止循环依赖导致无限循环
-  const queue = [...requiredPackages]; // BFS 队列，从 nft 结果开始（更精准）
-
-  while (queue.length > 0) {
-    const depName = queue.shift();
-
-    // 跳过已访问的包（防止循环依赖）
-    if (visited.has(depName)) continue;
-    visited.add(depName);
-
-    const depPkgPath = path.join(ROOT_NODE_MODULES, depName, 'package.json');
-    if (!fs.existsSync(depPkgPath)) continue;
-
-    try {
-      const depPkg = JSON.parse(fs.readFileSync(depPkgPath, 'utf8'));
-      const subDeps = {
-        ...depPkg.dependencies,
-        ...depPkg.optionalDependencies,
-      };
-
-      for (const subDep of Object.keys(subDeps)) {
-        // 检查包是否存在于 node_modules 中
-        const subDepPath = path.join(ROOT_NODE_MODULES, subDep);
-        if (!fs.existsSync(subDepPath)) continue;
-
-        // 如果是新发现的包，添加到结果集并加入队列继续遍历
-        if (!requiredPackages.has(subDep)) {
-          requiredPackages.add(subDep);
-          addedSubDeps++;
-        }
-
-        // 无论是否已在 requiredPackages 中，都需要继续遍历其子依赖
-        if (!visited.has(subDep)) {
-          queue.push(subDep);
-        }
-      }
-    } catch {
-      // 忽略解析错误
-    }
-  }
-
-  if (addedSubDeps > 0) {
-    console.log(`📦 递归补充动态依赖，新增 ${addedSubDeps} 个包`);
-  }
-
-  // 5. 处理 actionPlugins（动态加载的插件，无法被静态分析追踪）
   const actionPlugins = originalPackage.actionPlugins || {};
   const actionPluginNames = Object.keys(actionPlugins);
 
@@ -304,7 +212,7 @@ async function smartPrune() {
 
   console.log(`📦 总共需要 ${requiredPackages.size} 个 npm 包\n`);
 
-  // 6. 选择性复制包（只复制需要的）
+  // 5. 选择性复制包（只复制需要的）
   console.log('📋 选择性复制 node_modules（仅复制需要的包）...');
   const copyStart = Date.now();
 
@@ -316,7 +224,7 @@ async function smartPrune() {
   console.log(`   成功: ${copiedCount.success} 个包，失败: ${copiedCount.failed} 个`);
   console.log(`   硬链接: ${fileStats.hardLinks} 个文件，复制: ${fileStats.copies} 个文件\n`);
 
-  // 7. 生成精简版 package.json
+  // 6. 生成精简版 package.json
   // 优化：直接构建 dependencies，避免多次对象展开
   const prunedDependencies = {};
   const allDeps = originalPackage.dependencies || {};
@@ -335,6 +243,9 @@ async function smartPrune() {
     version: originalPackage.version,
     private: true,
     dependencies: prunedDependencies,
+    scripts: {
+      start: originalPackage.scripts?.start || 'node main.js'
+    },
     engines: originalPackage.engines
   };
 
@@ -342,7 +253,7 @@ async function smartPrune() {
 
   const totalElapsed = Date.now() - totalStartTime;
 
-  // 8. 输出统计信息
+  // 7. 输出统计信息
   console.log('='.repeat(60));
   console.log('📊 智能裁剪统计:');
   console.log('='.repeat(60));

package/template/scripts/run.sh

@@ -2,7 +2,4 @@
 # This file is auto-generated by @lark-apaas/fullstack-cli
 
 # 生产环境下，启动服务
-# 从 dist/ 根目录执行，确保 process.cwd() 与 dev 模式一致
-# dev: cwd = 项目根, shared/ client/ 可达
-# prod: cwd = dist/,  shared/ client/ 可达
-NODE_ENV=production node server/main.js
+npm run start

package/template/tsconfig.node.json

@@ -13,6 +13,5 @@
     "excludeDirectories": ["node_modules/**"]
   },
   "include": ["server/**/*", "shared/**/*.ts"],
-  // MCP UI 是独立浏览器工程，不使用服务端的 TypeScript 配置。
-  "exclude": ["server/mcp/ui", "node_modules", "dist", "client", "source_package", "**/*.spec.ts", "**/*.e2e-spec.ts"],
+  "exclude": ["node_modules", "dist", "client", "source_package", "**/*.spec.ts", "**/*.e2e-spec.ts"],
 }