更新记录

1.0.0(2026-08-31) 下载此版本

  • 将原 biz-uni-app 中的 aiChat 对话能力独立为插件 biz-uni-chat
  • 内置请求封装与配置中心,解除对宿主项目 api/publicConfig/ 的依赖
  • 支持 SSE 流式输出、思考过程折叠、Markdown 渲染、附件上传、智能体切换

平台兼容性

uni-app

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- - - × - - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

biz-uni-chat

AI 智能对话聊天插件(uni-app / uni_modules)。

功能特性

  • SSE 流式输出(H5 使用 fetch + ReadableStream,小程序/App 使用 enableChunked)
  • 思考过程(<think> 标签)折叠展示
  • Markdown 渲染(基于 marked)
  • 附件上传(图片自动压缩、文件/图片多选)
  • 智能体切换(依赖 uni-data-select)

依赖

依赖 类型 说明
uni-data-select uni_modules 插件 智能体下拉选择,随插件自动安装
marked npm 包 Markdown 解析,若宿主项目未安装请执行 npm install marked

使用

1. 页面跳转

uni.navigateTo({ url: '/uni_modules/biz-uni-chat/pages/aiChat/aiChat' })

2. 配置(必读)

插件默认内置以下接口,BASEURL.urlTokenPrefix 需按实际情况配置;agentsApi / sendMessageApi / uploadApi非必传,默认已使用下表默认值,仅当接口路径不同时才需覆盖:

配置项 默认值 说明
BASEURL.url '' 请求地址。H5 走同域代理可留空;小程序/App 必填完整地址
APIPrefix '' 多环境代理前缀
TokenPrefix '' 登录态存储前缀(对应 {TokenPrefix}_token{TokenPrefix}_XSRFToken
agentsApi /handler/mcp/agents 智能体列表接口(非必传)
sendMessageApi /handler/mcp/sendMessage SSE 对话接口(非必传)
uploadApi /api/doc/upload 文件上传接口(非必传)

推荐在宿主 App.vueonLaunch 中注入(优先级最高):

getApp().globalData.bizUniChatConfig = {
    BASEURL: { url: 'https://api.example.com' },
    TokenPrefix: 'customer'
    // agentsApi / sendMessageApi / uploadApi 非必传,默认已内置
}

也可通过 uni.setStorageSync('bizUniChatConfig', {...}) 覆盖(优先级低于 globalData)。

3. 页面参数

  • conversationId:可选,传入会话 ID 用于续聊。

约定

  • 接口中的 {mini} 占位符会自动替换为宿主 getApp().globalData.projectMini
  • 登录态(AuthorizationX-XSRF-TOKEN)从 {TokenPrefix}_token{TokenPrefix}_XSRFToken 存储中读取。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。