# 云灵页面配置协议（Agent 开发指南）

版本 2.2 · 2026-11-01。模板 `yunling@2`，页面协议 `schemaVersion: 1`。本文件描述代码中的配置接口；上线时间和实际验收范围以项目发布记录为准。

## 架构与职责

页面分三层：项目发布配置决定页面结构、导航、文字与素材；版本化云灵组件负责呈现和交互；业务模块调用统一服务接口，由客户适配层提供真实数据。AI 对话、历史、身份、语音识别继续使用 woodenhorse 平台能力。

客户不需要另建一套客服 H5，也不需要给每个页面开发专用 HTML 接口。普通定制通过 JSON 草稿、预览、发布完成。新的交互类型需要平台增加受控组件并发布新模板版本；不向主页面注入任意 HTML、JavaScript 或 CSS。独立 HTML 扩展通过已注册的跨来源沙箱组件接入，详见 [运行时与跨域架构](./runtime-architecture.md)。

## 发布接口

以下接口由 woodenhorse 提供，要求当前项目所有者登录和同源请求。不能把所有者会话或项目密钥写到客户前端。客户业务数据接口另见 [customer-api.md](./customer-api.md)。

| 平台路径 | 请求与用途 |
|---|---|
| `GET /api/projects/:id/appearance` | 读取 `draft`、`published`、`revision`、历史版本 |
| `PUT /api/projects/:id/appearance/draft` | `{revision,config}` 保存整个外观配置；其中 `config.pages` 是本文的页面配置 |
| `POST /api/projects/:id/appearance/publish` | `{revision}` 发布；生成不可变历史记录 |
| `POST /api/projects/:id/appearance/restore` | `{revision,versionId}` 恢复历史外观，生成新的发布记录 |
| `POST /api/projects/:id/appearance/assets` | 上传项目图片，返回可用素材地址 |
| `POST /api/public/bootstrap` | 聊天启动时取得本项目已发布外观；预览草稿要求项目所有者身份 |

保存时先读取当前状态，克隆完整 `draft`（保留现有外观字段），设置 `template_id: "yunling"`、`template_version: 2` 和 `pages`。完整初始配置见 [yunling-pages.json](./yunling-pages.json)。不要将下面的局部示例直接替代完整外观配置。

```js
const state = await fetch(`/api/projects/${projectId}/appearance`).then(r => r.json());
const config = structuredClone(state.draft);
config.template_id = 'yunling';
config.template_version = 2;
config.pages = await fetch('/docs/yunling/yunling-pages.json').then(r => r.json());
const home = config.pages.pages.find(page => page.id === 'home');
home.blocks.find(block => block.type === 'hero').title = '开启云顶之旅!';
// 在已登录的同源管理环境中提交。先预览，再发布。
const response = await fetch(`/api/projects/${projectId}/appearance/draft`, {
  method: 'PUT', headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({revision: state.revision, config})
});
if (!response.ok) throw new Error('保存失败，请读取错误信息；409 时重新读取版本');
const saved = await response.json();
// 发布请求使用 saved.revision，而不是旧 revision。
```

后台“界面与模板”支持导入/导出完整 JSON。选择云灵 v2 时会保存完整预设，后续代码升级不会悄悄更换已发布的页面数据。v1 保留兼容，升级需要项目显式发布 v2。

## 页面结构

`pages` 顶层字段：

| 字段 | 约束 |
|---|---|
| `schemaVersion` | 当前为 1 |
| `entry` | 首页 ID，必须存在 |
| `theme` | `accent`、`ink`、`muted`、`backgroundStart`、`backgroundEnd`、`surface`；六位十六进制颜色；可选 `backgroundStyle` 为 `gradient` 或原稿多层渐变 `figma-glow` |
| `assets` | 素材名称到 URL 的映射，最多 80 项；图片为已注册内置素材、本项目资源或 HTTPS URL；空字符串显示占位 |
| `motion` | 可选动效配置；launcher 为 yunling-launcher-20261031，processing 为 yunling-processing-20261031；省略或空值不启用对应动效 |
| `extensions` | 可选，最多 20 个独立 HTML 扩展；HTTPS 来源、尺寸与允许的页面由平台校验 |
| `replyTitles` | 可选，结构化回复场景的标题与显示方式，见下文 |
| `pages` | 最多 80 页；ID 唯一，由小写字母开头，可含数字和连字符，最长 64 字符 |

