> For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt.

# 茶饮/餐饮行业示例

:::info 提示

本文是外卖 / 即时零售行业的**场景化模板用法示例**，用于帮助餐饮、咖啡茶饮、即时零售类开发者快速理解：在豆包对话中，不同点单环节该选用哪个卡片模板、如何配置。**注意：本文不是完整的 PRD 文档**，仅覆盖典型场景下的模板选型与配置建议，实际接入时请结合自身业务字段与「卡片模板说明」中的完整属性表设计。


:::

## 一、整体思路

一次完整的外卖点单，通常会经历「问吃什么 → 挑商品 → 确认下单 → 售后（追踪 / 取消）」的链路。用户的每一句话都对应一个业务环节，而每个环节都有最合适的卡片模板来承载。开发者要做的，就是**按场景选模板，再按业务把字段填进去**。

外卖场景的一大特点是「意图跨度大」：既有「附近有什么好喝的」这类模糊探索，也有「点一杯生椰拿铁送到公司」这类一句话直达下单。选型时要先判断用户处在链路的哪一步，再决定用推荐类卡还是订单类卡。所有模板均来自 `@doubao-dev/template`，选型与属性细节请以「卡片模板说明」为准。

### 场景与模板速查

| 业务环节         | 典型 Query                | 推荐模板                 |
| ------------ | ----------------------- | -------------------- |
| 模糊推荐 / 条件搜索  | 「附近有什么好喝的咖啡外卖？」         | 信息卡 - ContentCard    |
| 门店选择         | 「在 BrewNow 中关村那家店买杯拿铁？」 |                      |
| 一句话下单 / 历史复购 | 「点一杯生椰拿铁送到公司」           | 确认订单卡 - CheckoutCard |
| 订单追踪 / 取消结果  | 「我的外卖到哪了？」              | 信息卡 - ContentCard    |
| 需用户主动选择 / 确认 | 「要不要改成自取？」              | 问询卡 - AskHumanCard   |

## 二、分场景用法说明

### 场景 1：模糊推荐 / 条件搜索 —— 信息卡 ContentCard

**适用**：用户没有明确商品，而是问「最近有什么新品」「附近有什么好喝的美式」「30 块以内推荐几款」这类探索型需求，需要以「商品 / 门店 + 关键信息」的列表形式给出推荐，并支持直接进入下单。

**推荐用法**:

- 用 `ContentCard` 的列表能力，每条对应一个推荐商品或门店。
- `thumbnail` 传商品图片；`title` 传商品名，`subtitle` 传规格、价格、门店距离等关键信息（可分行）。
- 列表项右侧 `action` 配「下单」按钮（`{ type: 'button' }`），点击用 `sendMessage` 让模型直接推进下单（如「要这款」），把「推荐 → 下单」在一张卡内闭环。
- 条件搜索结果建议在服务端做好分组或排序（如「便宜快送 / 精品好喝」），再用多条列表项呈现，避免一次给太多。
- 标题栏「查看更多」可保留，点击跳转应用插件完整列表页承接更细的筛选。


<img alt="图片展示的是BrewNow饮品推荐界面。上方显示“BrewNow最近有什么新品”，下方文字介绍2026年5月新品，含价格、口味、值不值得点等信息，如冰美式10 - 15元，新用户有券，配送超快。列表项右侧有“下单”按钮，点击可推进下单。图片下方还有“进店”“深度思考”“深入研究”“AI生图”“拍题”等功能选项。该图与文档中“模糊推荐/条件搜索——信息卡ContentCard”场景下，列表项右侧“下单”按钮点击用sendMessage推进下单的内容相关。" src={image0} />

### 场景 2：门店选择 —— 信息卡 ContentCard

**适用**：用户指定了商品或品牌，但同一品牌附近有多家门店（如「在 BrewNow 中关村那家店买杯拿铁」「附近哪家 BrewNow 还在营业」），需要先让用户在若干候选门店里挑一家，再进入下单。此环节把「门店 + 关键信息」以列表形式给出，并支持一键锁定门店继续下单。

**推荐用法**:

