SuperAPI AI 工具集

use-x-chat

编程与开发

查看项目

更新于 10-15 17:27

技能介绍

用途:本技能聚焦讲解如何使用 useXChat Hook 构建专业 AI 对话应用,前提是已具备自定义 Chat Provider(参考 x-chat-provider 技能)或使用 OpenAI、DeepSeek 等内置 Provider。

主要能力:覆盖消息管理、请求控制、错误处理,并给出依赖管理与三步集成路径:准备 Provider、基础使用、UI 集成。示例中通过 useXChat({ provider }) 获取 messages、onRequest、isRequesting、abort;messages 类型为 Ref<MessageInfo<MessageType>[]>,需用 messages.value 访问。MessageInfo 含 id、message、status、extraInfo;状态枚举为 local、loading、updating、success、error、abort。UI 可使用 @antdv-next/x 的 Bubble.List 与 Sender 组件,并用 onSubmit 发送、onCancel 取消。

Provider 配置:推荐以 XRequest 作为默认请求方式,可设置 requestPlaceholder 在请求开始前显示占位消息、requestFallback 在失败或 AbortError 时返回兜底消息。技能内置版本检查,若 @antdv-next/x-sdk 版本不满足要求会提示并提供修复命令,例如 npm install @antdv-next/x-sdk@latest。

依赖与用法顺序:核心依赖 x-chat-provider(或内置 Provider),推荐依赖 x-request;私有 API 适配用 x-chat-provider → use-x-chat,标准 API 直接用内置 Provider,需鉴权则先 x-request。使用前需确认 Provider 来源、已安装 @antdv-next/x-sdk、理解 MessageInfo 结构、UI 组件就绪;完成后运行 tsc --noEmit 检查类型,清理未使用变量与导入,用户未明确要求时不添加测试文件。

限制:仅覆盖上述 Hook 与请求、消息、错误处理内容,API 可能随版本更新,价格、平台范围及未被资料提及的效果暂未提供。