# StockAgent

**Repository Path**: yanhuaying/StockAgent

## Basic Information

- **Project Name**: StockAgent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-28
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
  <h1>🚀 StockAgent</h1>
  <p><strong>AI 驱动的智能量化分析平台</strong></p>
  <p>
    <a href="#功能特性">功能特性</a> •
    <a href="#系统架构">系统架构</a> •
    <a href="#快速开始">快速开始</a> •
    <a href="#部署指南">部署指南</a> •
    <a href="#技术栈">技术栈</a>
  </p>
  <p>
    <img src="https://img.shields.io/badge/Python-3.11+-blue?logo=python" alt="Python">
    <img src="https://img.shields.io/badge/Vue-3.4+-green?logo=vue.js" alt="Vue">
    <img src="https://img.shields.io/badge/FastAPI-0.100+-teal?logo=fastapi" alt="FastAPI">
    <img src="https://img.shields.io/badge/MongoDB-7.0-green?logo=mongodb" alt="MongoDB">
    <img src="https://img.shields.io/badge/License-MIT-yellow" alt="License">
  </p>
</div>

---

## 📖 项目简介

**StockAgent** 是一个面向 A 股市场的智能量化分析平台，融合了 **大语言模型 (LLM)**、**多因子选股**、**量化回测** 等技术，帮助投资者进行智能化的市场分析和策略验证。

### ✨ 核心亮点

- 🤖 **AI 智能分析** - 集成 GPT-4、DeepSeek、通义千问等多种 LLM，提供智能股票分析报告
- 📊 **多因子选股** - 内置 17+ 选股因子，支持动量、价值、质量、成长等多维度策略
- 📈 **向量化回测** - 高性能回测引擎，支持 A 股 T+1 规则、佣金印花税、涨跌停限制
- 🔄 **实时数据同步** - 自动同步 Tushare 行情数据，支持定时调度
- 🌐 **分布式架构** - 微服务设计，各节点可独立扩展
- 🎨 **现代化 UI** - Vue3 + Element Plus 构建的专业级交易界面

---

## 🖼️ 界面预览

<details>
<summary>点击展开截图</summary>

### 仪表盘
![Dashboard](docs/images/dashboard.png)

### 量化回测
![Backtest](docs/images/backtest.png)

### 因子选股
![Factor Selection](docs/images/factor-selection.png)

### 热点追踪
![Hot News](docs/images/hot-news.png)

</details>

---

## 🏗️ 系统架构

```
┌─────────────────────────────────────────────────────────────────┐
│                      Frontend (Vue3 + Vite)                      │
│                   Element Plus + ECharts + SCSS                  │
└─────────────────────────────┬───────────────────────────────────┘
                              │ HTTP / WebSocket
┌─────────────────────────────▼───────────────────────────────────┐
│                     Web Node (FastAPI)                           │
│              REST API • JWT Auth • WebSocket                     │
└─────────────────────────────┬───────────────────────────────────┘
                              │ gRPC (内部通信)
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
┌───────────────┐     ┌───────────────┐     ┌───────────────┐
│  Data Sync    │     │   Inference   │     │   Backtest    │
│    Node       │     │     Node      │     │     Node      │
│ ─────────────│     │ ─────────────│     │ ─────────────│
│ • 行情同步    │     │ • LLM 推理    │     │ • 单股回测    │
│ • 定时调度    │     │ • 智能分析    │     │ • 因子选股    │
│ • 数据清洗    │     │ • 报告生成    │     │ • 组合回测    │
└───────┬───────┘     └───────┬───────┘     └───────┬───────┘
        │                     │                     │
        └─────────────────────┼─────────────────────┘
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    MongoDB • Redis • Milvus                      │
│               数据存储 • 缓存队列 • 向量检索                        │
└─────────────────────────────────────────────────────────────────┘
```

### 节点说明

| 节点 | 职责 | 可扩展 |
|------|------|--------|
| **Web Node** | HTTP API 网关、用户认证、请求路由 | ✅ |
| **Data Sync Node** | Tushare 数据同步、定时调度、增量更新 | ❌ (单实例) |
| **Inference Node** | LLM 推理、智能分析、报告生成 | ✅ |
| **Backtest Node** | 量化回测、因子计算、绩效分析 | ✅ |
| **MCP Node** | Model Context Protocol 服务 | ❌ |
| **Listener Node** | 实时行情监听、异动提醒 | ❌ |

---

## 🎯 功能特性

### 📊 市场分析

- **大盘概览** - 主要指数行情、涨跌分布、成交热力图
- **板块分析** - 行业/概念板块资金流向、强弱对比
- **热点追踪** - 多源新闻聚合（财联社、36氪、雪球等）
- **涨跌停分析** - 涨停板复盘、连板统计、封板强度