- 用 `ContentCard` 的 `items` 承载候选门店，每条对应一家店：`title` 传门店名，`subtitle` 传距离、营业时间、地址等关键信息（可分行）；`thumbnail` 可传门店 / 品牌图标。
- 列表项右侧 `action` 配「选这家」按钮，点击用 `sendMessage` 回传选中门店（如「就选这家」），让模型锁定门店并推进到确认订单卡。
- 门店较多时，用 `header.actionText` 配「更多门店」，点击 `openFullPage` 跳转应用插件完整门店列表页承接更细筛选。
- 门店列表数据更新频繁，务必用门店 ID 作 `key`，不要用数组下标，避免选择错位。
- 建议服务端按距离排序，优先展示最近且在营业的门店，减少用户比对成本。


<img alt="图片展示的是茶饮/餐饮行业门店选择场景中信息卡ContentCard的示例界面。界面显示“豆包”品牌，时间为9:41，有信号、Wi - Fi图标及电池电量显示。上方有“帮我下单一杯杨浦 BrewNow 的冰美式，自提”的蓝色输入框。下方列出杨浦多家BrewNow门店，如保辉国际大厦店、国华国际广场店、君庭广场店等，每家门店显示距离、营业时间及地址，右侧有“选这家”按钮。此图与上下文介绍的门店选择用法说明相契合，直观呈现了门店信息展示及用户操作选择的场景。" src={image1} />

### 场景 3：一句话下单 / 历史复购 —— 确认订单卡 CheckoutCard

**适用**：交易前的核对环节，包括**一句话下单**（「点一杯生椰拿铁送到公司」）、**基于历史记忆复购**（「昨天那杯再来一杯」）。这些环节都需要展示商品 + 提单信息 + 费用明细 + 支付按钮，统一用 `CheckoutCard`。

**推荐用法**:

- `productItems` 配置商品：单杯用 1 条，多杯 / 代购用多条，每条复用商品摘要字段（`title`、`spec`、`imageSrc`、`price`、`quantity` 等），`spec` 里写「大杯 / 少糖 / 去冰」这类规格。
- `infoItems` 配置提单信息：收货地址、预计送达时间、配送 / 自取方式等。
- 费用区用 `feeItems` / `discountText` / `totalPrice` 展开明细：商品优惠、运费、打包费、合计。
- 底部 `footer.primaryActionButton` 定义「立即支付」→ 打开收银台；`footer.secondaryActionButton` 定义「修改」→ 跳转应用插件订单编辑全页。
- 历史复购场景直接复用历史订单的商品与规格填充 `productItems`，减少用户确认成本。


<img alt="这张图片展示的是茶饮/餐饮行业历史复购场景下的确认订单卡界面，对应文档中提及的CheckoutCard示例。界面内的商品区复用了BrewNow咖啡历史下单的生椰拿铁商品信息，包含规格、优惠后价格、数量。费用区通过feeItems类字段展开明细，标注了共优惠、运费、打包费和合计金额。底部设置了两个核心操作按钮，蓝色的primaryActionButton为「立即支付」，作用是打开收银台，黑色的secondaryActionButton为「修改」，作用是跳转订单编辑全页，还额外显示了店铺距离及是否自取的相关提示，方便用户完成下单操作。" src={image2} />

### 场景 4：点单过程中修改 —— 确认订单卡 CheckoutCard

**适用**：用户在下单流程中临时改地址、改规格、加减商品（「把地址改成家里」「换成大杯」「再加一杯」）。此环节复用 `CheckoutCard`，以「差量更新后的新预估单」重新出卡。

**推荐用法**:

- 修改后由服务端重新试算，生成新的预估单，再用 `CheckoutCard` 渲染最新状态，让用户对照确认。
- 在 `infoItems` 中同步更新变化项（如新的配送地址、调整后的送达时间），必要时可在文案侧提示「配送费不变，预计送达调整为 35 分钟」。
- 费用明细随修改实时更新，底部仍保留「立即支付」/「修改」双按钮，保证用户可继续调整或直接支付。


<img alt="图片展示的是豆包AI在茶饮/餐饮行业点单过程中修改确认订单卡的示例。用户要求点一杯BrewNow的生椰拿铁，AI回复已选好咖啡，可直接支付或修改信息。画面中显示了BrewNow咖啡的生椰拿铁商品信息，有修改收货地址和立即支付按钮。底部提示BrewNow咖啡最近门店距离用户512米，询问是否改成自取订单。该图与上下文介绍的分场景用法说明中，点单过程中修改确认订单卡的推荐用法相契合。" src={image3} />

