@lark-apaas/coding-templates 0.1.43-alpha.1 → 0.1.43-alpha.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-templates",
-  "version": "0.1.43-alpha.1",
+  "version": "0.1.43-alpha.3",
   "description": "OpenClaw project templates for mclaw CLI",
   "publishConfig": {
     "access": "public"

package/template-vite-react/package.json

@@ -13,7 +13,7 @@
     "dev": "concurrently -k -n vite,health 'vite --port 8001 --host 0.0.0.0' 'node scripts/mock-health.cjs'",
     "build": "bash scripts/build.sh",
     "typecheck": "tsc -p tsconfig.app.json",
-    "lint": "concurrently npm:typecheck npm:lint:eslint",
+    "lint": "npm run typecheck && npm run lint:eslint",
     "lint:eslint": "eslint client/src"
   },
   "dependencies": {
@@ -44,7 +44,7 @@
     "@radix-ui/react-toggle": "^1.1.9",
     "@radix-ui/react-toggle-group": "^1.1.10",
     "@radix-ui/react-tooltip": "^1.1.18",
-    "@lark-apaas/client-toolkit-lite": "^1.1.0",
+    "@lark-apaas/client-toolkit-lite": "1.1.7-alpha.5",
     "@formkit/auto-animate": "^0.9.0",
     "@gsap/react": "^2.1.2",
     "framer-motion": "^12.38.0",
@@ -79,7 +79,7 @@
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "@lark-apaas/coding-presets": "^1.0.0",
-    "@lark-apaas/coding-vite-preset": "^1.0.0",
+    "@lark-apaas/coding-vite-preset": "1.0.7-alpha.1",
     "concurrently": "^9",
     "eslint": "^9",
     "eslint-plugin-react-hooks": "^7",

package/template-vite-react/scripts/measure-boot.sh

@@ -0,0 +1,219 @@
+#!/usr/bin/env bash
+# 测沙箱（或本机）模板从 0 到"预览可访问"的耗时拆解。
+# 默认只测 dev 启动那段（不跑 npm install），符合沙箱里依赖已装好的常见场景。
+#
+# 用法：
+#   bash scripts/measure-boot.sh                      # 默认：只测 dev 启动（warm）
+#   bash scripts/measure-boot.sh --cold               # 冷启动：清光 vite 预打包缓存
+#   bash scripts/measure-boot.sh --with-install       # 顺带跑一次 npm install 测装包耗时
+#   bash scripts/measure-boot.sh --with-install --cold # 模拟首次冷启（清 node_modules + .vite）
+#   bash scripts/measure-boot.sh --port 18001         # 临时换端口
+#   bash scripts/measure-boot.sh --base /app/whatever # 临时换 CLIENT_BASE_PATH
+#
+# 兼容：--skip-install 等同于不传（默认就是跳过），保留作为 no-op 防止旧脚本/手势失败。
+#
+# 输出：每段耗时 + 总耗时，写到 ./logs/boot-timing.log（同时打到 stdout）
+
+set -uo pipefail
+T1=0; T2=0
+DEV_PID=0
+
+WITH_INSTALL=0
+COLD=0
+PORT=""
+BASE="/app/probe"
+LOG_DIR="./logs"
+LOG_FILE="$LOG_DIR/boot-timing.log"
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --with-install) WITH_INSTALL=1; shift ;;
+    --skip-install) shift ;;  # no-op，兼容旧手势；默认就是跳过
+    --cold) COLD=1; shift ;;
+    --port) PORT="$2"; shift 2 ;;
+    --base) BASE="$2"; shift 2 ;;
+    *) echo "未知参数: $1"; exit 1 ;;
+  esac
+done
+
+mkdir -p "$LOG_DIR"
+: > "$LOG_FILE"
+
+now_ms() {
+  # GNU date 支持 %N，macOS 的 BSD date 不支持——优先用 python3 兜底，避免 sandbox 上 BSD 镜像出错。
+  if command -v python3 >/dev/null 2>&1; then
+    python3 -c 'import time; print(int(time.time()*1000))'
+  else
+    local raw="$(date +%s%3N)"
+    case "$raw" in
+      *N) echo $(($(date +%s) * 1000));;  # date 不支持 %N，降级到秒级精度
+      *) echo "$raw";;
+    esac
+  fi
+}
+log() {
+  local msg="[$(date +%H:%M:%S)] $*"
+  echo "$msg" | tee -a "$LOG_FILE"
+}
+
+# 自动从 package.json 提取 vite 端口
+if [ -z "$PORT" ]; then
+  PORT=$(grep -oE -- '--port[[:space:]]+[0-9]+' package.json 2>/dev/null | head -1 | awk '{print $2}')
+  PORT="${PORT:-8001}"
+fi
+
+export CLIENT_BASE_PATH="$BASE"
+
+log "=============================================="
+log "Boot timing — port=$PORT base=$BASE with-install=$WITH_INSTALL cold=$COLD"
+log "=============================================="
+
+# ── 冷启动：清光本地缓存（不计入耗时，T_TOTAL_START 之前完成）────────
+if [ "$COLD" = "1" ]; then
+  log "[cold] 清缓存以模拟冷启动..."
+  # vite 依赖预打包缓存（永远要清，热启动的最大区别就在这）
+  if [ -d node_modules/.vite ]; then
+    log "  - rm -rf node_modules/.vite"
+    rm -rf node_modules/.vite
+  fi
+  # 本脚本上轮日志
+  if [ -d "$LOG_DIR" ]; then
+    log "  - 清 $LOG_DIR/dev.log（避免 grep 命中旧 ready 行）"
+    : > "$LOG_DIR/dev.log" 2>/dev/null || true
+  fi
+  # 项目级 dist（一般不影响 dev，但顺手）
+  [ -d dist ] && rm -rf dist
+  # 默认保留 node_modules（典型冷启动对照：装好依赖、只清 .vite）
+  # 仅 --with-install 模式才清 node_modules 触发 npm install 重装
+  if [ "$WITH_INSTALL" = "1" ]; then
+    if [ -d node_modules ]; then
+      log "  - rm -rf node_modules（--with-install 模式：清依赖以模拟首次冷启）"
+      rm -rf node_modules
+    fi
+    # npm 全局缓存留着（不动 /tmp/.npmcache / ~/.npm），不然太慢且不真实
+  else
+    log "  - 保留 node_modules（默认模式：只清 .vite 缓存）"
+  fi
+  log "[cold] 缓存清理完成"
+fi
+
+T_TOTAL_START=$(now_ms)
+
+# ── 阶段 1: npm install ──────────────────────────────────────────────
+if [ "$WITH_INSTALL" = "1" ]; then
+  log "[1/4] npm install ..."
+  T1=$(now_ms)
+  npm install --silent > "$LOG_DIR/install.log" 2>&1
+  RC=$?
+  T2=$(now_ms)
+  if [ $RC -ne 0 ]; then
+    log "  ❌ npm install 失败（exit=$RC，详见 $LOG_DIR/install.log）"
+    exit 1
+  fi
+  log "  ✅ 耗时 $((T2 - T1)) ms"
+else
+  log "[1/4] 跳过 npm install（默认；用 --with-install 启用）"
+fi
+
+# ── 阶段 2: 启动 dev（进程拉起到出现 \"VITE ready\" 提示）──────────────
+log "[2/4] npm run dev — 等 vite ready 提示 ..."
+
+# 杀光占用目标端口的所有进程（不依赖进程名匹配，沙箱里 vite 可能被各种 wrapper 拉起）
+kill_port() {
+  local p="$1"
+  local pids
+  pids=$(lsof -tiTCP:"$p" -sTCP:LISTEN 2>/dev/null | tr '\n' ' ')
+  if [ -n "$pids" ]; then
+    log "  清理 :$p 上的进程: $pids"
+    # shellcheck disable=SC2086
+    kill -9 $pids 2>/dev/null || true
+  fi
+}
+kill_port "$PORT"
+kill_port 3000
+# 再保险一道：按名字
+pkill -f 'concurrently.*vite' 2>/dev/null || true
+pkill -f 'mock-health' 2>/dev/null || true
+sleep 1
+
+# 二次校验：端口必须真的空了
+if lsof -tiTCP:"$PORT" -sTCP:LISTEN >/dev/null 2>&1; then
+  log "  ❌ 清理后 :$PORT 仍被占用，请手动 kill 后重试"
+  log "      lsof -i :$PORT"
+  exit 1
+fi
+
+# 截断 log 文件确保 grep 命中的是本次启动的输出（不是旧 log 残留）
+: > "$LOG_DIR/dev.log"
+
+T3=$(now_ms)
+nohup npm run dev > "$LOG_DIR/dev.log" 2>&1 &
+DEV_PID=$!
+
+# 等 vite ready 提示（最多 60s）
+T_READY=""
+for i in $(seq 1 600); do
+  if grep -q 'VITE.*ready' "$LOG_DIR/dev.log" 2>/dev/null; then
+    T_READY=$(now_ms)
+    break
+  fi
+  # 短路：如果 dev 进程已经退出且没出现 ready，提早失败
+  if ! kill -0 "$DEV_PID" 2>/dev/null; then
+    log "  ❌ dev 进程提前退出，看 $LOG_DIR/dev.log"
+    tail -20 "$LOG_DIR/dev.log" | sed 's/^/      /' | tee -a "$LOG_FILE"
+    exit 1
+  fi
+  sleep 0.1
+done
+
+if [ -z "$T_READY" ]; then
+  log "  ❌ 60s 内未看到 vite ready 提示，看 $LOG_DIR/dev.log"
+  kill ${DEV_PID} 2>/dev/null
+  exit 1
+fi
+log "  ✅ 耗时 $((T_READY - T3)) ms"
+
+# ── 阶段 3: 端口可 TCP 连接 ──────────────────────────────────────────
+log "[3/4] 端口 :$PORT 接受 TCP 连接 ..."
+T4=$(now_ms)
+T_TCP=""
+for i in $(seq 1 100); do
+  if (echo > /dev/tcp/127.0.0.1/$PORT) 2>/dev/null; then
+    T_TCP=$(now_ms)
+    break
+  fi
+  sleep 0.05
+done
+if [ -z "$T_TCP" ]; then
+  log "  ❌ 5s 内端口不可连接"
+  kill ${DEV_PID} 2>/dev/null
+  exit 1
+fi
+log "  ✅ 耗时 $((T_TCP - T4)) ms（自 ready 后再 $((T_TCP - T_READY)) ms）"
+
+# ── 阶段 4: 首屏 HTML 200 ─────────────────────────────────────────────
+log "[4/4] curl 首屏（含 base normalize rewrite 路径）..."
+T5=$(now_ms)
+URL="http://127.0.0.1:$PORT${BASE}?probe=1"
+HTTP_CODE=$(curl -sS -o "$LOG_DIR/first.html" -w '%{http_code}' --max-time 10 "$URL" 2>&1)
+T6=$(now_ms)
+SIZE=$(wc -c < "$LOG_DIR/first.html" 2>/dev/null | tr -d ' ')
+
+log "  URL=$URL"
+log "  HTTP=$HTTP_CODE size=${SIZE}B 耗时 $((T6 - T5)) ms"
+
+if [ "$HTTP_CODE" != "200" ]; then
+  log "  ⚠️  非 200，看 $LOG_DIR/first.html"
+fi
+
+# ── 汇总 ──────────────────────────────────────────────────────────────
+T_TOTAL_END=$(now_ms)
+log "=============================================="
+log "总耗时 $((T_TOTAL_END - T_TOTAL_START)) ms"
+log "dev 进程 PID=${DEV_PID}（kill 后退出：kill ${DEV_PID}）"
+log "  install:           $([ $WITH_INSTALL = 1 ] && echo "$((T2 - T1)) ms" || echo skipped)"
+log "  vite ready:        $((T_READY - T3)) ms"
+log "  tcp accept after ready: $((T_TCP - T_READY)) ms"
+log "  first html curl:   $((T6 - T5)) ms"
+log "=============================================="
+log "详细日志：$LOG_FILE / $LOG_DIR/dev.log"

