@tbox.cn/app-template-agent 0.10.3 → 0.10.5

package/AGENTS.md

@@ -104,10 +104,84 @@ CLI 免安装，命令均经 `npx --yes @tbox.cn/app-cli <cmd>` 运行（下表
    （空装配 chat 形态无业务服务，不适用）。再向用户收集：API 地址、认证方式（密钥值经
    平台凭据引用，不进 prompt/代码/配置明文）、可选连接参数。用户已给出的不重复问。
    未实施前调用报 `PROVIDER_NOT_IMPLEMENTED` 属预期中间态。
+
+#### integrations.json 结构 schema 参考
+
+完整接口见 `packages/contracts/src/providers.ts`，下表是给落声明用的字段速查。
+
+**InlineVendorDeclaration**（providers.ts:140）——**仅 `services.<slot>.provider` 层合法**（`modules[].provider` 与 `integrations.provider` 只接受字符串厂商名）：
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `provider` | `string` | ✅ | 厂商名（自定语义化短标识，同一后端多服务共用） |
+| `credentialType` | `string` | ✅ | 认证类型：`'-'`=无凭据（仅 local 供给合法）/ SDK 内置 `static-headers-v1` / 自定如 `bearer-v1` |
+| `configSchema` | `string` | ❌ | schema 文件路径（相对应用 `config/`），**可选**，无强制 schema 格式 |
+
+**ConfiguredService**（providers.ts:176）——服务槽绑定：
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `provider` | `string \| InlineVendorDeclaration` | ❌ | 字符串厂商名 **或** 内联声明对象（唯一支持内联对象的层） |
+| `implementation` | `string` | ❌ | `id@version` 字面量；字符串厂商可派生可省，内联声明必须显式 |
+| `config` | `Record<string, unknown>` | ❌ | 服务级连接参数（明文，如 baseUrl/超时） |
+| `credentialRef` | `string` | ❌ | 凭据引用 `secret://<stem>` |
+| `instances` | `Record<instId, ServiceInstanceConfig>` | ❌ | 实例激活表；**省略=通配激活，`{}`=零激活（禁）** |
+
+**ModuleConfig**（providers.ts:192）——模块级（key = install id = `tbox.module.json` id）：
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `provider` | `string` | ❌ | **仅字符串厂商，不支持内联声明对象** |
+| `config` | `Record<string, unknown>` | ❌ | 模块级共享配置 |
+| `resources` | `Record<id, ResourceSpec>` | ❌ | 资源声明（知识库等，不算 binding 面） |
+
+**IntegrationsConfig**（providers.ts:239）——顶层，仅 `services` 必填：
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `services` | `Record<slot, ConfiguredService>` | ✅ | 服务槽绑定 |
+| `provider` | `string` | ❌ | 全局默认厂商（**仅字符串**） |
+| `config` | `Record<string, unknown>` | ❌ | 全局默认配置（明文） |
+| `configByInstance` | `Record<instId, Record>` | ❌ | 按实例的全局配置覆盖 |
+| `credentialRef` | `string` | ❌ | 全局凭据引用 |
+| `credentialRefByInstance` | `Record<instId, string>` | ❌ | 实例级凭据（商户级主写位） |
+| `instances` | `DeploymentInstance[]` | ❌ | 部署实例注册表（参考表） |
+| `defaultInstanceId` | `string \| null` | ❌ | 默认实例 id（单实例免填） |
+| `modules` | `Record<install-id, ModuleConfig>` | ❌ | 模块集成位 |
+
+#### 级联优先级链（resolveEffectiveService，providers.ts:336）
+
+**provider 头 4 层**（最特异优先）：
+```
+services[slot].instances[instId].provider → services[slot].provider → modules[owner].provider → integrations.provider
+```
+
+**config 5 层浅合并**（后者覆盖前者同字段）：
+```
+integrations.config → integrations.configByInstance[instId] → modules[owner].config → services[slot].config → services[slot].instances[instId].config
+```
+
+**credentialRef 4 层链**：
+```
+services[slot].instances[instId].credentialRef → services[slot].credentialRef → integrations.credentialRefByInstance[instId] → integrations.credentialRef
+```
+
+**implementation 派生**：显式 `slot.implementation` / `inst.implementation` 优先；字符串厂商缺省则按 `supplies[provider\u0000service]` 查表派生（unique→自动取一 / 0→`PROVIDER_NOT_SUPPLIED` / 多→要求显式）；内联声明必须显式（zod 已拦）。
+
+> 内联声明对象只在 `services[slot].provider` 层合法。`modules[].provider` 与 `integrations.provider` 只接受字符串厂商名——这是 zod 直接拒导致 fail-visible 的常见错点。
+
+#### provider 名三处一致
+
+取的 provider 名必须下三处同名（任何一处失配则 `PROVIDER_NOT_IMPLEMENTED`）：
+
+1. `config/integrations.json` 中 `services.<slot>.provider.provider`（内联对象里的 `provider` 字段）
+2. `packages/provider-custom/src/server/index.ts` 里 `ctx.integrations?.registerAdapter('<同名>', 'inline', factory)` 第一参
+3. `config/credentials/${provider名}-${service}.json`（如 `my-parking-api-parking.query.json`）的 stem 前缀
+
 2. **落声明**：目标槽已有内联声明则跳过；否则直接编辑 `config/integrations.json`
    （CLI provider 命令仅支持字符串厂商）按下表范围写入槽级声明（`{ provider,
    credentialType, configSchema? }` + implementation 字面量，仅槽级合法；provider 名自定
