# AI 智能平台

**Repository Path**: ruovea-app/RuoVea.AI

## Basic Information

- **Project Name**: AI 智能平台
- **Description**: 多模型对话/绘图/写作/音乐/知识库RAG/工作流/思维导图
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-26
- **Last Updated**: 2026-10-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Web, FDE

## README

# 🌈 RuoVea.AI — 主系统框架

> **`dotnet new` 项目模板**：一套模板，通过 `tt` 参数一键生成三种形态 —— 纯后端 / 前后端一体 / 纯前端。

| 形态 | 命令 | 生成内容 |
|------|------|----------|
| 纯后端 | `dotnet new ruovea-omi-api -n MyApp`（默认） | Entry + Server |
| 前后端一体 | `dotnet new ruovea-omi-api -n MyApp --tt full` | 后端 + Web/ 前端 |
| 纯前端 | `dotnet new ruovea-omi-api -n MyApp --tt web` | 仅前端，摊平到根目录 |

## 📖 项目介绍

RuoVea.AI 是采用 .NET 8 + Vue 3 构建的企业级后台管理系统，基于 RuoVea 组件生态，提供完整的基础管理 + 业务扩展能力。所有 NuGet 包由 [RuoVea](https://gitee.com/ruovea) 开源提供。

- **技术先进**：.NET 8、Vue 3.5+、Composition API、TypeScript 5.7+、Vite 5.4+
- **动态 WebAPI**：后端服务类自动注册为 API，无需手动编写 Controller
- **RBAC 权限**：颗粒度到按钮级别的权限控制
- **国际化**：6 语言（zh-cn / zh-tw / en / ja-jp / fr-fr / vi-vn）
- **响应式设计**：适配手机、平板、PC
- **Docker 部署**：提供前端 + 后端容器化部署方案

## 📸 功能模块截图

### 登录页面
支持账号密码登录，包含验证码功能。

![登录页面](Doc/img/login.png)

### 仪表盘
仪表盘展示系统概览、数据统计和关键指标，支持自定义栅格布局。

![仪表盘](Doc/img/dashbard.png)

仪表盘管理支持创建、编辑、预览三种模式：

| 管理模式 | 预览模式 |
|----------|----------|
| ![仪表盘管理](Doc/img/dashboard-admin.png) | ![仪表盘预览](Doc/img/dashboard-view.png) |

![仪表盘编辑](Doc/img/dashboard-edit.png)

### 菜单管理
菜单的增删改查、权限设置和路由配置，支持拖拽排序，支持 DIR/MENU/BTN 三种类型。

![菜单管理](Doc/img/菜单管理.png)

### 角色管理
角色的创建、权限配置和菜单分配，实现细粒度的权限控制。

![角色管理](Doc/img/角色管理.png)

### 账号管理
用户信息的管理、角色分配和权限设置，包含用户状态管理。

![账号管理](Doc/img/账号管理.png)

### 机构管理
组织架构的管理，包括部门的增删改查和层级设置。

![机构管理](Doc/img/机构管理.png)

### 字典管理
字典类型的分类管理，支持从类型列表一键跳转四种字典值视图。

![字典管理](Doc/img/字典管理.png)

### 文章管理
文章列表/编辑（WangEditor 富文本编辑器）、分类管理、标签管理。

### 报表管理

图表配置、数据源管理、SQL 管理、可拖拽仪表盘、报表查询/图表预览。

![图表配置列表](Doc/img/chartConfig.png)
![图表配置编辑](Doc/img/chartConfig-edit.png)
![图表配置预览](Doc/img/chartConfig-view.png)
![数据源管理](Doc/img/dataSource.png)
![报表定义列表](Doc/img/definition.png)
![报表定义编辑](Doc/img/definition-edit.png)
![SQL 管理](Doc/img/definition-sql.png)
![QueryByCode](Doc/img/queryByCode.png)

### 访问日志
用户登录和访问记录的审计监控。

![访问日志](Doc/img/访问日志.png)

### 差异日志
系统数据变更历史的追踪审计。

![差异日志](Doc/img/差异日志.png)

### AI 能力（RuoVea.AI）

AI 能力按「模型接入 → 智能对话 → 知识库 → 智能增强 → 调用审计」五组菜单组织，路由与按钮权限均由后端菜单种子数据下发。

#### 模型接入

供应商管理维护 OpenAI 兼容的接口地址与 API Key；模型管理登记对话/嵌入模型及其 Token、温度参数；Token 配置设置单次、日、月用量上限与超限策略。

![供应商管理](Doc/img/ai-provider.png)
![编辑供应商](Doc/img/ai-provider-edit.png)
![模型管理](Doc/img/ai-model.png)
![编辑模型](Doc/img/ai-model-edit.png)
![Token配置](Doc/img/ai-token-config.png)
![编辑Token配置](Doc/img/ai-token-config-edit.png)

#### 智能对话

AI 助手管理配置助手的描述、系统提示词与开场白；AI 对话提供多会话切换、流式回复与上下文清理；助手会话留存历史会话的消息数与 Token 消耗。

![AI助手管理](Doc/img/ai-assistant.png)
![编辑助手](Doc/img/ai-assistant-edit.png)
![AI对话](Doc/img/ai-chat.png)
![新建对话](Doc/img/ai-chat-session.png)
![助手会话](Doc/img/ai-session.png)
![查看会话](Doc/img/ai-session-view.png)

#### 知识库

知识文档登记文档编码、文件类型与解析状态；知识分片管理分片内容与向量化状态；知识库测试用于验证 RAG 召回效果，输出模型回答与命中的分片、相似度。

![知识文档](Doc/img/ai-knowledge.png)
![编辑知识文档](Doc/img/ai-knowledge-edit.png)
![知识分片](Doc/img/ai-chunk.png)
![编辑知识分片](Doc/img/ai-chunk-edit.png)
![知识库测试](Doc/img/ai-rag-test.png)

#### 智能增强

意图规则、Function Calling、页面上下文、报表元数据与错误知识共同为模型提供业务路由、可调用函数与提示上下文。

![意图规则](Doc/img/ai-intent-rule.png)

| 规则详情 | 编辑规则 |
|----------|----------|
| ![意图规则详情](Doc/img/ai-intent-rule-view.png) | ![编辑意图规则](Doc/img/ai-intent-rule-edit.png) |

![Function Calling](Doc/img/ai-function-calling.png)
![编辑函数工具](Doc/img/ai-function-calling-edit.png)
![页面上下文](Doc/img/ai-page-context.png)
![编辑页面上下文](Doc/img/ai-page-context-edit.png)
![报表元数据](Doc/img/ai-report-meta.png)
![编辑报表元数据](Doc/img/ai-report-meta-edit.png)
![错误知识](Doc/img/ai-error-knowledge.png)
![编辑错误知识](Doc/img/ai-error-knowledge-edit.png)

#### 调用审计

API 调用日志记录每次模型请求的模型、供应商、Token 消耗、耗时与调用状态，可下钻查看完整的请求与响应内容。

![API调用日志](Doc/img/ai-api-log.png)
![调用日志详情](Doc/img/ai-api-log-detail.png)

### 移动端（RuoVea.AI.AppCore）

移动端由 `RuoVea.AI.AppCore`（uni-app H5）提供，与 PC 端共用同一套后端接口与菜单权限。以下截图为 750×1334 手机规格，与 `Doc/img/` 的 PC 端截图互补。

#### 基础页面

| 首页 | 工作台 | 我的 |
|------|--------|------|
| ![首页](Doc/phone/index.png) | ![工作台](Doc/phone/work.png) | ![我的](Doc/phone/mine.png) |

#### 模型接入

| 供应商管理 | 编辑供应商 |
|------------|------------|
| ![供应商管理](Doc/phone/ai-provider.png) | ![编辑供应商](Doc/phone/ai-provider-edit.png) |

| 模型管理 | 编辑模型 |
|----------|----------|
| ![模型管理](Doc/phone/ai-model.png) | ![编辑模型](Doc/phone/ai-model-edit.png) |

| Token配置 | 编辑Token配置 |
|-----------|---------------|
| ![Token配置](Doc/phone/ai-tokenConfig.png) | ![编辑Token配置](Doc/phone/ai-tokenConfig-edit.png) |

#### 智能对话

| AI助手管理 | 编辑助手 |
|------------|----------|
| ![AI助手管理](Doc/phone/ai-assistant.png) | ![编辑助手](Doc/phone/ai-assistant-edit.png) |

| AI对话 | 新建对话 |
|--------|----------|
| ![AI对话](Doc/phone/ai-chat.png) | ![新建对话](Doc/phone/ai-chat-edit.png) |

![助手会话](Doc/phone/ai-session.png)

#### 知识库

| 知识文档 | 编辑知识文档 |
|----------|--------------|
| ![知识文档](Doc/phone/ai-knowledge.png) | ![编辑知识文档](Doc/phone/ai-knowledge-edit.png) |

| 知识分片 | 知识库测试 |
|----------|------------|
| ![知识分片](Doc/phone/ai-chunk.png) | ![知识库测试](Doc/phone/ai-ragTest.png) |

#### 智能增强

| 意图规则 | 编辑意图规则 |
|----------|--------------|
| ![意图规则](Doc/phone/ai-intentRule.png) | ![编辑意图规则](Doc/phone/ai-intentRule-edit.png) |

| Function Calling | 编辑函数工具 |
|------------------|--------------|
| ![Function Calling](Doc/phone/ai-functionCalling.png) | ![编辑函数工具](Doc/phone/ai-functionCalling-edit.png) |

| 页面上下文 | 编辑页面上下文 |
|------------|----------------|
| ![页面上下文](Doc/phone/ai-pageContext.png) | ![编辑页面上下文](Doc/phone/ai-pageContext-edit.png) |

| 报表元数据 | 编辑报表元数据 |
|------------|----------------|
| ![报表元数据](Doc/phone/ai-reportMeta.png) | ![编辑报表元数据](Doc/phone/ai-reportMeta-edit.png) |

| 错误知识 | 编辑错误知识 |
|----------|--------------|
| ![错误知识](Doc/phone/ai-errorKnowledge.png) | ![编辑错误知识](Doc/phone/ai-errorKnowledge-edit.png) |

#### 调用审计

![API调用日志](Doc/phone/ai-apiLog.png)

## 🛠️ 技术栈

| 技术 | 版本 | 说明 |
| --- | --- | --- |
| .NET | 8.0 | 后端 API 框架 |
| SqlSugarCore | — | ORM 框架 |
| RuoVea.DynamicWebApi | — | 动态 WebAPI 生成 |
| RuoVea.OmiApi.* | 8.0.* | 基础模块 NuGet 包（Auth/System/Dict/Article/Notice/Reports/Log/Config/Upload） |
| Vue | 3.5+ | 前端框架 |
| TypeScript | 5.7+ | 类型系统 |
| Vite | 5.4+ | 构建工具 |
| Element Plus | 2.8+ | UI 组件库 |
| Pinia | 2.2+ | 状态管理 |
| Vue Router | 4.5+ | 路由管理（后端控制） |
| Vue I18n | 10.0+ | 国际化 |
| ECharts | 5.5+ | 数据可视化 |
| Axios | 1.7+ | HTTP 客户端 |
| WangEditor | 5.1+ | 富文本编辑器 |
| Vue Grid Layout | 3.0+ | 栅格布局（仪表盘） |
| Vue Signature Pad | 3.0+ | 电子签名 |
| Vue 3 Tree Org | 4.2+ | 组织架构图 |
| VForm3 | 3.0+ | 表单设计 |
| @Vue Office | 1.6+ | 文档预览 |
| SortableJS | 1.15+ | 拖拽排序 |

## 📦 核心功能

### 系统管理
- **用户管理**：用户信息管理、角色分配、状态管理
- **角色管理**：角色创建、权限配置、菜单分配
- **菜单管理**：菜单配置、权限设置、路由管理、拖拽排序
- **组织架构**：部门管理、组织层级设置
- **字典类型管理**：分类编码、名称配置，支持跳转四种字典值视图
- **配置管理**：系统配置、参数设置
- **缓存管理**：缓存监控、缓存清理
- **日志管理**：操作日志、异常日志、访问日志、差异日志

### 内容管理 (Article)
- **文章列表**：分页查询 + 标题/状态搜索，WangEditor 富文本编辑
- **文章编辑**：封面图片上传、分类下拉、标签多选、SEO 设置
- **分类管理**：树形上级节点选择，编码正则校验
- **标签管理**：简洁 CRUD

### 字典值管理 (DictValue)
- **常规管理**：标准 CRUD，14 种标签类型自由切换
- **动态组件**：输入控件智能适配，code 仅新增时显示
- **定制管理**：tagType 固定，aed 参数控制按钮权限
- **图片管理**：图片上传预览，表格缩略图 + 点击放大

### 报表管理 (Reports)
- **图表配置**：柱状图、折线图、饼图、仪表盘、统计卡片
- **数据源管理**：MySql/SqlServer/Sqlite/Oracle/PostgreSQL 连接管理
- **SQL 管理**：SQL 编辑 + 字段解析 + 拖拽排序 + 格式化预设 + 查询字典
- **仪表盘**：可拖拽图表布局（vue-grid-layout）
- **报表查询**：Element Plus 表格查询 + ECharts 图表预览
- **QueryByCode**：通过 code 参数访问报表

### AI 能力 (RuoVea.AI)
- **模型接入**：供应商管理（OpenAI 兼容接口）、模型管理、Token 用量配置
- **智能对话**：AI 助手、多会话对话、历史会话管理
- **知识库**：知识文档、知识分片、RAG 检索测试
- **智能增强**：意图规则、Function Calling、页面上下文、报表元数据、错误知识
- **调用审计**：API 调用日志与请求/响应详情

### 通知公告
- 系统通知 + SignalR 实时推送 + 已读/未读持久化

### 其他功能
- **文件管理**：文件上传、预览
- **代码生成**：模板代码快速生成
- **文档预览**：支持 docx、excel、pdf
- **电子签名**：在线签名功能

## 🌍 字典值视图对照

| 视图 | 路由 | 特点 |
|------|------|------|
| 常规管理 | /business/dictvalue/nomal | 标准 CRUD，14 种 tagType 自由切换 |
| 动态组件 | /business/dictvalue/dynamic | 输入控件智能适配，code 仅新增时显示 |
| 定制管理 | /business/dictvalue/custom | tagType 固定，aed 按钮可控 |
| 图片管理 | /business/dictvalue/image | 图片上传预览，表格缩略图 |

## 🌐 浏览器支持

| 浏览器 | 最低版本 |
| --- | --- |
| Edge | 88+ |
| Firefox | 78+ |
| Chrome | 87+ |
| Safari | 13+ |

> Vue 3 及 Element Plus 不支持 IE11 及之前版本。

## 🚀 快速开始

### 环境要求

- .NET 8 SDK
- Node.js >= 16.0.0
- pnpm >= 6.0.0（推荐）或 npm >= 7.0.0

### 后端启动

```bash
# 修改数据库配置：RuoVea.AI.Entry/Config/DbConnstring.json（默认 Sqlite）
dotnet restore
dotnet run --project RuoVea.AI.Entry
# Swagger: http://localhost:5000/swagger
```

### 前端启动

```bash
cd Web
pnpm install
pnpm dev        # http://localhost:3000
pnpm build      # 构建到 dist/
```

### Docker 部署

```bash
docker build -t ruovea-admin-master .
docker run -d -p 5000:80 --name ruovea-master ruovea-admin-master
```

## 📁 项目结构

```
ruovea-admin/
├── RuoVea.AI.Entry/        # 入口项目
│   ├── Config/               #   配置文件（DB、JWT、CORS、Swagger 等）
│   ├── Controllers/          #   Swagger 授权控制器
│   ├── Extensions/           #   本地化扩展
│   ├── Filters/              #   日志过滤器
│   └── Program.cs            #   应用启动入口
├── RuoVea.AI.Server/       # 业务逻辑层
│   ├── Dto/                  #   数据传输对象
│   ├── Language/             #   国际化资源文件
│   ├── Models/               #   数据模型
│   ├── SeedData/             #   种子数据
│   └── Service/              #   业务服务
├── Web/                      # Vue 3 前端
│   └── src/
│       ├── api/              #   API 服务层（按域分组）
│       ├── components/       #   通用组件
│       ├── i18n/             #   国际化（lang/框架级 + pages/页面级）
│       ├── layout/           #   布局组件
│       ├── router/           #   路由（后端控制）
│       ├── stores/           #   Pinia 状态管理
│       ├── utils/            #   工具函数
│   └── views/            # 页面组件
│       ├── ai/           #     AI 能力（模型接入/对话/知识库/增强/审计）
│       ├── dashboard/    #     工作台
│       ├── error/        #     错误页
│       ├── system/       #     系统管理（cache/file/infoSetting/server）
│       └── login/        #     登录
├── Doc/                      # 项目文档
│   ├── Docker/               #   Docker 部署文件
│   ├── img/                  #   截图（PC 端）
│   └── phone/                #   截图（移动端 AppCore）
├── CLAUDE.md                 # 项目编码规范（AI 自动加载）
├── RuoVea.AI.sln           # 解决方案文件
├── LICENSE                   # MIT 许可证
└── README.md
```

## 🎨 特色功能

### 1. 完善的权限管理
- 基于角色的权限控制（RBAC）
- 细粒度的菜单权限和按钮权限
- 权限缓存和动态加载

### 2. 丰富的通用组件
- **字典组件**：数据字典快速使用
- **富文本编辑器**：集成 WangEditor
- **电子签名**：支持在线签名
- **组织架构图**：可视化组织层级
- **文档预览**：支持多种文档格式
- **拖拽验证**：图片拖拽验证
- **图标选择器**：丰富的图标库
- **表格组件**：多功能表格封装

### 3. 国际化支持
- 内置 6 种语言
- 支持动态切换语言
- 框架级 + 页面级分层管理，自动 glob 导入

### 4. 主题定制
- 多种预设主题
- 自定义主题颜色
- 布局配置持久化

## 📚 开发文档

| 文档 | 说明 |
|------|------|
| [CLAUDE.md](CLAUDE.md) | 项目专属编码规范 v1.0（AI 自动加载，新增/修改代码必读；附录 6.1 含 RuoVea 组件文档导航） |
| [Web/README.md](Web/README.md) | 前端说明 |
| [Web/USE_WIKI.md](Web/USE_WIKI.md) | 使用手册 |
| [Web/CHANGELOG.md](Web/CHANGELOG.md) | 更新日志 |

## 📄 许可证

本项目基于 [RuoVea](https://gitee.com/ruovea) 开源组件生态，采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。

---

**RuoVea.AI** — 企业级后台管理系统基座！