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

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.62",
+    "@lark-apaas/fullstack-nestjs-core": "1.1.63-alpha.20260918073530",
     "@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.71",
-    "@lark-apaas/coding-preset-vite-react": "^1.0.23",
-    "@lark-apaas/fullstack-presets": "^1.1.0",
+    "@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",
     "@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)"
-OUT_DIR="$ROOT_DIR/dist/server"
+DIST_DIR="$ROOT_DIR/dist"
 
 # 记录总开始时间
 TOTAL_START=$(node -e "console.log(Date.now())")
@@ -19,94 +19,174 @@ print_time() {
 }
 
 # ==================== 步骤 0 ====================
-echo "🗑️  [0/5] 安装插件"
+echo "🗑️  [0/6] 安装插件"
 STEP_START=$(node -e "console.log(Date.now())")
 npx fullstack-cli action-plugin init
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 1 ====================
-echo "📝 [1/5] 更新 openapi 代码"
+echo "📝 [1/6] 更新 openapi 代码"
 STEP_START=$(node -e "console.log(Date.now())")
 npm run gen:openapi
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 2 ====================
-echo "🗑️  [2/5] 清理 dist 目录"
+echo "🗑️  [2/6] 清理 dist 目录"
 STEP_START=$(node -e "console.log(Date.now())")
 rm -rf "$ROOT_DIR/dist"
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 3 ====================
-echo "🔨 [3/5] 并行构建 server 和 client"
+echo "🗺️  [3/6] 生成路由定义"
 STEP_START=$(node -e "console.log(Date.now())")
 
-# 并行构建
-echo "   ├─ 启动 server 构建..."
-npm run build:server > /tmp/build-server.log 2>&1 &
-SERVER_PID=$!
+# 在 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 "   ├─ 启动 client 构建..."
-npm run build:client > /tmp/build-client.log 2>&1 &
-CLIENT_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=$!
 
-# 等待两个构建完成
-SERVER_EXIT=0
-CLIENT_EXIT=0
+API_ROUTES_EXIT=0
+PAGE_ROUTES_EXIT=0
 
-wait $SERVER_PID || SERVER_EXIT=$?
-wait $CLIENT_PID || CLIENT_EXIT=$?
+wait $API_ROUTES_PID || API_ROUTES_EXIT=$?
+wait $PAGE_ROUTES_PID || PAGE_ROUTES_EXIT=$?
 
-# 检查构建结果
-if [ $SERVER_EXIT -ne 0 ]; then
-  echo "   ❌ Server 构建失败"
-  cat /tmp/build-server.log
-  exit 1
+if [ $API_ROUTES_EXIT -ne 0 ]; then
+  echo "   ⚠️  API 路由生成失败（不影响构建）"
+  cat /tmp/gen-api-routes.log
+else
+  echo "   ✅ API 路由生成完成"
 fi
 
-if [ $CLIENT_EXIT -ne 0 ]; then
-  echo "   ❌ Client 构建失败"
-  cat /tmp/build-client.log
-  exit 1
+if [ $PAGE_ROUTES_EXIT -ne 0 ]; then
+  echo "   ⚠️  页面路由生成失败（不影响构建）"
+  cat /tmp/gen-page-routes.log
+else
+  echo "   ✅ 页面路由生成完成"
 fi
-
-echo "   ✅ Server 构建完成"
-echo "   ✅ Client 构建完成"
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 4 ====================
-echo "📦 [4/5] 准备 server 依赖产物"
+echo "🔨 [4/6] 并行构建 server 和 client"
 STEP_START=$(node -e "console.log(Date.now())")
 
-mkdir -p "$OUT_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/"
+# 给 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
 
-# 构建产物 HTML 随后拷，覆盖 public 里的同名文件（保证入口页是构建版，不被 public 静默覆盖）
-cp "$ROOT_DIR/dist/client/"*.html "$OUT_DIR/dist/client/" || true
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 5 ====================
+echo "📦 [5/6] 准备产物"
+STEP_START=$(node -e "console.log(Date.now())")
+
+# 移动 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/" \;
+fi
 
-# 拷贝 run.sh 文件
-cp "$ROOT_DIR/scripts/run.sh" "$OUT_DIR/"
+# 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
 
 # 清理无用文件
