# 简介

uni-ai x v3.0.0 新增于 HBuilderX 5.26

uni-ai x，是一个基于uni-app x 蒸汽模式的开源的、全平台的、原生的、云端一体的ai聊天套件。

能够连接ai大模型，真流式接收和输出内容，原生渲染markdown。

# 项目背景：

市面上开源的AI聊天套件大多以Web端为主，像ChatGPT、DeepSeek等的App端并不开源。
而通过Web-view接入AI的体验差强人意，自己开发面临如下核心挑战：

流式网络请求：基于POST的SSE技术实现实时数据传输
Markdown流式解析：动态解析富文本格式标记
编程语言代码高亮：实现语法识别与样式渲染
Table表格解析渲染：结构化数据的可视化呈现
流式排版性能：确保内容加载不阻塞UI交互操作
跨平台开发困境：缺乏成熟跨平台框架，鸿蒙端开发尤为艰难
极致性能要求：每个Token需同步完成Markdown解析、代码高亮及排版渲染，运算密集且不能卡顿UI

uni-ai x由此应运而生，专注攻克全平台原生AI聊天场景的技术痛点。

可以满足开发者的如下需求：

基于uni-ai x开发全新的ai应用
在之前的app中引入uni-ai x的sdk，给app补充ai聊天能力
客户端和服务器均开源，可以自由定制扩展

# 功能和特点

uni-ai x功能上参考 deepseek 的客户端设计，并扩展了更多平台。

多端支持与主题适配支持Web/H5、iOS、Android、鸿蒙 App、微信小程序。Web 端采用响应式布局，适配 PC 宽屏和移动设备，并提供浅色和暗黑两种主题模式
丰富的 AI 服务集成与高级功能集成多家主流 AI 服务商，用户可灵活切换不同 AI 模型，部分模型支持"深度思考"和"联网搜索"等高级能力
消息与会话管理
支持多轮对话和历史会话管理，具备会话切换、删除、自动创建等功能，提供完整的 AI 聊天体验
高级渲染与输出特性支持 AI 回复内容的流式输出和原生 Markdown 格式渲染，内置高性能解析器，支持代码高亮和复杂文本结构展示

Markdown 展示还支持任务列表、LaTeX 数学公式和 Mermaid 图表；宽表格可横向滚动，Android 端可直接拖选回复文字。

# 与主流 AI 客户端对比

以下横评聚焦 Android 和鸿蒙 App 的 Markdown 展示和流式渲染。

Android 功能对比

对比项	uni-ai x	ChatGPT	Gemini	豆包	DeepSeek
多语言代码高亮	✅	⚠️	❌	✅	✅
图表展示	✅	⚠️	❌	✅	✅
任务列表渲染	✅	❌	❌	✅	✅
在回复页直接拖选文字	✅	✅	✅	✅	❌

ChatGPT 的图表需要手动点击触发。
DeepSeek 需要进入单独的选择界面才能选取回复文字。
uni-ai x 的代码高亮可扩展 VS Code 支持的编程语言，包括 ets、wxs、ajs、wxml 等。

鸿蒙功能对比

本次测试的五款客户端中，只有 uni-ai x 和豆包提供鸿蒙版本。

对比项	uni-ai x	豆包
图表展示	✅	❌
任务列表渲染	✅	❌

流式渲染性能

相同 Markdown 回复各测试 5 轮，uni-ai x 在 Android 和鸿蒙端的慢帧次数均最少。Android 端其他客户端的慢帧次数是 uni-ai x 的 8.09～46.61 倍，鸿蒙端豆包是 uni-ai x 的 9.97 倍。

以 16.67ms 为慢帧门槛，表中次数为每轮平均值。两张表的倍数分别以该平台 uni-ai x 的慢帧次数为 1 计算。

Android（小米 11 Pro）：

应用	慢帧次数	慢帧平均耗时	慢帧次数倍数
uni-ai x	15.2	28.47ms	1 倍
DeepSeek	123.0	34.40ms	8.09 倍
Gemini	282.4	51.04ms	18.58 倍
ChatGPT	368.4	34.47ms	24.24 倍
豆包	708.4	60.00ms	46.61 倍

