x-components

name: x-components version: 2.8.0 description: 使用 @ant-design/x 组件库构建 AI 对话 UI 时使用 —— 涵盖 Bubble、Sender、Conversations、Prompts、ThoughtChain、Actions、Welcome、Attachments、Sources、Suggestion、Think、FileCard、CodeHighlighter、Mermaid、Folder、XProvider 和 Notification。

🎯 Skill 定位

本 Skill 覆盖 @ant-design/x 中所有 UI 组件 —— 这是一个基于 RICH 交互范式，用于构建 AI 驱动对话界面的 React 组件库。

涵盖组件选型、API 使用、组合模式及常见反模式。

前提说明：本 Skill 仅处理 UI 层。数据流和流式处理请参考 use-x-chat、x-chat-provider、x-request Skill。

目录

• 📦 包概述
• 🗂️ 组件分组
• 🚀 快速选型指南
• 🛠 推荐工作流
• 🚨 开发规则
• 🤝 Skill 协作
• 🔗 参考资源

📦 包概述

npm install @ant-design/x

@ant-design/x 扩展了 antd。如果你已经在用 ConfigProvider，请将其替换为 XProvider。

🗂️ 组件分组

基于 RICH 交互范式：

🚀 快速选型指南

🛠 推荐工作流

1. 从 COMPONENTS.md 为每个交互阶段选择对应组件。
2. 使用 PATTERNS.md 了解组件如何组合成完整页面。
3. 在应用根节点用 XProvider 包裹（替代 antd 的 ConfigProvider），配置国际化、主题和快捷键。
4. 使用 API.md 确认精确的属性名 —— 不要靠猜测。

最小完整示例

import { XProvider, Welcome, Prompts, Bubble, Sender } from '@ant-design/x';

export default () => (
  <XProvider>
    <Welcome title="你好！" description="有什么可以帮助你的？" />
    <Prompts
      items={[{ key: '1', label: '你能做什么？' }]}
      onItemClick={(info) => console.log(info.data.label)}
    />
    <Bubble.List items={[{ key: '1', content: 'Hello World', placement: 'end' }]} />
    <Sender onSubmit={(msg) => console.log(msg)} />
  </XProvider>
);

🚨 开发规则

• 始终在应用根节点使用 XProvider —— 它替代了 antd 的 ConfigProvider，并启用国际化、方向以及 x 专属快捷键。
• 在循环中用 Bubble.List 而非 Bubble —— Bubble.List 处理滚动锚定、自动滚动和基于角色的布局；手动 map Bubble 会丢失这些能力。
• 保持 Bubble 和 Bubble.List 的 components 属性稳定 —— 内联对象创建会导致重渲染并重置打字动画。
• 流式期间设置 streaming={true}，最终 chunk 时设置 streaming={false} —— 永久保持 true 会破坏完成状态。
• ThoughtChain vs Think：多步工具/Agent 调用链用 ThoughtChain；单块可折叠的推理展示用 Think。
• Actions.Copy、Actions.Feedback、Actions.Audio 是预设子组件 —— 优先使用它们，不要自己重新实现。
• Sender 的 onSubmit vs onChange：onSubmit 在发送按钮或 Enter 键时触发；onChange 在每次按键时触发 —— 不要混淆。
• 不要在 Bubble 的 content 字符串中直接渲染 Mermaid 或 CodeHighlighter —— 请使用 contentRender 或 components 映射。

🤝 Skill 协作

🔗 参考资源

• COMPONENTS.md —— 逐组件指南，包含使用方法、核心属性和示例
• PATTERNS.md —— 完整页面组合模式和集成方案
• API.md —— 从官方组件文档自动生成的属性参考，覆盖全部 17 个组件

官方文档

• Ant Design X 概览
• Bubble
• Sender
• Conversations
• ThoughtChain
• Actions
• Welcome
• Prompts
• Attachments
• Sources
• Suggestion
• Think
• Folder
• XProvider