@lark-apaas/coding-template-nestjs-react-fullstack 0.1.0 → 0.1.1-beta.0

package/package.json

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

package/template/scripts/dev-local.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+// ============================================================================
+// 本地开发启动脚本（由 miaoda app sync 维护，请勿手改）
+// Stack: nestjs-react-fullstack
+//
+// 流程:
+//   1. env pull —— 拉沙箱身份/凭证到 .env.local
+//   2. skills sync —— 同步当前 stack 的 agent skills
+//   3. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
+//   4. 并发起 dev:server + dev:client（子进程继承 process.env）
+//
+// 关键设计：本脚本在 spawn 子进程之前先把 .env / .env.local 加载到 process.env，
+// 然后 spawn 的 server / client 进程通过 env 继承直接拿到——SDK（fullstack-nestjs-core
+// / fullstack-vite-preset / fullstack-rspack-preset）无需自己 require('dotenv')。
+//
+// SUDA_WEBUSER 适配：沙箱 env pull 下发到 .env.local 的形态是
+// `SUDA_WEBUSER="{\"user_id\":\"...\"}"`（shell-quoted JSON），dotenv@17 剥外层引号后
+// 保留内部 `\"` 转义不还原，导致 process.env.SUDA_WEBUSER 是 `{\"user_id\":\"...\"}`
+// 这种带反斜杠串，下游 JSON.parse 直接挂。这里做一次「直接 parse 失败则 unescape
+// 后重 parse」兜底，把容错收敛在启动期单点，下游拿到干净 JSON 字符串。
+// ============================================================================
+const fs = require('node:fs');
+const path = require('node:path');
+const { execSync, spawn, spawnSync } = require('node:child_process');
+
+process.chdir(path.resolve(__dirname, '..'));
+
+function warn(msg) {
+  if (process.stderr.isTTY) process.stderr.write(`\x1b[33mWARNING: ${msg}\x1b[0m\n`);
+  else process.stderr.write(`WARNING: ${msg}\n`);
+}
+
+if (!process.env.MIAODA_APP_TYPE) process.env.MIAODA_APP_TYPE = '3';
+process.env.MIAODA_LOCAL_DEV = '1';
+
+// 1. env pull
+console.log('[dev-local] (1/4) env pull...');
+const hasLarkCli = spawnSync('command', ['-v', 'lark-cli'], { shell: true, stdio: 'ignore' }).status === 0;
+if (hasLarkCli) {
+  let appId = '';
+  try {
+    appId = JSON.parse(fs.readFileSync('.spark/meta.json', 'utf8')).app_id || '';
+  } catch {
+    /* meta.json 不存在或非法 JSON */
+  }
+  if (appId) {
+    const r = spawnSync('lark-cli', ['apps', '+env-pull', '--app-id', appId, '--as', 'user'], {
+      stdio: 'inherit',
+    });
+    if (r.status !== 0) warn('env pull 失败，继续按 .env.local 现状启动');
+  } else {
+    warn('.spark/meta.json 缺 app_id，请先跑 `miaoda app init --app-id <id>`');
+  }
+} else {
+  warn('lark-cli 未安装，跳过 env pull；请确保 .env.local 已就绪');
+}
+
+// 2. skills sync —— --local 切到 flat layout (.agents/skills + .claude/skills 软链),
+// 跟沙箱 nested layout 区分。临时钉 @alpha:latest dist-tag 还停在老版 (0.1.6,无 skills /
+// app sync 子命令);等 0.1.7 发到 latest 后切回 @latest。
+console.log('[dev-local] (2/4) miaoda skills sync...');
+try {
+  execSync('npx -y @lark-apaas/miaoda-cli@alpha skills sync --local', { stdio: 'inherit' });
+} catch {
+  console.log('  (skills sync 失败，继续启动)');
+}
+
+// 3. 加载 .env / .env.local 到 process.env
+// dotenv 默认 override:false，先到先得 → 先 .env.local 让它优先于 .env；
+// shell env 已在 process.env，两次 config 都不会覆盖。
+console.log('[dev-local] (3/4) loading .env / .env.local...');
+const dotenv = require('dotenv');
+dotenv.config({ path: '.env.local' });
+dotenv.config({ path: '.env' });
+
+// SUDA_WEBUSER 适配（详见文件头注释）
+if (process.env.SUDA_WEBUSER) {
+  const raw = process.env.SUDA_WEBUSER;
+  try {
+    JSON.parse(raw);
+  } catch {
+    try {
+      const unescaped = raw.replace(/\\"/g, '"');
+      JSON.parse(unescaped);
+      process.env.SUDA_WEBUSER = unescaped;
+    } catch {
+      warn(`SUDA_WEBUSER 解析失败,值头部: ${raw.slice(0, 80)}...`);
+    }
+  }
+}
+
+// 4. 并发起前后端 dev server
+console.log('[dev-local] (4/4) 并发起 dev:server + dev:client');
+const child = spawn(
+  'npx',
+  [
+    '--no-install',
+    'concurrently',
+    '--names',
+    'server,client',
+    '--prefix-colors',
+    'blue,green',
+    '--kill-others-on-fail',
+    'npm run dev:server',
+    'npm run dev:client',
+  ],
+  { stdio: 'inherit', env: process.env },
+);
+child.on('exit', (code) => process.exit(code ?? 0));
+child.on('error', (err) => {
+  console.error(err);
+  process.exit(1);
+});

package/template/scripts/dev.sh

@@ -12,14 +12,15 @@ if [ -n "${SANDBOX_ID:-}" ]; then
   exec node "$SCRIPT_DIR/dev.js" "$@"
 fi
 
-if [ ! -x "$SCRIPT_DIR/dev-local.sh" ]; then
-  echo "[dev] scripts/dev-local.sh 缺失或不可执行；先跑 \`npx -y @lark-apaas/miaoda-cli@alpha app sync\` 同步平台脚本" >&2
+if [ ! -f "$SCRIPT_DIR/dev-local.js" ]; then
+  echo "[dev] scripts/dev-local.js 缺失；先跑 \`npx -y @lark-apaas/miaoda-cli@alpha app sync\` 同步平台脚本" >&2
   exit 1
 fi
 
 # 本地启动前先跑一次 miaoda app sync：同步 platform-controlled 内容 + 升 @lark-apaas/* 到
-# 钉版 + 迁移老 npm scripts。沙箱不走这里（SANDBOX_ID 分支已经 exec return）。
-# 走 npx 不依赖用户全局装 miaoda；钉到 @alpha dist-tag 跟随最新发布。
+# latest + 迁移老 npm scripts。沙箱不走这里（SANDBOX_ID 分支已经 exec return）。
+# 临时钉 @alpha：latest dist-tag 还停在老版（0.1.6，无 app sync 子命令）；等 0.1.7 发到
+# latest 后切回 @latest。
 npx -y @lark-apaas/miaoda-cli@alpha app sync || echo "[dev] miaoda app sync 失败，按现状继续" >&2
 
-exec "$SCRIPT_DIR/dev-local.sh" "$@"
+exec node "$SCRIPT_DIR/dev-local.js" "$@"

package/template/scripts/dev-local.sh

@@ -1,44 +0,0 @@
-#!/usr/bin/env bash
-# ============================================================================
-# 本地开发启动脚本(由 miaoda app sync 维护,请勿手改)
-# Stack: nestjs-react-fullstack
-# 流程:env pull → skills sync → 并发起 server + client
-# ============================================================================
-set -euo pipefail
-ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
-cd "$ROOT_DIR"
-
-warn() {
-  if [ -t 2 ]; then
-    printf '\033[33mWARNING: %s\033[0m\n' "$*" >&2
-  else
-    printf 'WARNING: %s\n' "$*" >&2
-  fi
-}
-
-# 应用 scene + 本地开发开关
-export MIAODA_APP_TYPE="${MIAODA_APP_TYPE:-3}"
-export MIAODA_LOCAL_DEV=1
-
-# 1. 拉本地开发环境变量到 .env.local
-echo "[dev-local] (1/3) env pull..."
-if command -v lark-cli >/dev/null 2>&1; then
-  APP_ID=$(node -e 'try{process.stdout.write(JSON.parse(require("fs").readFileSync(".spark/meta.json","utf8")).app_id||"")}catch(e){}' 2>/dev/null || echo "")
-  if [ -n "$APP_ID" ]; then
-    lark-cli apps +env-pull --app-id "$APP_ID" --as user || warn "env pull 失败,继续按 .env.local 现状启动"
-  else
-    warn ".spark/meta.json 缺 app_id,请先跑 \`miaoda app init --app-id <id>\`"
-  fi
-else
-  warn "lark-cli 未安装,跳过 env pull;请确保 .env.local 已就绪"
-fi
-
-# 2. 同步当前 stack 对应的 skills
-echo "[dev-local] (2/3) miaoda skills sync..."
-npx -y @lark-apaas/miaoda-cli@alpha skills sync || echo "  (skills sync 失败,继续启动)"
-
-# 3. 并发起前后端 dev server
-echo "[dev-local] (3/3) 并发起 dev:server + dev:client"
-exec npx --no-install concurrently \
-  --names "server,client" --prefix-colors "blue,green" --kill-others-on-fail \
-  "npm run dev:server" "npm run dev:client"