设计对话中的卡片
概述
豆包应用插件卡片是相关服务在豆包对话流中的主要呈现形式。当用户提出需求时,豆包会调用相关服务,并通过卡片在对话中呈现结果。
由于卡片始终处于对话上下文中,其设计方式不同于独立 App 页面,既要高效承载服务所需的信息与操作,也要保持对话的连续性。

设计对话流中的卡片,必须使用豆包提供的模板,否则将导致审核不通过。模板是样式固定的一系列卡片,模板内的元素样式仅支持选择,不支持自定义修改,你可以根据业务需要选择适合的模板,填充合适的内容,
模板中的字体、颜色、间距和圆角等视觉样式由平台统一渲染,使不同服务的卡片在同一对话流中保持一致,并降低用户的理解与操作成本。使用设计系统还可自动适配深色模式,并有助于应用快速通过审核。
设计原则
01 内容优先
文本始终是 AI 对话最轻量、最高效的信息载体。能通过一句话表达清楚的信息,应优先使用文本,而不是卡片。
只有当内容具有结构化、可比较或可操作的特征时,才升级为卡片。
02 按用户意图选择形态
先理解用户希望完成什么,再选择合适的模板。当现有组件无法满足需求时,可通过开发者平台提交反馈。
03 单一焦点
一张卡片,只解决一个问题。每个卡片只保留一个主要操作,其他操作应弱化或拆分。
04 单一跳转
卡片中,不含按钮的每个 cell 仅支持一个点击事件,如果需要多个操作,应通过按钮明确表达,避免让用户猜测哪些区域可以点击。
05 克制表达
卡片不是页面,应控制信息密度,仅展示完成当前任务所需的信息。
超过容量时,应隐藏、裁剪或拆分,而不是继续堆叠,减少无意义的视觉装饰,突出内容本身。
06 遵循平台规范
统一使用:平台字体、平台色彩、平台组件,保持整个产品体验的一致性,避免为了局部视觉效果而破坏整体风格。
全局约束
以下规范属于强约束(Must),所有卡片均需遵守。
01 卡片尺寸
卡片宽度在气泡中自适应充满,在大屏幕设备中最大宽度 400dp,最大高度不超过 500dp。
超过高度限制时,应通过:限制展示内容、拆分卡片、跳转完整页面解决

02 内容边界
所有内容必须完整展示于卡片内部,任何情况下都不得突破卡片边界。
所有卡片的头部需要展示 haeder,说明服务来源。

03 每张卡片仅表达一个主题
每张卡片仅表达一个主题,例如“推荐酒店”。
禁止:一张卡片同时承载多个主题,例如:酒店 + 音乐 + 天气。

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

05 遵循平台规范
卡片统一使用平台系统字体,禁止使用自定义字体、艺术字体、品牌字体。
所有颜色均遵循豆包 Design Token,避免自定义渐变、强品牌色、高饱和装饰色。
模板卡型
信息卡(ContentCard)
信息卡是一张作用灵活的卡片,用于展示单项或多项信息,由图片区、信息区和操作区组成,你可以选择隐藏不需要的内容,适用于商品、服务或内容入口等场景。
结构
-
每个条目可包含图片(可选)、信息区和操作按钮。
- 信息区是一个最多展示 3 行的插槽,你可以在通用原子组件中选择要插入插槽的内容。
- 同样,豆包支持多种操作按钮
-
展示多个条目时,可配置底部按钮,通常用于“查看更多”。
通用原子组件
豆包设计系统提供多种通用原子组件,可在规范范围内组合使用(如内容卡的信息区域)。平台原生组件可减少对加载态、失效状态和深色模式的单独适配工作。
样例

价格操作卡(PriceActionCard)
用于展示单项或多项价格信息及相应操作,适用于报价、权益或服务方案等场景。
结构
- 每个条目包含价格、信息字段和按钮;价格可带辅助信息,信息字段仅支持灰色的纯文字,最多展示 3 行。
- 可配置底部按钮,通常用于“查看更多”。
样例

交通列表卡(TransitCard)
用于展示机票、火车票等交通班次信息,重点呈现出发与到达时间、站点、中转、时长及价格。
结构
- 样式固定,价格非必须展示,每个条目由行程信息和价格组成。
样例

确认订单卡(CheckoutCard)
用于展示商品或服务订单,支持用户在交易前核对订单与费用信息并完成确认操作。
结构
- 支持展示一项或多项商品或交易信息。
- 样式固定,支持展示多条订单信息及费用明细;每条订单信息最多展示 2 行,不支持单独的点击。
- 底部可配置主按钮和次按钮。
样例

问询卡(AskHumanCard)
用于在豆包回答气泡内展示一组可操作选项,引导用户补充信息、作出选择或继续流程。
结构
- 样式固定,支持 1~4 个选项,每个选项占据一行,整行均可点击。
样例

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