@tbox.cn/app-template-agent 0.10.15 → 0.10.16

package/.tbox/miniapp-containers.json

@@ -0,0 +1,6 @@
+[
+  {
+    "platform": "alipay",
+    "source": "@tbox.cn/app-miniapp-container-alipay@0.2.3"
+  }
+]

package/README.md

@@ -4,11 +4,15 @@ tbox AI Agent 全栈模板（npm 包名 `@tbox.cn/app-template-agent`，唯一
 缺省出厂 = 空装配（chat 形态）；**商圈形态经 `profiles/mall` 画像加装**（`tbox-app create --profile mall`：mall-core + 六业务模块 + 商圈配置叠加）。
 客户端同时支持浏览器和支付宝小程序 web-view；平台能力（鉴权/会话/TTS/ASR/上传/反馈）经 `@tbox.cn/app-sdk` 统一提供（007 下沉）。
 
+创建应用时默认生成 `apps/miniapp-container-alipay`，容器计划见 `.tbox/miniapp-containers.json`。使用前配置小程序 AppId 和 H5 地址；重复创建保留已登记的容器。
+
+`pnpm dev` 始终启动原有 H5/server；容器已安装且 PATH 中有 `minidev` 时同时启动容器，否则跳过。容器异常退出不影响 H5/server，Ctrl+C 统一停止本次启动的进程。
+
 ## 快速开始
 
 ```sh
 pnpm install
-pnpm dev          # 单进程 http://localhost:8000（API + WS + 页面 + HMR）
+pnpm dev          # H5/server + 可选 minidev 小程序容器
 pnpm verify       # typecheck + test + build
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-template-agent",
-  "version": "0.10.15",
+  "version": "0.10.16",
   "description": "tbox AI Agent 全栈模板（多包 pnpm workspace）：apps/client + apps/server。唯一模板（W4 单一模板统一化：缺省空装配 chat 形态；mall 能力经 profiles/mall 加装），能力经 tbox-app module add 模块扩展（shopping-guide/member 等）。",
   "engines": {
     "node": ">=24.0.0 <25.0.0"
@@ -44,7 +44,7 @@
     "access": "public"
   },
   "scripts": {
-    "dev": "pnpm --filter ./apps/server dev",
+    "dev": "node scripts/dev.mjs",
     "build": "pnpm check && pnpm --filter ./apps/server build && pnpm --filter ./apps/client build",
     "build:client": "pnpm check && pnpm --filter ./apps/client build",
     "typecheck": "pnpm -r --filter \"./{apps,packages}/*\" typecheck",

package/pnpm-lock.template.yaml

@@ -27,6 +27,9 @@ catalogs:
     '@tbox.cn/app-contracts-mall':
       specifier: 0.13.0
       version: 0.13.0
+    '@tbox.cn/app-sdk-client':
+      specifier: 0.21.3
+      version: 0.21.3
     '@tbox.cn/app-sdk-server':
       specifier: 0.25.0
       version: 0.25.0
@@ -190,6 +193,24 @@ importers:
         specifier: 'catalog:'
         version: 4.1.10(@opentelemetry/api@1.9.1)(@types/node@24.13.3)(happy-dom@20.11.2)(vite@6.4.3(@types/node@24.13.3)(less@4.8.1)(tsx@4.23.11))
 
+  apps/miniapp-container-alipay:
+    devDependencies:
+      '@mini-types/alipay':
+        specifier: ^3.0.14
+        version: 3.0.14
+      '@tbox.cn/app-sdk-client':
+        specifier: 'catalog:'
+        version: 0.21.3
+      '@tbox.cn/app-sdk-server':
+        specifier: 'catalog:'
+        version: 0.25.0
+      typescript:
+        specifier: 'catalog:'
+        version: 5.9.3
+      vitest:
+        specifier: 'catalog:'
+        version: 4.1.10(@opentelemetry/api@1.9.1)(@types/node@24.13.3)(happy-dom@20.11.2)(vite@6.4.3(@types/node@24.13.3)(less@4.8.1)(tsx@4.23.11))
+
   apps/server:
     dependencies:
       '@app/contracts-mall':
@@ -1101,6 +1122,15 @@ packages:
     peerDependencies:
       zod: ^3.25.0 || ^4.0.0
 
+  '@mini-types/alipay@3.0.14':
+    resolution: {integrity: sha512-FakzSsKvybtWlEIVTIRlr89kuQFn+XY86Ho9VUFFaKLplhW6Wx8FUxTDE7IzV7B9rT8DP/Icy637vUHlXPsw1g==}
+
+  '@mini-types/global@3.0.14':
+    resolution: {integrity: sha512-St2ucFRfKRskposOqV/9iNJTKn1MbyqDypQiy/0DaVJjEm2MFi82RJjX9sBz1uWhQIqzu741PgTjGSy7L/Qj9g==}
+
+  '@mini-types/my@3.0.14':
+    resolution: {integrity: sha512-aEgmM+rbEvEzTvqltCFRAg/h6KKs14M1y+FrOkz+hn2EyNpOVPesUzTjbRhSiFFsE3WdfBh54lHNYBahAmHq7w==}
+
   '@modelcontextprotocol/core@2.0.0':
     resolution: {integrity: sha512-pJCEwGG7Lfr/+PQp9ZTwKXNeO5wzbfKL7H3MYpCorM4oFBoQrdjnBgEoqG+RjhsvS1FKrDbKux+M1HhlnGWqcA==}
     engines: {node: '>=20'}
@@ -3907,6 +3937,15 @@ snapshots:
       zod: 3.25.76
       zod-from-json-schema: 0.5.6
 
+  '@mini-types/alipay@3.0.14':
+    dependencies:
+      '@mini-types/global': 3.0.14
+      '@mini-types/my': 3.0.14
+
+  '@mini-types/global@3.0.14': {}
+
+  '@mini-types/my@3.0.14': {}
+
   '@modelcontextprotocol/core@2.0.0':
     dependencies:
       zod: 4.4.3

package/profiles/mall.json

@@ -1,7 +1,7 @@
 {
   "$comment": "mall 画像（单一模板统一化 W4）：create --profile mall 执行器（W5 接线）按 modules 序列加装 + configOverlay 叠加（--config-dir 通道）+ rootFiles 根文件落地（TEMPLATE.md 使用指南 → 应用根）。provider 轴独立（缺省 mock-only 演示态；vendor 档由部署者后续 add）。",
   "name": "mall",
-  "description": "商圈 AI Agent：家页形态（home 槽）+ 域装配 + 六业务域（导购/会员/停车/营销/活动/客服）",
+  "description": "商圈 AI Agent：家页形态（home 槽）+ 域装配 + 七业务域（导购/会员/停车/营销/活动/客服/AI 支付）",
   "modules": [
     "@tbox.cn/app-module-mall-core",
     "@tbox.cn/app-module-shopping-guide",
@@ -9,7 +9,8 @@
     "@tbox.cn/app-module-parking",
     "@tbox.cn/app-module-promotion",
     "@tbox.cn/app-module-alipay-activity",
-    "@tbox.cn/app-module-customer-service"
+    "@tbox.cn/app-module-customer-service",
+    "@tbox.cn/app-module-ai-payment"
   ],
   "configOverlay": "profiles/mall/config",
   "rootFiles": ["TEMPLATE.md"]

package/scripts/dev.mjs

@@ -0,0 +1,91 @@
+import { spawn } from 'node:child_process';
+import { accessSync, constants, existsSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+export function hasCommand(command, env = process.env) {
+  const extensions = process.platform === 'win32' ? (env.PATHEXT ?? '.EXE;.CMD;.BAT').split(';') : [''];
+  return (env.PATH ?? '').split(path.delimiter).some(dir => extensions.some(extension => {
+    try {
+      const executable = path.join(dir || '.', command + extension);
+      accessSync(executable, constants.X_OK);
+      return statSync(executable).isFile();
+    }
+    catch { return false; }
+  }));
+}
+
+function stopChild(child, signal) {
+  if (!child?.pid) return;
+  try {
+    if (process.platform === 'win32') child.kill(signal);
+    else process.kill(-child.pid, signal);
+  } catch (error) {
+    if (error.code !== 'ESRCH') throw error;
+  }
+}
+
+/** H5/server 为主进程；可选容器失败不终止主进程。 */
+export function startDev({
+  projectDir,
+  spawnProcess = spawn,
+  commandExists = hasCommand,
+  stopProcess = stopChild,
+  signals = process,
+  log = console,
+  finish = code => { process.exitCode = code; },
+}) {
+  const options = { cwd: projectDir, detached: process.platform !== 'win32', shell: process.platform === 'win32' };
+  const containerInstalled = existsSync(path.join(projectDir, 'apps/miniapp-container-alipay/package.json'));
+  const containerEnabled = containerInstalled && commandExists('minidev');
+  const server = spawnProcess('pnpm', ['--filter', './apps/server', 'dev'], {
+    ...options, stdio: containerEnabled ? ['ignore', 'inherit', 'inherit'] : 'inherit',
+  });
+  let container;
+  let stopping = false;
+  let requestedCode;
+  let completed = false;
+  const stop = code => {
+    if (stopping) return;
+    stopping = true;
+    requestedCode = code;
+    stopProcess(server, 'SIGTERM');
+    stopProcess(container, 'SIGTERM');
+    setTimeout(() => {
+      stopProcess(server, 'SIGKILL');
+      stopProcess(container, 'SIGKILL');
+    }, 2000);
+  };
+  const interrupt = () => stop(130);
+  const terminate = () => stop(143);
+  signals.on('SIGINT', interrupt);
+  signals.on('SIGTERM', terminate);
+  const complete = code => {
+    if (completed) return;
+    completed = true;
+    stop(code);
+    signals.removeListener('SIGINT', interrupt);
+    signals.removeListener('SIGTERM', terminate);
+    finish(requestedCode ?? code);
+  };
+  server.once('error', error => { log.error(`H5/server 启动失败：${error.message}`); complete(1); });
+  server.once('exit', (code, signal) => complete(code ?? (signal ? 1 : 0)));
+
+  if (!containerInstalled) {
+    log.info('未安装支付宝小程序容器，仅启动 H5/server。');
+  } else if (!containerEnabled) {
+    log.info('未找到 minidev，跳过小程序容器，H5/server 正常启动。');
+  } else {
+    log.info('同时启动支付宝小程序容器（minidev）。');
+    container = spawnProcess('pnpm', ['--filter', '@app/miniapp-container-alipay', 'dev'], { ...options, stdio: 'inherit' });
+    container.once('error', error => log.warn(`小程序容器启动失败，H5/server 继续运行：${error.message}`));
+    container.once('exit', code => {
+      if (!stopping) log.info(`小程序容器已退出（${code ?? 'signal'}），H5/server 继续运行。`);
+    });
+  }
+  return { server, get container() { return container; }, stop };
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  startDev({ projectDir: path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..') });
+}

package/scripts/dev.sh

@@ -12,4 +12,4 @@ pnpm install
 echo "Starting development server..."
 echo "  - http://localhost:8000 (API + WS + 页面 + HMR)"
 
-pnpm --filter @app/server dev
+pnpm dev