-   语义化短标识，同一后端的多服务共用同一 provider 名——单键注册，见
+   语义化短标识，同一后端的多服务共用同一 provider 名——单键注册，三处一致见上文，见
    `packages/provider-custom/AGENTS.md`；凭据接线见同文件）：
 
    | 维度 | 声明范围 | 共享连接参数落点 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-template-agent",
-  "version": "0.10.3",
+  "version": "0.10.5",
   "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"
@@ -36,7 +36,7 @@
     "typescript-eslint": "8.67.0",
     "eslint-plugin-react-hooks": "5.2.0",
     "vite": "6.4.3",
-    "@tbox.cn/app-sdk-server": "0.21.0"
+    "@tbox.cn/app-sdk-server": "0.21.1"
   },
   "license": "MIT",
   "publishConfig": {

package/packages/provider-custom/AGENTS.md

@@ -26,6 +26,22 @@
 用不同 provider 名分键。adapter 内取凭据值（如自签名）：`input.credential()` 惰性 getter
 （返回 `{ scope, type, value }`；未配 credentialRef → undefined）。
 
+## provider 名三处一致
+
+取的 provider 名必须下三处同名（任一处失配则运行时报 `PROVIDER_NOT_IMPLEMENTED`——
+resolveService 惰性查表查不到对应 adapter）：
+
+1. **声明侧**：`config/integrations.json` 中 `services.<slot>.provider.provider` 字段
+   （内联声明对象内的 `provider` 键；若声明是字符串厂商则该键名直接是名字）
+2. **注册侧**：`packages/provider-custom/src/server/index.ts` 中
+   `ctx.integrations?.registerAdapter('<同名>', 'inline', factory)` 第一参
+3. **凭据侧**：`config/credentials/${provider名}-${service}.json` 的 stem 前缀
+   （服务级）；共享 stem = `${provider名}-global`；实例差异化另见
+   `${provider名}-${instanceId}-${domain}` 形（凭据文件嵌套形格式见下节）
+
+> 多服务单键只是注册侧共享，三处同名规则不放宽——同一 provider 名的全部服务 stem 仍各自
+> 含 `-<service>` 段；只有注册键（registerAdapter 第一参）一次（"单键"）。
+
 ## 认证与凭据
 
 | 认证形态 | credentialType（声明与凭据文件一致） | 机制 |
@@ -45,6 +61,31 @@
 - 槽 `instances` 省略 = 通配激活（**勿写空对象 `{}`** = 零激活）；已绑字符串厂商的槽整组
   替换前先向用户确认。
 
+### config 与 configSchema 的区别
+
+| 字段 | 落点 | 类型 | 内容形态 |
+|---|---|---|---|
+| `services[slot].config` / `modules[].config` / root `config` / `instances[].config` 等所有 `config*` 字段 | `config/integrations.json` | `Record<string, unknown>` 真实值 | **明文连接参数**——baseUrl / 路径前缀 / 超时 / 重试等。直接进 integrations.json（可见、非密钥） |
+| `services[slot].provider.configSchema`（内联声明中的可选字段） | `integrations.json` 写路径字符串，文件本体在 `config/<路径>.json` | `string` 路径 + 开发者自写文件 | **可选 schema 制品**——相对应用 `config/` 的路径；当前无强制 schema 格式；写则 doctor 谓词可消费校验，不写则不校验 |
+
+**`config` 不替代凭据**：嵌在 `config.*` 字段里的值是"可见的连接配置"，不是"凭据真值"。任何形式
+的密钥（API key / token / 签名 secret / OAuth secret）经 `credentialRef: "secret://<stem>"`
+引用，真值只进 `config/credentials/<stem>.json`（嵌套形）或平台 env——**禁**直接进 `config.*`
+字段明文，也禁进 prompt、代码、入库文档。
+
+**`configSchema` 不强制**：framework 不要求每条内联声明都配 schema 文件，schema 形态由开发者自选
+（推荐自身可读、可校验的 JSON schema 或自定义格式）。doctor 谓词对存在 `configSchema` 的声明做受
+控子集校验；不存在则跳过。AI 接自定义集成任务不要因为没 schema 而拒绝落声明。
+
+### 配置值与凭据真值的可见性边界
+
+| 数据 | 落点 | 是否进 prompt / 代码 / 入库文档 |
+|---|---|---|
+| `*.config` 字段（baseUrl / 超时 / 路径前缀等连接参数） | `config/integrations.json` 明文 | ⚠ 可见（明文即设计意图），但不应成"密钥代用品" |
+| 凭据真值（API key / token / 签名 secret / OAuth secret 等） | `config/credentials/<stem>.json` 嵌套形 或 平台 env | ❌ 禁入 prompt / 代码 / integrations.json / 入库文档 |
+| `credentialRef: "secret://<stem>"` 引用本身 | `config/integrations.json` 明文 | ✅ 可见（非真值，仅 stem 引用） |
+| AGENTS.md / 模板出厂文档 | 仓库 | ❌ 不含 `secret://` 真值（仅描述引用形态） |
+
 ## 完成判据
 
 - `pnpm typecheck && pnpm build` 通过；

package/pnpm-lock.template.yaml

@@ -16,20 +16,20 @@ catalogs:
       specifier: 0.1.0
       version: 0.1.0
     '@tbox.cn/app-agent-sdk-client':
-      specifier: 0.1.1
-      version: 0.1.1
+      specifier: 0.1.2
+      version: 0.1.2
     '@tbox.cn/app-agent-sdk-server':
       specifier: 0.1.2
       version: 0.1.2
     '@tbox.cn/app-contracts':
-      specifier: 0.12.1
-      version: 0.12.1
+      specifier: 0.12.2
+      version: 0.12.2
     '@tbox.cn/app-contracts-mall':
-      specifier: 0.12.1
-      version: 0.12.1
+      specifier: 0.12.2
+      version: 0.12.2
     '@tbox.cn/app-sdk-server':
-      specifier: 0.21.0
-      version: 0.21.0
+      specifier: 0.21.1
+      version: 0.21.1
     '@tbox.cn/app-theme-tbox':
       specifier: 0.1.3
       version: 0.1.3
@@ -115,7 +115,7 @@ importers:
     devDependencies:
       '@tbox.cn/app-sdk-server':
         specifier: 'catalog:'
-        version: 0.21.0
+        version: 0.21.1
       eslint:
         specifier: 'catalog:'
         version: 9.39.5
@@ -142,10 +142,10 @@ importers:
         version: link:../../packages/provider-custom
       '@tbox.cn/app-agent-sdk-client':
         specifier: 'catalog:'
-        version: 0.1.1(@types/react@18.3.31)
+        version: 0.1.2(@types/react@18.3.31)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.1
+        version: 0.12.2
       '@tbox.cn/app-theme-tbox':
         specifier: 'catalog:'
         version: 0.1.3
@@ -209,7 +209,7 @@ importers:
         version: 0.1.2(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.1
+        version: 0.12.2
       express:
         specifier: 'catalog:'
         version: 4.22.2
@@ -246,10 +246,10 @@ importers:
         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.1.1(@types/react@18.3.31)
+        version: 0.1.2(@types/react@18.3.31)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.1
+        version: 0.12.2
       antd-mobile:
         specifier: 'catalog:'
         version: 5.42.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
@@ -298,7 +298,7 @@ importers:
     dependencies:
       '@tbox.cn/app-contracts-mall':
         specifier: 'catalog:'
-        version: 0.12.1
+        version: 0.12.2
     devDependencies:
       '@types/node':
         specifier: 24.13.3
@@ -314,13 +314,13 @@ importers:
     dependencies:
       '@tbox.cn/app-agent-sdk-client':
         specifier: 'catalog:'
-        version: 0.1.1(@types/react@18.3.31)
+        version: 0.1.2(@types/react@18.3.31)
       '@tbox.cn/app-agent-sdk-server':
         specifier: 'catalog:'
         version: 0.1.2(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.1
+        version: 0.12.2
     devDependencies:
       '@types/node':
         specifier: 24.13.3
@@ -1335,16 +1335,16 @@ packages:
       '@tbox-dev-js/sdk': '>=0.1.18 <0.2.0'
       zod: '>=3.24.0 <4.0.0'
 
-  '@tbox.cn/app-agent-sdk-client@0.1.1':
-    resolution: {integrity: sha512-+HynOgllJS7dupTYTQ5R/5Ajpp5ErOVvGl/dz0wNBb/oZQxKgV0/ePQSxrlS1YnFXsiA9mzELdASz6CudOP/4A==}
+  '@tbox.cn/app-agent-sdk-client@0.1.2':
+    resolution: {integrity: sha512-Ba5n4PUCWsj8+jByOYGGAXS5lzEioBYmaMxvLL0Axvc3Id9gVYF31Jj5H4U+bVzO4Jtbb7huqG9sf3qX69lffw==}
     engines: {node: '>=20.0.0'}
 
   '@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':
-    resolution: {integrity: sha512-5A85jjdsvxDTAHWwGGruVTkd/106p1soo1mIWFSarXNkZi97dVmJjYxDaHb8v1yBdLXWZ1kb2yp9/oA2qZy/uQ==}
+  '@tbox.cn/app-contracts-mall@0.12.2':
+    resolution: {integrity: sha512-/vBCWpvFsCagnUSHbogHFFrnCURic9QUZ//AURasTzZoSv5u5/OetHAQ8JON1ukJ8ItLzfhjRJ1IBvFNMA3xhg==}
     engines: {node: '>=20.0.0'}
 
   '@tbox.cn/app-contracts@0.12.0':
@@ -1355,6 +1355,10 @@ packages:
     resolution: {integrity: sha512-h5HXIfk5frNx6hufY2IBE+hISCk3/2n8A7G3EtnAF4JsR91Pm/uwdmn4zYtZOz0r9cL7Wk1SrUMcokMZ9HkbLw==}
     engines: {node: '>=20.0.0'}
 
+  '@tbox.cn/app-contracts@0.12.2':
+    resolution: {integrity: sha512-SnteKq3+kQjwDHb4BN2HX2Eawd7ws84IxPkJziaeKaDGBfJ1RzPRUAQyL/Zo4kJLCzsY3ViE2AEh1SG10r4MXw==}
+    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'}
@@ -1372,6 +1376,11 @@ packages:
     engines: {node: '>=20.0.0'}
     hasBin: true
 
+  '@tbox.cn/app-sdk-server@0.21.1':
+    resolution: {integrity: sha512-LCB9gH6n5ILdLDHQUAq1NLrclLjmB0dsqGVHe4Zb4yucUPb16jxk/53NREYq0NzsHiTDxc29IvcreVaxRpVmXw==}
+    engines: {node: '>=20.0.0'}
+    hasBin: true
+
   '@tbox.cn/app-theme-tbox@0.1.3':
     resolution: {integrity: sha512-Wf2umpT/k+Ppy1oKuCDqe6M5yvp4F/tjdGpU7uygGWMaEduwFnoK0EVh4eDcA6dMlERLCAjxFlEUY68xXGq99A==}
 
@@ -1379,6 +1388,10 @@ packages:
     resolution: {integrity: sha512-ShLYwxsMzhr8V5sjixo4GFGBZbAw4/8CoTnCigrbBcRLtydf2ezLrLDR9jHfi/d5fQworFR5ZBzI7xDSjvR2zA==}
     engines: {node: '>=20.0.0'}
 
+  '@tbox.cn/app-toolkit@0.7.2':
+    resolution: {integrity: sha512-bvq5l7rwwX3EJe0hQm4dnwSh0tuDmoucCkCfX306PvNbhSv0H9uHSljg/jeXh08DBtc2gjIJyvPsfDxrv5X6Uw==}
+    engines: {node: '>=20.0.0'}
+
   '@types/babel__core@7.20.5':
     resolution: {integrity: sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==}
 
@@ -4077,11 +4090,11 @@ snapshots:
       '@tbox-dev-js/sdk': 0.1.18
       zod: 3.25.76
 
-  '@tbox.cn/app-agent-sdk-client@0.1.1(@types/react@18.3.31)':
+  '@tbox.cn/app-agent-sdk-client@0.1.2(@types/react@18.3.31)':
     dependencies:
-      '@tbox.cn/app-contracts': 0.12.0
+      '@tbox.cn/app-contracts': 0.12.1
       '@tbox.cn/app-sdk-client': 0.21.1
-      '@tbox.cn/app-sdk-core': 0.20.0
+      '@tbox.cn/app-sdk-core': 0.20.1
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
       zustand: 4.5.7(@types/react@18.3.31)(react@18.3.1)
@@ -4117,9 +4130,9 @@ snapshots:
       - utf-8-validate
       - workflow
 
-  '@tbox.cn/app-contracts-mall@0.12.1':
+  '@tbox.cn/app-contracts-mall@0.12.2':
     dependencies:
-      '@tbox.cn/app-contracts': 0.12.0
+      '@tbox.cn/app-contracts': 0.12.1
       zod: 3.25.76
 
   '@tbox.cn/app-contracts@0.12.0':
@@ -4134,6 +4147,12 @@ snapshots:
       react: 18.3.1
       zod: 3.25.76
 
+  '@tbox.cn/app-contracts@0.12.2':
+    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
@@ -4161,6 +4180,18 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  '@tbox.cn/app-sdk-server@0.21.1':
+    dependencies:
+      '@ag-ui/core': 0.0.47
+      '@tbox.cn/app-contracts': 0.12.1
+      '@tbox.cn/app-sdk-core': 0.20.1
+      '@tbox.cn/app-toolkit': 0.7.2
+      express: 4.22.2
+      jose: 6.2.8
+      zod: 3.25.76
+    transitivePeerDependencies:
+      - supports-color
+
   '@tbox.cn/app-theme-tbox@0.1.3': {}
 
   '@tbox.cn/app-toolkit@0.5.0':
@@ -4168,6 +4199,11 @@ snapshots:
       ajv: 8.20.0
       zod: 3.25.76
 
+  '@tbox.cn/app-toolkit@0.7.2':
+    dependencies:
+      ajv: 8.20.0
+      zod: 3.25.76
+
   '@types/babel__core@7.20.5':
     dependencies:
       '@babel/parser': 7.29.8

package/pnpm-workspace.template.yaml

@@ -40,11 +40,11 @@ catalog:
   "@tbox.cn/agent-plugin": 0.1.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-sdk-server": 0.21.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.1
-  "@tbox.cn/app-contracts-mall": 0.12.1
+  "@tbox.cn/app-agent-sdk-client": 0.1.2
+  "@tbox.cn/app-contracts": 0.12.2
+  "@tbox.cn/app-contracts-mall": 0.12.2
   "@tbox.cn/app-theme-tbox": 0.1.3
   zustand: 4.5.7
   eslint: 9.39.5

package/profiles/mall/TEMPLATE.md

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