@tbox.cn/app-template-agent 0.10.19 → 0.10.20

package/.tbox/default-modules.json

@@ -0,0 +1,3 @@
+[
+  "@tbox.cn/app-module-ai-payment"
+]

package/.tbox/miniapp-containers.json

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

package/README.md

@@ -1,18 +1,24 @@
 # template-agent
 
 tbox AI Agent 全栈模板（npm 包名 `@tbox.cn/app-template-agent`，唯一模板——W4 单一模板统一化），多包 pnpm workspace：`apps/` 薄组装端 + `packages/` 模块。
-缺省出厂 = 空装配（chat 形态）；**商圈形态经 `profiles/mall` 画像加装**（`tbox-app create --profile mall`：mall-core + 六业务模块 + 商圈配置叠加）。
+缺省出厂 = 带 AI 支付体验的 chat 形态；**商圈形态经 `profiles/mall` 画像加装**（`tbox-app create --profile mall`：mall-core + 七业务模块 + 商圈配置叠加）。
 客户端同时支持浏览器和支付宝小程序 web-view；平台能力（鉴权/会话/TTS/ASR/上传/反馈）经 `@tbox.cn/app-sdk` 统一提供（007 下沉）。
 
+创建应用时按 `.tbox/default-modules.json` 加装 AI 支付模块，源码落在 `packages/module-ai-payment`。
+
+创建应用时默认使用 `@tbox.cn/app-miniapp-container-alipay@0.2.5` 生成 `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
 ```
 
