# ruoyi-unity-ai-app
**Repository Path**: pengles/ruoyi-unity-ai-app
## Basic Information
- **Project Name**: ruoyi-unity-ai-app
- **Description**: ruoyi-unity-ai-app
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 3
- **Forks**: 3
- **Created**: 2025-08-29
- **Last Updated**: 2025-09-08
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
[](https://gitee.com/pengles/ruoyi-unity-ai/stargazers)
[](https://gitee.com/pengles/ruoyi-unity-ai/members)
`RuoYi-Unity-AI-App` —— 基于 `RuoYi-Unity-AI` 后台系统的跨平台前端应用，采用 `uniapp` + `Vue3` + `TypeScript` + `Vite5` + `UnoCSS` 技术栈构建，支持 H5、小程序、APP 多端部署。
本项目基于 [unibest](https://unibest.tech/) 框架进行二次开发，是 [RuoYi-Unity-AI](https://gitee.com/pengles/ruoyi-unity-ai) 后台管理系统的配套移动端应用，提供完整的AI增强企业级管理功能。
## 🎯 项目特色
- 🤖 **AI集成**：与后台AI服务深度集成，支持智能对话、知识库检索等功能
- 📱 **多端支持**：一套代码，支持H5、微信小程序、APP等多个平台
- 🎨 **现代化UI**：基于最新前端技术栈，提供流畅的用户体验
- 🔐 **权限管理**：完整的用户权限体系，与后台系统无缝对接
- 📊 **数据可视化**：丰富的图表组件，直观展示业务数据
- 🌐 **国际化**：内置多语言支持，满足国际化需求
## 🏗️ 技术架构
### 前端技术栈
| 技术 | 版本 | 说明 |
|------|------|------|
| Vue3 | ^3.4.0 | 渐进式JavaScript框架 |
| TypeScript | ^5.0.0 | JavaScript的超集 |
| Vite | ^5.0.0 | 下一代前端构建工具 |
| UnoCSS | ^0.58.0 | 原子化CSS引擎 |
| Pinia | ^2.1.0 | Vue状态管理库 |
| uni-app | ^3.0.0 | 跨平台应用开发框架 |
### 后台系统
本项目配套的后台系统：[RuoYi-Unity-AI](https://gitee.com/pengles/ruoyi-unity-ai)
- 🤖 **统一AI服务**：集成Spring AI、LangChain4j等主流AI框架
- 🔌 **多Provider支持**：支持OpenAI、ChatGLM、通义千问、智谱AI等
- 💬 **智能对话**：支持单轮对话、多轮对话、流式响应和记忆管理
- 📚 **知识库集成**：内置知识库服务，支持RAG（检索增强生成）
- ⚖️ **智能编排**：多Provider负载均衡、故障转移和智能路由
## 平台兼容性
| H5 | iOS | 安卓 | 微信小程序 | 字节小程序 | 快手小程序 | 支付宝小程序 | 钉钉小程序 | 百度小程序 |
| --- | --- | ---- | ---------- | ---------- | ---------- | ------------ | ---------- | ---------- |
| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
## ⚙️ 环境要求
- Node.js >= 18
- pnpm >= 7.30
- Vue Official >= 2.1.10
- TypeScript >= 5.0
## 🚀 快速开始
### 1. 克隆项目
```bash
git clone https://gitee.com/pengles/RuoYi-Unity-AI-App.git
cd RuoYi-Unity-AI-App
```
### 2. 安装依赖
```bash
pnpm install
```
### 3. 配置环境
复制环境配置文件并修改相关配置：
```bash
cp env/.env.example env/.env.development
```
在 `env/.env.development` 中配置后台API地址等信息。
### 4. 启动开发服务
```bash
# H5开发
pnpm dev
# 微信小程序开发
pnpm dev:mp
# APP开发
pnpm dev:app
```
## 📦 开发调试
### H5平台
```bash
pnpm dev:h5
```
然后打开 [http://localhost:9000/](http://localhost:9000/)
### 微信小程序
```bash
pnpm dev:mp
```
然后打开微信开发者工具，导入 `dist/dev/mp-weixin` 目录
### APP平台
```bash
pnpm dev:app
```
然后打开 HBuilderX，导入 `dist/dev/app` 目录
## 🔗 项目构建
### H5构建
```bash
pnpm build:h5
```
构建文件位于 `dist/build/h5`
### 微信小程序构建
```bash
pnpm build:mp
```
构建文件位于 `dist/build/mp-weixin`
### APP构建
```bash
pnpm build:app
```
构建文件位于 `dist/build/app`
## 📁 项目结构
```
src/
├── api/ # API接口定义
├── components/ # 公共组件
├── hooks/ # 组合式函数
├── http/ # HTTP请求封装
├── layouts/ # 布局组件
├── pages/ # 页面文件
│ ├── index/ # 首页
│ ├── login/ # 登录页
│ ├── me/ # 个人中心
│ └── message/ # 消息中心
├── router/ # 路由配置
├── service/ # 业务服务
├── static/ # 静态资源
├── store/ # 状态管理
├── style/ # 全局样式
├── tabbar/ # 底部导航
└── utils/ # 工具函数
```
## 🔧 主要功能
- 🔐 **用户认证**：登录、注册、找回密码
- 👤 **个人中心**：个人信息管理、设置
- 💬 **AI对话**：智能客服、AI助手
- 📚 **知识库**：文档检索、知识问答
- 📊 **数据看板**：业务数据可视化
- 📱 **消息推送**：实时消息通知
- 🌍 **多语言**：中英文切换
- 🎨 **主题切换**：明暗主题
## 🤝 贡献指南
1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request
## 📄 开源协议
[MIT License](https://opensource.org/license/mit/)
Copyright (c) 2025 pengles
## 🔗 相关链接
- [后台系统](https://gitee.com/pengles/ruoyi-unity-ai) - RuoYi-Unity-AI 后台管理系统
- [uni-app官网](https://uniapp.dcloud.net.cn/) - 跨平台应用开发框架
- [Vue3官网](https://cn.vuejs.org/) - 渐进式JavaScript框架
- [TypeScript官网](https://www.typescriptlang.org/) - JavaScript的超集
## 💬 交流群
如有问题或建议，欢迎提交 Issue 或加入交流群讨论。
---
⭐ 如果这个项目对你有帮助，请给个 Star 支持一下！