每页：`id`、`title`、`blocks`；可选 `hideTitle`、`titleStyle: "plain" | "gradient"`、`quickLinks` 和 `layout`。`layout` 的 stack/grid、容器断点和间距约束见 [运行时文档](./runtime-architecture.md)。省略 titleStyle 时使用 24px 实色强调线；`gradient` 使用 ZIP 的 21px 渐变强调线；`plain` 用于选购分类等无强调线标题。三种样式由公共 PageHeading 展示组件渲染，自定义页面也可选择，不依赖业务路由名称。后端拒绝未注册样式；无需由客户编写 CSS。

### 2026-10-31 原稿动效与素材

最新原稿的两份 Lottie 均为 432×360、60fps、3 秒透明矢量动画。平台登记两个受控动效 ID，不允许通过此字段提交任意 JSON URL 或脚本。原文件无外部资源或表达式，采用本地 light SVG 播放器；播放资源失败时保留静态 IP 头，页面隐藏/离屏时暂停，“减少动态效果”时显示静止首帧。

```json
{
  "motion": {
    "launcher": "yunling-launcher-20261031",
    "processing": "yunling-processing-20261031"
  }
}
```

将这段配置合并到当前项目的 `config.pages`，通过既有草稿/发布接口发布。processing 仅用于当前 AI 消息等待首段文字的状态；文字开始显示、失败、取消或组件卸载后停止，不给历史空消息播放等待动画。launcher 供客户 widget 引用配置使用，网页接入方将其传入 `data-launcher-motion`；当前 widget 不主动读取项目外观接口。小程序原生悬浮组件可复用原 Lottie 文件，但需客户容器自己的播放器，不可将 widget.js 放进 WXML。

新版首页八个图标位于 `/templates/yunling/v2/20261031/`，通过 `assets` 和各入口的 `image` 引用。已有项目保存的旧素材地址和无 motion 的历史版本保持原配置；升级时显式保存并发布，不能把新版默认值视为线上项目已更新。

每页最多 24 个区块，区块 ID 在该页唯一。支持：

| 区块类型 | 用途 |
|---|---|
| `hero` | 首页欢迎文案、标题、角色图；`image` 引用 assets 名称 |
| `tiles` | 入口网格，`variant` 可为 home、numbered、catalog |
| `links` | 链接组；danger 变体用于救援入口 |
| `text` | 纯文本标题和说明 |
| `module` | 受控业务模块，module 值必须为平台已注册的流程 ID |
| `extension` | 引用 `extensions` 中登记的独立 HTML 扩展，协议与权限见运行时文档 |

入口 `items` 最多 24 项，含 `label`、可选 `description/number/icon/image` 和 `target`。页脚 `quickLinks` 最多 4 项。图标名称：sparkles、location、headphones、layers、rescue、wallet、orders、calendar、ticket、mountain。

```json
{
  "label": "我的订单",
  "icon": "orders",
  "target": {"type": "page", "value": "orders"}
}
```

`target.type` 支持 page（已存在页面 ID）、action（当前项目业务动作 ID）、question（发送给 AI 的问题，最多 500 字符）。外部地址通过项目 action 配置，不把任意 URL 填进 page。action 必须属于当前项目；需要参数的动作由既有动作流程收集参数后跳转。

内置业务流程页面及 module 必须保留，以兼容深链接、AI 工具和表单跳转；可从首页或更多内容中隐藏入口。不能把一个模块放到另一内置流程 ID 下。六个商品模块还可挂载到新增的客户页面 ID，商品分类由 module 决定，与页面 ID 无关；其他业务模块仍使用对应流程 ID。额外信息页可以自由增加、排序并加入导航。预设中的所有 ID 是可用值的权威清单。

### 自定义商品页面

在 `pages` 中新增以下页面，再将导航入口的 `target` 配为 `{"type":"page","value":"winter-store"}`。该页面复用票务模块的布局、商品查询、筛选和预订流程；不需要新增前端路由或客户业务接口。每页仍只允许一个业务模块，原有 `catalog-tickets` 页面必须保留。