### 场景 5：下单信息缺失 / 追问补全 —— 确认订单卡 CheckoutCard（缺地址态）

**适用**：一句话下单时，用户想要的商品已经明确（「豆包，给我点一杯 BrewNow 的生椰拿铁」），但下单必需信息缺失——最典型的是**没有收货地址**。此时不能直接支付，需要用 CheckoutCard 先把已确认的商品与费用亮出来，再把缺失项转成「去补全」的动作，引导用户补齐后继续。

**推荐用法**:

- 商品与费用照常渲染：productItems 传已选商品：生椰拿铁、规格、数量、price；feeItems / totalPrice 展示费用明细，让用户先确认「点的是对的」。
- 把缺失信息态显式化：地址未知时，infoItems 中收货地址项留空或提示「未填写」，同时**底部主按钮从「立即支付」替换为「新增收货地址」**（footer.primaryActionButton），点击用 openFullPage 跳转应用插件地址填写页。
- 补全后回到对话继续：地址填好后由服务端重新试算，再出一张完整的 CheckoutCard（主按钮恢复为「立即支付」），形成「缺信息 → 补全 → 支付」的闭环。可叠加智能追问：若识别到附近有更近门店，可在卡片下方用文本或 AskHumanCard 追问「最近门店距离你只有 512 米，需要给你改成自取订单吗？」，把「补地址」与「改自取」两条路径都递给用户。


<img alt="这是一张茶饮行业相关的对话界面对话截图，上方是用户向名为“豆包”的助手请求购买BrewNow的生椰拿铁，中间部分显示生椰拿铁的商品信息：单价5.8元、规格为1份大杯意式冰饮，配料默认甜度、PLC吸管，下方有蓝色的“新增收货地址”按钮，同时对话栏提示“BrewNow咖啡最近门店距离你只有512米，需要给你改成自取订单吗？”，该截图对应下单信息缺失时的场景，体现了引导用户补全地址或切换自取的交互流程。" src={image4} />

### 场景 6：需要用户主动选择 / 确认 —— 问询卡 AskHumanCard

**适用**：流程推进中出现需要用户拍板的岔路口，如「附近门店更近，要不要改成自取」「有多款相近商品，选哪款」「确认取消这单吗」，用包裹在回答气泡内的 `AskHumanCard` 让用户点选。

**推荐用法**:

- `items` 配置选项列表，每项用 `text` 描述选项（如具体商品、外送 / 自取、确认 / 取消），点选后回传给模型继续推进。
- 用 `items[].showArrow`(`'left'` / `'right'` / `'none'`）控制箭头样式；可增加「跳过」「自己去应用插件选」等固定入口。
- 问询卡适合作为链路中的「岔路口」，与上面几张推荐卡、订单卡配合使用，而非承载完整信息。


<img alt="图片展示的是BrewNow咖啡饮品推荐界面。上方显示“BrewNow最近有什么新品”，下方介绍BrewNow最新新品，含价格、口味、值不值得点等信息，如小青桔美式、小青桔冰茶、龙井美式等。底部有“需要我帮你选一款吗？”的提示，以及“来杯销量最高的”“来杯咖啡因最少的”“来杯最便宜的”三个选项。该图片与上下文介绍的问询卡AskHumanCard用法相关，展示了其在饮品推荐场景中的应用。" src={image5} />

## 三、开发提示

- **一个 Widget 对应一张卡片**:`render` 直接返回模板组件。
- **列表项传稳定 key**：商品 / 门店列表数据更新频繁，务必用商品 ID 等稳定值作 `key`，不要用数组下标。
- **图片传可访问 URL**：商品图、门店 logo 放入 `src/assets` 后静态 `import` 再传入。
- **点击事件按需选型**：推进对话（下单、改点、确认）用 `sendMessage`，进入编辑 / 支付等复杂操作用 `openFullPage`。
- **推荐与下单尽量在卡内闭环**：外卖用户决策快，推荐卡列表项直接带下单入口，可显著缩短「看到 → 下单」路径。
- 本文仅示范选型与配置思路，完整属性、字段类型与代码示例请查阅 **「卡片模板说明」** 对应章节及 Widget 模板库。
