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

package/apps/client/src/examples/tourism/index.less

@@ -1,192 +0,0 @@
-.tourism-example {
-  &__welcome {
-    display: flex;
-    flex-direction: column;
-    align-items: center;
-    padding: 44px 48px 32px;
-  }
-
-  &__welcome-title {
-    margin-bottom: 24px;
-    color: #1f3b63;
-    font-size: 40px;
-    font-weight: 700;
-    line-height: 48px;
-    text-align: center;
-  }
-
-  &__welcome-desc {
-    color: #1f3b63;
-    font-size: 30px;
-    line-height: 48px;
-    text-align: justify;
-  }
-
-  &__section {
-    margin: 24px;
-    padding: 24px;
-    background: #fff9;
-    border: 1px solid #fff3;
-    border-radius: 24px;
-    box-shadow: 0 2px 18px 0 #2a31380a;
-  }
-
-  &__carousel-section {
-    padding-right: 0;
-  }
-
-  &__section-title {
-    display: block;
-    margin: 0 0 24px;
-    color: #1f3b63;
-    font-size: 30px;
-    font-weight: 500;
-  }
-
-  &__carousel {
-    display: flex;
-    gap: 16px;
-    overflow-x: auto;
-    padding-right: 24px;
-    scrollbar-width: none;
-
-    &::-webkit-scrollbar {
-      display: none;
-    }
-  }
-
-  &__carousel-item {
-    position: relative;
-    width: 280px;
-    height: 168px;
-    flex-shrink: 0;
-    overflow: hidden;
-    padding: 0;
-    background: transparent;
-    border: 0;
-    border-radius: 32px;
-  }
-
-  &__carousel-image {
-    display: block;
-    width: 100%;
-    height: 100%;
-    object-fit: cover;
-  }
-
-  &__carousel-overlay {
-    position: absolute;
-    right: 0;
-    bottom: 0;
-    left: 0;
-    display: flex;
-    flex-direction: column;
-    padding: 16px 20px 14px;
-    background: linear-gradient(180deg, transparent 0%, rgb(0 0 0 / 50%) 100%);
-    text-align: left;
-  }
-
-  &__carousel-title {
-    margin-bottom: 4px;
-    color: #fff;
-    font-size: 30px;
-  }
-
-  &__carousel-desc {
-    color: rgb(255 255 255 / 80%);
-    font-size: 22px;
-  }
-
-  &__service-grid,
-  &__suggestion-grid {
-    display: flex;
-    flex-wrap: wrap;
-    gap: 16px;
-  }
-
-  &__service-item,
-  &__suggestion {
-    display: flex;
-    align-items: center;
-    width: calc(50% - 8px);
-    box-sizing: border-box;
-    background: #fff;
-    border: 1px solid #8d9fb866;
-    border-radius: 24px;
-    box-shadow: 0 0 24px 0 #8d9fb80d;
-    color: #1f3b63;
-    text-align: left;
-  }
-
-  &__service-item {
-    height: 112px;
-    padding: 0 8px 0 20px;
-  }
-
-  &__service-icon {
-    display: block;
-    width: 72px;
-    height: 72px;
-    margin-right: 16px;
-    flex-shrink: 0;
-    object-fit: contain;
-  }
-
-  &__service-content {
-    display: flex;
-    min-width: 0;
-    flex: 1;
-    flex-direction: column;
-  }
-
-  &__service-title-row {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    margin-bottom: 4px;
-  }
-
-  &__service-title,
-  &__service-desc {
-    overflow: hidden;
-    text-overflow: ellipsis;
-    white-space: nowrap;
-  }
-
-  &__service-title {
-    font-size: 28px;
-    font-weight: 500;
-  }
-
-  &__service-desc {
-    color: #1f3b6373;
-    font-size: 22px;
-  }
-
-  &__suggestion-header {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-  }
-
-  &__refresh {
-    display: flex;
-    align-items: center;
-    gap: 9px;
-    margin-bottom: 24px;
-    padding: 0;
-    background: transparent;
-    border: 0;
-    color: #10295399;
-    font-size: 26px;
-  }
-
-  &__suggestion {
-    justify-content: space-between;
-    height: 78px;
-    padding: 0 20px;
-    overflow: hidden;
-    font-size: 26px;
-    font-weight: 500;
-  }
-}

