# VibeQuant

**Repository Path**: lele2015/vibe-quant

## Basic Information

- **Project Name**: VibeQuant
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-23
- **Last Updated**: 2026-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Vibe-Quant

基于 Tushare 数据的 A 股量化投研框架，支持多因子策略的全流程：数据获取、因子计算、模型训练、信号生成、Backtrader 回测验证。

## 目录结构

```
vibe-quant/
├── src/                          # 代码 + 文档
│   ├── python/                   # Python 源码
│   │   ├── pipeline_*.py         # Pipeline 入口（Stage 0-5）
│   │   ├── config.py             # 配置管理模块
│   │   ├── factors/              # 因子注册 + LLM 因子生成
│   │   └── scripts/              # 50+ 功能脚本
│   └── docs/                     # 文档
│       ├── guides/               # Pipeline 使用指南
│       ├── technical_notes/      # 技术分析笔记
│       └── plans/                # 开发计划
│
├── workspace/                    # 数据 + 配置 + 输出
│   ├── config/                   # 配置文件（含因子/策略/提示词定义）
│   │   ├── config.yaml           # 主配置文件
│   │   ├── config.yaml.template  # 配置模板
│   │   ├── factor_profiles/      # 因子分组定义（22 组）
│   │   ├── strategy_configs/     # 策略参数配置
│   │   └── prompt_templates/     # LLM Prompt 模板
│   ├── data/                     # 输入数据
│   │   ├── stock_pool/           # 股票池文件
│   │   ├── it_stocks/            # 历史行情
│   │   ├── daily_basic/          # 每日基本面
│   │   ├── moneyflow/            # 资金流
│   │   ├── margin/               # 融资融券
│   │   ├── cyq_perf/             # 筹码分布
│   │   ├── financial/            # 财务报表
│   │   └── holders/              # 股东信息
│   ├── factors/                  # 因子计算结果
│   │   ├── training_factors/     # 训练期因子
│   │   └── backtest_factors/     # 回测期因子
│   ├── models/                   # 训练模型
│   ├── signals/                  # 交易信号
│   ├── results/                  # 回测报告 / Dashboard
│   ├── logs/                     # 运行日志
│   └── temp/                     # 临时文件
│
└── .workspace                    # 指向 workspace/ 目录（内容: "workspace"）
```

## Pipeline 流程

```
Stage 0: 数据准备 → Stage 1: 因子计算 → Stage 2: 模型训练
                     → Stage 3: 可视化分析 → Stage 4: 信号生成
                                           → Stage 5: 回测验证
```

## 支持的策略

| 策略 | 文件 | 类型 |
|------|------|------|
| ML Baseline | `src/python/pipeline-bt-LGBM.py` | LightGBM 模型选股 |
| 多因子选股 | `src/python/pipeline-bt-multiFact.py` | 因子打分排序 |
| 简单排名 | `src/python/pipeline-bt-simpleRank.py` | 截面排名 |
| 反转策略 | `src/python/pipeline-bt-reversalV2.py` | 短期反转 |
| 强势股回调 | `src/python/pipeline-bt-pullback.py` | 放量回调确认 |

## 快速开始

```bash
cd E:\quant\vquant\vibe-quant

# 配置初始化
python src/python/config.py

# 全量流水线
python src/python/run_complete_pipeline.py
```

## 数据源

- **Tushare Pro** — 历史行情、财务、资金流、融资融券、筹码分布
- **AKShare** — 概念板块数据（备用）
- **Qlib** — Alpha158 因子（可选）

## 配置管理

优先级：`环境变量 > config.yaml > 自动检测 > 默认值`

敏感配置（token/路径）通过 `config.yaml` 管理，已从 Git 跟踪中移除。模板文件为 `config.yaml.template`。配置加载逻辑见 `src/python/config.py`。

## 远程

```bash
git remote -v
origin  https://gitee.com/lele2015/vibe-quant.git
```