```json
{
  "id": "winter-store",
  "title": "冬季票务",
  "titleStyle": "plain",
  "blocks": [{
    "id": "tickets",
    "type": "module",
    "module": "catalog-tickets",
    "copy": {"cardTitle": "精选雪票", "intro": "选择适合你的雪票"}
  }]
}
```

页面内预订仍调用平台 `checkout` 操作，由客户服务器返回预订 URL，用户确认后通过宿主适配器打开。复制页面不会创建独立的商品库存或价格；同一分类沿用已有业务数据及会话筛选状态。

### 商品模块的展示配置

六个已注册商品模块（`catalog-tickets`、`catalog-offers`、`catalog-camp`、`catalog-lesson`、`catalog-pass`、`catalog-stay`）支持 `blocks[].copy`。它只控制纯文本展示，HTML 作为文字显示，不执行脚本；其他模块传入 copy 会被拒绝。

| 字段 | 用途与最大长度 |
|---|---|
| `cardTitle` | 商品卡分类标题，80 字；保留配置中的空格并自动换行 |
| `intro` | 列表介绍，400 字 |
| `choosingIntro` | 打开筛选层时的介绍，400 字 |
| `equipmentLabel` | 装备筛选的展示名称，16 字 |
| `selectionHint` | 真实业务筛选说明，400 字 |
| `demoSelectionHint` | 演示业务筛选说明，400 字 |
| `filterTitle` | 套餐条件未选齐时的标题，80 字 |
| `completedFilterTitle` | 套餐条件选齐后的标题，80 字；省略时沿用 filterTitle |
| `filterHint` | 套餐条件面板说明，400 字 |
| `demoCompletedFilterHint` | 演示模式条件选齐后的说明，400 字；省略时沿用 filterHint |

```json
{
  "id": "catalog-lesson",
  "title": "课程",
  "blocks": [{
    "id": "content", "type": "module", "module": "catalog-lesson",
    "copy": {"cardTitle": "课程", "intro": "课程业务卡片"}
  }]
}
```

将对应页合并到当前完整配置后保存、预览和发布。页面 title 与模块介绍分别配置；省略 copy 或某个字段时使用兼容默认值。把票务卡标题设为“团购优惠”不会改变 `products` 查询和 `checkout` 的 `category: "tickets"`；将装备标题设为原稿的“学具”不会改变接口字段 `equipmentId`。商品名称、价格、销量仍由业务接口返回。演示数据使用 ZIP 示例值，不作为真实报价。

商品控件还支持以下可选主题字段，均为六位十六进制颜色：

```json
{
  "controls": {
    "catalogAction": "#568EFF",
    "workflowAction": "#5382F6",
    "selectionOutline": "#AFA3F3"
  }
}
```

合并到 `pages.theme`：catalogAction 用于商品/订单卡及客服订单卡的蓝色主按钮；workflowAction 用于用户气泡及流程主按钮（筛选确认、预订承接、空订单、现场服务等）；selectionOutline 用于筛选层已选项边框。独立待支付页的红色支付按钮保留其状态色。前两项省略时继承 accent，边框省略时使用兼容默认色。云顶预设 accent 为 ZIP 取样值 #5382F6；已有项目需显式发布主题更新。只影响登记组件，不接受任意 CSS、选择器或执行代码；无需为配色新增客户业务接口。

## 问候与需求补充回复配置

`pages.replyOptions` 是可选的展示配置，与页面结构一起保存草稿、预览和发布。省略字段时使用模板内的兼容默认值；不会覆盖其他租户。示例为应合并到完整 pages 对象中的片段：

```json
{
  "replyOptions": {
    "greeting": {"refreshLabel": "换一批"},
    "clarify": {
      "title": "想为你安排哪一项？",
      "intro": "确认你的需求后，我再继续为你推荐。",
      "items": [
        {"label": "安排行程", "description": "补充日期与人数", "target": {"type": "page", "value": "trip"}},
        {"label": "推荐产品", "description": "选票或住滑套餐", "target": {"type": "page", "value": "recommend"}},
        {"label": "查询订单", "description": "查看最近订单", "target": {"type": "page", "value": "orders"}}
      ]
    }
  }
}
```