package/apps/client/src/pages/index/index.less

@@ -1,43 +0,0 @@
-.chat-page {
-  display: flex;
-  flex-direction: column;
-  height: 100%;
-  position: relative;
-  background: #eef2f9;
-
-  &__bg {
-    position: absolute;
-    inset: 0;
-    z-index: 0;
-    background-image: linear-gradient(180deg, #9dc6ff 0%, #e5f0ff 63%, #e5f0ff 100%);
-    opacity: 0.66;
-    pointer-events: none;
-  }
-
-  &__body-wrapper {
-    flex: 1;
-    min-height: 0;
-    position: relative;
-    z-index: 1;
-    display: flex;
-    flex-direction: column;
-  }
-
-  &__body {
-    flex: 1;
-    min-height: 0;
-    overflow-y: auto;
-    overflow-anchor: none;
-    overscroll-behavior: contain;
-    position: relative;
-    padding: 10px 0 8px;
-    width: 100%;
-    max-width: var(--tbox-content-max-width);
-    margin: 0 auto;
-    scrollbar-width: none;
-
-    &::-webkit-scrollbar {
-      display: none;
-    }
-  }
-}

package/apps/client/src/store/chat-config.ts

@@ -1,40 +0,0 @@
-import { create } from 'zustand';
-import type { ChatUiSettings } from '@tbox.cn/app-sdk/client';
-import chatConfigJson from '../../../../config/chat.json';
-
-export interface QuickCommand {
-  /** 纯文案；前导星标/图标由 QuickCommands 组件渲染，不要写进 label */
-  label: string;
-  query: string;
-  icon?: string;
-}
-
-interface ChatConfigStore {
-  enableImageUpload: boolean;
-  enableVideoUpload: boolean;
-  enableTTS: boolean;
-  enableVoiceInput: boolean;
-  defaultInputMode: 'TEXT' | 'VOICE';
-  quickCommands: QuickCommand[];
-  /** HELLO_ACK settings 水合：服务端单一真源；undefined 键保留构建期快照（五键整组语义，禁部分水合） */
-  applyServerSettings: (settings: ChatUiSettings | undefined) => void;
-}
-
-const cfg = chatConfigJson as Record<string, unknown>;
-
-export const useChatConfigStore = create<ChatConfigStore>()((set) => ({
-  enableImageUpload: (cfg.enableImageUpload as boolean) ?? true,
-  enableVideoUpload: (cfg.enableVideoUpload as boolean) ?? true,
-  enableTTS: (cfg.enableTTS as boolean) ?? true,
-  enableVoiceInput: (cfg.enableVoiceInput as boolean) ?? true,
-  defaultInputMode: (cfg.defaultInputMode as 'TEXT' | 'VOICE') ?? 'TEXT',
-  quickCommands: (cfg.quickCommands as QuickCommand[]) ?? [],
-  applyServerSettings: (settings) =>
-    set((cur) => ({
-      enableImageUpload: settings?.enableImageUpload ?? cur.enableImageUpload,
-      enableVideoUpload: settings?.enableVideoUpload ?? cur.enableVideoUpload,
-      enableTTS: settings?.enableTTS ?? cur.enableTTS,
-      enableVoiceInput: settings?.enableVoiceInput ?? cur.enableVoiceInput,
-      defaultInputMode: settings?.defaultInputMode ?? cur.defaultInputMode,
-    })),
-}));

package/apps/client/src/styles/global.less

@@ -1,60 +0,0 @@
-@import './tokens.less';
-
-* {
-  box-sizing: border-box;
-}
-
-html,
-body,
-#root {
-  margin: 0;
-  padding: 0;
-  height: 100%;
-}
-
-body {
-  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
-  font-size: var(--tbox-fs-body);
-  color: var(--tbox-text-primary);
-  background: var(--tbox-bg-subtle);
-  -webkit-font-smoothing: antialiased;
-}
-
-/* 顶层容器全宽（渐变底铺满），内容区由各处 max-width:800px 居中（对齐原模板 #app）。 */
-#root {
-  width: 100%;
-  position: relative;
-}
-
-/* 去掉移动端点击高亮 */
-* {
-  -webkit-tap-highlight-color: transparent;
-}
-
-/* 卡片统一外层 = 卡片「卡框」。所有卡片共有的框在这里，单卡组件别重复写：
-   - 间距：卡片与上下元素（工具调用 / 气泡）的间距，与 .tool-calls 一致；
-   - 外观：默认背景(白) / 圆角 / 阴影；`overflow:hidden` 把内容裁进圆角。
-   值为源码 px（2x 基线、折半渲染）：圆角 40≈20、阴影 0 4px 16px≈0 2px 8px。
-   ⚠️ **内边距不在卡框里**——由卡片自己写。卡框给 padding 会让「自带背景色的卡」在外面露一圈白边（卡里套卡）。
-   宽度也不在卡框里：默认占满整列（≈移动端 350~400px 设计宽），紧凑卡自己写 max-width。
-   单卡组件（.tbox-<type>）只画内容；**要整卡换底色 / 出血图，直接在自己 root 上 `background:<色>` 或铺满图**——
-   会铺满卡框、裁进圆角、不出白边（别再自己设圆角，卡框已裁）。不写背景则露卡框默认白底，不透明。 */
-.tbox-card {
-  margin-bottom: 12px;
-  background: var(--tbox-bg-card);
-  border-radius: 40px;
-  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.1);
-  overflow: hidden;
-}
-
-/* 兜底态（未知 cardType / 渲染出错，由 CardRenderer 给外层加此修饰类）：
-   复用卡框，弱化成无阴影的虚线提示框（内边距自带，因为卡框不再给 padding） */
-.tbox-card--fallback {
-  max-width: 80%;
-  padding: 32px 24px;
-  background: var(--tbox-bg-subtle);
-  border: 1px dashed var(--tbox-border);
-  box-shadow: none;
-  color: var(--tbox-text-muted);
-  font-size: var(--tbox-fs-caption);
-}

