# 简介

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的体验差强人意，自己开发面临如下核心挑战：

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

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

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

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

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

web pc端：

配置获取临时鉴权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 端需要打自定义基座

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

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

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

Provider 服务商 @Provider

LLMModel 模型 @LLMModel

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

更多相关文档：

‌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‌