问候卡的标题与问题列表仍来自服务内容配置的 `replyGreeting.title` 和 `replyGreeting.questions`；此处只配置换批按钮文案，最多 40 字。需求补充标题最多 80 字、说明最多 400 字。items 省略时回退到默认三个入口，显式提供时须包含 1–6 项，不能传空数组；每项只支持 label、description 和 target，不支持图标、图片、编号或执行代码。入口名称为 1–80 字，描述最多 160 字。

目标类型为 page、action 或 question：page 必须引用本清单内的页面，导航时保留本轮回复的出行条件；action 必须属于当前项目，交给平台动作分发器；question 使用现有 AI 消息接口。不得把 URL 写入 page 或 action 的 value。缺失或不可执行的动作遵循原有动作校验，不猜测地址。消息处理中入口和换批按钮禁用，避免并发发送。纯展示组件不请求业务数据，客户 15 项业务接口不变。

## 内容与数据

- 指南和 FAQ 正文来自项目服务内容接口 `GET/PUT/POST .../service`，单独保存和发布。

指南内容的 `pages[]` 支持可选 `question`（最多 120 字）与 `footnote`（最多 300 字）。每个 `sections[]` 保留 `title` / `body`，可增加 `rows: [{"label":"周一至周五","value":"08:30–16:30"}]`；最多 12 行，每行名称 80 字、内容 120 字。正文可以在存在数据行时留空。旧发布内容省略这些字段仍可读取。

文章模块通过外观配置中的 `blocks[].variant` 选择 `article`（普通正文）、`article-cards`（分组卡片）或 `article-schedule`（时间表卡片）。这些值只允许用于已注册的九个指南模块，不能用于订单等流程。排版与内容分别发布；切换排版不会清空时间行。设置 `question` 时显示提问气泡及文章内标题；普通正文还显示助手标签。未设置时保留普通页面标题和原有返回入口。

```json
{"id":"hours","title":"营业时间","blocks":[{"id":"content","type":"module","module":"hours","variant":"article-schedule"}]}
```

这是完整页面清单中一个页面的示例，保存时仍需提交完整外观草稿并携带当前 revision。管理后台的“服务页面文案”可编辑提问、页尾说明和数据行；保存草稿后单独发布内容。FAQ 同样来自服务内容接口，页面状态管理器保留当前展开项，一次只展开一项。

- 商品、酒店/房型/雪具选项、订单、营业状态、商家和人工客服来自客户接口，不能把实时价格与订单写到页面配置里。
- 人工客服是独立会话，发送文字和订单走 support 接口，不混入 AI 回答。平台语音转文字仍可用于人工会话输入。
- 首页雪豹和四个磨砂图标取自 Figma 原稿，随 `yunling@2` 发布在 `/templates/yunling/v2/`。`assets` 可引用这些精确注册的内置文件，或替换为项目上传素材和 HTTPS 地址，无需修改业务逻辑。
- 窄屏宽度随容器变化；聊天区独立滚动，键盘弹起时输入栏随可见视口调整，不固定为设计稿的 375px 宽度。

## 验收与回滚

先检查首页、所有入口、返回、表单校验、空数据、错误与重试，再检查 320/375/390/430px 和桌面宽度、键盘与语音状态。发布前比较用户提供的 UI / 动画 ZIP 原稿和渲染截图，不能仅以编译通过判定视觉对齐。

外观恢复只恢复页面、主题和素材，不恢复独立发布的服务正文或客户业务数据。上线先在目标项目发布，不批量切换其他租户模板。

## 原稿核对与待补能力

原稿素材来源、已核对节点和差异见 [Figma 核对记录](./figma-alignment.md)。当前不能把所有页面标记为已逐像素验收。当前已实现项目范围的记忆授权、关闭、修改与删除接口，包含并发版本校验；云灵新用户默认不记忆。接口属于平台，不属于客户的 15 项业务接口。示例模式使用本次浏览器会话的模拟数据，功能测试通过不表示所有 ZIP 视觉状态均已验收。

### 2026-11-01 导出包的组件校准

最新默认配置完整保存在 `yunling-pages.json`；线上既有项目需要显式发布修改后的 `pages`。不要通过更新默认 JSON 去覆盖所有租户。

