@lark-apaas/coding-template-nestjs-react-fullstack 0.1.27-alpha.20260824122815 → 0.1.28-alpha.20260824161528

package/package.json

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

package/template/package.json

@@ -30,7 +30,7 @@
     "lint": "node ./scripts/lint.js",
     "format": "prettier --write \"{server,client,test}/**/*.{js,ts,tsx,json,md}\"",
     "precommit": "node scripts/hooks/run-precommit.js",
-    "upgrade": "npx -y @lark-apaas/fullstack-cli@1.1.62-alpha.20260824121535 sync --disable-gen-openapi"
+    "upgrade": "npx -y @lark-apaas/fullstack-cli@1.1.62-alpha.20260824155956 sync --disable-gen-openapi"
   },
   "dependencies": {
     "@lark-apaas/fullstack-nestjs-core": "^1.1.59",
@@ -63,7 +63,7 @@
     "@heroicons/react": "^2.2.0",
     "@hookform/resolvers": "^5.2.2",
     "@lark-apaas/client-toolkit": "^1.2.63",
-    "@lark-apaas/coding-preset-vite-react": "1.0.19-alpha.20260824121536",
+    "@lark-apaas/coding-preset-vite-react": "1.0.19-alpha.20260824155954",
     "@lark-apaas/fullstack-presets": "^1.1.0",
     "@nestjs/cli": "^10.4.9",
     "@nestjs/testing": "^10.4.20",

package/template/scripts/dev.js

@@ -9,9 +9,6 @@ const readline = require('readline');
 // ── Project root ──────────────────────────────────────────────────────────────
 const PROJECT_ROOT = path.resolve(__dirname, '..');
 process.chdir(PROJECT_ROOT);
-// Runtime scripts may be image-owned and therefore live outside the workspace.
-// Keep the project identity explicit for validation and all supervised children.
-process.env.MIAODA_WORKSPACE_ROOT ||= PROJECT_ROOT;
 
 // ── Load .env ─────────────────────────────────────────────────────────────────
 function loadEnv() {
@@ -34,143 +31,15 @@ loadEnv();
 
 // ── Configuration ─────────────────────────────────────────────────────────────
 const LOG_DIR = process.env.LOG_DIR || 'logs';
-const MAX_RESTART_COUNT =
-  process.env.MAX_RESTART_COUNT != null && process.env.MAX_RESTART_COUNT !== ''
-    ? parseInt(process.env.MAX_RESTART_COUNT, 10)
-    : Infinity;
+const MAX_RESTART_COUNT = process.env.MAX_RESTART_COUNT != null && process.env.MAX_RESTART_COUNT !== ''
+  ? parseInt(process.env.MAX_RESTART_COUNT, 10)
+  : Infinity;
 const RESTART_DELAY = parseInt(process.env.RESTART_DELAY, 10) || 2;
 const MAX_DELAY = 8;
 const SERVER_PORT = process.env.SERVER_PORT || '3000';
 const CLIENT_DEV_PORT = process.env.CLIENT_DEV_PORT || '8080';
-const WORKSPACE_READY_FILE = path.resolve(
-  process.env.MIAODA_WORKSPACE_READY_FILE || '/tmp/event/WORKSPACE_READY'
-);
-const ACTION_PLUGIN_READY_FILE = path.resolve(
-  process.env.MIAODA_ACTION_PLUGIN_READY_FILE ||
-    '/tmp/event/MIAODA_ACTION_PLUGIN_READY.json'
-);
-const NEST_ORCHESTRATOR_OWNER_FILE = path.resolve(
-  process.env.MIAODA_NEST_ORCHESTRATOR_OWNER_FILE ||
-    '/tmp/event/MIAODA_NEST_ORCHESTRATOR_OWNER.json'
-);
-let STARTUP_EXPERIMENT_ENABLED =
-  process.env.MIAODA_STARTUP_EXPERIMENT_ENABLED === 'true';
-const STARTUP_RUNTIME_SCRIPTS_ROOT = path.resolve(
-  process.env.MIAODA_CACHE_RUNTIME_SCRIPTS_ROOT ||
-    path.join(PROJECT_ROOT, 'scripts')
-);
-
-// When the image launched a bundle orchestrator before this project process
-// existed, it owns the Nest lifecycle and records itself here. dev.js then
-// follows that owner instead of competing for the public server port.
-function readExternalNestOrchestratorOwner() {
-  try {
-    const owner = JSON.parse(
-      fs.readFileSync(NEST_ORCHESTRATOR_OWNER_FILE, 'utf8')
-    );
-    const pid = Number(owner.pid);
-    if (
-      owner.schemaVersion !== 1 ||
-      owner.mode !== (process.env.MIAODA_NEST_START_MODE || 'workspace') ||
-      !Number.isSafeInteger(pid) ||
-      pid <= 1 ||
-      pid === process.pid
-    ) {
-      return undefined;
-    }
-    process.kill(pid, 0);
-    return { pid, mode: owner.mode };
-  } catch {
-    return undefined;
-  }
-}
-
-function workspaceDependenciesReady() {
-  try {
-    return (
-      fs.statSync(WORKSPACE_READY_FILE).isFile() &&
-      fs.statSync(path.join(PROJECT_ROOT, 'node_modules')).isDirectory()
-    );
-  } catch {
-    return false;
-  }
-}
-
-async function waitForWorkspaceDependencies() {
-  while (!stopping && !workspaceDependenciesReady()) await sleep(100);
-  if (stopping) throw new Error('MIAODA_ACTION_PLUGIN_STARTUP_STOPPING');
-}
-
-function publishActionPluginReady(status, startedAtEpochMs) {
-  const atEpochMs = Date.now();
-  let restoreEpochMs = process.env.MIAODA_PLATFORM_ENV_NOT_BEFORE_MS || '';
-  if (!restoreEpochMs) {
-    try {
-      const dependencyReceipt = JSON.parse(
-        fs.readFileSync(
-          path.join(PROJECT_ROOT, '.miaoda-runtime', 'dependencies-ready.json'),
-          'utf8'
-        )
-      );
-      restoreEpochMs = String(dependencyReceipt.restoreEpochMs || '');
-    } catch {}
-  }
-  if (restoreEpochMs) {
-    process.env.MIAODA_PLATFORM_ENV_NOT_BEFORE_MS = restoreEpochMs;
-  }
-  const marker = {
-    schemaVersion: 1,
-    restoreEpochMs,
-    status,
-    atEpochMs,
-  };
-  fs.mkdirSync(path.dirname(ACTION_PLUGIN_READY_FILE), { recursive: true });
-  const temporaryFile = `${ACTION_PLUGIN_READY_FILE}.${process.pid}.tmp`;
-  fs.writeFileSync(temporaryFile, `${JSON.stringify(marker)}\n`, {
-    mode: 0o600,
-  });
-  fs.renameSync(temporaryFile, ACTION_PLUGIN_READY_FILE);
-  process.env.MIAODA_NEST_SKIP_ACTION_PLUGIN_INIT = 'true';
-  writeOutput(
-    `${JSON.stringify({
-      event: 'miaoda_workspace_runtime_phase',
-      runtime: 'shared',
-      mode: process.env.MIAODA_NEST_START_MODE || 'workspace',
-      phase: 'action_plugin_init',
-      phaseStartedAtEpochMs: startedAtEpochMs,
-      atEpochMs,
-      durationMs: atEpochMs - startedAtEpochMs,
-      status,
-      readyFile: ACTION_PLUGIN_READY_FILE,
-    })}\n`
-  );
-}
-
-function initializeActionPlugins(publishReady = false) {
-  const startedAtEpochMs = Date.now();
-  let status = 'success';
-  writeOutput('\n🔌 Initializing action plugins...\n');
-  try {
-    execSync('fullstack-cli action-plugin init', {
-      cwd: PROJECT_ROOT,
-      stdio: 'inherit',
-    });
-    writeOutput('✅ Action plugins initialized\n\n');
-  } catch {
-    status = 'failed-continued';
-    writeOutput(
-      '⚠️  Action plugin initialization failed, continuing anyway...\n\n'
-    );
-  }
-  if (publishReady) publishActionPluginReady(status, startedAtEpochMs);
-}
 
 fs.mkdirSync(LOG_DIR, { recursive: true });
-process.once('exit', () => {
-  try {
-    fs.rmSync(ACTION_PLUGIN_READY_FILE, { force: true });
-  } catch {}
-});
 
 // ── Logging infrastructure ────────────────────────────────────────────────────
 const devStdLogPath = path.join(LOG_DIR, 'dev.std.log');
@@ -181,16 +50,11 @@ const devLogFd = fs.openSync(devLogPath, 'a');
 function timestamp() {
   const now = new Date();
   return (
-    now.getFullYear() +
-    '-' +
-    String(now.getMonth() + 1).padStart(2, '0') +
-    '-' +
-    String(now.getDate()).padStart(2, '0') +
-    ' ' +
-    String(now.getHours()).padStart(2, '0') +
-    ':' +
-    String(now.getMinutes()).padStart(2, '0') +
-    ':' +
+    now.getFullYear() + '-' +
+    String(now.getMonth() + 1).padStart(2, '0') + '-' +
+    String(now.getDate()).padStart(2, '0') + ' ' +
+    String(now.getHours()).padStart(2, '0') + ':' +
+    String(now.getMinutes()).padStart(2, '0') + ':' +
     String(now.getSeconds()).padStart(2, '0')
   );
 }
@@ -204,33 +68,21 @@ const STDOUT_MAX_INFLIGHT = 1000;
 function writeOutput(msg) {
   // File first and synchronously — read-logs reads this file; it must never be gated
   // by the terminal consumer.
-  try {
-    fs.writeSync(devStdLogFd, msg);
-  } catch {}
+  try { fs.writeSync(devStdLogFd, msg); } catch {}
   // stdout mirror via async fs.write: if process.stdout is a pty/pipe whose consumer
   // stalls, the block happens on the libuv threadpool, NOT the event loop — so the
   // synchronous log-FILE writes above (and subsequent readline callbacks) keep running.
   // Drop overflow when too many writes are already pending (best-effort mirror).
-  if (_stdoutInFlight >= STDOUT_MAX_INFLIGHT) {
-    return;
-  }
+  if (_stdoutInFlight >= STDOUT_MAX_INFLIGHT) { return; }
   _stdoutInFlight++;
-  try {
-    fs.write(1, msg, () => {
-      _stdoutInFlight--;
-    });
-  } catch {
-    _stdoutInFlight--;
-  }
+  try { fs.write(1, msg, () => { _stdoutInFlight--; }); } catch { _stdoutInFlight--; }
 }
 
 /** Structured event log → terminal + dev.std.log + dev.log */
 function logEvent(level, name, message) {
   const msg = `[${timestamp()}] [${level}] [${name}] ${message}\n`;
   writeOutput(msg);
-  try {
-    fs.writeSync(devLogFd, msg);
-  } catch {}
+  try { fs.writeSync(devLogFd, msg); } catch {}
 }
 
 // ── Process group management ──────────────────────────────────────────────────
@@ -242,16 +94,11 @@ function killProcessGroup(pid, signal) {
 
 function killOrphansByPort(port) {
   try {
-    const pids = execSync(`lsof -ti :${port}`, {
-      encoding: 'utf8',
-      timeout: 5000,
-    }).trim();
+    const pids = execSync(`lsof -ti :${port}`, { encoding: 'utf8', timeout: 5000 }).trim();
     if (pids) {
       const pidList = pids.split('\n').filter(Boolean);
       for (const p of pidList) {
-        try {
-          process.kill(parseInt(p, 10), 'SIGKILL');
-        } catch {}
+        try { process.kill(parseInt(p, 10), 'SIGKILL'); } catch {}
       }
       return pidList;
     }
@@ -264,7 +111,7 @@ let stopping = false;
 const managedProcesses = []; // { name, pid, child }
 
 function sleep(ms) {
-  return new Promise(resolve => setTimeout(resolve, ms));
+  return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
 /**
@@ -294,23 +141,14 @@ function startProcess({ name, command, args, cleanupPort }) {
       entry.child = child;
 
       const startTime = Date.now();
-      logEvent(
-        'INFO',
-        name,
-        `Process started (PGID: ${child.pid}): ${command} ${args.join(' ')}`
-      );
+      logEvent('INFO', name, `Process started (PGID: ${child.pid}): ${command} ${args.join(' ')}`);
 
       // Pipe stdout and stderr through readline for timestamped logging
-      const pipeLines = stream => {
-        const rl = readline.createInterface({
-          input: stream,
-          crlfDelay: Infinity,
-        });
-        rl.on('line', line => {
+      const pipeLines = (stream) => {
+        const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
+        rl.on('line', (line) => {
           const msg = `[${timestamp()}] [${name}] ${line}\n`;
-          try {
-            fs.writeSync(logFd, msg);
-          } catch {}
+          try { fs.writeSync(logFd, msg); } catch {}
           writeOutput(msg);
         });
       };
@@ -321,8 +159,8 @@ function startProcess({ name, command, args, cleanupPort }) {
       // NOTE: must use 'exit', not 'close'. With shell:true, grandchild processes
       // (e.g. nest's server) inherit stdout pipes. 'close' won't fire until ALL
       // pipe holders exit, causing dev.js to hang when npm/nest dies but server survives.
-      const exitCode = await new Promise(resolve => {
-        child.on('exit', code => resolve(code ?? 1));
+      const exitCode = await new Promise((resolve) => {
+        child.on('exit', (code) => resolve(code ?? 1));
         child.on('error', () => resolve(1));
       });
 
@@ -339,11 +177,7 @@ function startProcess({ name, command, args, cleanupPort }) {
       if (cleanupPort) {
         const orphans = killOrphansByPort(cleanupPort);
         if (orphans.length > 0) {
-          logEvent(
-            'WARN',
-            name,
-            `Killed orphan processes on port ${cleanupPort}: ${orphans.join(' ')}`
-          );
+          logEvent('WARN', name, `Killed orphan processes on port ${cleanupPort}: ${orphans.join(' ')}`);
           await sleep(500);
         }
       }
@@ -353,38 +187,21 @@ function startProcess({ name, command, args, cleanupPort }) {
       const runDuration = (Date.now() - startTime) / 1000;
       if (runDuration >= 60) {
         restartCount = 0;
-        logEvent(
-          'INFO',
-          name,
-          `Ran for ${Math.round(runDuration)}s, resetting restart counter`
-        );
+        logEvent('INFO', name, `Ran for ${Math.round(runDuration)}s, resetting restart counter`);
       } else {
         restartCount++;
       }
       if (restartCount >= MAX_RESTART_COUNT) {
-        logEvent(
-          'ERROR',
-          name,
-          `Max restart count (${MAX_RESTART_COUNT}) reached, giving up`
-        );
+        logEvent('ERROR', name, `Max restart count (${MAX_RESTART_COUNT}) reached, giving up`);
         break;
       }
 
-      const delay = Math.min(
-        RESTART_DELAY * (1 << Math.max(0, restartCount - 1)),
-        MAX_DELAY
-      );
-      logEvent(
-        'WARN',
-        name,
-        `Process exited with code ${exitCode}, restarting (${restartCount}/${MAX_RESTART_COUNT}) in ${delay}s...`
-      );
+      const delay = Math.min(RESTART_DELAY * (1 << Math.max(0, restartCount - 1)), MAX_DELAY);
+      logEvent('WARN', name, `Process exited with code ${exitCode}, restarting (${restartCount}/${MAX_RESTART_COUNT}) in ${delay}s...`);
       await sleep(delay * 1000);
     }
 
-    try {
-      fs.closeSync(logFd);
-    } catch {}
+    try { fs.closeSync(logFd); } catch {}
   };
 
   return run();
@@ -414,11 +231,7 @@ async function cleanup() {
   // Force kill any remaining
   for (const entry of managedProcesses) {
     if (entry.pid) {
-      logEvent(
-        'WARN',
-        'main',
-        `Force killing process group (PGID: ${entry.pid})`
-      );
+      logEvent('WARN', 'main', `Force killing process group (PGID: ${entry.pid})`);
       killProcessGroup(entry.pid, 'SIGKILL');
     }
   }
@@ -429,12 +242,8 @@ async function cleanup() {
 
   logEvent('INFO', 'main', 'All processes stopped');
 
-  try {
-    fs.closeSync(devStdLogFd);
-  } catch {}
-  try {
-    fs.closeSync(devLogFd);
-  } catch {}
+  try { fs.closeSync(devStdLogFd); } catch {}
+  try { fs.closeSync(devLogFd); } catch {}
 
   process.exit(0);
 }
@@ -443,99 +252,16 @@ process.on('SIGTERM', cleanup);
 process.on('SIGINT', cleanup);
 process.on('SIGHUP', cleanup);
 
-// dist 缓存策略:
-//   沙箱首次启动 → 保留 dist/, 让 nest --watch 复用上次编译产物
-//   后续启动 (agent 主动触发 npm run dev) → 全清 dist/, 让模型面对新鲜产物避免 stale
-//   依赖升级 (lockfile hash 变) → 同后续启动 (清 dist), log 里点出 "deps changed"
-//   FORCE_CLEAN_DIST=true → escape hatch, 强清
-// marker 放 os.tmpdir()/.miaoda-dev-boot (跟沙箱容器 lifecycle 同, 沙箱重启会清空,
-// 语义对齐"沙箱首次启动"); 具体逻辑抽到 lib/preserve-dev-cache.cjs 便于单测。
+// 定向保留 dist/ 里能复用的部分, 替代之前无脑 rm -rf dist/。
+// 收益: 保留 dist/server 让 nest --watch 从增量编译起点起 (省 8-13s 冷启动),
+// routes JSON 也保留 (build 会覆盖, 无 stale 风险)。dist/client/index.html 按
+// preset 打的 <meta name="miaoda-html-mode"> marker 判定:
+//   marker=dev  → 保留 dist/client/ 整个 (dev cache hit)
+//   marker=prod → agent 跑过 build:client 污染, 定向清 index.html + assets/
+// 具体逻辑抽到 lib/preserve-dev-cache.cjs 便于单测。
+// 降级 escape hatch: FORCE_CLEAN_DIST=true 走原全清路径 (marker 逻辑出 bug 时用)。
 const { preserveDevCache } = require('./lib/preserve-dev-cache.cjs');
 
-function prepareTypeScriptBuildState() {
-  const startedAtEpochMs = Date.now();
-  const enabled =
-    STARTUP_EXPERIMENT_ENABLED &&
-    process.env.MIAODA_TYPESCRIPT_INCREMENTAL_CACHE_ENABLED === 'true';
-  const distPath = path.join(PROJECT_ROOT, 'dist');
-  const rootBuildInfoPath = path.join(
-    PROJECT_ROOT,
-    'tsconfig.node.tsbuildinfo'
-  );
-  const distBuildInfoPath = path.join(distPath, 'tsconfig.node.tsbuildinfo');
-  const candidateDistExists = fs.existsSync(distPath);
-  const candidateBuildInfoPath = fs.existsSync(distBuildInfoPath)
-    ? distBuildInfoPath
-    : fs.existsSync(rootBuildInfoPath)
-      ? rootBuildInfoPath
-      : '';
-  const candidateAvailable =
-    enabled && candidateDistExists && Boolean(candidateBuildInfoPath);
-  if (!candidateAvailable) {
-    fs.rmSync(distPath, { recursive: true, force: true });
-    fs.rmSync(rootBuildInfoPath, { force: true });
-  }
-  const atEpochMs = Date.now();
-  writeOutput(
-    `${JSON.stringify({
-      event: 'miaoda_typescript_incremental_cache',
-      phase: 'consume',
-      enabled,
-      status: candidateAvailable ? 'preserved' : enabled ? 'miss' : 'disabled',
-      candidateDistExists,
-      candidateTsbuildinfoExists: Boolean(candidateBuildInfoPath),
-      tsbuildinfoPath: candidateBuildInfoPath || null,
-      distExists: fs.existsSync(distPath),
-      tsbuildinfoExists:
-        fs.existsSync(distBuildInfoPath) || fs.existsSync(rootBuildInfoPath),
-      phaseStartedAtEpochMs: startedAtEpochMs,
-      atEpochMs,
-      durationMs: atEpochMs - startedAtEpochMs,
-    })}\n`
-  );
-}
-
-async function followExternalNestOrchestratorOrStartLocal(
-  serverStartupRuntimeScript
-) {
-  const owner = readExternalNestOrchestratorOwner();
-  if (!owner) {
-    return startProcess({
-      name: 'server',
-      command: process.execPath,
-      args: [serverStartupRuntimeScript],
-      cleanupPort: SERVER_PORT,
-    });
-  }
-
-  logEvent(
-    'INFO',
-    'server',
-    `Following image-owned Nest orchestrator pid=${owner.pid} mode=${owner.mode}`
-  );
-  while (!stopping) {
-    try {
-      process.kill(owner.pid, 0);
-      await sleep(200);
-    } catch {
-      break;
-    }
-  }
-  if (stopping) return 0;
-
-  logEvent(
-    'WARN',
-    'server',
-    `Image-owned Nest orchestrator pid=${owner.pid} exited; starting local supervisor`
-  );
-  return startProcess({
-    name: 'server',
-    command: process.execPath,
-    args: [serverStartupRuntimeScript],
-    cleanupPort: SERVER_PORT,
-  });
-}
-
 // ── Main ──────────────────────────────────────────────────────────────────────
 async function main() {
   logEvent('INFO', 'main', '========== Dev session started ==========');
@@ -544,97 +270,29 @@ async function main() {
     log: (level, msg) => logEvent(level, 'main', msg),
   });
 
-  if (process.env.MIAODA_HMR_ROUTING_MODE === 'same-origin') {
-    delete process.env.MIAODA_WS_HOST;
-    logEvent(
-      'INFO',
-      'main',
-      'Using same-origin HMR routing; ignored the dedicated MIAODA_WS_HOST'
-    );
-  }
-
-  const serverStartupRuntimeScript = path.join(
-    STARTUP_RUNTIME_SCRIPTS_ROOT,
-    'server-startup-runtime.mjs'
-  );
-  const workspaceClientRuntimeScript = path.join(
-    STARTUP_RUNTIME_SCRIPTS_ROOT,
-    'workspace-client-runtime.mjs'
-  );
-  const viteRuntimeConfigScript = path.join(
-    PROJECT_ROOT,
-    'scripts',
-    'vite-runtime.config.mjs'
-  );
-  if (STARTUP_EXPERIMENT_ENABLED) {
-    try {
-      for (const requiredPath of [
-        serverStartupRuntimeScript,
-        workspaceClientRuntimeScript,
-        viteRuntimeConfigScript,
-      ]) {
-        if (!fs.existsSync(requiredPath)) {
-          throw new Error(
-            `MIAODA_STARTUP_EXPERIMENT_INPUT_MISSING: ${requiredPath}`
-          );
-        }
-      }
-    } catch (error) {
-      STARTUP_EXPERIMENT_ENABLED = false;
-      process.env.MIAODA_STARTUP_EXPERIMENT_ENABLED = 'false';
-      logEvent(
-        'WARN',
-        'main',
-        `Startup experiment unavailable; using original services: ${error.message}`
-      );
-    }
-  }
-
-  if (STARTUP_EXPERIMENT_ENABLED) {
-    fs.rmSync(ACTION_PLUGIN_READY_FILE, { force: true });
-    await waitForWorkspaceDependencies();
-    prepareTypeScriptBuildState();
-    initializeActionPlugins(true);
-  } else {
-    prepareTypeScriptBuildState();
-    initializeActionPlugins();
+  // Initialize action plugins
+  writeOutput('\n🔌 Initializing action plugins...\n');
+  try {
+    execSync('fullstack-cli action-plugin init', { cwd: PROJECT_ROOT, stdio: 'inherit' });
+    writeOutput('✅ Action plugins initialized\n\n');
+  } catch {
+    writeOutput('⚠️  Action plugin initialization failed, continuing anyway...\n\n');
   }
 
   // Start server and client
-  let serverPromise;
-  let clientPromise;
-  if (STARTUP_EXPERIMENT_ENABLED) {
-    logEvent(
-      'INFO',
-      'main',
-      `Starting normal workspace Vite with Nest mode ${
-        process.env.MIAODA_NEST_START_MODE || 'workspace'
-      }`
-    );
-    serverPromise = followExternalNestOrchestratorOrStartLocal(
-      serverStartupRuntimeScript
-    );
-    clientPromise = startProcess({
-      name: 'client',
-      command: process.execPath,
-      args: [workspaceClientRuntimeScript],
-      cleanupPort: CLIENT_DEV_PORT,
-    });
-  } else {
-    serverPromise = startProcess({
-      name: 'server',
-      command: 'npm',
-      args: ['run', 'dev:server'],
-      cleanupPort: SERVER_PORT,
-    });
-
-    clientPromise = startProcess({
-      name: 'client',
-      command: 'npm',
-      args: ['run', 'dev:client'],
-      cleanupPort: CLIENT_DEV_PORT,
-    });
-  }
+  const serverPromise = startProcess({
+    name: 'server',
+    command: 'npm',
+    args: ['run', 'dev:server'],
+    cleanupPort: SERVER_PORT,
+  });
+
+  const clientPromise = startProcess({
+    name: 'client',
+    command: 'npm',
+    args: ['run', 'dev:client'],
+    cleanupPort: CLIENT_DEV_PORT,
+  });
 
   writeOutput(`📋 Dev processes running. Press Ctrl+C to stop.\n`);
   writeOutput(`📄 Logs: ${devStdLogPath}\n\n`);
@@ -647,7 +305,7 @@ async function main() {
   }
 }
 
-main().catch(err => {
+main().catch((err) => {
   console.error('Fatal error:', err);
   process.exit(1);
 });

package/template/scripts/dev.sh

@@ -1,20 +1,14 @@
 #!/usr/bin/env bash
-# `npm run dev` 入口；按 MIAODA_DEP_CACHE_DIR 是否非空判断运行环境（与 miaoda-cli
-# isSandboxEnv() 同口径）：
-#   - 非空（沙箱平台注入的依赖缓存目录）→ 直接跑 dev.js
+# `npm run dev` 入口；按 SANDBOX_ID 是否非空判断运行环境：
+#   - SANDBOX_ID 非空（沙箱平台注入应用所属沙箱 ID）→ 直接跑 dev.js
 #       （保活 / restart loop / 文件日志 —— 沙箱生产形态）。脚本同步由平台 pod 启动阶段做过，
 #       dev 入口不再额外 `npm run upgrade`。
-#   - 否则（本地）→ 走 miaoda app sync 兜底 + 跑 dev-local.js：纯 stdout、崩了就崩、Agent 友好。
-# 显式想跑本地路径可用 `npm run dev:local`（绕过本判断）。
-#
-# 不用 SANDBOX_ID：它由 sandbox_console 在绑定沙箱时才写入 .force/environment/env，预热池实例
-# 在绑定前拿不到，会被误判成本地。保留为附加条件只为兼容，不影响判定结果。
+#   - 否则（本地）→ 走 miaoda app sync 兜底 + 跑 dev-local.sh：纯 stdout、崩了就崩、Agent 友好。
+# 显式想跑本地路径可用 `npm run dev:local`（绕过 SANDBOX_ID 判断）。
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-export MIAODA_CACHE_RUNTIME_SCRIPTS_ROOT="${MIAODA_CACHE_RUNTIME_SCRIPTS_ROOT:-$SCRIPT_DIR}"
-export MIAODA_WORKSPACE_ROOT="${MIAODA_WORKSPACE_ROOT:-$(cd "$SCRIPT_DIR/.." && pwd)}"
 
-if [ -n "${MIAODA_DEP_CACHE_DIR:-}" ] || [ -n "${SANDBOX_ID:-}" ]; then
+if [ -n "${SANDBOX_ID:-}" ]; then
   exec node "$SCRIPT_DIR/dev.js" "$@"
 fi
 
@@ -24,7 +18,7 @@ if [ ! -f "$SCRIPT_DIR/dev-local.js" ]; then
 fi
 
 # 本地启动前先跑一次 miaoda app sync：同步 platform-controlled 内容 + 升 @lark-apaas/* 到
-# latest + 迁移老 npm scripts。沙箱不走这里（上面的沙箱分支已经 exec return）。
+# latest + 迁移老 npm scripts。沙箱不走这里（SANDBOX_ID 分支已经 exec return）。
 npx -y @lark-apaas/miaoda-cli@latest app sync || echo "[dev] miaoda app sync 失败，按现状继续" >&2
 
 exec node "$SCRIPT_DIR/dev-local.js" "$@"