@tbox.cn/app-template-agent 0.7.5 → 0.9.0

package/profiles/mall/config/agent.jsonc

@@ -0,0 +1,33 @@
+// agent 提示词配置：instructions = 业务段（置前于 SDK 平台规则段）；首行身份句，数组 = 提示词行（\n 拼接）。
+// 分层契约：平台规则段管卡片机制协议；本文件管跨域基线（数据新鲜度/注入块定性/操作入口/沟通风格/兜底承接）；
+// 域内细则归各域 SKILL.md（经领域指引块注入，域内细则优先于本段基线）。
+// memoryInstructions：装配长期记忆时由 SDK 追加（未装配不拼接）。
+// 注意：不写与平台卡片协议冲突的指令——出不出卡由模型经 <agent-ui-cards> 标签决策，平台协议优先。
+{
+  "instructions": [
+    "你是商圈智能助理——用户逛商场时的商圈搭子，服务到店顾客，帮助其高效完成会员、停车、优惠与导购相关事务。",
+    "# 服务范围",
+    "会员（积分/会员卡/入会）、停车（费用/缴费/寻车）、优惠营销（活动/领券/我的券）、导购（商户/门店/商品）、客服（服务政策/退换货/发票/投诉/营业时间等基础信息）。",
+    "# 业务规则",
+    "业务数据（价格、库存、活动、积分、费用、状态）随时可能变化，以本轮工具结果为准：凡涉及业务数据的问题（查询或操作），必须先调用工具取得本轮结果再作答，禁止凭历史工具结果或常识直接回答。",
+    "用户一次提问涉及多个业务域时（如「推荐鞋店 + 积分怎么算」），对每个域分别调用对应工具——即使本轮只注入了其中一个域的操作指引，其余域也必须调工具拿本轮结果，不凭历史轮结论作答。",
+    "操作类（缴费、领券、绑定车牌、入会等）都由对应卡片上的按钮完成——需要用户动手时，先拿到本轮结果再引导操作。",
+    "智能体自身没有导航能力：回复正文不提及、不承诺导航（「带您过去」「发您路线」等），也不反问「要不要导航过去」——导航入口只存在于卡片上的导航按钮，由用户自行点击；正文最多客观告知门店位置（楼层/铺位）。",
+    "user 消息前部可能收到系统注入的 <system-reminder> 数据块（非用户输入；类型与语义以平台协议为准）：内部注入，不向用户复述其来源与分类。",
+    "pre-tool 块是系统预执行的域数据（商场楼层/类目、客服 FAQ 条目、碰一碰活动详情等）：其中 FAQ 条目属政策知识；实时列表/数字类问题（可领券、积分余额、停车费）仍须调用对应域实时工具。",
+    "领域指引块是当前业务域的操作规程：命中当前请求所属领域时遵循其场景细则与红线，域内细则与本段不一致时以指引块为准。",
+    "支付与授权类操作严格走系统引导流程，不承诺未经系统确认的结果。",
+    "# 沟通风格",
+    "语言跟随用户：用户用中文提问就用中文回答，用英文提问就用英文回答；禁止在中文对话中夹杂英文句子（专有名词除外）。",
+    "语气亲切、简洁，先给结果再给动作；回复正文按轻量 markdown 输出（渲染支持换行、加粗、列表）。",
+    "正文保持分段可扫读：多项并列各占一行、组间空一行；长回复按「结论 / 明细 / 收尾」分 2-3 段，不整段堆叠。",
+    "重点才加粗（关键数字、门槛、时效，一条回复 3 处以内）；不使用标题、表格、代码块、颜色样式——气泡窄屏显示不开。",
+    "即将调用工具时，先用一句贴合本轮诉求的话承接再发起（多诉求时一句覆盖全部），让用户立即看到回应；承接句换着说法勿模板化，只说要做什么、不预告结果。",
+    "任何回复正文不出现工具名、接口名、字段名（如 listVehicles、customer-service-faq 这类内部词汇），也不出现\"知识库\"\"FAQ\"\"检索\"这类机制词——用户只看得到白话与结果，需要提及操作时用业务语言（如「帮您查停车费」）。",
+    "# 兜底承接",
+    "超出服务范围或查不到时如实说明，并按最近承接路径引导：服务政策与商场基础信息（营业时间等）转客服 FAQ，FAQ 无结果时如实说明暂无收录并引导联系人工客服；近似导购的诉求转找店逛店；仍解决不了转人工客服。"
+  ],
+  "memoryInstructions": [
+    "长期记忆：用户透露的稳定偏好（口味/忌口）、常逛商场与常用服务、车牌等事实值得记住——跨会话服务更贴心；闲聊与一次性信息不记，记忆与当下需求冲突时以当下为准。"
+  ]
+}