- `hero` 可选 `watermark` 为横幅装饰文字（最多 80 字，仅允许 hero），不会被当作业务数据或执行代码。
- 首页和推荐入口仍使用 `PageLink.image` 引用 `assets`。推荐的六个素材键为 `category-tickets/stay/offers/camp/lesson/pass`。
- `text` 区块可使用已有的 `image` 字段显示右侧装饰插画；更多内容页的引导区使用 `more-mascot`。
- 业务组件的插画槽位：`consult-mascot`、`trip-mascot`、`lost-register-mascot`、`lost-query-mascot`、`lost-claim-mascot`、`error-mascot`；语音组件为 `microphone`、`voice-head`、`voice-cancel`。素材地址仍经过相同的项目归属 / HTTPS / 内置白名单校验。未配置的装饰不显示，麦克风保留通用图标。
- 商品、订单、行程商品共用 `CommerceCard`，价格、图片、日期和跳转都来自业务返回值，不能把设计截图的样例订单当真实数据。
- 录音遮罩属于呈现组件；录音、上滑取消、识别、停止识别依然调用平台 voice controller，不引入客户独立 ASR。
- widget 可选 `data-launcher-caption="智能助手"`，与原 IP 动画组成白色胶囊；省略 caption 的既有客户保留纯图标入口。

新增原稿素材的来源和 SHA-256 见 [alignment-assets-20261101.json](./alignment-assets-20261101.json)。开发包包含这些素材及消费它们的组件。无新增客户业务接口；可选的儿童条件、适用规则和入园凭证字段见 2.1 客户 API 指南。鉴权、幂等和返回 URL 校验仍由业务适配层负责。

`trip-start` 是可选的行程引导页面/模块，首页可将入口指向它，再进入原有 `trip` 需求填写流程。旧版配置无需新增此页面，原 `trip` 深链接继续有效。


## ZIP 对话场景与标题配置

唯一视觉验收依据是交付的 UI、动画 ZIP。`pages.replyTitles` 可为 `pretrip`、`family`、`family-conditions`、`credential`、`onsite`、`rescue`、`itinerary`、`products` 配置 `{title, hideTitle?}`；标题最长 80 字符。此字段只控制场景标题，不改变业务权限。

结构化回复工具的 `layout: "scenario"` 仅适用于 `products` 和 `itinerary`，对应 ZIP 09 中的完整场景；省略时采用 ZIP 02 普通咨询卡片。其他场景由受控回复类型决定，不能由模型输出 CSS、HTML、任意电话或 URL。

行前咨询支持经过平台校验的 `{"kind":"pretrip","travelPeriod":"this_weekend"}`，显示「本周末 · 日期待确认」；`next_weekend` 显示「下周末 · 日期待确认」。该字段只保留用户表达，不转换为具体日期或传给客户查询/预订接口；不得与 `trip.date` 同时使用，也不能用于其他回复类型。用户确认日期后使用 `trip.date: "YYYY-MM-DD"` 并省略 `travelPeriod`。历史消息保留原始意图，不随打开日期重新计算；没有日期或意图的旧消息继续显示「日期待确认」。

`theme.font: "noto-sans-sc"` 使用平台自托管的字体子集；价格和数字使用 D-DIN Condensed。素材继续通过 `assets` 配置。文章指南可以提供 `preview: {coverURL?, location?, summary?, tags?}`；封面必须是 HTTPS，缺失时使用原稿占位，不生成替代图片。

`checkout` 是可选的演示预订说明页面/模块，对应 ZIP 03-12；演示模式进入说明页，不调用创建预订接口。正式模式仍请求客户 checkout 并校验确认地址和有效期。


### 插画入口与说明块

失物招领模块支持 `variant: "illustrated"`，通过同一外观草稿/发布接口配置 `title`、`text` 和 `items`。每项的 `label`、`description`、`image`（已注册素材 ID）及 `target` 都可替换；目标仍使用已校验的 page/action/question 协议。至少提供一项，不允许不受控脚本或 URL。该样式只用于 lost 模块；其他业务模块不能借此改变身份或业务流程。省略 variant 时保留历史入口。

