@tbox.cn/app-template-agent 0.1.0

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@tbox.cn/app-template-agent",
+  "version": "0.1.0",
+  "description": "tbox AI Agent 全栈模板（多包 pnpm workspace）：apps/client + apps/server + packages/module-*。客户端同时跑在浏览器与支付宝小程序 web-view 壳里。",
+  "engines": {
+    "node": ">=24.0.0 <25.0.0"
+  },
+  "files": [
+    "apps",
+    "!apps/**/dist",
+    "!apps/**/dist-ssr",
+    "!apps/**/.vite",
+    "!apps/**/node_modules",
+    "config",
+    "packages",
+    "!packages/**/node_modules",
+    "scripts",
+    ".tbox",
+    ".gitignore",
+    ".nvmrc",
+    "AGENTS.md",
+    "ENV.md",
+    "LEGAL.md",
+    "README.md",
+    "eslint.config.mjs",
+    "pnpm-workspace.template.yaml",
+    "tsconfig.base.json",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "eslint": "^9.0.0",
+    "typescript-eslint": "^8.57.2",
+    "eslint-plugin-react-hooks": "^5.2.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "pnpm --filter @app/server dev",
+    "build": "pnpm check:workspace && pnpm --filter @app/server build && pnpm --filter @app/client build",
+    "typecheck": "pnpm -r --filter \"@app/*\" typecheck",
+    "test": "pnpm -r --filter \"@app/*\" test",
+    "lint": "eslint apps packages",
+    "verify": "pnpm typecheck && pnpm test && pnpm lint && pnpm build && pnpm verify:generated",
+    "verify:generated": "node scripts/verify-generated.mjs",
+    "check:workspace": "node scripts/check-workspace.mjs",
+    "plugin:inspect": "pnpm --filter @app/server exec node --import tsx src/cli/plugin-inspect.ts",
+    "plugin:doctor": "pnpm --filter @app/server exec node --import tsx src/cli/plugin-doctor.ts"
+  }
+}

package/packages/module-weather/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@app/module-weather",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    },
+    "./server": {
+      "types": "./src/server/index.ts",
+      "import": "./src/server/index.ts"
+    },
+    "./client": {
+      "types": "./src/client/index.ts",
+      "import": "./src/client/index.ts"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@tbox.cn/app-sdk": "catalog:",
+    "@tbox.cn/app-contracts": "catalog:"
+  },
+  "peerDependencies": {
+    "zod": "catalog:",
+    "react": "catalog:"
+  },
+  "devDependencies": {
+    "@types/react": "catalog:",
+    "typescript": "catalog:"
+  }
+}

package/packages/module-weather/src/client/cards/weather/index.less

@@ -0,0 +1,22 @@
+.tbox-weather {
+  max-width: 80%;
+  padding: 32px 24px;
+
+  &__city {
+    font-size: var(--tbox-fs-heading);
+    font-weight: 600;
+    color: var(--tbox-text-primary);
+  }
+
+  &__temp {
+    font-size: 56px;
+    font-weight: 700;
+    color: var(--tbox-primary);
+    margin: 8px 0;
+  }
+
+  &__meta {
+    font-size: var(--tbox-fs-caption);
+    color: var(--tbox-text-secondary);
+  }
+}

package/packages/module-weather/src/client/cards/weather/index.tsx

@@ -0,0 +1,14 @@
+import type { WeatherCardData } from '../../../server/cards/weather/meta';
+import './index.less';
+
+export function WeatherCard({ data }: { data: WeatherCardData; cardId: string; isHistory: boolean }) {
+  return (
+    <div className="tbox-weather">
+      <div className="tbox-weather__city">{data.city}</div>
+      <div className="tbox-weather__temp">{data.temp}°</div>
+      <div className="tbox-weather__meta">
+        {data.weather} · 湿度 {data.humidity}%
+      </div>
+    </div>
+  );
+}

package/packages/module-weather/src/client/index.ts

