# 医疗助手超级智能体平台

**Repository Path**: lflboy/SuperAgent

## Basic Information

- **Project Name**: 医疗助手超级智能体平台
- **Description**: 一个基于Spring Boot和React的智能医疗AI平台，集成了多种AI模型和工具，为医疗场景提供智能化解决方案。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 2
- **Created**: 2025-09-07
- **Last Updated**: 2026-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能医疗AI平台 (Medical AI Platform)

一个基于Spring Boot和React的智能医疗AI平台，集成了多种AI模型和工具，为医疗场景提供智能化解决方案。

## 🏗️ 项目架构

本项目采用前后端分离架构：

- **后端**: Spring Boot + MyBatis + Redis + Spring AI + LangChain4j
- **前端**: React + TypeScript + Vite + Tailwind CSS + shadcn/ui
- **AI集成**: 支持多种AI模型和工具调用
- **数据库**: MySQL (通过MyBatis进行数据访问)
- **缓存**: Redis (用于聊天记录和缓存)

## 📁 项目结构

```
agent/
├── medical-ai-platform/          # 前端React应用
│   ├── src/
│   │   ├── components/           # UI组件
│   │   ├── pages/               # 页面组件
│   │   ├── contexts/            # React上下文
│   │   ├── hooks/               # 自定义Hook
│   │   ├── services/            # API服务
│   │   └── lib/                 # 工具库
│   ├── public/                  # 静态资源
│   └── package.json
├── src/main/java/               # 后端Java代码
│   └── cn/longwingstech/intelligence/agent/
│       ├── app/                 # 应用层
│       │   ├── manus/           # AI智能体实现
│       │   ├── memory/          # 记忆管理
│       │   └── tool/            # 工具集成
│       ├── controller/          # 控制器层
│       ├── service/             # 服务层
│       ├── mapper/              # 数据访问层
│       ├── model/               # 数据模型
│       ├── config/              # 配置类
│       ├── langchain4j/         # LangChain4j集成
│       ├── exception/           # 异常处理
│       ├── aop/                 # 切面编程
│       ├── monitor/             # 监控指标
│       └── utils/               # 工具类
├── src/main/resources/
│   ├── mapper/                  # MyBatis映射文件
│   ├── prompts/                 # AI提示词模板
│   └── application.yaml         # 应用配置
└── pom.xml                      # Maven配置
```

## ✨ 核心功能

### 🤖 AI智能体
- **ReActAgent**: 基于推理-行动模式的智能体
- **ToolCallAgent**: 支持工具调用的智能体
- **LongManus**: 长对话记忆智能体
- **DoctorApp**: 专业医疗AI助手

### 🛠️ 工具集成
- **文件操作工具**: 支持文件读写、管理
- **PDF生成工具**: 动态生成PDF文档
- **MCP客户端**: 模型上下文协议支持

### 💾 数据管理
- **聊天历史**: 完整的对话记录和管理
- **用户管理**: 用户认证和权限控制
- **应用管理**: 多应用实例管理

### 🎨 前端特性
- **现代化UI**: 基于shadcn/ui的美观界面
- **响应式设计**: 支持多设备适配
- **主题切换**: 支持明暗主题
- **实时聊天**: WebSocket实时通信

## 🚀 快速开始

### 环境要求

- **Java**: 21+
- **Node.js**: 16+
- **MySQL**: 8.0+
- **Redis**: 6.0+
- **Maven**: 3.6+

### 后端启动

1. **克隆项目**
```bash
git clone https://gitee.com/Long-Boy-Project/SuperAgent.git
cd SuperAgent
```

2. **配置数据库**
```yaml
# 修改 src/main/resources/application-dev.yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/medical_ai?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: your_username
    password: your_password
```

3. **配置Redis**
```yaml
spring:
  redis:
    host: localhost
    port: 6379
    password: your_redis_password
```

4. **启动后端服务**
```bash
mvn clean install
mvn spring-boot:run
```

后端服务将在 `http://localhost:8080` 启动

### 前端启动

1. **进入前端目录**
```bash
cd medical-ai-platform
```

2. **安装依赖**
```bash
npm install
```

3. **启动开发服务器**
```bash
npm run dev
```

前端应用将在 `http://localhost:5173` 启动

## 🔧 配置说明

### AI模型配置

在 `application.yaml` 中配置AI模型：

```yaml
ai:
  model:
    provider: openai  # 或其他支持的提供商
    api-key: your_api_key
    base-url: https://api.openai.com/v1
```

### 限流配置

支持API请求限流：

```java
@RateLimiter(key = "chat", time = 60, count = 10)
```

### 监控配置

集成Micrometer监控指标：
- AI模型调用次数
- 响应时间统计
- 错误率监控

## 📚 API文档

### 主要接口

- `POST /api/ai/chat` - AI对话接口
- `GET /api/history/list` - 获取聊天历史
- `POST /api/auth/login` - 用户登录
- `POST /api/file/upload` - 文件上传
- `GET /api/app/list` - 获取应用列表

### 响应格式

```json
{
  "code": 0,
  "data": {},
  "message": "success"
}
```

## 🧪 测试

### 运行测试
```bash
# 后端测试
mvn test

# 前端测试
cd medical-ai-platform
npm run test
```

## 📦 部署

### Docker部署

1. **构建镜像**
```bash
# 后端
docker build -t medical-ai-backend .

# 前端
cd medical-ai-platform
docker build -t medical-ai-frontend .
```

2. **使用Docker Compose**
```bash
docker-compose up -d
```

### 生产环境配置

- 配置生产环境数据库连接
- 设置Redis集群
- 配置负载均衡
- 启用HTTPS

## 🤝 贡献指南

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](LICENSE) 文件了解详情

## 🆘 支持

如果您遇到问题或有疑问，请：

1. 查看 [Issues](../../issues) 页面
2. 创建新的 Issue
3. 联系维护团队

## 🔄 更新日志

### v1.0.0
- 初始版本发布
- 基础AI对话功能
- 用户管理系统
- 文件操作工具


**联系邮箱**: a13695191730@163.cn