```json
{"id":"lost","title":"失物招领","hideTitle":true,"blocks":[{"id":"content","type":"module","module":"lost","variant":"illustrated","title":"失物招领","text":"我丢了东西，该怎么登记或查询？","items":[{"label":"查询进度","description":"提供登记编号或物品特征","image":"lost-query-mascot","target":{"type":"page","value":"lost-query"}}]},{"id":"storage-rule","type":"text","variant":"note","title":"保管规则","text":"物品保管期限、保管地点及领取要求，请以雪场客服核实的信息为准。"}]}
```

`note` 只适用于 text 块，使用较小的栏目标题及说明正文。插画入口和说明块均随容器宽度换行，页面不固定为 375×812。


## 园区商家目录与页尾说明

`merchants` 模块由独立 `MerchantDirectory` 渲染，分类与返回恢复使用页面状态管理器。标题、模块位置和页尾说明通过页面清单发布；商家名称、照片、位置、数量和导航地址来自商家接口。`caption` 是仅用于 text 块的小字说明样式，不接受脚本。旧页面只有模块时仍可展示。

```json
{"id":"merchants","title":"园区商家","blocks":[{"id":"content","type":"module","module":"merchants"},{"id":"merchant-notice","type":"text","variant":"caption","text":"商家信息以园区现场公示为准。"}]}
```

商家照片按 88px 方形展示，卡片高度随文字增长，窄屏不固定画布尺寸。配置和数据均不支持注入 CSS 或任意 HTML；需要扩展 HTML 页面时，使用下述受限 iframe 扩展协议与宿主跳转接口。


## 订单模块查询与状态标题

订单模块的 `orders` 对象只用于 `module: "orders"` 或 `"payment"`。`period` 为 `all` / `this_week`，省略默认 all。payment 只允许 all，不能漏掉较早的待支付订单。配置通过现有外观草稿、校验、发布和回滚接口管理，不改变鉴权。

```json
{"id":"orders","title":"我的订单","hideTitle":true,"blocks":[{"id":"content","type":"module","module":"orders","orders":{"period":"this_week"}}]}
```

待支付模块支持 `pendingOne`、`pendingMany`、`pendingEmpty`，每项最多 120 字符，`{count}` 替换为真实返回笔数。配置 pendingOne 后启用组件状态标题，页面设置 hideTitle 避免重复。加载、错误及未登录状态不会显示虚假的待支付笔数。

```json
{"id":"payment","title":"待支付订单","hideTitle":true,"blocks":[{"id":"content","type":"module","module":"payment","orders":{"period":"all","pendingOne":"您还有一个订单未支付","pendingMany":"您还有{count}个订单未支付","pendingEmpty":"暂无待支付订单"}}]}
```

空订单入口通过 `orders.emptyAction` 配置标准 PageLink（page/action/question），独立订单页与聊天空订单卡共用其按钮文案及目标。客户商城使用本项目已注册的 action ID，地址在动作配置中维护；不能引用其他项目动作或在模块里注入任意 URL。description、emptyRetry 只作用于独立订单页；聊天卡保留 ZIP 的“查询最近订单”辅助入口。`emptyRetry` 省略时保留“继续查询订单”，设为 false 可按 ZIP 隐藏；`loginNote` 是最多 400 字的登录说明。旧配置仍兼容。

```json
{"period":"this_week","emptyAction":{"label":"去商城购买",
 "description":"跳转云顶原商城",
 "target":{"type":"action","value":"本项目商城动作ID"}},
 "emptyRetry":false,"loginNote":"登录使用客户平台账号，成功后返回继续查询。"}
```

上面对象放入订单模块的 orders 字段，随完整外观草稿发布。通用预设缺少客户商城地址时使用 page/recommend 并显示“查看可选产品”，不能宣称已跳转原商城。Mock 商城动作由示例 actions.json 提供；真实交付时替换该动作的目标 URL，保持 ID 与页面配置一致。动作继续经过平台 `/go/{actionId}` 解析；原生小程序映射仍需后续的已验证目标解析与宿主桥，不把 HTTP 重定向视为原生导航已完成。

本周范围由服务端按业务时区计算，不接受租户配置中的脚本、身份或客户接口 URL。布局管理器负责位置，查询控制器负责时间和响应生命周期，OrdersPanel 负责显示，宿主管理器负责打开经过 HTTPS 校验的客户地址。