### 🔬 智能分析

- **AI 股票分析** - 基于 LLM 的多维度分析报告
- **技术面诊断** - 自动识别 K 线形态、支撑压力位
- **基本面评估** - 财务指标评分、估值对比
- **资金面解读** - 主力资金流向、龙虎榜解析

### 📈 量化回测

#### 单股回测
- 支持自定义因子权重
- A 股交易规则（T+1、涨跌停、佣金印花税）
- 收益曲线、回撤分析、交易明细

#### 因子选股回测
- **17+ 内置因子**：

| 分类 | 因子 |
|------|------|
| 动量 | 5日/20日/60日动量 |
| 价值 | PE_TTM、PB、PS_TTM、股息率 |
| 质量 | ROE、ROA、毛利率 |
| 成长 | 营收增长率、利润增长率 |
| 波动 | 20日/60日波动率 |
| 流动性 | 换手率、成交额、总市值 |
| 技术 | 均线偏离、RSI、价格位置 |

- **灵活配置**：调仓频率、选股数量、权重方法
- **基准对比**：策略收益 vs 沪深300
- **详细报告**：夏普比率、最大回撤、超额收益

### 🗂️ 策略管理

- **自选股** - 分组管理、实时行情
- **市场监听** - 条件触发、实时提醒
- **历史记录** - 回测结果存档、策略对比

---

## 🛠️ 技术栈

### 后端

| 技术 | 用途 |
|------|------|
| **Python 3.11+** | 主开发语言 |
| **FastAPI** | Web 框架、REST API |
| **gRPC** | 节点间通信 |
| **Pydantic** | 数据验证 |
| **APScheduler** | 定时任务调度 |
| **Pandas/NumPy** | 数据处理、向量化计算 |
| **LangChain** | LLM 应用框架 |

### 前端

| 技术 | 用途 |
|------|------|
| **Vue 3.4** | 前端框架 |
| **TypeScript** | 类型安全 |
| **Vite 5** | 构建工具 |
| **Element Plus** | UI 组件库 |
| **ECharts** | 图表可视化 |
| **Pinia** | 状态管理 |
| **Vue Router** | 路由管理 |

### 存储

| 技术 | 用途 |
|------|------|
| **MongoDB 7** | 主数据库 |
| **Redis 7** | 缓存、消息队列、分布式锁 |
| **Milvus** | 向量数据库 (可选) |

### 数据源

| 数据源 | 数据类型 |
|--------|----------|
| **Tushare Pro** | A股行情、财务、资金流向等 |

### LLM 支持

- OpenAI (GPT-4o, GPT-4o-mini)
- DeepSeek (deepseek-chat)
- 阿里云 DashScope (qwen-plus)
- 智谱 AI (GLM-4)
- Ollama (本地部署)

---

## 🚀 快速开始

### 环境要求

- Python 3.11+
- Node.js 18+
- MongoDB 7.0
- Redis 7.0
- Milvus 2.4+ (可选，用于语义搜索)
- Docker & Docker Compose (推荐)

### 1. 克隆项目

```bash
git clone https://github.com/your-username/StockAgent.git
cd StockAgent
```

### 2. 启动基础设施

```bash
cd AgentServer/deploy

# 方式 A：仅启动必需服务（回测、数据同步等基础功能）
docker compose up -d mongodb redis

# 方式 B：启动全部服务（包含 AI 智能分析的语义搜索）
docker compose up -d mongodb redis milvus
```

> 💡 **关于 Milvus**：向量数据库用于 AI 智能分析中的语义搜索。基础功能（量化回测、数据同步）不需要它。

### 3. 配置环境变量

```bash
cd AgentServer
cp .env.example .env
# 编辑 .env，填入必要配置
```