@@ -0,0 +1,19 @@
+import type { CardComponent } from '@tbox.cn/app-contracts';
+import type { ClientContext, ClientModule } from '@tbox.cn/app-sdk/client';
+import { WeatherCard } from './cards/weather/index';
+
+/**
+ * 客户端卡片组件 map（CLI sync 读取）。
+ * key 约定 = cardType；渲染边界统一为 CardComponent（data: unknown），具体类型由组件内部收窄。
+ */
+const cards = {
+  weather: WeatherCard as CardComponent,
+} as const;
+
+/** 模块注册入口：自注册闭环（与服务端 serverModule 对称） */
+export const clientModule = {
+  cards,
+  register(ctx: ClientContext): void {
+    ctx.cards.registerMap(cards);
+  },
+} satisfies ClientModule;

package/packages/module-weather/src/index.ts

@@ -0,0 +1,2 @@
+export * from './server';
+export * from './client';

package/packages/module-weather/src/server/cards/weather/meta.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import type { CardMeta } from '@tbox.cn/app-contracts';
+
+export const dataSchema = z.object({
+  city: z.string(),
+  temp: z.number(),
+  weather: z.string(),
+  humidity: z.number(),
+});
+
+export type WeatherCardData = z.infer<typeof dataSchema>;
+
+const meta: CardMeta<typeof dataSchema> = {
+  cardType: 'weather',
+  dataSchema,
+  allowedTools: ['getWeather'],
+  displayName: '天气卡片',
+  description: '展示某城市的天气数据，含温度、天气状况、湿度',
+  sampleData: {
+    city: '北京',
+    temp: 22,
+    weather: '晴',
+    humidity: 35,
+  },
+};
+
+export default meta;
+export { meta as weatherMeta };

package/packages/module-weather/src/server/index.ts

@@ -0,0 +1,19 @@
+import { weatherTool } from './tool';
+import weatherMeta from './cards/weather/meta';
+import type { ServerContext, ServerModule } from '@tbox.cn/app-sdk/server';
+
+export { weatherTool, weatherMeta };
+
+/** 卡片 meta 声明 map（key 约定 = meta.cardType；数据 + 类型源） */
+const cards = {
+  weather: weatherMeta,
+} as const;
+
+/** 模块注册入口：自注册闭环（与客户端 clientModule 对称） */
+export const serverModule = {
+  cards,
+  register(ctx: ServerContext): void {
+    ctx.tools.register(weatherTool);
+    ctx.cards.registerMap(cards);
+  },
+} satisfies ServerModule;

package/packages/module-weather/src/server/tool.ts

@@ -0,0 +1,29 @@
+import { createTool } from '@tbox.cn/app-sdk/server';
+import { z } from 'zod';
+
+/**
+ * 天气查询工具 — 示例
+ */
+export const weatherTool = createTool({
+  id: 'getWeather',
+  description: '查询城市天气信息',
+  inputSchema: z.object({
+    city: z.string().describe('城市名称，如 北京、上海'),
+  }),
+  outputSchema: z.object({
+    city: z.string(),
+    temp: z.number(),
+    weather: z.string(),
+    humidity: z.number(),
+  }),
+  execute: async ({ city }) => {
+    const mockData: Record<string, { temp: number; weather: string; humidity: number }> = {
+      北京: { temp: 22, weather: '晴', humidity: 35 },
+      上海: { temp: 25, weather: '多云', humidity: 65 },
+      广州: { temp: 30, weather: '阵雨', humidity: 80 },
+      深圳: { temp: 29, weather: '多云', humidity: 75 },
+    };
+    const data = mockData[city] || { temp: 20, weather: '未知', humidity: 50 };
+    return { city, ...data };
+  },
+});

package/packages/module-weather/tbox.component.json

@@ -0,0 +1,27 @@
+{
+  "schemaVersion": 1,
+  "name": "module-weather",
+  "version": "0.1.0",
+  "kind": "business",
+  "risk": {
+    "level": "low",
+    "writeBoundary": "source"
+  },
+  "distribution": {
+    "defaultMode": "codegen"
+  },
+  "contributes": {
+    "handlers": [],
+    "tools": ["getWeather"],
+    "cards": [
+      { "cardType": "weather", "schemaVersion": 1 }
+    ],
+    "routes": [],
+    "pages": [],
+    "tabs": []
+  },
+  "dependencies": {
+    "modules": []
+  },
+  "env": []
+}

