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, and this page is available as Markdown at /apps-plugin/docs/design-principles/card-design.md.

设计对话中的卡片

概述

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

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

卡片在不同设备上的展示效果

设计对话流中的卡片,必须使用豆包提供的模板,否则将导致审核不通过。模板是样式固定的一系列卡片,模板内的元素样式仅支持选择,不支持自定义修改,你可以根据业务需要选择适合的模板,填充合适的内容,

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

设计原则

01 内容优先

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

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

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

02 按用户意图选择形态

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

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

03 单一焦点

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

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

04 单一跳转

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

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

05 克制表达

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

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

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

06 遵循平台规范

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

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

全局约束

以下规范属于强约束(Must),所有卡片均需遵守。

01 卡片尺寸

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

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

卡片尺寸规范示例

02 内容边界

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

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

卡片内容边界正误示例

03 每张卡片仅表达一个主题

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

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

单一主题卡片正误示例

04 不支持自动刷新

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

卡片状态展示正误示例

05 遵循平台规范

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

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

模板卡型

信息卡(ContentCard)

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

查看信息卡模板用法

结构

  • 每个条目可包含图片(可选)、信息区和操作按钮。

    • 信息区是一个最多展示 3 行的插槽,你可以在通用原子组件中选择要插入插槽的内容。
    • 同样,豆包支持多种操作按钮
  • 展示多个条目时,可配置底部按钮,通常用于“查看更多”。

通用原子组件

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

样例

信息卡样例

价格操作卡(PriceActionCard)

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

结构

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

样例

价格操作卡样例

交通列表卡(TransitCard)

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

结构

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

样例

交通列表卡样例

确认订单卡(CheckoutCard)

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

结构

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

样例

确认订单卡样例

问询卡(AskHumanCard)

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

结构

  • 样式固定,支持 1~4 个选项,每个选项占据一行,整行均可点击。

样例

问询卡样例

规范未覆盖的场景

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