鸿蒙（华为 nova 12）：

应用	慢帧次数	慢帧平均耗时	慢帧次数倍数
uni-ai x	73.4	51.60ms	1 倍
豆包	732.0	43.62ms	9.97 倍

测试版本、采集方法及逐轮数据详见：uni-ai x 和ChatGPT、Gemini、豆包、DeepSeek的横评测试报告。

流式回复对比视频

从左至右：uni-ai x、Gemini、ChatGPT。

从左至右：uni-ai x、豆包、DeepSeek。

长会话滚动与启动视频

长会话滚动：

App 启动：

各端效果如下截图，依次平台为：iOS、Android、鸿蒙

web pc端：

# Android端demo：

扫码或点此下载

# 安装步骤

下载示例项目
打开uni-ai x插件下载地址：https://ext.dcloud.net.cn/plugin?name=uni-ai-x
绑定项目的服务空间

不基于unicloud的项目，无需绑定服务空间；删除uni_modules目录下的uni-ai-x/uniCloud 即可。
基于unicloud的项目，在项目根目录uniCloud右键选择"关联云服务空间或项目"，关联你的服务空间

配置获取临时鉴权token的方法（仅作为OpenClaw channel时可跳过）为提供更好的用户体验，uni-ai x 由客户端直接连接 AI 服务器。同时为了保证在前端调用大模型时不暴露服务商的apiKey信息，特采用方案：前端调用服务端接口获取临时 token 后，使用临时 token 调用服务商的api。

不基于unicloud的项目，需要先注册阿里百炼账户并创建 API-Key根据文档提供获取临时鉴权 token 接口。并配置到/uni_modules/uni-ai-x/config.uts，bailian -> getToken 内
基于unicloud的项目，默认将通过 uni-ai-x-co 获取；
- uni-ai-x 版本号1.1.0起，客户端默认 AI 服务商为：七牛云，开通uni-ai 网关即可使用。
- 旧版本默认使用“阿里云百联”要将API-Key配置到uniCloud/cloudfunctions/common/uni-config-center/uni-ai-x/config.json（此配置文件需手动创建）
  配置示例：
```
{
		"apiKey":{
				"bailian": "sk-2****7"
		} 
}
```
示例源码如下，请查看 pre > code 标签中的内容
```
{
		"apiKey":{
				"bailian": "sk-2****7"
		} 
}
```

运行项目
在菜单点击运行，选择要运行的客户端。

注意: 运行到 App 端需要打自定义基座

客户端配置 @config-client 配置文件路径：/uni_modules/uni-ai-x/config.uts

配置用户信息（可选）@UserInfo

字段名	类型	说明
currentUser	Userinfo	左侧菜单区域下方的用户头像信息
userCenterPage	string	点击左侧菜单区域下方的用户头像信息后跳转的页面路径

默认例子（顶部被注释的代码）适用于基于 unicloud + uni-id-pages-x 的项目的，解开注释即可使用。非 unicloud 项目，参考此示例简单修改即可

配置服务商与模型请直接参考插件预置配置信息 llmModelMap 下的内容 注意： OpenClaw，需配合uni-ai-openclaw-channel-plugin插件使用

Provider 服务商 @Provider

字段名	类型	说明
models	LLMModel[]	该服务商下支持的模型列表详见
description	string	服务商描述信息，用于 UI 展示
baseURL	string	API 基础地址，部分服务商需要
getToken	function	token 获取方法

LLMModel 模型 @LLMModel

字段名	类型	说明
name	string	模型名称，需与服务商实际支持的模型一致

更多相关文档：

uni-ai x 基于uni-ai，uni-ai的文档详情参考
通义大模型应用上架及合规备案详情参考

# 常见问题

项目不是基于uni-app-x而是基于uni-app开发的如何接入？答：基于uni-app开发的项目暂不支持接入，但可以接入uni-ai-chat
如遇以下报错，则说明你未打自定义基座运行

‌error: app-service.js(4737:38) ReferenceError:Can't find variable: TextDecoder parseChunkData@app-service.js:4737:38‌
‌error: java.util.regex.PatternSyntaxException: Syntax error in regexp pattern near index 110‌