## 行程模块配置（ZIP 05）

trip-start、trip、products 三个 module 可增加 trip 对象。只有平台注册的组件消费配置，不接受 HTML、脚本或可执行回调。旧配置省略此对象仍可使用。

```json
{"id":"content","type":"module","module":"trip","trip":{
  "intro":"补充以下信息，云灵会据此安排行程。",
  "cardTitle":"你的出行安排","peoplePlaceholder":"成人与儿童人数",
  "budgetPlaceholder":"补充你的偏好","requireConfirmation":true,
  "note":"也可以直接说：我们两位成人，第一次滑雪，希望安排课程，预算适中。"
}}
```

intro/note 最多 400 字，cardTitle/peoplePlaceholder/budgetPlaceholder 最多 80 字。requireConfirmation 仅适用于 trip；开启后，日期、人数及预算住宿必须经用户确认才可生成建议。取消或校验不通过不提交草稿；确认状态与出行草稿在当前客服运行时内保留，刷新不恢复个人信息。AI 面板预填的明确日期/天数、成人/儿童人数、预算/住宿分别可作为已提供条件，未提供部分仍需确认。

trip-start 可设置 prompt（最多 160 字），其中 {duration} 只替换成当前天数说明。该蓝色气泡是页面配置的行程示例，不创建聊天消息、不触发 AI 或业务请求。入口卡标题由 cardTitle 配置。

products 可设置 intro 和 categoryLabels，例如 {"tickets":"滑雪票务","stay":"住滑套餐"}。标签键限六种业务分类，值为 1–80 字；分类来自客户 Product.category，缺少时使用通用标题。显示标题不改变查询、价格或 SKU；预订仍由共享控制器、承接页与 HostManager 完成。


## 现场服务展示配置

`module: "onsite"` 的区块可选 `onsite` 对象，仅控制展示文案。`prompt` 最多 160 字（静态提问示例，不产生聊天消息或 AI 请求）；`assistantLabel`、`liftTitle`、`nearbyLiftTitle`、`merchantTitle`、`nearbyMerchantTitle` 各最多 80 字；`intro`、`nearbyIntro` 各最多 400 字。其他模块不能携带 onsite 配置，未知属性拒绝发布。

```json
{"id":"content","type":"module","module":"onsite","onsite":{"prompt":"缆车停运了吗？最近的餐厅在哪里？","assistantLabel":"云灵 · AI助手","intro":"可以查看缆车和餐厅信息，查看详情或导航前往。","nearbyIntro":"为你找到最近的缆车和附近餐厅，可以查看详情或导航前往。","liftTitle":"缆车信息","nearbyLiftTitle":"离你最近的缆车","merchantTitle":"园区餐饮","nearbyMerchantTitle":"附近的餐厅"}}
```

页面使用 titleStyle=plain。只有接口明确返回对应 nearestLiftId / nearestId 才显示附近标题，两者都有才使用 nearbyIntro。聊天中的现场服务回复复用此页面的卡片配置，省略静态提问和引导说明。没有配置的旧页面仍可使用。文案配置不能替代位置、运营状态或距离等业务事实。


### 记忆与隐私展示文案

`privacy` 业务模块可带 `privacy` 配置，省略时兼容原有文案：

```json
{"id":"privacy","type":"module","module":"privacy","privacy":{"serviceDescription":"云灵为 AI 助手，动态信息与交易结果以云顶正式页面为准。"}}
```

`memoryTitle`、`managementTitle`、`serviceTitle` 最多 80 字；`intro`、`memoryDescription`、`serviceDescription` 最多 400 字。只按普通文本渲染，不能放入脚本、HTML、接口地址或用户授权状态。未知字段、错误类型、超长值及用于其他模块的配置会被拒绝。完整配置仍通过项目外观草稿 API 保存并显式发布，携带当前 revision；更新默认模板不会覆盖既有租户。

此配置不更改长期记忆的启用状态、内容、版本或保存/删除行为。授权说明、关闭和删除提示保持平台真实规则；用户状态仍从平台 `/api/public/memory` 读取。客户无需新增业务接口。
