AI 驱动的智能量化分析平台

功能特性 • 系统架构 • 快速开始 • 部署指南 • 技术栈

Python Vue FastAPI MongoDB License

📖 项目简介

✨ 核心亮点

🖼️ 界面预览

🏗️ 系统架构

┌─────────────────────────────────────────────────────────────────┐
│ 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 │
│ 数据存储 • 缓存队列 • 向量检索 │
└─────────────────────────────────────────────────────────────────┘

节点说明

🎯 功能特性

📊 市场分析

📰 新闻聚合

🔬 智能分析

📈 量化回测

单股回测

因子选股回测

🗂️ 策略管理

🛠️ 技术栈

后端

前端

存储

数据源

LLM 支持

🚀 快速开始

环境要求

1. 克隆项目

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

2. 启动基础设施

cd AgentServer/deploy
# 启动全部服务 (推荐)
docker compose up -d mongodb redis milvus
# 或仅启动核心服务 (不含向量搜索)
docker compose up -d mongodb redis

3. 配置环境变量

cd AgentServer
cp .env.example .env
# 编辑 .env,填入必要配置

4. 安装依赖

cd AgentServer
# 创建虚拟环境
python -m venv venv
# 激活虚拟环境
.\venv\Scripts\activate # Windows
# source venv/bin/activate # Linux/Mac
# 安装依赖
pip install -r requirements.txt

cd frontend
npm install

5. 启动服务

方式 A:使用管理脚本 (推荐)

# 进入项目根目录
cd stockAgent
.\manager.ps1

[1] Start Web
[2] Start Inference
[3] Start DataSync
[4] Start Listener
[5] Start Backtest
[6] Start Frontend
[A] Start all backend nodes
[F] Start full stack (backend + frontend)

方式 B:手动启动

cd AgentServer
# 启动 Web 节点
NODE_TYPE=web python main.py
# 新终端:启动数据同步节点
NODE_TYPE=data_sync python main.py
# 新终端:启动前端
cd frontend && npm run dev

6. 访问服务

📦 项目结构

StockAgent/
├── AgentServer/ # 后端服务
│ ├── main.py # 统一入口
│ ├── requirements.txt # Python 依赖
│ ├── .env.example # 环境变量模板
│ │
│ ├── core/ # 核心模块
│ │ ├── settings.py # 配置管理
│ │ ├── protocols.py # 协议定义
│ │ ├── rpc/ # gRPC 通信
│ │ └── managers/ # 管理器 (MongoDB, Redis, DataSource)
│ │
│ ├── src/ # 业务逻辑
│ │ ├── data_sources/ # 数据源适配器
│ │ └── collector/ # 新闻采集框架
│ │
│ ├── nodes/ # 节点实现
│ │ ├── web/ # Web 节点 (FastAPI)
│ │ │ └── api/ # API 路由
│ │ ├── data_sync/ # 数据同步节点
│ │ │ ├── collectors/ # 数据采集器
│ │ │ │ ├── stock/ # 股票数据
│ │ │ │ └── news/ # 新闻采集
│ │ │ ├── tasks/ # 定时任务
│ │ │ └── generators/ # 报告生成
│ │ ├── inference/ # 推理节点
│ │ ├── backtest_engine/ # 回测引擎
│ │ ├── mcp/ # MCP 节点
│ │ └── listener/ # 监听节点
│ │
│ ├── scripts/ # 工具脚本
│ └── deploy/ # 部署配置
│
├── frontend/ # 前端应用
│ ├── src/
│ │ ├── api/ # API 封装
│ │ ├── views/ # 页面视图
│ │ ├── stores/ # 状态管理
│ │ └── router/ # 路由配置
│ └── ...
│
├── manager.ps1 # Windows 管理脚本
├── backup.ps1 # 备份脚本
└── README.md # 本文件

📖 部署指南

Docker Compose 部署 (推荐)

cd AgentServer/deploy
# 启动所有服务
docker compose up -d
# 查看状态
docker compose ps

按需启动

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

🔧 配置说明

🗺️ 路线图

🤝 贡献指南

📄 许可证

⚠️ 免责声明

🙏 致谢

如果这个项目对你有帮助,请给一个 ⭐ Star 支持一下!