package/apps/client/src/styles/tokens.less

@@ -1,60 +0,0 @@
-/**
- * 设计 token —— 从原 server `cards/_shared/tokens.css` 搬家到 client。
- *
- * C 方案下卡片是 client React 组件、不再有 iframe 下发 tokens，
- * 所以这些设计变量必须落在 client。卡片组件与页面统一用 var(--tbox-*) 引用，
- * 禁止硬编码十六进制色值 / px 字号。
- *
- * 注：这里的 px 会被 postcss-px-to-viewport（750 基准）转成 vw。
- */
-:root {
-  /* 主色 */
-  --tbox-primary: #1677ff;
-  --tbox-primary-dark: #0958d9;
-  --tbox-primary-light: #e6f4ff;
-
-  /* 文本 */
-  --tbox-text-primary: #1f1f1f;
-  --tbox-text-secondary: #595959;
-  --tbox-text-muted: #8c8c8c;
-
-  /* 背景 */
-  --tbox-bg-card: #ffffff;
-  --tbox-bg-subtle: #f5f7fa;
-
-  /* 边框 */
-  --tbox-border: #e8ebed;
-
-  /* 状态色 */
-  --tbox-success: #52c41a;
-  --tbox-warning: #faad14;
-  --tbox-error: #ff4d4f;
-
-  /* 字号——按 750/2x 设计稿基线，对标消息气泡（MessageBubble）：
-       正文 .msg-markdown / __text = 25px，次要信息(时间/角色) = 18~19px，标题 h1~h4 = 36/32/30/28px。
-     注意：rootValue 100 + 根字号脚本会把 px 折半渲染（750 稿 → ≈375 手机列），
-     所以这里写的是 2x 值，别按普通 web 的 12/14/16 写（那样渲染出来只有一半、发虚）。
-     价格等强调大号字单独硬编（~32，≈气泡 h2），不挤进这 3 档。 */
-  --tbox-fs-heading: 30px; /* ≈气泡 h3：商品名 / 店名 */
-  --tbox-fs-body: 25px;    /* =气泡正文 */
-  --tbox-fs-caption: 20px; /* ≈气泡次要信息(时间/角色) */
-
-  /* 圆角 */
-  --tbox-radius-sm: 4px;
-  --tbox-radius-md: 8px;
-
-  /* 内容最大宽度（对齐原模板）：全宽渐变底 + 内容区 800px 居中。
-     大写 PX 不被 postcss-pxtorem 转换（正则大小写敏感），保持固定像素。 */
-  --tbox-content-max-width: 800PX;
-
-  /* 媒体缩略图 */
-  --tbox-media-item-size: 174px;
-  --tbox-media-item-radius: 12px;
-
-  /* 输入框（对齐原模板 AdvancedChatInput） */
-  --tbox-input-bg: rgba(255, 255, 255, 0.7);
-  --tbox-input-radius: 50px;
-  --tbox-input-padding: 20px 24px;
-  --tbox-send-btn-size: 44px;
-  --tbox-icon-color: #4b6282;
-}

