# cduestc

**Repository Path**: pu13398199549/cduestc

## Basic Information

- **Project Name**: cduestc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 电子科技大学智能助手 (UESTC Assistant)

基于 AI Agent 的智能问答系统，为电子科技大学学生提供选课、奖学金、宿舍等方面的咨询服务。

## 功能特性

- **智能问答**：基于 RAG（检索增强生成）技术，提供准确的校园信息咨询
- **用户系统**：完整的注册、登录、身份验证功能
- **对话管理**：支持对话摘要、历史记录管理
- **知识库**：涵盖选课指南、奖学金规则、宿舍规定等校园生活各个方面
- **偏好记忆**：保存用户偏好，提供个性化服务
- **招生咨询**：额外提供电子科技大学成都学院招生咨询服务

## 技术栈

### 后端
- **FastAPI**：高性能异步 Web 框架
- **LangChain Agent**：AI 智能体框架
- **Redis**：向量数据库存储知识库
- **Pydantic**：数据验证与类型管理

### 前端
- **Vue 3**：现代前端框架
- **Vite**：极速构建工具
- **Vue Router**：路由管理
- **Pinia**：状态管理

## 项目结构

```
uestc/
├── afterend/                # 后端服务
│   ├── main.py             # FastAPI 应用入口
│   ├── agent/              # AI Agent 相关
│   │   ├── agent.py        # Agent 实现
│   │   └── system_prompt.json
│   ├── config/             # 配置管理
│   ├── tool/               # 工具函数
│   │   ├── knowledge_tools.py    # 知识库工具
│   │   ├── preference_tools.py   # 偏好存储工具
│   │   └── digest_tools.py       # 对话摘要工具
│   ├── models/             # 数据模型
│   ├── vectorstores/       # 向量存储
│   └── users.csv           # 用户数据存储
├── docs/                   # 知识库文档
│   ├── course_selection_guide.md   # 选课指南
│   ├── dormitory_rules.md          # 宿舍规则
│   └── scholarship_rules.md        # 奖学金规则
├── frontend/               # 前端应用
│   ├── src/
│   │   ├── api/           # API 接口
│   │   ├── store/         # 状态管理
│   │   ├── views/         # 页面组件
│   │   │   ├── chat/      # 聊天页面
│   │   │   ├── login/     # 登录页面
│   │   │   └── register/  # 注册页面
│   │   └── router/        # 路由配置
│   └── package.json
├── skills/                 # 技能模块
│   └── enroll-assistant/  # 招生助手
├── requirements.txt        # Python 依赖
└── README.md
```

## 快速开始

### 环境要求

- Python 3.8+
- Node.js 16+
- Redis 6+

### 后端安装

1. 创建虚拟环境：
```bash
cd uestc
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate  # Windows
```

2. 安装依赖：
```bash
pip install -r requirements.txt
```

3. 启动 Redis 服务器（确保 Redis 已安装）

4. 启动后端服务：
```bash
cd afterend
uvicorn main:app --reload
```

后端服务运行在 `http://localhost:8000`

### 前端安装

1. 安装依赖：
```bash
cd frontend
npm install
```

2. 启动开发服务器：
```bash
npm run dev
```

前端服务运行在 `http://localhost:5173`

## API 文档

### 认证接口

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/register` | 用户注册 |
| POST | `/api/login` | 用户登录 |
| GET | `/api/verify` | 验证 token |

### 功能接口

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/chat` | 发送聊天消息 |

## Agent 工具模块

系统内置多个智能工具模块：

### 知识库工具
- `load_course_selection_guide_knowledge`：加载选课指南知识库
- `load_scholarship_rules_knowledge`：加载奖学金规则知识库
- `load_dormitory_rules_knowledge`：加载宿舍规则知识库
- `query_knowledge`：从向量库中检索相关知识

### 对话摘要工具
- `compress_digest`：压缩并保存对话摘要
- `get_digests`：获取对话摘要

### 偏好记忆工具
- `save_preference`：保存用户偏好
- `get_preference`：查询用户偏好

## 知识库管理

系统默认包含以下知识库：

- **选课指南**：选课时间、方式、规则、学分要求等
- **奖学金规则**：2026 年奖学金评定细则、等级标准、申请流程
- **宿舍规定**：宿舍分配、设施管理、调换退宿规定等

用户可通过 Agent 动态加载和查询知识库内容。

## 招生助手技能

系统还集成了电子科技大学成都学院招生咨询服务，涵盖：

- **本科招生**：普通本科招生章程、录取规则、专业信息
- **专科招生**：全日制专科招生章程、特殊专业说明
- **国际班招生**：国际化办学项目招生简章、培养特色

## 许可证

本项目仅供学习和研究使用。