UI Design System
build dev

Welcome

展示会话空状态、能力和起始任务。中文惯用名:欢迎页。
稳定本期新增已接入

元信息

字段值
规范 IDcomponent.welcome
名称Welcome
二级分类AI 与会话(ai-chat)
用途展示会话空状态、能力和起始任务
描述中文惯用名:欢迎页。

预览

静态结构:居中 hero(主色大图标 + text-xl 主标题 + muted 副标题)+ 起始任务卡片栅格(grid-cols-1 sm:grid-cols-2,复用 Prompt);点击卡片经 onSelect 传出 value。

DSL 结构

DslNode
{
  "type": "Welcome",
  "props": {
    "title": "有什么可以帮你?",
    "description": "我可以分析数据、生成报表与起草文案",
    "prompts": [
      {
        "title": "生成月报",
        "icon": "chart",
        "value": "generate-monthly-report"
      },
      {
        "title": "总结会议纪要",
        "icon": "file"
      }
    ]
  }
}

何时用

何时使用

  • 展示会话空状态、能力和起始任务:新会话落地页。

何时不用

  • 非会话空状态:使用 Empty / Result。

变体

变体视觉形态适用场景
默认图标 + 标题 + 副标题通用空状态
带起始任务2 列 Prompt 栅格引导首次任务

API 属性

属性类型默认值说明
titlestring有什么可以帮你?主标题
descriptionstring—副标题(能力说明)
iconstring'chat'主图标名(Icon 白名单)
promptsWelcomePromptItem[][]起始任务:{ title, description?, icon?, value? }
onSelectevent—起始任务选择事件(${event})
className / stylestring / CSSProperties—通用:根节点 class 合并 / 内联样式

使用规范

  • 起始任务 2~4 个,选最能体现能力的场景。

正例

  • ✓ 新会话页:Welcome + 4 个起始任务,点击即发起首轮提问。

反例

  • ✕ 在消息流中间插入 Welcome(仅用于空状态)。

Design Token 映射

不适用:组件 tokenRefs 为空:样式 Token 数据尚未接入,三层映射(Primitive → Semantic → Component)待样式 Token 接入后回填。