package/apps/server/src/config/deployment.ts

@@ -1,47 +0,0 @@
-/**
- * mall 装配派生层（integrations v4：部署拓扑并入 integrations.json——单文件真源；
- * 与 mall 模板同构，base 无 mallName 包装链）。
- * - 旧 `config/deployments/development.json` 已退役：stale 防线在 integration.ts 装载链
- *   （在场且含 malls 键 → error 迁移指引；support 独立体系不受影响）；
- * - controlPlane 来源 = integration.ts 的 mallControlPlaneOf 投影（attributes 赋义 zod
- *   单源上收 contracts-mall——本文件不再内嵌 schema）；
- * - mall 语义集中在 contracts-mall（TIER1）；apps 只做装配组合（011 L6 checklist）。
- */
-import { createLogger } from '@tbox.cn/app-sdk/server';
-import { createMallRuntimeAssembly, type MallDeploymentControlPlane, type MallRuntimeAssembly } from '@app/contracts-mall';
-import type { LoadedIntegrations } from './integration.js';
-
-const deploymentLogger = createLogger('DEPLOYMENT');
-
-export interface LoadedDeployment {
-  controlPlane: MallDeploymentControlPlane;
-  assembly: MallRuntimeAssembly;
-}
-
-/** integrations 装载产物 → mall 装配（恒投影——无参考表 = 空平面，装配零拓扑分支） */
-export function deploymentFromIntegrations(loaded: LoadedIntegrations): LoadedDeployment {
-  const assembly = createMallRuntimeAssembly(loaded.controlPlane);
-  return { controlPlane: loaded.controlPlane, assembly };
-}
-
-/**
- * 016：默认商圈 HELLO context（无 URL 参数访问时的服务端兜底；与 mall 模板同构）。
- * v4 mallId-only 注入（D8/D9）：miniAppId 是尽力回填的展示值，非会话边界——
- * 读源统一 root config.miniAppId 优先、回落参考表 attributes.miniAppId；双缺不再
- * 阻断注入（此前 warn-refuse 会造成默认商圈静默失效），按 mallId-only 注入。
- * 缺省 defaultMallId → undefined（不兜底）。
- */
-export function buildDefaultMallContext(
-  controlPlane: MallDeploymentControlPlane,
-  rootMiniAppId?: string,
-): Record<string, unknown> | undefined {
-  if (!controlPlane.defaultMallId) return undefined;
-  const mall = controlPlane.malls.find((m) => m.mallId === controlPlane.defaultMallId);
-  const miniAppId = rootMiniAppId ?? mall?.miniAppId;
-  if (!miniAppId) {
-    deploymentLogger.warn(
-      `defaultMallId=${controlPlane.defaultMallId} 无 miniAppId 真源（root config 与参考表双缺）——按 mallId-only 注入默认商圈`,
-    );
-  }
-  return { mall: { mallId: controlPlane.defaultMallId, ...(miniAppId ? { miniAppId } : {}) } };
-}

package/packages/module-weather/package.json

@@ -1,36 +0,0 @@
-{
-  "name": "@app/module-weather",
-  "version": "0.1.0",
-  "private": true,
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./src/index.ts",
-      "import": "./src/index.ts"
-    },
-    "./server": {
-      "types": "./src/server/index.ts",
-      "import": "./src/server/index.ts"
-    },
-    "./client": {
-      "types": "./src/client/index.ts",
-      "import": "./src/client/index.ts"
-    },
-    "./package.json": "./package.json"
-  },
-  "scripts": {
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@tbox.cn/app-sdk": "catalog:",
-    "@tbox.cn/app-contracts": "catalog:"
-  },
-  "peerDependencies": {
-    "zod": "3.25.76",
-    "react": "18.3.1"
-  },
-  "devDependencies": {
-    "@types/react": "18.3.31",
-    "typescript": "5.9.3"
-  }
-}