package/profiles/mall/config/chat.json

@@ -0,0 +1,21 @@
+{
+  "enableImageUpload": false,
+  "enableVideoUpload": false,
+  "enableTTS": false,
+  "enableVoiceInput": true,
+  "defaultInputMode": "TEXT",
+  "quickCommands": [
+    {
+      "label": "今日优惠",
+      "query": "现在有什么优惠？"
+    },
+    {
+      "label": "品牌导览",
+      "query": "品牌导览"
+    },
+    {
+      "label": "活动中心",
+      "query": "活动中心"
+    }
+  ]
+}

package/profiles/mall/config/knowledge.json

@@ -0,0 +1,5 @@
+{
+  "version": "1.0",
+  "description": "知识库注册表占位（模板态：模块资源保持 datasetId 直填；真实档经 create --config-dir 注入带条目的注册表并切换 ref 引用）",
+  "knowledge_bases": {}
+}

package/profiles/mall/config/llm_provider.json

@@ -0,0 +1,5 @@
+{
+  "modelName": "glm-5.1",
+  "thinking": false,
+  "parallelToolCalls": true
+}

package/profiles/mall/config/plugins.json

@@ -0,0 +1,3 @@
+{
+  "plugins": []
+}

package/profiles/mall.json

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

package/scripts/check-workspace.mjs

@@ -100,9 +100,10 @@ function printFailure(findings) {
   process.exitCode = 1;
 }
 
-/** 豁免：SDK/契约包无 tbox.module.json（002 §2.3 / 003 §4.1） */
+/** 豁免：SDK/契约/UI-Kit 包无 tbox.module.json（002 §2.3 / 003 §4.1；kit 为壳 UI 源码包，
+ *  单一模板统一化 W2-5——无模块贡献面，非业务模块） */
 function isExemptPackage(dirName) {
-  return dirName === 'app-sdk' || dirName === 'shared' || dirName.startsWith('contracts');
+  return dirName === 'app-sdk' || dirName === 'shared' || dirName.startsWith('contracts') || dirName === 'agent-ui-kit';
 }
 
 /** 校验 packages/* 每个业务包必须有 tbox.module.json（002 §2.3 / 003 §4.1） */

package/apps/client/src/cards/CardRenderer.tsx

@@ -1,20 +0,0 @@
-/**
- * 卡片渲染入口 — 注入本地 registry 后委托 SDK 的 CardRenderer。
- * 011 B3：动作按钮 → sendUiAction（token 来自 payload.actionTokens）。
- * P1：onAction 升级为完整 UiAction（CardRenderer 按 kind 分发后回传，桥一行透传）。
- */
-import { CardRenderer as SdkCardRenderer } from '@tbox.cn/app-sdk/client';
-import type { TboxCardPayload, UiAction } from '@tbox.cn/app-contracts';
-import { CARD_REGISTRY } from './registry';
-import { useChatStore } from '@/store/chat';
-
-export function CardRenderer({ card }: { card: TboxCardPayload }) {
-  const sendUiAction = useChatStore((s) => s.sendUiAction);
-  return (
-    <SdkCardRenderer
-      card={card}
-      registry={CARD_REGISTRY}
-      onAction={(action: UiAction) => sendUiAction(card.id, action)}
-    />
-  );
-}

package/apps/client/src/components/ChatHeader/index.less

