> 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.

# 设计对话中的卡片

## 概述

豆包应用插件卡片是相关服务在豆包对话流中的主要呈现形式。当用户提出需求时，豆包会调用相关服务，并通过卡片在对话中呈现结果。

由于卡片始终处于对话上下文中，其设计方式不同于独立 App 页面，既要高效承载服务所需的信息与操作，也要保持对话的连续性。

![卡片在不同设备上的展示效果](//lf-flow-web-cdn.doubao.com/obj/flow-doubao/goofy_deploy_edenx/flow/doubao-apps--plugin-doc/static/image/card-design-device-previews.70212301d6.png)
**设计对话流中的卡片，必须使用豆包提供的模板，否则将导致审核不通过**。模板是样式固定的一系列卡片，模板内的元素样式仅支持选择，不支持自定义修改，你可以根据业务需要选择适合的模板，填充合适的内容，

模板中的字体、颜色、间距和圆角等视觉样式由平台统一渲染，使不同服务的卡片在同一对话流中保持一致，并降低用户的理解与操作成本。使用设计系统还可自动适配深色模式，并有助于应用快速通过审核。


## 设计原则

**01 内容优先**

文本始终是 AI 对话最轻量、最高效的信息载体。能通过一句话表达清楚的信息，应优先使用文本，而不是卡片。

只有当内容具有结构化、可比较或可操作的特征时，才升级为卡片。

| **✅ 推荐**            | **❌ 避免**    |
| ------------------- | ----------- |
| 查询订单、商品推荐、推荐音乐、查看路线 | 为了丰富视觉而使用卡片 |

**02 按用户意图选择形态**

先理解用户希望完成什么，再选择合适的模板。当现有组件无法满足需求时，可通过开发者平台提交反馈。

| **✅ 推荐**    | **❌ 避免**   |
| ----------- | ---------- |
| 从用户任务出发选择模板 | 根据已有模板硬塞内容 |

**03 单一焦点**

一张卡片，只解决一个问题。每个卡片只保留一个主要操作，其他操作应弱化或拆分。

| **✅ 推荐**             | **❌ 避免**   |
| -------------------- | ---------- |
| 每张卡 / 弹窗 / 区块只有一个主按钮 | 多个主按钮竞争注意力 |

**04 单一跳转**

卡片中，不含按钮的每个 cell 仅支持一个点击事件，如果需要多个操作，应通过按钮明确表达，避免让用户猜测哪些区域可以点击。

| **✅ 推荐**            | **❌ 避免**                 |
| ------------------- | ------------------------ |
| 标题配箭头，作为 cell 的跳转入口 | 看起来能点的地方点不动，看不出能点的地方藏着链接 |

**05 克制表达**

卡片不是页面，应控制信息密度，仅展示完成当前任务所需的信息。

超过容量时，应隐藏、裁剪或拆分，而不是继续堆叠，减少无意义的视觉装饰，突出内容本身。

| **✅ 推荐**               | **❌ 避免**          |
| ---------------------- | ----------------- |
| 超出容量时，裁剪、拆分或提供「查看更多」入口 | 为了展示更多内容，不断增加卡片高度 |

**06 遵循平台规范**

统一使用：平台字体、平台色彩、平台组件，保持整个产品体验的一致性，避免为了局部视觉效果而破坏整体风格。

| **✅ 推荐**                  | **❌ 避免**      |
| ------------------------- | ------------- |
| 使用平台字体、Design Token 和通用组件 | 自定义字体、颜色或组件样式 |

## 全局约束

以下规范属于强约束（Must），所有卡片均需遵守。

**01 卡片尺寸**

卡片宽度在气泡中自适应充满，在大屏幕设备中最大宽度 **400dp，最大高度不超过 500dp。**

超过高度限制时，应通过：限制展示内容、拆分卡片、跳转完整页面解决

![卡片尺寸规范示例](//lf-flow-web-cdn.doubao.com/obj/flow-doubao/goofy_deploy_edenx/flow/doubao-apps--plugin-doc/static/image/card-design-size-guidelines.3102b07ce5.png)
**02 内容边界**

所有内容必须完整展示于卡片内部，任何情况下都不得突破卡片边界。

所有卡片的头部需要展示 haeder，说明服务来源。

![卡片内容边界正误示例](//lf-flow-web-cdn.doubao.com/obj/flow-doubao/goofy_deploy_edenx/flow/doubao-apps--plugin-doc/static/image/card-design-content-boundaries.70e49d07f7.png)
**03 每张卡片仅表达一个主题**

每张卡片仅表达一个主题，例如“推荐酒店”。

禁止：一张卡片同时承载多个主题，例如：酒店 + 音乐 + 天气。

![单一主题卡片正误示例](//lf-flow-web-cdn.doubao.com/obj/flow-doubao/goofy_deploy_edenx/flow/doubao-apps--plugin-doc/static/image/card-design-single-topic.d37a64865d.png)
**04 不支持自动刷新**

卡片内容不会自动更新，因此不建议在卡片中展示会随时间变化的信息，例如商品物流状态、实时库存等，避免用户回看历史卡片时产生误解。

![卡片状态展示正误示例](//lf-flow-web-cdn.doubao.com/obj/flow-doubao/goofy_deploy_edenx/flow/doubao-apps--plugin-doc/static/image/card-design-status-display.5f35f529da.png)
**05 遵循平台规范**

卡片统一使用平台系统字体，禁止使用自定义字体、艺术字体、品牌字体。

所有颜色均遵循豆包 Design Token，避免自定义渐变、强品牌色、高饱和装饰色。

## 模板卡型

### 信息卡（ContentCard）

信息卡是一张作用灵活的卡片，用于展示单项或多项信息，由图片区、信息区和操作区组成，你可以选择隐藏不需要的内容，适用于商品、服务或内容入口等场景。

[查看信息卡模板用法](/apps-plugin/docs/templates/content-card.md)

**结构**

- 每个条目可包含图片（可选）、信息区和操作按钮。

  - 信息区是一个最多展示 3 行的插槽，你可以在通用原子组件中选择要插入插槽的内容。
  - 同样，豆包支持多种操作按钮

- 展示多个条目时，可配置底部按钮，通常用于“查看更多”。

**通用原子组件**

豆包设计系统提供多种通用原子组件，可在规范范围内组合使用（如内容卡的信息区域）。平台原生组件可减少对加载态、失效状态和深色模式的单独适配工作。


**样例**

![信息卡样例](//lf-flow-web-cdn.doubao.com/obj/flow-doubao/goofy_deploy_edenx/flow/doubao-apps--plugin-doc/static/image/card-design-content-card.a12dd0e057.png)
### 价格操作卡（PriceActionCard）

用于展示单项或多项价格信息及相应操作，适用于报价、权益或服务方案等场景。

**结构**

- 每个条目包含价格、信息字段和按钮；价格可带辅助信息，信息字段仅支持灰色的纯文字，最多展示 3 行。
- 可配置底部按钮，通常用于“查看更多”。

**样例**

![价格操作卡样例](//lf-flow-web-cdn.doubao.com/obj/flow-doubao/goofy_deploy_edenx/flow/doubao-apps--plugin-doc/static/image/card-design-price-action-card.61740c015c.png)
### 交通列表卡（TransitCard）

用于展示机票、火车票等交通班次信息，重点呈现出发与到达时间、站点、中转、时长及价格。

**结构**

- 样式固定，价格非必须展示，每个条目由行程信息和价格组成。

**样例**

![交通列表卡样例](//lf-flow-web-cdn.doubao.com/obj/flow-doubao/goofy_deploy_edenx/flow/doubao-apps--plugin-doc/static/image/card-design-transit-card.18e4110fae.png)
### 确认订单卡（CheckoutCard）

用于展示商品或服务订单，支持用户在交易前核对订单与费用信息并完成确认操作。

**结构**

- 支持展示一项或多项商品或交易信息。
- 样式固定，支持展示多条订单信息及费用明细；每条订单信息最多展示 2 行，不支持单独的点击。
- 底部可配置主按钮和次按钮。

**样例**

![确认订单卡样例](//lf-flow-web-cdn.doubao.com/obj/flow-doubao/goofy_deploy_edenx/flow/doubao-apps--plugin-doc/static/image/card-design-checkout-card.44c5d57b87.png)
### 问询卡（AskHumanCard）

用于在豆包回答气泡内展示一组可操作选项，引导用户补充信息、作出选择或继续流程。

**结构**

- 样式固定，支持 1～4 个选项，每个选项占据一行，整行均可点击。

**样例**

![问询卡样例](//lf-flow-web-cdn.doubao.com/obj/flow-doubao/goofy_deploy_edenx/flow/doubao-apps--plugin-doc/static/image/card-design-ask-human-card.c1ee93f86d.png)
## 规范未覆盖的场景

卡型与组件将持续完善。若现有能力无法覆盖业务场景，可通过开发者平台提交反馈。我们将结合场景通用性、用户价值和实现成本，评估后续支持方案。