package/packages/module-weather/skills/weather-guide/SKILL.md

@@ -1,22 +0,0 @@
----
-name: weather-guide
-description: 天气查询与穿衣出行建议（调用 getWeather 真实数据）
-metadata:
-  routingTerms: [天气, 穿衣, 温度, 湿度, 出行]
----
-## 适用意图
-用户询问天气、穿衣建议、出行准备（如"今天穿什么"）时使用本规范。
-
-## 调用工具
-必须调用 getWeather 工具查询真实天气（city 取用户提到的城市），禁止编造温度/天气数据。
-
-## 返回字段说明
-getWeather 返回：temp(温度℃)、weather(天气现象)、humidity(湿度%)。
-
-## 回答组织方式
-1. 先报城市与天气现象、温度、湿度
-2. 再给出穿衣/出行建议（结合温度与天气现象）
-3. 温度 <10℃ 提醒保暖，>30℃ 提醒防晒
-
-## 出卡规则
-getWeather 结果含天气卡：回复末尾另起一行输出 `<agent-ui-cards>` 引用本轮卡片 id，否则用户看不到卡。

package/packages/module-weather/skills/weather-guide/references/dressing-tips.md

@@ -1,5 +0,0 @@
-## 穿衣指数
-- 温度 <10℃：厚外套/羽绒服
-- 10~20℃：夹克/风衣
-- 20~30℃：单衣/薄外套
-- >30℃：短袖，注意防晒

package/packages/module-weather/src/client/cards/weather/index.less

@@ -1,22 +0,0 @@
-.tbox-weather {
-  max-width: 80%;
-  padding: 32px 24px;
-
-  &__city {
-    font-size: var(--tbox-fs-heading);
-    font-weight: 600;
-    color: var(--tbox-text-primary);
-  }
-
-  &__temp {
-    font-size: 56px;
-    font-weight: 700;
-    color: var(--tbox-primary);
-    margin: 8px 0;
-  }
-
-  &__meta {
-    font-size: var(--tbox-fs-caption);
-    color: var(--tbox-text-secondary);
-  }
-}

package/packages/module-weather/src/client/cards/weather/index.tsx

@@ -1,14 +0,0 @@
-import type { WeatherCardData } from '../../../server/cards/weather/meta';
-import './index.less';
-
-export function WeatherCard({ data }: { data: WeatherCardData; cardId: string; isHistory: boolean }) {
-  return (
-    <div className="tbox-weather">
-      <div className="tbox-weather__city">{data.city}</div>
-      <div className="tbox-weather__temp">{data.temp}°</div>
-      <div className="tbox-weather__meta">
-        {data.weather} · 湿度 {data.humidity}%
-      </div>
-    </div>
-  );
-}

package/packages/module-weather/src/client/index.ts

@@ -1,19 +0,0 @@
-import type { CardComponent } from '@tbox.cn/app-contracts';
-import type { ClientContext, ClientModule } from '@tbox.cn/app-sdk/client';
-import { WeatherCard } from './cards/weather/index';
-
-/**
- * 客户端卡片组件 map（CLI sync 读取）。
- * key 约定 = cardType；渲染边界统一为 CardComponent（data: unknown），具体类型由组件内部收窄。
- */
-const cards = {
-  weather: WeatherCard as CardComponent,
-} as const;
-
-/** 模块注册入口：自注册闭环（与服务端 serverModule 对称） */
-export const clientModule = {
-  cards,
-  register(ctx: ClientContext): void {
-    ctx.cards.registerMap(cards);
-  },
-} satisfies ClientModule;

package/packages/module-weather/src/index.ts

@@ -1,2 +0,0 @@
-export * from './server';
-export * from './client';

package/packages/module-weather/src/server/cards/weather/meta.ts