@@ -1,104 +0,0 @@
-/* 顶部居中浮动控件：毛玻璃按钮组 + 下方小手柄；折叠时只剩手柄。对齐原模板。 */
-.chat-header {
-  position: absolute;
-  top: 4px;
-  left: 0;
-  right: 0;
-  z-index: 100;
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  padding: 4px 16px 0;
-  pointer-events: none;
-
-  &__group {
-    pointer-events: auto;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    gap: 8px;
-    margin-bottom: 8px;
-    padding: 12px 16px;
-    background: rgba(255, 255, 255, 0.4);
-    backdrop-filter: blur(10px);
-    border-radius: 31px;
-    max-height: 100px;
-    overflow: hidden;
-    opacity: 1;
-    transform: translateY(0) scale(1);
-    transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
-
-    &--collapsed {
-      opacity: 0;
-      transform: translateY(-20px) scale(0.95);
-      max-height: 0;
-      margin-bottom: 0;
-      padding-top: 0;
-      padding-bottom: 0;
-      pointer-events: none;
-    }
-  }
-
-  &__btn {
-    display: flex;
-    align-items: center;
-    gap: 8px;
-    appearance: none;
-    border: none;
-    padding: 12px 24px;
-    background: #fff;
-    border-radius: 92px;
-    box-shadow: 0 1px 4px rgba(0, 0, 0, 0.08);
-    transition: all 0.2s ease;
-
-    &:active {
-      transform: scale(0.98);
-      background: #f5f5f5;
-    }
-  }
-
-  &__btn-icon {
-    width: 32px;
-    height: 32px;
-    flex-shrink: 0;
-  }
-
-  &__btn-text {
-    font-size: 24px;
-    color: #4b6282;
-    font-weight: 500;
-    white-space: nowrap;
-    line-height: 1;
-  }
-
-  &__toggle {
-    pointer-events: auto;
-    appearance: none;
-    border: none;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    width: 110px;
-    height: 30px;
-    background: rgba(255, 255, 255, 0.8);
-    border-radius: 14px;
-    box-shadow: 0 1px 4px rgba(0, 0, 0, 0.08);
-    transition: all 0.2s ease;
-
-    &:active {
-      transform: scale(0.98);
-      background: #f5f5f5;
-    }
-  }
-
-  &__arrow {
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    transition: transform 0.3s cubic-bezier(0.4, 0, 0.2, 1);
-
-    &--up {
-      transform: rotate(180deg);
-    }
-  }
-}

package/apps/client/src/components/ErrorBoundary.tsx

@@ -1,2 +0,0 @@
-// Re-export from app-sdk
-export { ErrorBoundary } from '@tbox.cn/app-sdk/client';

package/apps/client/src/components/QuickCommands/index.less

@@ -1,48 +0,0 @@
-.quick-commands {
-  position: relative;
-  z-index: 1;
-  width: 100%;
-  max-width: var(--tbox-content-max-width);
-  margin: 0 auto;
-  box-sizing: border-box;
-  display: flex;
-  gap: 16px;
-  overflow-x: auto;
-  padding: 0 24px 12px;
-  -ms-overflow-style: none;
-  scrollbar-width: none;
-
-  &::-webkit-scrollbar {
-    display: none;
-  }
-
-  &__item {
-    flex-shrink: 0;
-    display: inline-flex;
-    align-items: center;
-    gap: 8px;
-    height: 61px;
-    padding: 0 24px 0 16px;
-    appearance: none;
-    border: none;
-    background: #fff;
-    border-radius: 31px;
-    box-shadow: 0 2px 12px rgba(110, 139, 180, 0.12);
-  }
-
-  &__icon {
-    width: 32px;
-    height: 32px;
-    object-fit: contain;
-  }
-
-  &__icon-svg {
-    color: var(--tbox-primary);
-  }
-
-  &__label {
-    font-size: 26px;
-    color: rgba(31, 59, 99, 0.85);
-    white-space: nowrap;
-  }
-}

package/apps/client/src/components/QuickCommands/index.tsx

@@ -1,29 +0,0 @@
-// ⚠️ 平台标准组件：输入框上方的「快捷指令」。视觉还原时不改本组件、不另画。
-// 改内容只改 client/config/chat.json 的 quickCommands 数组（{ label, query, icon? }）。
-// 011 I2：服务端 HelloAck.chatConfig.quickCommands 优先（单一真源），本地 chat.json 为 fallback。
-// label 只写纯文字；前面的星标由本组件渲染（icon 字段或默认 ✦），不要把 ✦/emoji 写进 label。
-import { useChatConfigStore } from '@/store/chat-config';
-import { useChatStore } from '@/store/chat';
-import starIcon from '../../../assets/quick-command-star.svg';
-import './index.less';
-
-export function QuickCommands({ onCommand }: { onCommand: (query: string) => void }) {
-  const staticCommands = useChatConfigStore((s) => s.quickCommands);
-  const serverCommands = useChatStore((s) => s.helloAck?.chatConfig.quickCommands);
-  // 服务端下发优先；未收到 HELLO_ACK（非 mall 部署）回落本地静态
-  const commands = (serverCommands && serverCommands.length > 0
-    ? serverCommands.map((c) => ({ label: c.label, query: c.prompt }))
-    : staticCommands) as { label: string; query: string }[];
-  if (!commands.length) return null;
-
-  return (
-    <div className="quick-commands">
-      {commands.map((cmd) => (
-        <button key={cmd.label} className="quick-commands__item" onClick={() => onCommand(cmd.query)}>
-          <img className="quick-commands__icon" src={starIcon} alt="" />
-          <span className="quick-commands__label">{cmd.label}</span>
-        </button>
-      ))}
-    </div>
-  );
-}

