SuperAPI AI 工具集

x-chat-provider

智能体与模型

查看项目

更新于 10-15 18:46

技能介绍

用途:本技能只解决一个问题——如何把任意流式接口快速适配成 Antdv Next X 的 Chat Provider,用于私有 API 或非标准格式接口;不涉及 useXChat 使用教程。

技术栈:UI 层 @antdv-next/x(Vue 3 组件库),逻辑层 @antdv-next/x-sdk(Provider、Hook、XRequest),渲染层 @antdv-next/x-markdown。需从正确包导入:AbstractChatProvider、XRequest 来自 @antdv-next/x-sdk。SDK 版本要求 ≥0.0.1。

主要能力:通过继承 AbstractChatProvider 实现类型安全的适配,把原始接口的请求参数与流式响应转换为标准消息格式。

使用方式(四步):1)分析接口格式,确认 URL、请求方法、请求与响应格式、鉴权方式;2)创建 Provider 类,只改三处——接口类型、类名、响应转换逻辑;需实现 transformParams(参数转换)、transformLocalMessage(本地用户消息)、transformMessage(响应数据转换,处理结束标记与内容累加);3)检查校验:运行 npx tsc --noEmit MyChatProvider.ts 确认无类型错误;4)配置使用:用 XRequest 创建请求实例并传入 Provider。

限制与强制规则:严禁在 Provider 中实现 request 方法,所有网络请求必须交由 XRequest 处理,Provider 只负责数据转换。类型检查通过、清理未使用导出;除非用户明确要求,不添加测试文件。若为标准 OpenAI 或 DeepSeek API,可直接使用内置 Provider,无需自定义。已提供的方法签名、请求配置与安装命令需按原文保持,其余细节暂未提供。