-**能力加装**（空装配起点，能力即模块；mall 全套可改用 `create --profile mall` 一步到位）：
+**能力加装**（已有 AI 支付体验，能力即模块；mall 全套可改用 `create --profile mall` 一步到位）：
 
 ```sh
 tbox-app module add shopping-guide   # 导购/找店/业态/客服（模块级 intents + LLM 工具 + 卡片）
@@ -28,7 +34,7 @@ tbox-app module doctor               # 26 条结构校验
 > 环境变量：本地开发用 shell export 注入（见 `ENV.md`，含必需变量命令块；每次新终端需重新执行），
 > 生产建议在 tbox 平台页面上配置（平台托管 env，密钥不进代码仓库）。
 
-> 平台包消费（005 v0.4.0 发布态）：生成应用初始通过 `@app/contracts-mall` shim 使用 `catalog:` 引用的发布包；添加依赖 contracts-mall 的 codegen 模块后，CLI 将 shim 替换为本地源码包——
+> 平台包消费（005 v0.4.0 发布态）：模板通过 `@app/contracts-mall` shim 使用 `catalog:` 引用的发布包；创建时默认安装 AI 支付模块，CLI 按依赖将 shim 替换为本地源码包——
 > 生产（registry 已发布）直接 `pnpm install`；平台包未发布 npm 时，由 `tbox-app create --local-deps <平台 tgz 目录>`
 > 注入 overrides（`file:` 本地发布态产物）后 install 离线可用。
 >

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tbox.cn/app-template-agent",
-  "version": "0.10.19",
-  "description": "tbox AI Agent 全栈模板（多包 pnpm workspace）：apps/client + apps/server。唯一模板（W4 单一模板统一化：缺省空装配 chat 形态；mall 能力经 profiles/mall 加装），能力经 tbox-app module add 模块扩展（shopping-guide/member 等）。",
+  "version": "0.10.20",
+  "description": "tbox AI Agent 全栈模板（多包 pnpm workspace）：apps/client + apps/server。唯一模板（W4 单一模板统一化：缺省带 AI 支付体验的 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

@@ -6,9 +6,6 @@ settings:
 
 catalogs:
   default:
-    '@phosphor-icons/react':
-      specifier: 2.1.10
-      version: 2.1.10
     '@tbox-dev-js/sdk':
       specifier: 0.1.18
       version: 0.1.18
@@ -24,9 +21,9 @@ catalogs:
     '@tbox.cn/app-contracts':
       specifier: 0.13.1
       version: 0.13.1
-    '@tbox.cn/app-contracts-mall':
-      specifier: 0.13.1
-      version: 0.13.1
+    '@tbox.cn/app-sdk-client':
+      specifier: 0.21.3
+      version: 0.21.3
     '@tbox.cn/app-sdk-server':
       specifier: 0.26.0
       version: 0.26.0
@@ -48,9 +45,6 @@ catalogs:
     '@vitejs/plugin-react':
       specifier: 4.7.0
       version: 4.7.0
-    antd-mobile:
-      specifier: 5.42.3
-      version: 5.42.3
     eslint:
       specifier: 9.39.5
       version: 9.39.5
@@ -75,12 +69,6 @@ catalogs:
     react-dom:
       specifier: 18.3.1
       version: 18.3.1
-    react-markdown:
-      specifier: 9.1.0
-      version: 9.1.0
-    remark-gfm:
-      specifier: 4.0.1
-      version: 4.0.1
     tsup:
       specifier: 8.5.1
       version: 8.5.1
@@ -137,6 +125,9 @@ importers:
       '@app/contracts-mall':
         specifier: workspace:*
         version: link:../../packages/contracts-mall
+      '@app/module-ai-payment':
+        specifier: workspace:*
+        version: link:../../packages/module-ai-payment
       '@app/provider-custom':
         specifier: workspace:*
         version: link:../../packages/provider-custom
@@ -190,11 +181,32 @@ 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.26.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':
         specifier: workspace:*
         version: link:../../packages/contracts-mall
+      '@app/module-ai-payment':
+        specifier: workspace:*
+        version: link:../../packages/module-ai-payment
       '@app/provider-custom':
         specifier: workspace:*
         version: link:../../packages/provider-custom
@@ -242,7 +254,7 @@ importers:
   packages/agent-ui-kit:
     dependencies:
       '@phosphor-icons/react':
-        specifier: 'catalog:'
+        specifier: 2.1.10
         version: 2.1.10(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       '@tbox.cn/app-agent-sdk-client':
         specifier: 'catalog:'
@@ -251,64 +263,119 @@ importers:
         specifier: 'catalog:'
         version: 0.13.1
       antd-mobile:
-        specifier: 'catalog:'
+        specifier: 5.42.3
         version: 5.42.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       react-markdown:
-        specifier: 'catalog:'
+        specifier: 9.1.0
         version: 9.1.0(@types/react@18.3.31)(react@18.3.1)
       remark-gfm:
-        specifier: 'catalog:'
+        specifier: 4.0.1
         version: 4.0.1
       zustand:
-        specifier: 'catalog:'
+        specifier: 4.5.7
         version: 4.5.7(@types/react@18.3.31)(react@18.3.1)
     devDependencies:
       '@types/node':
-        specifier: 'catalog:'
+        specifier: 24.13.3
         version: 24.13.3
       '@types/react':
-        specifier: 'catalog:'
+        specifier: 18.3.31
         version: 18.3.31
       '@types/react-dom':
-        specifier: 'catalog:'
+        specifier: 18.3.7
         version: 18.3.7(@types/react@18.3.31)
       happy-dom:
-        specifier: 'catalog:'
+        specifier: 20.11.2
         version: 20.11.2
       less:
-        specifier: 'catalog:'
+        specifier: 4.8.1
         version: 4.8.1
       react:
-        specifier: 'catalog:'
+        specifier: 18.3.1
         version: 18.3.1
       react-dom:
-        specifier: 'catalog:'
+        specifier: 18.3.1
         version: 18.3.1(react@18.3.1)
       typescript:
-        specifier: 'catalog:'
+        specifier: 5.9.3
         version: 5.9.3
       vite:
-        specifier: 'catalog:'
+        specifier: 6.4.3
         version: 6.4.3(@types/node@24.13.3)(less@4.8.1)(tsx@4.23.11)
       vitest:
-        specifier: 'catalog:'
+        specifier: 4.1.10
         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))
 
   packages/contracts-mall:
     dependencies:
-      '@tbox.cn/app-contracts-mall':
+      '@tbox.cn/app-contracts':
+        specifier: 'catalog:'
+        version: 0.13.1
+      zod:
+        specifier: 3.25.76
+        version: 3.25.76
+    devDependencies:
+      happy-dom:
+        specifier: 20.11.2
+        version: 20.11.2
+      tsup:
+        specifier: 8.5.1
+        version: 8.5.1(postcss@8.5.26)(tsx@4.23.11)(typescript@5.9.3)
+      typescript:
+        specifier: 5.9.3
+        version: 5.9.3
+      vitest:
+        specifier: 4.1.10
+        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))
+
+  packages/module-ai-payment:
+    dependencies:
+      '@app/contracts-mall':
+        specifier: workspace:*
+        version: link:../contracts-mall
+      '@phosphor-icons/react':
+        specifier: 2.1.10
+        version: 2.1.10(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@tbox.cn/app-agent-sdk-client':
+        specifier: 'catalog:'
+        version: 0.2.0(@types/react@18.3.31)
+      '@tbox.cn/app-agent-sdk-server':
+        specifier: 'catalog:'
+        version: 0.3.0(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+      '@tbox.cn/app-contracts':
         specifier: 'catalog:'
         version: 0.13.1
+      react:
+        specifier: 18.3.1
+        version: 18.3.1
     devDependencies:
       '@types/node':
         specifier: 24.13.3
         version: 24.13.3
+      '@types/react':
+        specifier: 18.3.31
+        version: 18.3.31
+      '@types/react-dom':
+        specifier: 18.3.7
+        version: 18.3.7(@types/react@18.3.31)
+      happy-dom:
+        specifier: 20.11.2
+        version: 20.11.2
+      react-dom:
+        specifier: 18.3.1
+        version: 18.3.1(react@18.3.1)
+      tsup:
+        specifier: 8.5.1
+        version: 8.5.1(postcss@8.5.26)(tsx@4.23.11)(typescript@5.9.3)
       typescript:
         specifier: 5.9.3
         version: 5.9.3
       vitest:
         specifier: 4.1.10
         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))
+      zod:
+        specifier: 3.25.76
+        version: 3.25.76
 
   packages/provider-custom:
     dependencies:
@@ -1101,6 +1168,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'}
@@ -1343,10 +1419,6 @@ packages:
     resolution: {integrity: sha512-thnnPwA0Tkb3yf+HxmeIEDyji6myIJVKvyhzn0WWuVJN7mg9I6+juTimxwRNhqnpZBjue3kExMw75+MvTineYA==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-contracts-mall@0.13.1':
-    resolution: {integrity: sha512-xylb7J5KxH3rmK8bA1AAJ/Qinn0zGsqO3HjXY8R4CrazHV+F0R2YJvD4J2vd/tazOm9rKRqDxfhdW208QQioFg==}
-    engines: {node: '>=20.0.0'}
-
   '@tbox.cn/app-contracts@0.13.0':
     resolution: {integrity: sha512-8sqP/23MoUlbTX9enFNotP5bu7XKFfigDUJ6sEn1Ff2a0rRlSTWzLWmDv9lP70cfZMPjh4MHoLKFoukr8QPvMA==}
     engines: {node: '>=20.0.0'}
@@ -3911,6 +3983,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
@@ -4114,11 +4195,6 @@ snapshots:
       - utf-8-validate
       - workflow
 
-  '@tbox.cn/app-contracts-mall@0.13.1':
-    dependencies:
-      '@tbox.cn/app-contracts': 0.13.1
-      zod: 3.25.76
-
   '@tbox.cn/app-contracts@0.13.0':
     dependencies:
       '@ag-ui/core': 0.0.47

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