package/packages/module-weather/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "jsx": "react-jsx",
+    "paths": {
+      "@tbox.cn/app-contracts": ["../contracts/src/index.ts"],
+      "@tbox.cn/app-contracts/*": ["../contracts/src/*"],
+      "@tbox.cn/app-sdk/server": ["../app-sdk/src/server/index.ts"],
+      "@tbox.cn/app-sdk/client": ["../app-sdk/src/client/index.ts"]
+    }
+  },
+  "include": ["src"]
+}

package/pnpm-workspace.template.yaml

@@ -0,0 +1,60 @@
+# 应用 workspace 模板：tbox-app create 用它生成应用的 pnpm-workspace.yaml。
+# 本文件不触发 workspace root（非 pnpm-workspace.yaml 文件名）。
+# 同步规则：catalog 与根 pnpm-workspace.yaml 保持并集一致（单向复制，未引用条目无害）。
+packages:
+  - apps/*
+  - packages/*
+
+onlyBuiltDependencies:
+  - esbuild
+
+allowBuilds:
+  esbuild: true
+
+catalog:
+  typescript: ^5.7.0
+  tsx: ^4.19.0
+  zod: ^3.24.0
+  vite: ^6.4.3
+  vitest: ^4.1.4
+  react: ^18.3.1
+  react-dom: ^18.3.1
+  "@types/react": ^18.3.12
+  "@types/react-dom": ^18.3.1
+  "@types/node": ^24.0.0
+  express: ^4.21.0
+  "@types/express": ^4.17.21
+  ws: ^8.18.0
+  "@types/ws": ^8.5.0
+  "@mastra/core": ^1.33.0
+  "@mastra/observability": 1.12.0
+  "@ag-ui/core": ^0.0.47
+  ai: ^6.0.0
+  "@ai-sdk/openai": ^3.0.0
+  "@ai-sdk/provider": ^3.0.10
+  "@tbox.cn/agent-plugin": 0.1.0
+  "@tbox.cn/app-sdk": ^0.1.0
+  "@tbox.cn/app-contracts": ^0.1.0
+  "@tbox.cn/app-contracts-mall": ^0.1.0
+  zustand: ^4.5.5
+  commander: ^12.1.0
+  diff: ^7.0.0
+  "@types/diff": ^7.0.0
+  eslint: ^9.0.0
+  typescript-eslint: ^8.57.2
+  eslint-plugin-react-hooks: ^5.2.0
+  tsup: ^8.0.0
+  cors: ^2.8.5
+  jose: ^6.2.2
+  "@types/cors": ^2.8.17
+  "@tbox-dev-js/sdk": 0.1.18
+  "@vitejs/plugin-react": ^4.3.3
+  less: ^4.2.0
+  "@phosphor-icons/react": ^2.1.10
+  antd-mobile: ^5.42.3
+  react-markdown: ^9.1.0
+  remark-gfm: ^4.0.1
+  "@types/supertest": ^7.2.0
+  supertest: ^7.2.2
+  happy-dom: ^20.9.0
+  postcss-pxtorem: ^6.1.0

package/scripts/build.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+set -e
+
+# Usage: build.sh [--skip-server]
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+cd "$PROJECT_DIR"
+echo "Project directory: $PROJECT_DIR"
+
+export NODE_ENV=production
+echo "APP_API_URL: $APP_API_URL"
+
+SKIP_SERVER=false
+for arg in "$@"; do
+  [ "$arg" = "--skip-server" ] && SKIP_SERVER=true
+done
+echo "Skip server: $SKIP_SERVER"
+
+# 工程边界守卫
+node "$SCRIPT_DIR/check-workspace.mjs"
+
+# 平台基础设施守卫
+bash "$SCRIPT_DIR/check-inspector.sh"
+
+echo "Installing dependencies..."
+CI=true pnpm install
+
+echo "Building client (H5)..."
+pnpm --filter @app/client build
+
+if [ "$SKIP_SERVER" = false ]; then
+  echo "Building server..."
+  pnpm --filter @app/server build
+else
+  echo "Skipping server build (--skip-server)"
+fi
+
+echo "All builds completed successfully!"

package/scripts/check-inspector.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+# ============================================================================
+# 平台基础设施守卫 — 校验 tbox 微调（Inspector）注入未被破坏。
+# Inspector 已下沉 @tbox.cn/app-sdk/platform（003 §3.1），本脚本断言同步更新。
+# 支持两种上下文：
+#   1. 根 workspace 成员形态（模板子树）：向上探测 pnpm-workspace.yaml 取 SDK 真源
+#   2. 生成应用发布态：app-sdk 经 node_modules 解析（检查包存在 + exports 含 ./platform）
+# ============================================================================
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+
+INDEX_FILE="$PROJECT_DIR/apps/server/src/index.ts"
+AGENT_HTML="$PROJECT_DIR/apps/client/index.html"
+VITE_CFG="$PROJECT_DIR/apps/client/vite.config.ts"
+
+fail() {
+  echo ""
+  echo "❌ [check-inspector] 平台基础设施校验失败：$1"
+  echo ""
+  echo "   tbox 平台微调能力（点选元素 → 写入聊天框）是平台基础设施，AI agent 不得删除。"
+  echo "   必须保留："
+  echo "     1. @tbox.cn/app-sdk/platform 存在并导出 installInspector（RUNTIME_PATH 约定不变）"
+  echo "     2. apps/server/src/index.ts 从 @tbox.cn/app-sdk/platform import 并调用 installInspector(app)"
+  echo "     3. apps/client/index.html 含 inspector 脚本标签"
+  echo "     4. apps/client/vite.config.ts 接入 code-inspect plugin"
+  echo ""
+  exit 1
+}
+
+# 定位 app-sdk 源码路径：模板内 → workspace 根 → node_modules（发布态）
+SDK_SRC=""
+for candidate in \
+  "$PROJECT_DIR/packages/app-sdk" \
+  "$PROJECT_DIR/../packages/app-sdk" \
+  "$PROJECT_DIR/../../packages/app-sdk"; do
+  if [ -f "$candidate/src/platform/inspector.ts" ]; then
+    SDK_SRC="$candidate"
+    break
+  fi
+done
+
+if [ -n "$SDK_SRC" ]; then
+  # 1. inspector.ts 存在 + 导出 installInspector + RUNTIME_PATH（RUNTIME_PATH 约定不变）
+  INSPECTOR_FILE="$SDK_SRC/src/platform/inspector.ts"
+  grep -qE "export\s+(async\s+)?function\s+installInspector" "$INSPECTOR_FILE" \
+    || fail "inspector.ts 未导出 installInspector"
+  grep -qE "RUNTIME_PATH\s*=\s*['\"]/__vs_inspector__\.js['\"]" "$INSPECTOR_FILE" \
+    || fail "inspector.ts 中 RUNTIME_PATH 被改动"
+else
+  # 发布态：@tbox.cn/app-sdk 经 node_modules 解析
+  SDK_PKG=""
+  for base in "$PROJECT_DIR" "$PROJECT_DIR/../.."; do
+    if [ -d "$base/node_modules/@tbox.cn/app-sdk" ]; then
+      SDK_PKG="$base/node_modules/@tbox.cn/app-sdk"
+      break
+    fi
+  done
+  [ -n "$SDK_PKG" ] || fail "未找到 @tbox.cn/app-sdk（源码形态或 node_modules 发布态）"
+  node -e "
+    const fs = require('fs');
+    const pkg = JSON.parse(fs.readFileSync('$SDK_PKG/package.json', 'utf8'));
+    const ex = pkg.exports || {};
+    if (!ex['./platform']) { console.error('platform export missing'); process.exit(1); }
+  " || fail "@tbox.cn/app-sdk 的 package.json 未导出 ./platform"
+fi
+
+# 2. index.ts 从 @tbox.cn/app-sdk/platform import 并调用 installInspector(app)
+grep -qE "from\s+['\"]@tbox\.cn/app-sdk/platform['\"]" "$INDEX_FILE" \
+  || fail "index.ts 未从 @tbox.cn/app-sdk/platform import"
+grep -qE "installInspector\s*\(\s*app\s*[,)]" "$INDEX_FILE" \
+  || fail "index.ts 未调用 installInspector(app)"
+
+# 3. client/index.html 内置 inspector 脚本标签
+[ -f "$AGENT_HTML" ] || fail "缺失文件 apps/client/index.html"
+grep -qE "/__vs_inspector__\.js" "$AGENT_HTML" \
+  || fail "apps/client/index.html 缺少 inspector 脚本标签"
+
+# 4. vite.config 接入 code-inspect plugin
+[ -f "$VITE_CFG" ] || fail "缺失文件 apps/client/vite.config.ts"
+grep -qE "codeInspectPlugin" "$VITE_CFG" \
+  || fail "apps/client/vite.config.ts 未接入 code-inspect plugin"
+
+# 5. 源码标注：code-inspect babel plugin 存在
+CODE_INSPECT="$PROJECT_DIR/apps/client/babel-plugins/code-inspect.cjs"
+[ -f "$CODE_INSPECT" ] || fail "缺失文件 apps/client/babel-plugins/code-inspect.cjs"
+grep -qE "data-code-inspect-loc-filepath" "$CODE_INSPECT" \
+  || fail "code-inspect.cjs 未注入 data-code-inspect-* 属性"
+
+echo "✅ [check-inspector] 平台基础设施校验通过"

package/scripts/check-workspace.mjs

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+
+import { existsSync } from 'node:fs';
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import process from 'node:process';
+
+const projectDir = path.resolve(process.argv[2] ?? path.join(import.meta.dirname, '..'));
+const allowedViteConfigDirs = new Set(['apps/client']);
+const ignoredDirs = new Set([
+  '.agents',
+  '.claude',
+  '.codex',
+  '.git',
+  '.node',
+  '.pnpm-store',
+  '.tmp',
+  '.vite',
+  'dist',
+  'dist-ssr',
+  'node_modules',
+]);
+const nestedLockfiles = new Set([
+  'bun.lock',
+  'bun.lockb',
+  'package-lock.json',
+  'pnpm-lock.yaml',
+  'yarn.lock',
+]);
+const viteConfigPattern = /^vite\.config\.(?:js|mjs|cjs|ts|mts|cts)$/;
+
+function relativeDir(filePath) {
+  const relative = path.relative(projectDir, path.dirname(filePath));
+  return relative === '' ? '.' : relative.split(path.sep).join('/');
+}
+
+async function walk(dir, findings) {
+  const entries = await readdir(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (entry.isSymbolicLink()) continue;
+
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (!ignoredDirs.has(entry.name)) await walk(fullPath, findings);
+      continue;
+    }
+    if (!entry.isFile()) continue;
+
+    const dirName = relativeDir(fullPath);
+    const relativePath = path.relative(projectDir, fullPath).split(path.sep).join('/');
+
+    if (nestedLockfiles.has(entry.name) && dirName !== '.') {
+      findings.nestedLockfiles.push(relativePath);
+    }
+
+    if (viteConfigPattern.test(entry.name) && !allowedViteConfigDirs.has(dirName)) {
+      findings.detachedViteConfigs.push(relativePath);
+    }
+  }
+}
+
+function readWorkspacePackages(source) {
+  const packages = [];
+  let inPackages = false;
+
+  for (const line of source.split(/\r?\n/)) {
+    if (/^packages:\s*$/.test(line)) {
+      inPackages = true;
+      continue;
+    }
+    if (inPackages && /^\S/.test(line)) break;
+
+    const match = inPackages ? line.match(/^\s+-\s+['"]?([^'"#]+?)['"]?\s*(?:#.*)?$/) : null;
+    if (match) packages.push(match[1].trim());
+  }
+
+  return packages;
+}
+
+function printFailure(findings) {
+  console.error('');
+  console.error('[check-workspace] 工程边界校验失败。');
+
+  if (findings.nestedLockfiles.length > 0) {
+    console.error('\n检测到嵌套 lockfile（本项目只允许根 pnpm-lock.yaml）：');
+    for (const file of findings.nestedLockfiles) console.error(`  - ${file}`);
+  }
+  if (findings.detachedViteConfigs.length > 0) {
+    console.error('\n检测到 apps/client/ 之外的 Vite 项目配置：');
+    for (const file of findings.detachedViteConfigs) console.error(`  - ${file}`);
+  }
+  if (findings.missingComponentDescriptors.length > 0) {
+    console.error('\npackages/* 缺少 tbox.component.json（contracts / app-sdk / shared 除外）：');
+    for (const file of findings.missingComponentDescriptors) console.error(`  - ${file}`);
+  }
+
+  console.error('');
+  process.exitCode = 1;
+}
+
+/** 豁免：SDK/契约包无 tbox.component.json（002 §2.3 / 003 §4.1） */
+function isExemptPackage(dirName) {
+  return dirName === 'app-sdk' || dirName === 'shared' || dirName.startsWith('contracts');
+}
+
+/** 校验 packages/* 每个业务包必须有 tbox.component.json（002 §2.3 / 003 §4.1） */
+async function checkComponentDescriptors(projectDir, findings) {
+  const packagesDir = path.join(projectDir, 'packages');
+  if (!existsSync(packagesDir)) return;
+  const entries = await readdir(packagesDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (isExemptPackage(entry.name)) continue;
+    const pkgDir = path.join(packagesDir, entry.name);
+    if (!existsSync(path.join(pkgDir, 'package.json'))) continue;
+    if (!existsSync(path.join(pkgDir, 'tbox.component.json'))) {
+      findings.missingComponentDescriptors.push(`packages/${entry.name}/`);
+    }
+  }
+}
+
+/** 向上查找最近的 pnpm-workspace.yaml（模板目录并入根 workspace 后本目录可无 workspace 文件，属父 workspace 成员） */
+function findWorkspaceFile(dir) {
+  let cur = path.resolve(dir);
+  for (;;) {
+    const f = path.join(cur, 'pnpm-workspace.yaml');
+    if (existsSync(f)) return f;
+    const parent = path.dirname(cur);
+    if (parent === cur) return null;
+    cur = parent;
+  }
+}
+
+async function main() {
+  const workspaceFile = findWorkspaceFile(projectDir);
+  if (!workspaceFile) {
+    console.error('[check-workspace] 缺少 pnpm-workspace.yaml（本目录及父级均未找到）。');
+    process.exitCode = 1;
+    return;
+  }
+
+  const workspacePackages = readWorkspacePackages(await readFile(workspaceFile, 'utf8'));
+  const findings = {
+    nestedLockfiles: [],
+    detachedViteConfigs: [],
+    missingComponentDescriptors: [],
+  };
+
+  await walk(projectDir, findings);
+  await checkComponentDescriptors(projectDir, findings);
+
+  if (Object.values(findings).some((items) => items.length > 0)) {
+    printFailure(findings);
+    return;
+  }
+
+  console.log('[check-workspace] 工程边界校验通过（apps/* + packages/* workspace）');
+}
+
+main().catch((error) => {
+  console.error('[check-workspace] 校验执行失败：', error);
+  process.exitCode = 1;
+});

package/scripts/dev.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+cd "$PROJECT_DIR"
+echo "Project directory: $PROJECT_DIR"
+
+echo "Installing dependencies..."
+pnpm install
+
+echo "Starting development server..."
+echo "  - http://localhost:8000 (API + WS + 页面 + HMR)"
+
+pnpm --filter @app/server dev

package/scripts/prepare.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+cd "$PROJECT_DIR"
+
+echo "Installing dependencies..."
+CI=true pnpm install
+
+echo "Prepare complete!"

package/scripts/start.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+cd "$PROJECT_DIR"
+
+echo "Starting production server..."
+echo "NODE_ENV: $NODE_ENV"
+
+NODE_ENV=production pnpm --filter @app/server start