-rm -rf "$ROOT_DIR/dist/scripts"
-rm -rf "$ROOT_DIR/dist/tsconfig.node.tsbuildinfo"
+rm -rf "$DIST_DIR/scripts"
+rm -rf "$DIST_DIR/tsconfig.node.tsbuildinfo"
 
 print_time $STEP_START
 echo ""
 
-# ==================== 步骤 5 ====================
-echo "✂️  [5/5] 智能依赖裁剪"
+# ==================== 步骤 6 ====================
+echo "✂️  [6/6] 智能依赖裁剪"
 STEP_START=$(node -e "console.log(Date.now())")
 
-# 分析实际依赖、复制并裁剪 node_modules、生成精简的 package.json
-node "$ROOT_DIR/scripts/prune-smart.js"
+# 智能依赖裁剪（仅全量构建时执行，纯前端场景不打包 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
 
 print_time $STEP_START
 echo ""
@@ -116,10 +196,17 @@ echo "构建完成"
 print_time $TOTAL_START
 
 # 输出产物信息
-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 ""
+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

package/template/scripts/prune-smart.js

@@ -6,15 +6,53 @@ const fs = require('fs');
 const path = require('path');
 
 const ROOT_DIR = path.resolve(__dirname, '..');
-const DIST_SERVER_DIR = path.join(ROOT_DIR, 'dist/server');
+
+// 加载提交的 .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 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_SERVER_DIR, 'node_modules');
-const OUT_PACKAGE_JSON = path.join(DIST_SERVER_DIR, 'package.json');
+const OUT_NODE_MODULES = path.join(DIST_DIR, 'node_modules');
+const OUT_PACKAGE_JSON = path.join(DIST_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',
@@ -144,12 +182,15 @@ 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], {
+  const { fileList } = await nodeFileTrace([SERVER_ENTRY, ...RUNTIME_ENTRIES], {
     base: ROOT_DIR,
     processCwd: ROOT_DIR,
     ts: false, // 禁用 TS 解析
@@ -180,8 +221,59 @@ async function smartPrune() {
 
   console.log(`📦 静态分析需要 ${requiredPackages.size} 个 npm 包`);
 
-  // 4. 处理 actionPlugins（动态加载的插件，无法被静态分析追踪）
+  // 4. 从 nft 结果递归收集子依赖（处理动态 require 无法被静态分析追踪的问题）
+  // 某些包（如 pdf-parse）使用 try-catch 动态加载依赖（如 @napi-rs/canvas），
+  // @vercel/nft 无法追踪这类依赖，需要基于 package.json 声明补充
+  // 策略：只对 nft 已追踪到的包递归，避免收集无关依赖
   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);
 
@@ -212,7 +304,7 @@ async function smartPrune() {
 
   console.log(`📦 总共需要 ${requiredPackages.size} 个 npm 包\n`);
 
-  // 5. 选择性复制包（只复制需要的）
+  // 6. 选择性复制包（只复制需要的）
   console.log('📋 选择性复制 node_modules（仅复制需要的包）...');
   const copyStart = Date.now();
 
@@ -224,7 +316,7 @@ async function smartPrune() {
   console.log(`   成功: ${copiedCount.success} 个包，失败: ${copiedCount.failed} 个`);
   console.log(`   硬链接: ${fileStats.hardLinks} 个文件，复制: ${fileStats.copies} 个文件\n`);
 
-  // 6. 生成精简版 package.json
+  // 7. 生成精简版 package.json
   // 优化：直接构建 dependencies，避免多次对象展开
   const prunedDependencies = {};
   const allDeps = originalPackage.dependencies || {};
@@ -243,9 +335,6 @@ async function smartPrune() {
     version: originalPackage.version,
     private: true,
     dependencies: prunedDependencies,
-    scripts: {
-      start: originalPackage.scripts?.start || 'node main.js'
-    },
     engines: originalPackage.engines
   };
 
@@ -253,7 +342,7 @@ async function smartPrune() {
 
   const totalElapsed = Date.now() - totalStartTime;
 
-  // 7. 输出统计信息
+  // 8. 输出统计信息
   console.log('='.repeat(60));
   console.log('📊 智能裁剪统计:');
   console.log('='.repeat(60));

package/template/scripts/run.sh

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

package/template/tsconfig.node.json

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