**必须配置**：
- `TUSHARE_TOKEN` - [Tushare Pro](https://tushare.pro) 账号 Token
- `LLM_API_KEY` - LLM 服务的 API Key

### 4. 启动后端

```bash
cd AgentServer

# 安装依赖
pip install -r requirements.txt

# 启动 Web 节点
NODE_TYPE=web python main.py

# 新终端：启动数据同步节点
NODE_TYPE=data_sync python main.py

# 新终端：启动回测节点 (可选)
NODE_TYPE=backtest python main.py
```

### 5. 启动前端

```bash
cd frontend

# 安装依赖
npm install

# 开发模式
npm run dev
```

访问 http://localhost:5173

---

## 📦 项目结构

```
StockAgent/
├── AgentServer/                 # 后端服务
│   ├── main.py                  # 统一入口
│   ├── requirements.txt         # Python 依赖
│   ├── .env.example             # 环境变量模板
│   │
│   ├── core/                    # 核心模块
│   │   ├── settings.py          # 配置管理
│   │   ├── protocols.py         # 协议定义
│   │   ├── rpc.py               # RPC 通信
│   │   ├── logging.py           # 日志配置
│   │   └── managers/            # 管理器 (MongoDB, Redis, Tushare)
│   │
│   ├── nodes/                   # 节点实现
│   │   ├── base.py              # 基类
│   │   ├── web/                 # Web 节点 (FastAPI)
│   │   │   ├── node.py
│   │   │   └── api/             # API 路由
│   │   ├── data_sync/           # 数据同步节点
│   │   │   ├── node.py
│   │   │   └── collectors/      # 数据采集器
│   │   ├── inference/           # 推理节点
│   │   ├── backtest_engine/     # 回测引擎
│   │   │   ├── backtester.py    # 向量化回测
│   │   │   ├── factors.py       # 因子数据
│   │   │   ├── performance.py   # 绩效分析
│   │   │   └── factor_selection/# 因子选股模块
│   │   ├── mcp/                 # MCP 节点
│   │   └── listener/            # 监听节点
│   │
│   ├── common/                  # 公共模块
│   │   └── utils/               # 工具函数
│   │
│   ├── scripts/                 # 脚本工具
│   │   ├── sync_stock_daily.py  # 同步日线数据
│   │   ├── sync_daily_basic.py  # 同步每日指标
│   │   └── update_sync_date.py  # 更新同步记录
│   │
│   └── deploy/                  # 部署配置
│       ├── docker-compose.yml   # Docker Compose
│       ├── Dockerfile           # 统一镜像
│       ├── README.md            # 部署文档
│       ├── mongodb/             # MongoDB 配置
│       ├── redis/               # Redis 配置
│       └── vector_db/           # Milvus 配置
│
├── frontend/                    # 前端应用
│   ├── src/
│   │   ├── api/                 # API 封装
│   │   ├── components/          # 公共组件
│   │   ├── views/               # 页面视图
│   │   │   ├── dashboard/       # 仪表盘
│   │   │   ├── market/          # 市场分析
│   │   │   ├── backtest/        # 量化回测
│   │   │   ├── analysis/        # 智能分析
│   │   │   └── ...
│   │   ├── stores/              # 状态管理
│   │   ├── router/              # 路由配置
│   │   └── styles/              # 全局样式
│   └── ...
│
├── manager.ps1                  # Windows 管理脚本
└── README.md                    # 本文件
```

---

## 📖 部署指南

详见 [AgentServer/deploy/README.md](AgentServer/deploy/README.md)

### Docker Compose 部署 (推荐)

```bash
cd AgentServer/deploy

# 启动所有服务
docker compose up -d

# 查看状态
docker compose ps
```

### 按需启动

```bash
# 只启动核心服务
docker compose up -d mongodb redis web data-sync backtest
```

---

## 🔧 配置说明

完整配置项见 `AgentServer/.env.example`，主要配置：

| 配置项 | 说明 | 必须 |
|--------|------|------|
| `TUSHARE_TOKEN` | Tushare Pro Token | ✅ |
| `LLM_PROVIDER` | LLM 提供商 | ✅ |
| `LLM_API_KEY` | LLM API Key | ✅ |
| `MONGO_*` | MongoDB 连接配置 | ✅ |
| `REDIS_*` | Redis 连接配置 | ✅ |
| `JWT_SECRET` | JWT 签名密钥 | ✅ |

---

## 🗺️ 路线图

- [x] 基础架构搭建
- [x] 数据同步模块
- [x] 单股量化回测
- [x] 因子选股回测
- [x] 热点新闻聚合
- [ ] 实时行情 WebSocket
- [ ] 策略可视化编排
- [ ] 自定义因子编写
- [ ] 移动端适配
- [ ] 多账户支持
- [ ] 实盘对接

---

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

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) 开源许可证。

---

## ⚠️ 免责声明

本项目仅供学习和研究使用，不构成任何投资建议。股市有风险，投资需谨慎。使用本软件进行的任何投资决策，用户需自行承担风险。

---

## 🙏 致谢

- [Tushare](https://tushare.pro) - 金融数据接口
- [LangChain](https://langchain.com) - LLM 应用框架
- [FastAPI](https://fastapi.tiangolo.com) - Web 框架
- [Vue.js](https://vuejs.org) - 前端框架
- [Element Plus](https://element-plus.org) - UI 组件库

---

<div align="center">
  <p>如果这个项目对你有帮助，请给一个 ⭐ Star 支持一下！</p>
</div>

## QQ群

![Dashboard](docs/images/QQ群二维码.jpg)
<div align="center">
  <p>有问题可进Q群交流</p>
</div>