SuperAPI AI 工具集

use-x-chat

通用与其它

查看项目

更新于 10-16 03:13

技能介绍

用途:useXChat 用于在 React 中构建专业 AI 对话应用,前提是已有 Chat Provider(自定义或内置),自定义 Provider 可参考 x-chat-provider。

主要能力:管理 MessageInfo 消息列表(内容在 msg.message,含 id、status、extraInfo),提供 onRequest 发起请求、abort 中断、isRequesting 请求状态、onReload 重新生成、setMessages/setMessage/removeMessage 直接修改消息、queueRequest 在会话初始化后延迟发送;支持 requestPlaceholder 占位、requestFallback 处理网络错误与 AbortError、parser 转换消息、defaultMessages 异步默认消息。多会话由 useXConversations 配合,返回 conversations、activeConversationKey、setActiveConversationKey、addConversation、removeConversation、getConversation、getMessages 等,用于列表管理与跨组件读取消息。

使用方式:安装 npm install @ant-design/x-sdk@latest @ant-design/x@latest,要求 @ant-design/x-sdk 2.2.2+。Provider 的 XRequest 必须传 manual: true。调用 useXChat({ provider, conversationKey, defaultMessages, requestPlaceholder, requestFallback }) 获取返回值;messages 为 MessageInfo<ChatMessage>[],需映射为 { key, role, content, loading } 后传 Bubble.List,role 用 role 而非 roles;复杂 ChatMessage 用 contentRender 渲染。多会话中每个会话需独立 Provider 实例,避免状态混淆。

限制与规则:使用前确认已有 Provider、manual: true、理解 MessageInfo 结构。用户未明确需要时不要添加测试文件;完成后运行 tsc --noEmit 检查类型,清除未使用变量与导入。