宏观错误定价套利引擎 · Macro Mispricing Arbitrage Engine
一套面向 A 股市场的全链路量化研究系统，覆盖定价研究、宏观因子监控、另类数据挖掘、跨市场回测与研究运营闭环。
当前版本：v4.1.0 · 查看更新日志
💰 定价研究 · 🛰️ 上帝视角 · 📂 研究工作台 · 🧪 Quant Lab — 4 大核心工作区 · 11 类 API 分组 · 30+ 运维脚本
本仓库是一个独立维护的量化研究项目，专注于以下四大核心方向：
| 工作区 | 图标 | 说明 |
|---|---|---|
| 定价研究 | 💰 | CAPM / Fama-French 三因子 / DCF 估值 / Gap Analysis |
| 上帝视角 (GodEye) | 🛰️ | 宏观因子引擎 · 证据质量 · 政策雷达 · 结构性衰败 · 跨市场总览 |
| 研究工作台 | 📂 | 研究任务持久化 · 状态流转 · 深链重开 · 剧本联动 |
| Quant Lab | 🧪 | 参数优化 · 风险归因 · 估值历史 · 告警编排 · 数据质量诊断 |
- 需要多模型定价分析能力，CAPM / FF3 / DCF 一键对比，发现错误定价
- 需要宏观因子监控和证据质量引擎，从源头追踪因子的可信度和衰变
- 需要一个完整的研究运营闭环，从发现到建模到回测到执行的全链路
- 需要另类数据管道：政策雷达、治理数据、人事脆弱性、供应链信号
| 如果你想先看 | 入口 |
|---|---|
| 🖼️ 系统实际长什么样 | 本地体验 + 页面预览 |
| ⚡ 怎么最快启动 | 快速开始 |
| 🔌 提供了哪些 API | API 路由 + API 参考 |
| 📝 最近版本改了什么 | 更新日志 |
当前不提供在线 Demo。请在本地启动前后端后体验完整功能。
git clone https://github.com/Leonard-Don/super-pricing-system.git
cd super-pricing-system
cp .env.example .env
./scripts/start_system.sh| 页面 | 地址 | 说明 |
|---|---|---|
| 💰 定价研究 | http://localhost:3100?view=pricing |
CAPM / FF3 / DCF / Gap Analysis |
| 🛰️ 上帝视角 | http://localhost:3100?view=godsEye |
宏观因子 · 证据质量 · 政策雷达 · 跨市场总览 |
| 📂 研究工作台 | http://localhost:3100?view=workbench |
研究任务持久化 · 状态流转 · 深链重开 |
| 🧪 Quant Lab | http://localhost:3100?view=quantlab |
参数优化 · 风险归因 · 估值历史 · 告警编排 |
| 📖 API 文档 | http://localhost:8100/docs |
OpenAPI 交互式文档 |
- 先进入 定价研究，完成标的检索、多模型估值和理论价格判断
- 再切到 上帝视角，查看宏观因子、证据质量和跨市场叙事切换
- 接着进入 研究工作台，验证任务卡、状态流转和深链重开
- 最后进入 Quant Lab，运行参数优化、估值实验和告警编排
多模型定价分析引擎，支持标的快速检索与同行对比：
- CAPM 模型 — 市场风险溢价估算与 β 系数分析
- Fama-French 三因子 — 规模/价值因子暴露计算
- DCF 现金流折现 — 自由现金流建模与敏感性分析
- Gap Analysis — 市场价格与理论价值的偏离度分析，识别潜在套利机会
- 估值支撑解释 — 多模型交叉验证与定价结论可解释性
宏观错误定价监控总部，集成多因子可靠度引擎：
- 宏观因子雷达 — 官僚摩擦 / 基荷错位 / 技术稀释 / 人事脆弱性 / 利率曲线压力 / 信用利差压力 / 汇率错配
- 证据质量引擎 — 来源可信度 · 冲突/漂移/断流诊断 · 跨源确认 · 反转前兆 · 因子共振
- 结构性衰败监控 — people / governance / execution / physical / evidence 维度雷达
- 部门混乱看板 — 政策执行紊乱监控与部门注意力碎片化分析
- 政策时间线 — 官方 feed + 正文抓取 + source health 诊断
- 跨市场总览 — 多市场联动关系与叙事切换预警
持久化研究运营中心，驱动从发现到执行的研究闭环：
- 研究卡片管理 — 后端持久化任务卡 · 状态流转 · 深链重开
- 快照解释与版本对比 — recommendation / allocation / bias / driver 主题变化追踪
- 研究剧本联动 — 与 GodEye、定价研究、跨市场回测的保存与重开闭环
- 共振驱动优先级 — 自动降级 · 核心腿受压 · 直达 deep link
独立量化实验台，系统性验证策略假设：
- 策略优化器 — 批量参数搜索 · Walk-Forward 验证
- 组合实验 — 多资产组合构建 · 基准对比 · 风险归因
- 估值实验室 — 估值历史回溯 · 敏感性矩阵
- 告警编排 — 自定义告警条件 · 批量管理 · 通知调度
- 数据质量中心 — 数据源健康度 · 断流/漂移检测 · 质量评分
|
|
| 系统总览 四大主工作区与研究闭环入口 |
交互演示 从入口切换到研究动作的连续体验 |
本地页面入口见上方"本地体验"。如果你想直接验证当前主应用链路，推荐在
tests/e2e/下运行端到端验证。
┌─────────────────────────────────────────────────────────────────┐
│ Frontend (React 18) │
│ ┌──────────┐ ┌──────────┐ ┌──────────────┐ ┌───────────────┐ │
│ │ 定价研究 │ │ GodEye │ │ 研究工作台 │ │ Quant Lab │ │
│ │ Pricing │ │ Dashboard│ │ Workbench │ │ Laboratory │ │
│ └──────────┘ └──────────┘ └──────────────┘ └───────────────┘ │
│ Ant Design · Recharts · Lightweight Charts │
├───────────────────────┬─────────────────────────────────────────┤
│ REST API (v1) │ WebSocket │
├───────────────────────┴─────────────────────────────────────────┤
│ Backend (FastAPI + Uvicorn) │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌─────────────┐ │
│ │ Pricing API│ │ Macro API │ │Workbench │ │QuantLab API │ │
│ │ AltData API│ │ Evidence │ │ API │ │Alerts API │ │
│ └────────────┘ └────────────┘ └────────────┘ └─────────────┘ │
├─────────────────────────────────────────────────────────────────┤
│ Core Engine (src/) │
│ ┌───────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │
│ │ Analytics │ │ Backtest │ │ Strategy │ │ Alternative Data │ │
│ │ (28+ 模块) │ │ Engine │ │ Library │ │ Pipeline │ │
│ └───────────┘ └──────────┘ └──────────┘ └──────────────────┘ │
├─────────────────────────────────────────────────────────────────┤
│ Infrastructure │
│ TimescaleDB · Redis · Celery · Prometheus │
└─────────────────────────────────────────────────────────────────┘
|
后端
|
前端 & 基础设施
|
本仓只展示私有系统工作区相关 API。
backtest / realtime / industry / trade等公开研究仓能力仍可能作为 Quant Lab 或历史任务的运行时支撑存在，但不作为super-pricing-system的主产品边界展示；公开入口请看独立仓quant-trading-system。
| 路由前缀 | 模块 | 说明 |
|---|---|---|
/pricing/* |
💰 定价研究 | 标的搜索 · 多模型定价 · 同行对比 · 敏感性分析 |
/pricing-support/* |
定价支撑 | 基准因子摘要 · 估值支撑解释 |
/alt-data/* |
另类数据 | 供应链 · 治理 · 人事 · 政策源 · 实体统一 |
/macro/* |
🛰️ 宏观引擎 | 因子可靠度 · 冲突诊断 · 衰败监控 · 部门混乱 |
/research-workbench/* |
📂 研究工作台 | 任务卡 CRUD · 状态流转 · 快照 |
/quant-lab/* |
🧪 Quant Lab | 优化实验 · 批量回测 · 告警 · 估值 |
/cross-market/* |
内部跨市场复盘 | GodEye / Workbench 深链重开与组合验证 |
/infrastructure/* |
系统支撑 | 认证 · 令牌管理 · 通知 · 本地运行状态 |
以下路由仍在后端挂载以兼容 Quant Lab 实验、旧快照和本地验证脚本，但已从生成的
OpenAPI/Postman 主文档隐藏：/market-data/*、/strategies/*、/backtest/*、
/realtime/*、/trade/*、/industry/*、/analysis/*、/events/*、/optimization/*。
| 依赖 | 最低版本 | 推荐版本 |
|---|---|---|
| Python | 3.9+ |
3.13 |
| Node.js | 16+ |
22 |
| npm | 8+ |
10+ |
| Docker | 可选 | 24+ (用于 TimescaleDB + Redis) |
git clone https://github.com/Leonard-Don/super-pricing-system.git
cd super-pricing-system
cp .env.example .env# 后端依赖
pip install -r requirements.txt
# 前端依赖
cd frontend && npm install && cd ..最简启动（无需 Docker，使用本地 ThreadPoolExecutor 任务队列）：
./scripts/start_system.sh默认任务执行器为内置
ThreadPoolExecutor；只有显式启用--with-worker并配置CELERY_BROKER_URL/REDIS_URL时才会切换到 Celery 调度。
完整启动（含基础设施 + Celery Worker）：
./scripts/start_system.sh --with-infra --with-worker --bootstrap-persistence# 健康检查
python3 ./scripts/health_check.py
# 打开浏览器
# 前端: http://localhost:3100
# API: http://localhost:8100/docs# 仅前后端
./scripts/stop_system.sh
# 含基础设施和 Worker
./scripts/stop_system.sh --with-infra --with-worker# 运行全部测试（unit + integration + system）
python scripts/run_tests.py
# 仅单元测试
python scripts/run_tests.py --unit
# 仅集成测试
python scripts/run_tests.py --integration
# 前端测试
cd frontend && CI=1 npm test -- --runInBand --watchAll=false
# 覆盖率报告
python scripts/run_tests.py --coverage详细说明请参阅 测试指南
pip install -r requirements-dev.txt
cd frontend && npm install && cd ..
./scripts/start_system.sh# 后端
API_RELOAD=false python backend/main.py
# 前端构建
cd frontend && npm run build# 启动 TimescaleDB + Redis
./scripts/start_infra_stack.sh --bootstrap-persistence
# 启动 Celery Worker
./scripts/start_celery_worker.sh
# 数据迁移
python3 ./scripts/migrate_infra_store.py --apply若未安装 Docker，系统可自动降级为 SQLite + 本地执行器运行。
支持 Nginx 反向代理部署，详见 部署指南。
super-pricing-system/
├── backend/ # FastAPI 后端应用
│ ├── main.py # 应用入口 & Uvicorn 启动
│ └── app/
│ ├── api/v1/endpoints/ # 26+ REST API 端点
│ ├── core/ # 配置中心 & 应用核心
│ ├── db/ # TimescaleDB Schema & 迁移
│ ├── schemas/ # Pydantic 请求/响应模型
│ ├── services/ # 业务服务层 (QuantLab 7 服务)
│ └── websocket/ # 实时行情 & 交易推送
│
├── frontend/ # React 前端应用
│ └── src/
│ ├── components/ # 40+ 页面组件
│ │ ├── pricing/ # 定价研究 UI (11 组件)
│ │ ├── GodEyeDashboard/ # 上帝视角 UI (29 组件)
│ │ ├── research-workbench/ # 研究工作台 UI (18 组件)
│ │ ├── quant-lab/ # 量化实验台 UI (49 组件)
│ │ └── ...
│ ├── hooks/ # 自定义 React Hooks
│ ├── services/ # API 调用封装
│ └── i18n/ # 国际化
│
├── src/ # 核心计算引擎
│ ├── analytics/ # 分析模块 (26+ 引擎)
│ ├── backtest/ # 回测引擎 (14 模块)
│ ├── data/ # 数据层
│ │ ├── alternative/ # 另类数据管道
│ │ └── providers/ # 多数据源适配器
│ ├── strategy/ # 策略库
│ └── research/ # 研究工作台核心
│
├── tests/ # 测试套件
│ ├── unit/ # 单元测试
│ ├── integration/ # 集成测试
│ └── e2e/ # 浏览器端到端回归
│
├── scripts/ # 运维脚本 (30+)
├── docs/ # 项目文档
├── docker-compose.pricing-infra.yml # 基础设施编排
└── VERSION # 当前版本: 4.1.0
| 文档 | 说明 |
|---|---|
| API 参考手册 | 完整 API 端点说明 |
| 更新日志 | 版本发布记录 |
| 部署指南 | 开发/生产环境部署 |
| 测试指南 | 测试分层与运行方式 |
| 项目结构 | 代码组织说明 |
| 贡献指南 | 开发流程与提交建议 |
| 安全政策 | 漏洞报告流程 |
如果你还需要更偏交易研究、实时监控和行业轮动分析的能力，可以查看独立项目 quant-trading-system。
两个项目当前按独立仓维护：
| 项目 | 聚焦领域 |
|---|---|
| super-pricing-system (本仓) | 💰 定价研究 · 🛰️ 上帝视角 · 📂 研究工作台 · 🧪 Quant Lab |
| quant-trading-system | 📊 策略回测 · 📈 实时行情 · 🔥 行业热度 |
两边各自独立 clone、安装、启动、测试和发布。
MIT License © 2026 Leonardo