系统架构¶
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()