@@ -1,27 +0,0 @@
-import { z } from 'zod';
-import type { CardMeta } from '@tbox.cn/app-contracts';
-
-export const dataSchema = z.object({
-  city: z.string(),
-  temp: z.number(),
-  weather: z.string(),
-  humidity: z.number(),
-});
-
-export type WeatherCardData = z.infer<typeof dataSchema>;
-
-const meta: CardMeta<typeof dataSchema> = {
-  cardType: 'weather',
-  dataSchema,
-  displayName: '天气卡片',
-  description: '展示某城市的天气数据，含温度、天气状况、湿度',
-  sampleData: {
-    city: '北京',
-    temp: 22,
-    weather: '晴',
-    humidity: 35,
-  },
-};
-
-export default meta;
-export { meta as weatherMeta };

package/packages/module-weather/src/server/index.ts

@@ -1,45 +0,0 @@
-import { weatherTool } from './tool';
-import weatherMeta from './cards/weather/meta';
-import { loadModuleSkills } from '@tbox.cn/app-sdk/server';
-import type { LocalSkill, ServerContext, ServerModule } from '@tbox.cn/app-sdk/server';
-import { weatherPreTool } from './pre-tools';
-
-export { weatherTool, weatherMeta };
-
-/** 卡片 meta 声明 map（key 约定 = meta.cardType；数据 + 类型源） */
-const cards = {
-  weather: weatherMeta,
-} as const;
-
-/**
- * 模块 skill 声明（009 模块文件化：SKILL.md 目录格式，文件即唯一源）。
- * - 底层能力：SDK `loadModuleSkills(packageName, import.meta.url)` 单策略定位包根
- *   （createRequire 包名解析：dev workspace link / 模块 dist / 应用 bundle dist / 发布态
- *   node_modules 全形态恒命中；失败 warn 可行动 + 恒 resolve []）；
- * - 顶层 await 加载 → 填回 serverModule.skills 声明式通道（装配端 registerAll 自动注册）；
- * - 前置：本包 exports 须含 "./package.json"（见 package.json）；
- * - 生成应用内（codegen 展开）调用名由 CLI 自动改写为 @app/<id>，源码按字面量包名写法。
- */
-const skills = Object.fromEntries(
-  (await loadModuleSkills('@app/module-weather', import.meta.url)).map((s) => [s.name, s]),
-) satisfies Record<string, LocalSkill>;
-
-/**
- * 模块前置工具声明（010：key 约定 = toolId，纯数据 + 一个 resolve 函数）。
- * 装配端 registerServerModules 自动注册（register 内无需代码）。
- */
-const preTools = {
-  getWeather: weatherPreTool,
-} as const;
-
-/** 模块注册入口：自注册闭环（与客户端 clientModule 对称） */
-export const serverModule = {
-  cards,
-  skills,
-  preTools,
-  declaration: { moduleId: 'weather' },
-  register(ctx: ServerContext): void {
-    ctx.tools.register(weatherTool);
-    ctx.cards.registerMap(cards);
-  },
-} satisfies ServerModule;

package/packages/module-weather/src/server/pre-tools.ts

@@ -1,20 +0,0 @@
-import { definePreTool } from '@tbox.cn/app-sdk/server';
-import { weatherTool } from './tool';
-
-/**
- * 前置工具声明（010）：getWeather 的 city 参数可工程化抽取（城市词表），
- * 无需模型抽参——词表命中即预执行，模型第一轮直接作答（省一轮 loop）。
- *
- * 演示形态：文本工程化抽取——决策即构造：
- *   抽到城市 → { decision: 'run', args: { city } }（预执行，args 强类型由 tool 推断）；
- *   抽不到 → { decision: 'skip' }（本轮不生效，模型正常调用工具）。
- */
-const CITIES = ['北京', '上海', '广州', '深圳', '杭州', '成都', '武汉', '西安', '南京', '重庆'];
-
-export const weatherPreTool = definePreTool(weatherTool, {
-  routing: { mode: 'keywords', terms: ['天气', '气温', '下雨', '下雪', '穿衣', '出行'] },
-  decide: ({ text }) => {
-    const city = CITIES.find((c) => text.includes(c));
-    return city ? { decision: 'run', args: { city } } : { decision: 'skip' };
-  },
-});