@tbox.cn/app-template-agent 0.10.2 → 0.10.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-template-agent",
-  "version": "0.10.2",
+  "version": "0.10.4",
   "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"

package/pnpm-lock.template.yaml

@@ -19,11 +19,11 @@ catalogs:
       specifier: 0.1.1
       version: 0.1.1
     '@tbox.cn/app-agent-sdk-server':
-      specifier: 0.1.1
-      version: 0.1.1
+      specifier: 0.1.2
+      version: 0.1.2
     '@tbox.cn/app-contracts':
-      specifier: 0.12.0
-      version: 0.12.0
+      specifier: 0.12.1
+      version: 0.12.1
     '@tbox.cn/app-contracts-mall':
       specifier: 0.12.1
       version: 0.12.1
@@ -31,8 +31,8 @@ catalogs:
       specifier: 0.21.0
       version: 0.21.0
     '@tbox.cn/app-theme-tbox':
-      specifier: 0.1.2
-      version: 0.1.2
+      specifier: 0.1.3
+      version: 0.1.3
     '@types/express':
       specifier: 4.17.25
       version: 4.17.25
@@ -145,10 +145,10 @@ importers:
         version: 0.1.1(@types/react@18.3.31)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.0
+        version: 0.12.1
       '@tbox.cn/app-theme-tbox':
         specifier: 'catalog:'
-        version: 0.1.2
+        version: 0.1.3
       react:
         specifier: 'catalog:'
         version: 18.3.1
@@ -206,10 +206,10 @@ importers:
         version: 0.1.0(@mastra/core@1.59.0(ai@6.0.246(zod@3.25.76))(express@4.22.2)(rxjs@7.8.1)(zod@3.25.76))(@tbox-dev-js/sdk@0.1.18)(zod@3.25.76)
       '@tbox.cn/app-agent-sdk-server':
         specifier: 'catalog:'
