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

package/package.json

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

package/template/.env

@@ -1,19 +1,4 @@
-# Application
-# Server Configuration (NestJS)
-SUDA_DATABASE_URL=
-# 后端 NestJS 监听端口(被 scripts/dev.js 和 server/main.ts 读取,默认 3000)
-# SERVER_PORT=3000
-
-# Client Configuration
-# 前端 dev server (Vite/Rspack) 监听端口(被 scripts/dev.js 读取,默认 8080;
-# 本地开发需改端口时取消注释,例如 8001)
-# CLIENT_DEV_PORT=8080
-
 # Logger
 LOG_DIR=./logs
 LOG_REQUEST_BODY=true
 LOG_RESPONSE_BODY=true
-
-# Framework build / lint mode（false = 严格）
-FORCE_FRAMEWORK_BUILD_LOOSE_MODE=false
-FORCE_FRAMEWORK_LINT_LOOSE_MODE=false

package/template/scripts/dev-local.sh

@@ -1,60 +1,43 @@
 #!/usr/bin/env bash
 # ============================================================================
-# 本地 dev 启动脚本（平台控制，通过 `miaoda app upgrade` 同步，请勿手改）
+# 本地开发启动脚本(由 miaoda app sync 维护,请勿手改)
 # Stack: nestjs-react-fullstack
-# 流程：env pull → skills sync → 并发起 server + client
+# 流程:env pull → skills sync → 并发起 server + client
 # ============================================================================
 set -euo pipefail
 ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
 cd "$ROOT_DIR"
 
-# === Sentinels（必须由本脚本注入，不属于 .env.local 业务范畴）===
+warn() {
+  if [ -t 2 ]; then
+    printf '\033[33mWARNING: %s\033[0m\n' "$*" >&2
+  else
+    printf 'WARNING: %s\n' "$*" >&2
+  fi
+}
 
-# Stack 对应 miaoda CLI 的 application scene；沙箱里平台注入，本地脚本兜底，
-# 让后续 miaoda 子命令（skills sync 等）走对的 scene。
+# 应用 scene + 本地开发开关
 export MIAODA_APP_TYPE="${MIAODA_APP_TYPE:-3}"
-
-# 本地开发总开关：SDK（fullstack-vite-preset / fullstack-rspack-preset /
-# fullstack-nestjs-core）据此启用本地兜底逻辑：
-#   - vite/rspack-preset：反代 /__runtime__ 到沙箱（带 cookie / webuser header）
-#   - nestjs-core：从 cookie 补 csrf header + 注入 webuser header
-# 沙箱 dev / 生产不设此 env，SDK 行为完全不变。
 export MIAODA_LOCAL_DEV=1
 
-# 临时：绕 npmmirror/bnpm 内网到 npmjs 的同步延迟，等 coding-steering 正式版去掉。
-export MIAODA_NPM_REGISTRY="${MIAODA_NPM_REGISTRY:-https://registry.npmjs.org/}"
-
-# === .env.local / .env 加载由 SDK 侧负责，本脚本不再手工 source ===
-# fullstack-nestjs-core 在 module init 通过 dotenv 读 .env.local + .env；
-# fullstack-{vite,rspack}-preset 的 defineConfig 同理。优先级：shell > .env.local > .env。
-# 历史版本曾在这里用 bash 自写 parser，引号 / 多行 / 行尾注释处理不全且重复造轮子，已下放到 SDK。
-
-# 1. 拉本地 dev 所需 ENV（jwt / cookie / sandbox URL 等，写入 .env.local）
-#    app_id 从 .spark/meta.json 读 —— `miaoda app init --app-id <id>` 时持久化的权威源，
-#    后续 dev / sync 全部沿用这一个值；不在脚本里 hack 别的推断渠道。
-#    lark-cli 子命令真名是 `+env-pull`（带 + 前缀单 token，不是 `env pull` 空格分隔）；
-#    `--as user` 必须显式：env-pull 只接受 user identity，默认 bot 会校验失败。
+# 1. 拉本地开发环境变量到 .env.local
 echo "[dev-local] (1/3) env pull..."
 if command -v lark-cli >/dev/null 2>&1; then
-  # 用 node 读 .spark/meta.json，不引 python3 依赖（user app 必装 node）。
   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 || echo "  (env pull 失败，后续按 .env.local 现状继续)"
+    lark-cli apps +env-pull --app-id "$APP_ID" --as user || warn "env pull 失败,继续按 .env.local 现状启动"
   else
-    echo "  (.spark/meta.json 缺 app_id，先跑 \`miaoda app init --app-id <id>\` 写入)"
+    warn ".spark/meta.json 缺 app_id,请先跑 \`miaoda app init --app-id <id>\`"
   fi
 else
-  echo "  (lark-cli 未装，跳过 env pull；请确保 .env.local 已就绪)"
+  warn "lark-cli 未安装,跳过 env pull;请确保 .env.local 已就绪"
 fi
 