package/apps/client/src/components/ToolCallBlock/index.less

@@ -1,131 +0,0 @@
-.tool-calls {
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-  margin: 0 0 12px;
-}
-
-.tool-call {
-  border-radius: 12px;
-  overflow: hidden;
-
-  &--calling {
-    background: rgba(16, 163, 127, 0.08);
-  }
-  &--done {
-    background: rgba(0, 0, 0, 0.03);
-  }
-  &--error {
-    background: rgba(239, 68, 68, 0.08);
-  }
-
-  &__header {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    padding: 12px 16px;
-  }
-
-  &__left {
-    display: flex;
-    align-items: center;
-    gap: 8px;
-    min-width: 0;
-  }
-
-  &__spinner {
-    width: 14px;
-    height: 14px;
-    border: 2px solid rgba(16, 163, 127, 0.3);
-    border-top-color: #10a37f;
-    border-radius: 50%;
-    flex-shrink: 0;
-    animation: tool-spin 0.8s linear infinite;
-  }
-
-  // 010：前置工具「自动」徽标（与模型主动调用区分）
-  &__badge {
-    font-size: 18px;
-    line-height: 1;
-    padding: 3px 8px;
-    border-radius: 8px;
-    background: rgba(93, 126, 198, 0.12);
-    color: #5f7ec6;
-    flex-shrink: 0;
-  }
-
-  &__name {
-    font-size: 22px;
-    line-height: 1.4;
-    color: #4a5568;
-    font-weight: 500;
-    overflow: hidden;
-    text-overflow: ellipsis;
-    white-space: nowrap;
-  }
-  &--calling &__name {
-    color: #10a37f;
-  }
-  &--error &__name {
-    color: #ef4444;
-  }
-
-  &__toggle {
-    font-size: 20px;
-    color: #8b95b0;
-    flex-shrink: 0;
-    margin-left: 8px;
-  }
-
-  &__result {
-    padding: 0 16px 12px;
-  }
-
-  &__result-text {
-    font-size: 20px;
-    color: #6b7a99;
-    line-height: 1.6;
-    font-family: Menlo, Monaco, Consolas, monospace;
-    white-space: pre-wrap;
-    word-break: break-all;
-
-    &--error {
-      color: #dc2626;
-    }
-  }
-
-  // 018 dev 视图输入/输出双栏（紧凑单行 + 头尾保留）
-  &__io {
-    display: flex;
-    flex-direction: column;
-    gap: 4px;
-
-    & + & {
-      margin-top: 12px;
-    }
-  }
-
-  &__io-label {
-    font-size: 18px;
-    color: #8a97ad;
-  }
-
-  &__io-text {
-    font-size: 20px;
-    color: #6b7a99;
-    line-height: 1.6;
-    font-family: Menlo, Monaco, Consolas, monospace;
-    white-space: pre-wrap;
-    word-break: break-all;
-
-    &--error {
-      color: #dc2626;
-    }
-  }
-}
-
-@keyframes tool-spin {
-  to {
-    transform: rotate(360deg);
-  }
-}

package/apps/client/src/components/ToolCallBlock/index.tsx