package/template-vite-react/vite.config.ts

@@ -1,5 +1,56 @@
 import path from 'path'
+import type { IncomingMessage, ServerResponse } from 'http'
 import { defineConfig } from '@lark-apaas/coding-vite-preset'
+import type { Plugin, ViteDevServer } from 'vite'
+
+/**
+ * dev 模式 base-path normalize 中间件
+ *
+ * 沙箱预览网关把流量原样转给 vite（保留 /app/:appId 前缀）。浏览器首次访问的
+ * URL 形如 `/app/app_xxx?sso_token=...`，pathname 缺末尾 /。
+ *
+ * vite 8 的 baseMiddleware 对"缺末尾 /"的请求不再像 vite 5 那样自动 301，
+ * 而是直接返回 404 警告页 "The server is configured with a public base URL..."。
+ *
+ * 这里做 internal rewrite（不发 301，避免跟沙箱网关形成 round-trip 死循环）：
+ * 在 vite 内置 baseMiddleware **之前** unshift 一个中间件，把 req.url 改写
+ * 成带尾 /，下游 baseMiddleware 继续 strip base → SPA fallback。
+ * 浏览器全程不感知 redirect，地址栏可保留缺尾 / 形态（BrowserRouter basename
+ * 处理路由）。
+ *
+ * 必须 stack.unshift 而非 server.middlewares.use(...)，否则会排到内置
+ * baseMiddleware 之后失效。
+ *
+ * TODO: 这段已同步到 @lark-apaas/coding-vite-preset，待该包发布并被本模板
+ * 依赖升级拉到后，可以删除此 plugin。保留是为了让现存沙箱（用着老 preset
+ * 的应用）也能立即生效。
+ */
+const baseNormalizePlugin: Plugin = {
+  name: 'base-path-normalize',
+  configureServer(server: ViteDevServer) {
+    const base = (process.env.CLIENT_BASE_PATH || '').replace(/\/+$/, '')
+    if (!base) return
+    const stack = (
+      server.middlewares as unknown as {
+        stack: Array<{ route: string; handle: unknown }>
+      }
+    ).stack
+    if (!Array.isArray(stack)) return
+    stack.unshift({
+      route: '',
+      handle: (req: IncomingMessage, _res: ServerResponse, next: () => void) => {
+        const url = req.url || ''
+        const qIdx = url.indexOf('?')
+        const pathname = qIdx >= 0 ? url.slice(0, qIdx) : url
+        const search = qIdx >= 0 ? url.slice(qIdx) : ''
+        if (pathname === base) {
+          req.url = base + '/' + search
+        }
+        next()
+      },
+    })
+  },
+}
 
 export default defineConfig({
   root: path.resolve(__dirname, 'client'),
@@ -9,4 +60,5 @@ export default defineConfig({
       '@shared': path.resolve(__dirname, 'shared'),
     },
   },
+  plugins: [baseNormalizePlugin],
 })