# demo-ai

**Repository Path**: mingwei81/demo-ai

## Basic Information

- **Project Name**: demo-ai
- **Description**: 学习springai和redis stack向量库的配电网规划智能问答系统
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# demo-ai

基于 Spring AI + Redis Stack 向量库的配电网规划智能问答系统。

## 技术栈

| 层次 | 技术 |
|------|------|
| 框架 | Spring Boot 3.5.9 |
| JDK | 17 |
| AI 模型 | 智谱 AI (GLM-4-flash / embedding-2) |
| 向量存储 | Redis Stack (RediSearch) |
| 构建 | Maven |
| 通信 | SSE (Server-Sent Events) 流式对话 |

## 快速开始

### 1. 环境要求

- JDK 17+
- Maven 3.6+
- Redis Stack (需开启 RediSearch 模块)

### 2. 配置

设置环境变量 `ZHIPU_API_KEY`：

```bash
export ZHIPU_API_KEY=你的智谱API密钥     # Linux / macOS
set ZHIPU_API_KEY=你的智谱API密钥        # Windows CMD
$env:ZHIPU_API_KEY="你的智谱API密钥"     # Windows PowerShell
```

Redis 连接默认为 `localhost:6379`，如需修改请编辑 `src/main/resources/application.yml`。

### 3. 启动

```bash
cd demo-ai
mvn spring-boot:run
```

启动后访问：**http://localhost:8080**

## API 接口

### 普通对话（非流式）

```http
GET /chat?message=你好
```

### 流式对话（SSE）

```http
GET /chat-stream?message=介绍一下配电网规划
```

- Content-Type: `text/event-stream`
- 测试页面：http://localhost:8080/sse-test.html

### 设计建议

```http
GET /design?voltage=10&load=5
```

### 设计建议（流式）

```http
GET /design-stream?voltage=10&load=5
```

## 项目结构

```
src/main/java/com/example/demo/
├── DemoApplication.java          # 启动类
├── ChatController.java           # 对话接口（普通 + SSE 流式）
├── config/
│   ├── RedisConfig.java          # Redis 连接配置
│   └── VectorStoreConfig.java    # 向量存储配置
├── service/
│   ├── ChatMemoryService.java    # 对话记忆服务
│   ├── SemanticCacheService.java # 语义缓存
│   └── PdfIngestionService.java  # PDF 文档摄入
├── rag/
│   ├── RagController.java        # RAG 检索增强接口
│   └── RagMemoryController.java  # 带记忆的 RAG
└── ...
```

## License

仅供学习参考。