SuperAPI AI 工具集

x-components

前端与建站

查看项目

更新于 10-15 16:49

技能介绍

用途:本技能覆盖 @ant-design/x 中用于构建 AI 聊天界面的全部 React UI 组件,基于 RICH 交互范式,涉及组件选型、API 使用、组合模式与常见反模式。仅处理 UI;数据流与流式处理需参考 use-x-chat、x-chat-provider、x-request 等技能。安装:npm install @ant-design/x。@ant-design/x 扩展 antd,若使用 ConfigProvider,应替换为 XProvider。

组件分组:通用(Bubble、Bubble.List、Conversations、Notification);唤醒(Welcome、Prompts);表达(Sender、Attachments、Suggestion);确认(Think、ThoughtChain);反馈(Actions、FileCard、Sources、CodeHighlighter、Mermaid、Folder);全局(XProvider)。

选型指引:渲染消息气泡看 Bubble;构建输入框看 Sender;会话列表与切换看 Conversations;展示思考过程看 ThoughtChain/Think;消息下方操作按钮看 Actions;欢迎/引导页看 Welcome + Prompts;输入中附件看 Attachments;来源引用看 Sources;快捷命令建议看 Suggestion;层级文件树看 Folder;完整聊天页配置看 PATTERNS.md;具体 prop 查 API.md。

工作流:按交互阶段从 COMPONENTS.md 选组件,用 PATTERNS.md 了解整页组合,用 XProvider 包裹应用根节点以配置语言、主题与快捷键,用 API.md 确认 prop 名称,不要猜测。

开发规则:应用根节点始终使用 XProvider,它取代 antd 的 ConfigProvider;循环中应使用 Bubble.List 而非 Bubble,否则会丢失滚动锚定、自动滚动与基于角色的布局;保持 Bubble 与 Bubble.List 的 components prop 引用稳定,内联对象会导致重渲染并重置打字动画;流式期间设置 streaming={true},最后一块设置 streaming={false},长期保持 true 会破坏完成状态;ThoughtChain 用于多步工具/智能体调用链,Think 用于可折叠的单块推理展示;优先使用 Actions.Copy、Actions.Feedback、Actions.Audio 预设子组件;Sender 的 onSubmit 在发送按钮或回车时触发,onChange 在每次按键时触发,不可混用;不要在 Bubble 的 content 字符串中渲染 Mermaid 或 CodeHighlighter,应使用 contentRender 或 components 映射。

参考资源:COMPONENTS.md(逐组件指南)、PATTERNS.md(整页组合模式)、API.md(覆盖全部 17 个组件的自动生成 prop 参考)。适用场景包括完整 AI 聊天应用、仅构建 UI 结构、气泡回复中的 Markdown 渲染、仅流式数据流等,具体技能组合见协作说明。暂未提供的功能、收费、价格与平台信息未在资料中说明。