@tbox.cn/app-template-h5 0.1.0 → 0.1.1

package/AGENTS.md

@@ -2,8 +2,6 @@
 
 template-h5 是面向 AI 生成移动 H5 应用的单 workspace 模板：`apps/client`（React/Vite）+ `apps/server`（Express）。
 
-> **工作区上下文**：仓库内本目录是根 workspace 成员子树，平台引用走 `catalog:`（in-repo 经根 overrides 源码直连 SDK）；`tbox-app create` 从模板源（目录或 pack tgz）展开生成应用，`pnpm-workspace.yaml` 由 `pnpm-workspace.template.yaml` 改名生成。
-
 ## 工程结构
 
 | 包 | 职责 |
@@ -12,20 +10,21 @@ template-h5 是面向 AI 生成移动 H5 应用的单 workspace 模板：`apps/c
 | `apps/server` | Express API：健康检查、静态托管、inspector（@app/server） |
 | `scripts/` | 平台生命周期脚本（prepare/dev/start/stop/build 固定名契约）与工程守卫 |
 
-## 常用命令
+## 运行与验证（平台沙箱）
+
+应用构建与运行在平台沙箱中，启动/停止/重启由平台负责——不要运行 `pnpm dev` 等长驻进程
+命令（沙箱规则 `config/rules/no-persistent-process.md`）。你只改代码与配置，用一次性命令
+验证：
 
 ```sh
-pnpm install
-pnpm dev              # 单进程 localhost:8000（API + 页面 + HMR）
+pnpm install       # 会话开始时 node_modules 缺失先装
 pnpm typecheck
 pnpm test
 pnpm build
-pnpm verify           # typecheck + test + lint + build + check:inspector
+pnpm verify        # typecheck + test + lint + build + check:inspector
 pnpm check:inspector  # inspector 接线守卫（随 @tbox.cn/app-sdk 分发）
 ```
 
-会话开始时，若 `node_modules` 缺失，先跑 `pnpm install`。
-
 ## SDK 复用点（优先复用，勿手写）
 
 - `@tbox.cn/app-sdk/client`：`configureRuntime`（API base 注入，勿硬编码 host）、`httpGet/httpPost/createService`（HTTP 客户端）、`ErrorBoundary`、`createLogger`、`installGlobalErrorReporting`

package/apps/client/package.json

@@ -10,9 +10,9 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@tbox.cn/app-sdk": "catalog:",
     "react": "catalog:",
-    "react-dom": "catalog:"
+    "react-dom": "catalog:",
+    "@tbox.cn/app-sdk-client": "catalog:"
   },
   "devDependencies": {
     "@types/node": "catalog:",

package/apps/client/src/business/App.tsx

@@ -1,6 +1,6 @@
 /**
  * 业务应用唯一入口：中性单页起点，无占位标记。
- * 新应用替换本组件；后端调用走 @tbox.cn/app-sdk/client 的 httpGet/httpPost（同源 /api/*）。
+ * 新应用替换本组件；后端调用走 @tbox.cn/app-sdk-client 的 httpGet/httpPost（同源 /api/*）。
  */
 export default function BusinessApp() {
   return (

package/apps/client/src/main.tsx

@@ -4,7 +4,7 @@ import {
   configureRuntime,
   ErrorBoundary,
   installGlobalErrorReporting,
-} from '@tbox.cn/app-sdk/client';
+} from '@tbox.cn/app-sdk-client';
 import BusinessApp from './business/App';
 import './styles/base.css';
 

package/apps/client/vite.config.ts

@@ -5,7 +5,7 @@ import pxToRem from 'postcss-pxtorem';
 import { resolve } from 'node:path';
 // 平台微调配套 babel plugin（随 @tbox.cn/app-sdk 分发）：dev 期给每个 JSX 注入源码位置属性，
 // 供 inspector runtime(/__vs_inspector__.js) 点选元素→定位源码（check:inspector 断言点）。
-import codeInspectPlugin from '@tbox.cn/app-sdk/platform/code-inspect';
+import codeInspectPlugin from '@tbox.cn/app-sdk-client/platform/code-inspect';
 
 const pxToRemPlugin = pxToRem({
   rootValue: 100,
@@ -25,9 +25,6 @@ export default defineConfig(({ command }) => ({
   resolve: {
     alias: {
       '@': resolve(__dirname, 'src'),
-      // @tbox-dev-js/sdk 顶层静态 import fs/path（浏览器不执行）——生产构建以桩 alias（agent 同构）
-      fs: resolve(__dirname, 'src/shims/node-stub.ts'),
-      path: resolve(__dirname, 'src/shims/node-stub.ts'),
     },
   },
   css: {

package/apps/server/package.json

@@ -11,8 +11,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@tbox.cn/app-sdk": "catalog:",
-    "express": "catalog:"
+    "express": "catalog:",
+    "@tbox.cn/app-sdk-server": "catalog:"
   },
   "devDependencies": {
     "@types/express": "catalog:",

package/apps/server/src/app.ts

@@ -5,7 +5,7 @@
  */
 import { createServer } from 'http';
 import express from 'express';
-import { createLogger } from '@tbox.cn/app-sdk/server';
+import { createLogger } from '@tbox.cn/app-sdk-server';
 
 export const app = express();
 const logger = createLogger('server');

package/apps/server/src/dev.ts

@@ -8,7 +8,7 @@ import path from 'path';
 import { readFile } from 'node:fs/promises';
 import { fileURLToPath } from 'url';
 import { createServer as createViteServer } from 'vite';
-import { injectScript, installInspector, isReady } from '@tbox.cn/app-sdk/platform';
+import { injectScript, installInspector, isReady } from '@tbox.cn/app-sdk-server/platform';
 import { app, start } from './app.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));

package/apps/server/src/index.ts

@@ -7,8 +7,8 @@ import path from 'path';
 import { existsSync } from 'node:fs';
 import { fileURLToPath } from 'url';
 import express from 'express';
-import { createLogger } from '@tbox.cn/app-sdk/server';
-import { installInspector } from '@tbox.cn/app-sdk/platform';
+import { createLogger } from '@tbox.cn/app-sdk-server';
+import { installInspector } from '@tbox.cn/app-sdk-server/platform';
 import { app, start } from './app.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-template-h5",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "tbox 移动 H5 全栈模板（单 workspace：apps/client + apps/server），运行时与页面微调经 @tbox.cn/app-sdk。",
   "type": "module",
   "engines": {
@@ -31,11 +31,11 @@
     "tsconfig.base.json"
   ],
   "devDependencies": {
-    "@tbox.cn/app-sdk": "0.20.0",
     "eslint": "9.39.5",
     "eslint-plugin-react-hooks": "5.2.0",
     "typescript-eslint": "8.67.0",
-    "vite": "6.4.3"
+    "vite": "6.4.3",
+    "@tbox.cn/app-sdk-server": "0.21.0"
   },
   "scripts": {
     "dev": "pnpm --filter ./apps/server dev",