# QuantForge

**Repository Path**: hilw94/QuantForge

## Basic Information

- **Project Name**: QuantForge
- **Description**: A股量化因子研究平台
- **Primary Language**: Python
- **License**: Unlicense
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-28
- **Last Updated**: 2026-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QuantForge 量化因子研究平台
> 本地可移植量化研究系统：原始行情 → 因子计算 → 回测验证 → 组合构建，全流程离线运行

## 🚀 快速开始
1. 双击 `启动QuantForge.bat`，自动打开控制台（端口8767）
2. 双击 `运行测试.bat`，跑754个回归测试验证系统正常
3. 双击 `停止控制台.bat`，停止服务

## 📁 目录结构（和实际代码一一对应）
```
QuantForge/
├── engine/                 # 核心回测引擎
│   ├── FactorGene/         # 因子公式解析与计算模块
│   ├── backtest.py         # 事件研究法快筛回测
│   ├── paper_trading.py    # 模拟盘慢跑（T+1/涨跌停/交易成本）
│   ├── full_batch_runner.py# 全量批量跑批（分片加载/checkpoint续跑）
│   ├── signals.py          # 信号生成逻辑
│   ├── smart_scheduler.py  # CPU/内存自适应调度器
│   └── data_source.py      # 行情数据接口
├── data/                   # DuckDB数据库（行情/因子/结果）
├── config/                 # 配置文件（硬标准/参数）
├── console/                # 控制台后端API
├── static/                 # 控制台前端页面
├── docs/                   # 所有文档（数据字典/历史版本/交接文档）
├── tools/                  # 诊断/验证/备份工具脚本
├── launchers/              # 后台批处理启动脚本
├── tests_regression/       # 754个回归测试
├── logs/                   # 运行日志
├── runs/                   # 每次回测的输出结果
└── Temp/                   # 历史备份归档（33GB，不影响运行）
```

## ✅ 核心特性（当前实际实现）
- **双引擎架构**：快筛用事件研究法回测，深度分析用模拟盘引擎
- **全相对路径**：整个文件夹拷到任何Windows电脑/移动硬盘，双击就能跑，不用改任何配置
- **754个回归测试**：改任何代码跑一遍就能知道有没有碰坏功能
- **Checkpoint断点续跑**：全量跑批中途被杀，下次从上次的位置继续
- **L3口径一致性守卫**：防止不同模块算出来的夏普/回撤不一致
- **超额收益口径**：所有因子收益扣同窗口全池基准，消除幸存者偏差
- **信号明细落地**：symbol×date粒度信号全入库，支持任意组合回测

## 🔧 常用命令
- 启动控制台：`python start_quantforge.py`
- 跑回归测试：`python -m pytest tests_regression/ -q`
- 查看进度：`python tools/check_progress.py`