# StockAnalyseAgent

**Repository Path**: yin_yong_chao/stock-analyse-agent

## Basic Information

- **Project Name**: StockAnalyseAgent
- **Description**: No description available
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-07
- **Last Updated**: 2025-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Stock-Agent

## 项目简介

股票分析智能体是一个基于AI的股票分析系统，利用人工智能技术对股票市场数据进行分析和预测，为投资者提供智能化的投资建议。

## 软件架构

软件架构采用模块化设计，主要包括以下模块：

```
stock-agent/
├── agent/                    # AI分析核心模块
│   ├── agent-common/         # 公共工具类和基础配置
│   └── agent-service/        # 核心AI分析服务
│       ├── src/main/java/org/stock/agent/
│       │   ├── Application.java      # 应用启动类
│       │   ├── controller/           # 控制层
│       │   ├── service/              # 服务层，包含各类分析师实现
│       │   ├── model/                # 数据模型
│       │   ├── client/               # 外部服务客户端
│       │   ├── config/               # 配置类
│       │   └── tools/                # 工具类
│       └── Dockerfile                # Docker部署文件
├── docker-compose.yml                # Docker编排配置
└── pom.xml                           # 项目根POM文件
```

## 功能特性

- **多维度分析**：系统内置5种不同类型的分析师角色，分别从技术、基本面、市场情绪、估值和行业角度进行分析
- **AI驱动**：基于DeepSeek大模型进行智能分析
- **实时流式响应**：支持SSE流式输出分析过程和结果
- **容器化部署**：支持Docker容器化部署，一键启动所有服务

## 技术栈

- Java 17
- Spring Boot 3.4.0
- Spring AI 1.0.0
- Spring AI Alibaba 1.0.0.2
- Maven 3.8.1+
- DeepSeek AI模型
- Docker (可选)

## 快速开始

### 环境要求

- JDK 17
- Maven 3.8.1+
- Docker (可选，用于容器化部署)

### 构建项目

```bash
# 克隆项目
git clone https://gitee.com/yin_yong_chao/stock-analyse-agent.git

# 进入项目目录
cd stock-agent

# 编译打包
mvn clean package
```

### 配置说明

在运行服务之前，需要先配置AI模型的API密钥。编辑 `agent/agent-service/src/main/resources/application.yml` 文件：

```yaml
spring:
  ai:
    openai:
      api-key: YOU-KEY  # 替换为你的API密钥
      base-url: https://api.siliconflow.cn
      chat:
        options:
          model: deepseek-ai/DeepSeek-V3.1
```

### 运行项目

#### 本地运行

```bash
# 启动agent-service服务
cd agent/agent-service
mvn spring-boot:run
```

#### Docker运行（推荐）

项目支持通过Docker容器化部署，使用docker-compose可以一键启动所有服务。

```bash
# 构建并启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 停止所有服务
docker-compose down
```

### 端口说明

- agent-service: 8082
- stock-service: 8081
- MySQL: 3306
- Redis: 6379

## API接口

### 股票分析接口

1. **GET /api/analysis/stock**
   - 参数：symbol (股票代码)
   - 返回：完整的股票分析结果

2. **POST /api/analysis/stock**
   - 请求体：`{"symbol": "股票代码"}`
   - 返回：完整的股票分析结果

3. **GET /api/analysis/stock/stream**
   - 参数：symbol (股票代码)
   - 返回：SSE流式响应，实时输出分析过程和结果

## 项目模块详解

### agent模块

核心AI分析模块，包含分析器、协调器、控制器等组件：

- **ChiefAnalyst**：首席分析师，协调各领域分析师进行综合分析
- **TechnicalAnalyst**：技术分析师，负责技术面分析
- **FundamentalAnalyst**：基本面分析师，负责财务和基本面分析
- **SentimentAnalyst**：情绪分析师，负责市场情绪分析
- **ValuationAnalyst**：估值分析师，负责股票估值分析
- **IndustryAnalyst**：行业分析师，负责行业趋势分析

## 开发指南

### 项目结构说明

```
agent-service/
├── src/
│   └── main/
│       ├── java/
│       │   └── org.stock.agent/
│       │       ├── controller/     # 控制层，处理HTTP请求
│       │       ├── service/        # 服务层，业务逻辑实现
│       │       ├── model/          # 数据模型
│       │       ├── client/         # 外部服务客户端
│       │       ├── config/         # 配置类
│       │       └── Application.java # 应用启动类
│       └── resources/
│           ├── application.yml     # 主配置文件
│           └── application-docker.yml # Docker环境配置
└── Dockerfile                      # Docker镜像构建文件
```

### 自定义分析逻辑

如需添加新的分析维度，可以：
1. 在 [service](file://D:\code\stock-analyse-agent\agent\agent-service\src\main\java\org\stock\agent\service) 包下创建新的分析师类，继承相应基类或实现接口
2. 在 [ChiefAnalyst](file://D:\code\stock-analyse-agent\agent\agent-service\src\main\java\org\stock\agent\service\ChiefAnalyst.java#L22-L310) 类中注入并使用新的分析师
3. 更新综合分析逻辑

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request