@@ -1,125 +0,0 @@
-import { useState } from 'react';
-import { Check, X } from '@phosphor-icons/react';
-import { parseMemoryToolCallArgs, parsePreToolToolCallArgs } from '@tbox.cn/app-contracts';
-import type { ToolCallInfo } from '@/types/chat';
-import { describeToolCall, formatCompactToolIo } from '@tbox.cn/app-sdk/client';
-import './index.less';
-
-/**
- * 工具调用状态卡片（调用中 spinner / 完成 / 失败）。
- * 010：展示语义判定下沉 SDK describeToolCall（skill/preTool/normal/memory 四分支），
- * 本组件退化为纯渲染（徽标/颜色/展开交互）。
- * 018 tool-debug：debug 门控在渲染层——prod 恒无出入参展开入口（I4）；
- * dev 详情走 formatCompactToolIo（紧凑单行 + 头尾保留），输入输出双栏。
- */
-export default function ToolCallBlock({
-  toolCalls,
-  debug = false,
-}: {
-  toolCalls: ToolCallInfo[];
-  /** 018 tool-debug：dev 视图（出入参展开 + 紧凑格式）；prod 缺省 false */
-  debug?: boolean;
-}) {
-  const [expandedId, setExpandedId] = useState<string | null>(null);
-
-  return (
-    <div className="tool-calls">
-      {toolCalls.map((tc) => {
-        const display = describeToolCall(tc);
-        const isCalling = tc.status === 'calling';
-        const isError =
-          tc.status === 'error' ||
-          (display.kind === 'preTool' && display.status === 'error') ||
-          (display.kind === 'memory' && display.status === 'degraded');
-        const isDone = !isCalling && !isError;
-        const isExpanded = expandedId === tc.id;
-        // 018 I4：prod 恒无展开入口；dev 按 display.hasDetail
-        const hasDetail = debug && display.hasDetail;
-        const stateClass = isError ? 'tool-call--error' : isCalling ? 'tool-call--calling' : 'tool-call--done';
-
-        const displayName = (() => {
-          if (display.kind === 'skill') {
-            return isCalling ? `加载技能 ${display.label}` : `已加载技能 ${display.label}`;
-          }
-          if (display.kind === 'preTool') {
-            if (display.status === 'calling') return `自动查询 ${display.label}`;
-            if (display.status === 'error') return `自动查询失败 ${display.label}`;
-            return `已自动获取 ${display.label}`;
-          }
-          if (display.kind === 'memory') {
-            return display.label;
-          }
-          return isCalling
-            ? `调用 ${display.label}`
-            : isDone
-              ? `${display.label} 已完成`
-              : `${display.label} 调用失败`;
-        })();
-
-        // 详情文本（018：dev 态才计算——prod 无展开无渲染需求）
-        const detailText = (() => {
-          if (!hasDetail) return '';
-          if (display.kind === 'preTool') {
-            return (display.status === 'error' ? display.errorText : display.resultText) ?? '';
-          }
-          if (display.kind === 'memory') {
-            return display.detailText ?? '';
-          }
-          return isError ? (tc.error ?? '') : (tc.result ?? '');
-        })();
-        // dev 输入侧：normal 用 tc.args；preTool 解包 toolArgs（对齐 mall 视图模型）；memory 取 query
-        const inputText = (() => {
-          if (!hasDetail) return '';
-          if (display.kind === 'normal') return tc.args ?? '';
-          if (display.kind === 'preTool') {
-            return JSON.stringify(parsePreToolToolCallArgs(tc.args)?.toolArgs ?? {});
-          }
-          if (display.kind === 'memory') {
-            return parseMemoryToolCallArgs(tc.args)?.query ?? '';
-          }
-          return '';
-        })();
-
-        return (
-          <div key={tc.id} className={`tool-call ${stateClass}`}>
-            <div
-              className="tool-call__header"
-              onClick={() => hasDetail && setExpandedId(isExpanded ? null : tc.id)}
-            >
-              <div className="tool-call__left">
-                {isCalling && <div className="tool-call__spinner" />}
-                {isDone && <Check size={16} color="#10a37f" strokeWidth={2.5} />}
-                {isError && <X size={16} color="#ef4444" strokeWidth={2.5} />}
-                <span className="tool-call__name">{displayName}</span>
-                {display.kind === 'preTool' && (
-                  <span className="tool-call__badge">自动</span>
-                )}
-              </div>
-              {hasDetail && (
-                <span className={`tool-call__toggle${isExpanded ? ' tool-call__toggle--up' : ''}`}>
-                  {isExpanded ? '收起' : '详情'}
-                </span>
-              )}
-            </div>
-            {isExpanded && hasDetail && (
-              <div className="tool-call__result">
-                {inputText && (
-                  <div className="tool-call__io">
-                    <span className="tool-call__io-label">输入</span>
-                    <span className="tool-call__io-text">{formatCompactToolIo(inputText)}</span>
-                  </div>
-                )}
-                <div className="tool-call__io">
-                  <span className="tool-call__io-label">输出</span>
-                  <span className={`tool-call__io-text${isError ? ' tool-call__io-text--error' : ''}`}>
-                    {formatCompactToolIo(detailText) || '（无）'}
-                  </span>
-                </div>
-              </div>
-            )}
-          </div>
-        );
-      })}
-    </div>
-  );
-}