-# 2. 同步 stack 对应 skills（coding-steering）。走 npx 不依赖用户全局装 miaoda；
-#    钉到 @alpha dist-tag 跟随最新发布，miaoda-cli 通道我们自己控制风险小。
+# 2. 同步当前 stack 对应的 skills
 echo "[dev-local] (2/3) miaoda skills sync..."
-npx -y @lark-apaas/miaoda-cli@alpha skills sync || echo "  (skills sync 失败，继续启动)"
+npx -y @lark-apaas/miaoda-cli@alpha skills sync || echo "  (skills sync 失败,继续启动)"
 
-# 3. 并发起 dev:server（NestJS）+ dev:client（vite/rspack）
-#    端口、SANDBOX_* 等业务 env 由 SDK 内 dotenv 加载，不在 banner 里假装显示。
-#    不走 scripts/dev.js（保活 / restart / 日志写文件那套）—— 本地崩就崩，错日志直接 stdout。
+# 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 \

package/template/scripts/dev.sh

@@ -1,32 +1,25 @@
 #!/usr/bin/env bash
-# `npm run dev` 入口；按 IS_SANDBOX 分发：
-#   - IS_SANDBOX=1（沙箱平台注入）→ 先 fullstack-cli sync 同步平台脚本，再跑 dev.js
-#       （保活 / restart loop / 文件日志 —— 沙箱生产形态）
-#   - 否则（本地）→ 跑 dev-local.sh：纯 stdout、崩了就崩、Agent 友好
-# 显式想跑本地路径可用 `npm run dev:local`（绕过 IS_SANDBOX）。
+# `npm run dev` 入口；按 SANDBOX_ID 是否非空判断运行环境：
+#   - SANDBOX_ID 非空（沙箱平台注入应用所属沙箱 ID）→ 直接跑 dev.js
+#       （保活 / restart loop / 文件日志 —— 沙箱生产形态）。脚本同步由平台 pod 启动阶段做过，
+#       dev 入口不再额外 `npm run upgrade`。
+#   - 否则（本地）→ 走 miaoda app sync 兜底 + 跑 dev-local.sh：纯 stdout、崩了就崩、Agent 友好。
+# 显式想跑本地路径可用 `npm run dev:local`（绕过 SANDBOX_ID 判断）。
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 
-if [ "${IS_SANDBOX:-}" = "1" ] || [ "${IS_SANDBOX:-}" = "true" ]; then
-  # 沙箱前置同步：fullstack-cli sync 把平台管控的 scripts/ + 部分 package.json 字段同步过来。
-  # 不直接调 `fullstack-cli`，走 `npm run upgrade` 享 package.json 里的入口定义（与 prepublish
-  # 之类的钩子一致）；后续若 upgrade 脚本换实现，dev 路径自动跟随。
-  npm run upgrade
+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 缺失或不可执行；先跑 \`miaoda app upgrade\` 同步平台脚本" >&2
+  echo "[dev] scripts/dev-local.sh 缺失或不可执行；先跑 \`npx -y @lark-apaas/miaoda-cli@alpha app sync\` 同步平台脚本" >&2
   exit 1
 fi
 
-# 本地启动前先跑一次 miaoda app upgrade：同步 platform-controlled 内容 + 升 @lark-apaas/* 到
-# 最新 alpha + 迁移老 npm scripts。沙箱不走这里（IS_SANDBOX 分支已经 return）。miaoda 缺失时
-# 软失败（agent 环境可能没装），靠用户自己保证 .env.local / scripts 现状能跑。
-if command -v miaoda >/dev/null 2>&1; then
-  miaoda app upgrade || echo "[dev] miaoda app upgrade 失败，按现状继续" >&2
-else
-  echo "[dev] miaoda 未装，跳过 upgrade；建议 npm i -g @lark-apaas/miaoda-cli" >&2
-fi
+# 本地启动前先跑一次 miaoda app sync：同步 platform-controlled 内容 + 升 @lark-apaas/* 到
+# 钉版 + 迁移老 npm scripts。沙箱不走这里（SANDBOX_ID 分支已经 exec return）。
+# 走 npx 不依赖用户全局装 miaoda；钉到 @alpha dist-tag 跟随最新发布。
+npx -y @lark-apaas/miaoda-cli@alpha app sync || echo "[dev] miaoda app sync 失败，按现状继续" >&2
 
 exec "$SCRIPT_DIR/dev-local.sh" "$@"

package/template/tsconfig.node.json

@@ -3,14 +3,14 @@
   "compilerOptions": {
     "baseUrl": "./",
     "outDir": "./dist",
+    "preserveWatchOutput": true,
     "paths": {
       "@server/*": ["server/*"],
       "@shared/*": ["shared/*"],
     }
   },
   "watchOptions": {
-    "excludeDirectories": ["node_modules/**"],
-    "preserveWatchOutput": true
+    "excludeDirectories": ["node_modules/**"]
   },
   "include": ["server/**/*", "shared/**/*.ts"],
   "exclude": ["node_modules", "dist", "client", "**/*.spec.ts", "**/*.e2e-spec.ts"],

package/template/.spark/meta.json

@@ -1 +0,0 @@
-{"stack":"nestjs-react-fullstack"}