跳转至

系统架构

EasyQuant 的核心是事件驱动回测库 eqlib。本文解释其整体架构以及各模块的职责。


整体架构

┌────────────────────────────────────────────────────────────────────────────┐
│                                   用户层                                   │
│  Python 脚本 / Jupyter Notebook                                            │
└──────────────────────────────────────┬─────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│  策略 API                                                                  │
│  initialize(context) / handle_data(ctx, data)                              │
│  run_daily(func) / order*()                                                │
└──────────────────────────────────────┬─────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│  回测引擎 (eqlib/engine.py)                                                │
│  ┌────────────┐  ┌────────────┐  ┌────────────┐                            │
│  │ 调度器     │  │ 订单撮合   │  │ 组合管理   │                            │
│  │ run_daily  │  │ T+1 检查   │  │ 持仓/现金  │                            │
│  │ run_weekly │  │ 100股取整  │  │ 手续费     │                            │
│  │            │  │ 涨跌停拦截 │  │            │                            │
│  │            │  │ 停牌取消   │  │            │                            │
│  │            │  │ 退市清算   │  │            │                            │
│  └────────────┘  └────────────┘  └────────────┘                            │
└──────────────┬──────────────────────────────────────────────┬──────────────┘
               │                                              │
               ▼                                              ▼
┌────────────────────────┐  ┌────────────────────────────────────────────────┐
│  数据层                │  │  分析与报告层                                  │
│  eqlib/data.py         │  │  eqlib/attribution.py  (Brinson / 因子分析)    │
│  ┌─────────────┐       │  │  eqlib/report.py       (HTML / PNG / MD / JSON)│
│  │ AKShare API │       │  │  eqlib/scientific/     (过拟合 / 偏差检测)     │
│  │ 本地 CSV    │       │  └────────────────────────────────────────────────┘
│  │ 缓存管理    │       │
│  └─────────────┘       │
└────────────────────────┘

模块职责

模块 文件 职责
回测引擎 eqlib/engine.py 事件循环、调度、订单撮合(含涨跌停/停牌/退市规则)、组合管理
数据 API eqlib/data.py 历史行情、实时快照、财务数据、A 股特色数据
交易执行 eqlib/trade.py 下单、T+1 检查、100 股取整、手续费计算
绩效分析 eqlib/attribution.py Sharpe、Alpha/Beta、Brinson 归因、因子分析
报告生成 eqlib/report.py HTML 交互式报告、PNG 图表、Markdown、JSON
选股框架 eqlib/selection.py TopNSelector、MultiFactorSelector、定期调仓
工具库 eqlib/utils/ 40+ 技术指标、统计分析、资金管理
通知 eqlib/notification.py 钉钉/飞书 Webhook 交易信号
科学验证 eqlib/scientific/ 过拟合检测、统计置信度、偏差检测

数据流

用户定义策略 → initialize() → run_daily() 注册回调
                                      │
                                      ▼
每个交易日: before_trading_start → handle_data / market_open → after_trading_end
                                      │
                                      ├── 调用 data API 获取行情
                                      ├── 计算信号
                                      ├── 调用 order*() 下单(入队)
                                      │
                                      ▼
                          下一交易日开盘:订单撮合(避免前视偏差)
                          ├─ 涨跌停拦截:开盘价触板的买/卖单当日取消
                          ├─ 停牌处理:当日无行情的订单当日取消(记入 cancel_reason)
                          └─ 退市清算:连续 30 个交易日无行情 → 强制卖出(DELIST_LIQUIDATE)
                                      │
                                      ▼
回测结束 → analyze_returns() → generate_report()