-        version: 0.1.1(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+        version: 0.1.2(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.0
+        version: 0.12.1
       express:
         specifier: 'catalog:'
         version: 4.22.2
@@ -249,7 +249,7 @@ importers:
         version: 0.1.1(@types/react@18.3.31)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.0
+        version: 0.12.1
       antd-mobile:
         specifier: 'catalog:'
         version: 5.42.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
@@ -317,10 +317,10 @@ importers:
         version: 0.1.1(@types/react@18.3.31)
       '@tbox.cn/app-agent-sdk-server':
         specifier: 'catalog:'
-        version: 0.1.1(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+        version: 0.1.2(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.0
+        version: 0.12.1
     devDependencies:
       '@types/node':
         specifier: 24.13.3
@@ -1339,8 +1339,8 @@ packages:
     resolution: {integrity: sha512-+HynOgllJS7dupTYTQ5R/5Ajpp5ErOVvGl/dz0wNBb/oZQxKgV0/ePQSxrlS1YnFXsiA9mzELdASz6CudOP/4A==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-agent-sdk-server@0.1.1':
-    resolution: {integrity: sha512-0KmAWR+wZODm5oRJ6IPgKfFFz49V8ACnetaFShgl5HI2HSianWWMECAWdyxdwp4hBOAMQU+IG6t2sz0gyE0UNQ==}
+  '@tbox.cn/app-agent-sdk-server@0.1.2':
+    resolution: {integrity: sha512-qS9RDPAGHiFB+FesBtgc2QLZnGNgXrG62fCyPQ663Cb9xfF0Fs0r+fTPXpG2ewsBkoST7c1oy/ZlfMO85o7/pw==}
     engines: {node: '>=20.0.0'}
 
   '@tbox.cn/app-contracts-mall@0.12.1':
@@ -1351,6 +1351,10 @@ packages:
     resolution: {integrity: sha512-GFthajvUSE7tY6Y5kLJgg2dRuZQdLfxq/WAEHOh+Q7RTwg7mpuLsWiNhXISkXMAtpxg0RkSgtwyRq33QS0ay3w==}
     engines: {node: '>=20.0.0'}
 
+  '@tbox.cn/app-contracts@0.12.1':
+    resolution: {integrity: sha512-h5HXIfk5frNx6hufY2IBE+hISCk3/2n8A7G3EtnAF4JsR91Pm/uwdmn4zYtZOz0r9cL7Wk1SrUMcokMZ9HkbLw==}
+    engines: {node: '>=20.0.0'}
+
   '@tbox.cn/app-sdk-client@0.21.1':
     resolution: {integrity: sha512-hN+tIj8kh11PD0HMhq5KUs/nZYjxS+ps3F3HTTmOHWXNXzilYafFxeIWJ1bXKVm1Di5EUIjNaRPUDkP6HAcHvw==}
     engines: {node: '>=20.0.0'}
@@ -1359,13 +1363,17 @@ packages:
     resolution: {integrity: sha512-hvdcXntg4iJniVu9LEwo5A/vov3L08kRlJLTgStYRdAlH9AJXWLDxFITMNf7YJX8W+j9wjJmmS7Sv88iswxM+w==}
     engines: {node: '>=20.0.0'}
 
+  '@tbox.cn/app-sdk-core@0.20.1':
+    resolution: {integrity: sha512-OSncc0sjhcuEQAlcANLCKNP0V+hgVhP0qol6pIyYSxSUUVLf69naiGWC4CBtY7PTIYlhximMw6bIn8tqNYKFXg==}
+    engines: {node: '>=20.0.0'}
+
   '@tbox.cn/app-sdk-server@0.21.0':
     resolution: {integrity: sha512-buiwhnT46Jb1P99UJN1p0ATjRzhFIXIgqIYQDT4aT3fVbmMxWUuAPpFYhM3uTFGx5oPh18/ju3MVz0FxZ5DMCg==}
     engines: {node: '>=20.0.0'}
     hasBin: true
 
-  '@tbox.cn/app-theme-tbox@0.1.2':
-    resolution: {integrity: sha512-/0x1XjcE1dDgQ4CTaqcXFZjWS47JQ2u7JS2jAbORTqrSmo7F0X/3m4LsH+WHAn+2r709KIRFh99NT3iMYqci2g==}
+  '@tbox.cn/app-theme-tbox@0.1.3':
+    resolution: {integrity: sha512-Wf2umpT/k+Ppy1oKuCDqe6M5yvp4F/tjdGpU7uygGWMaEduwFnoK0EVh4eDcA6dMlERLCAjxFlEUY68xXGq99A==}
 
   '@tbox.cn/app-toolkit@0.5.0':
     resolution: {integrity: sha512-ShLYwxsMzhr8V5sjixo4GFGBZbAw4/8CoTnCigrbBcRLtydf2ezLrLDR9jHfi/d5fQworFR5ZBzI7xDSjvR2zA==}
@@ -4081,7 +4089,7 @@ snapshots:
       - '@types/react'
       - immer
 
-  '@tbox.cn/app-agent-sdk-server@0.1.1(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)':
+  '@tbox.cn/app-agent-sdk-server@0.1.2(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)':
     dependencies:
       '@ag-ui/core': 0.0.47
       '@ai-sdk/openai-compatible': 2.0.68(zod@3.25.76)
@@ -4089,8 +4097,8 @@ snapshots:
       '@mastra/core': 1.59.0(ai@6.0.246(zod@3.25.76))(express@4.22.2)(rxjs@7.8.1)(zod@3.25.76)
       '@mastra/observability': 1.16.5(@mastra/core@1.59.0(ai@6.0.246(zod@3.25.76))(express@4.22.2)(rxjs@7.8.1)(zod@3.25.76))(zod@3.25.76)
       '@tbox.cn/agent-plugin': 0.1.0(@mastra/core@1.59.0(ai@6.0.246(zod@3.25.76))(express@4.22.2)(rxjs@7.8.1)(zod@3.25.76))(@tbox-dev-js/sdk@0.1.18)(zod@3.25.76)
-      '@tbox.cn/app-contracts': 0.12.0
-      '@tbox.cn/app-sdk-core': 0.20.0
+      '@tbox.cn/app-contracts': 0.12.1
+      '@tbox.cn/app-sdk-core': 0.20.1
       '@tbox.cn/app-sdk-server': 0.21.0
       ai: 6.0.246(zod@3.25.76)
       express: 4.22.2
@@ -4120,6 +4128,12 @@ snapshots:
       react: 18.3.1
       zod: 3.25.76
 
+  '@tbox.cn/app-contracts@0.12.1':
+    dependencies:
+      '@ag-ui/core': 0.0.47
+      react: 18.3.1
+      zod: 3.25.76
+
   '@tbox.cn/app-sdk-client@0.21.1':
     dependencies:
       '@tbox.cn/app-contracts': 0.12.0
@@ -4131,6 +4145,10 @@ snapshots:
     dependencies:
       '@tbox.cn/app-contracts': 0.12.0
 
+  '@tbox.cn/app-sdk-core@0.20.1':
+    dependencies:
+      '@tbox.cn/app-contracts': 0.12.1
+
   '@tbox.cn/app-sdk-server@0.21.0':
     dependencies:
       '@ag-ui/core': 0.0.47
@@ -4143,7 +4161,7 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  '@tbox.cn/app-theme-tbox@0.1.2': {}
+  '@tbox.cn/app-theme-tbox@0.1.3': {}
 
   '@tbox.cn/app-toolkit@0.5.0':
     dependencies:

package/pnpm-workspace.template.yaml

@@ -38,14 +38,14 @@ catalog:
   ws: 8.21.3
   "@types/ws": 8.18.1
   "@tbox.cn/agent-plugin": 0.1.0
-  "@tbox.cn/app-sdk-core": 0.20.0
+  "@tbox.cn/app-sdk-core": 0.20.1
   "@tbox.cn/app-sdk-client": 0.21.1
   "@tbox.cn/app-sdk-server": 0.21.0
-  "@tbox.cn/app-agent-sdk-server": 0.1.1
+  "@tbox.cn/app-agent-sdk-server": 0.1.2
   "@tbox.cn/app-agent-sdk-client": 0.1.1
-  "@tbox.cn/app-contracts": 0.12.0
+  "@tbox.cn/app-contracts": 0.12.1
   "@tbox.cn/app-contracts-mall": 0.12.1
-  "@tbox.cn/app-theme-tbox": 0.1.2
+  "@tbox.cn/app-theme-tbox": 0.1.3
   zustand: 4.5.7
   eslint: 9.39.5
   typescript-eslint: 8.67.0

package/profiles/mall/TEMPLATE.md

@@ -1,42 +1,27 @@
 # 商圈智能体应用 · 使用指南
 
-本应用已内置商圈智能体全套能力：商圈家页、商圈信息，以及导购、会员、停车、营销、碰一下活动、客服六大业务组件。
-开箱即为演示态——业务数据使用内置模拟数据，无需接入真实服务即可体验完整流程；正式上线按以下四步推进。
+本应用已支持客服问答、商圈基础、会员积分、停车缴费、智能导购等业务能力。当前使用演示数据，无需接入真实服务即可体验；正式使用时，可按以下步骤完成配置。
 
 ## 第一步 · 接入业务服务
 
-将各业务组件连接到商场的真实服务：通过自定义服务实现对完成对接与联调。
+在右侧「业务组件」Tab 中选择所需组件，提供对应业务的 API 接口文档，由 Agent 完成服务集成。
 
-| 业务组件 | 配置内容 |
+| 业务组件 | 需准备的接口文档 |
 |---|---|
-| 商圈信息 | 商场名称、地址与位置信息（可直填，或配置商圈信息获取接口） |
-| 会员积分 | 会员服务地址、应用凭证、入会落地页链接 |
-| 停车缴费 | 停车服务地址、应用凭证（含支付密钥）、车场标识 |
-| 智能导购 | 导购服务地址、应用凭证、商户图片资源域名 |
-| 营销优惠 | 营销服务地址、应用凭证、商场映射标识与领券方式 |
-| 支付宝碰一下 | 活动服务网关地址、活动方案标识 |
-| 客服问答 | 客服知识库来源（知识内容在第三步配置） |
-
-商圈家页无需单独接入，其数据聚合自以上组件，接入完成后自动生效。
+| 客服问答 | 客服知识库相关接口 |
+| 商圈基础 | 商场名称、地址及位置信息接口 |
+| 会员积分 | 会员信息、积分查询及入会接口 |
+| 停车缴费 | 车辆查询、停车计费及缴费接口 |
+| 智能导购 | 商户、品牌及门店查询接口 |
 
 ## 第二步 · 调试业务卡片
 
-在对话中逐组件试用，预览卡片返回结果，校验业务数据展示，并按需调整交互与样式（品牌视觉可随商场形象更换主题）。
-
-- 「帮我找商场里的美食」→ 导购检索与商户卡片
-- 「我的积分有多少」→ 会员积分卡片
-- 「停车费多少」→ 停车费用卡片
+在对话中逐项体验已接入的组件，检查业务数据和卡片展示效果，并按需调整交互与主题样式。
 
 ## 第三步 · 配置业务知识
 
-- **客服知识**：商场常见问题、服务政策、退换货与发票规则等
-- **业务规则与口吻**：智能体的服务范围、回答风格与兜底引导
-- **常用指令**：对话首页的快捷入口（如「今日优惠」「品牌导览」）
+在「知识库」中补充商场常见问题、服务政策等内容，并设置智能体的回答风格、服务范围和常用指令。
 
 ## 第四步 · 测试并部署
 
-- **多场景验证**：覆盖各业务组件的典型对话与操作链路，确认数据准确、卡片正常
-- **发布上线**：完成验证后部署发布；所需环境变量（模型服务等）可在平台页面配置
-- **小程序接入**：应用嵌入支付宝小程序，服务到店顾客
-
-完成以上四步后，应用即可稳定上线，为顾客提供导购、会员、停车与优惠等智能服务。
+测试典型对话和业务流程，确认数据与卡片展示正常后，即可部署发布并接入支付宝小程序。