🧠 量化交易引擎（专业版）

> 📡 信息端 — 你用自己的东方财富 Key | 🧠 模型端 — 10 引擎在你本地跑 | 📤 输出端 — 建议 or 模拟下单

🏗 三模块架构

┌──────────────────────────────────────────────────────────────┐
│  📡 信息端 — 东方财富妙想 Skills                             │
│     用户自行注册 → 获取 MX_APIKEY → 配置环境变量              │
│     ├─ mx-data     行情 / 财务 / 资金流向                    │
│     ├─ mx-search   新闻 / 公告 / 研报                        │
│     └─ mx-xuangu   条件选股 / 成分股扫描                      │
├──────────────────────────────────────────────────────────────┤
│  🧠 模型端 — 10 引擎决策集群（部署在你本地，通过 API 对外）   │
│     本模块是专业版与入门版的唯一区别                          │
│     ├─ regime_clustering.py     市场状态聚类（K-Means）       │
│     ├─ prediction_model.py      预测模型（置信度校准）        │
│     ├─ rl_reward_engine.py      RL 强化学习奖励引擎           │
│     ├─ reliability_screen.py    风控可靠性筛选                │
│     ├─ dynamic_params.py        动态参数自适应                │
│     ├─ auto_turnover.py         自适应换手策略                │
│     ├─ self_reflect.py          自我反思闭环                  │
│     ├─ real_portfolio_manager.py 实盘仓位管理                 │
│     ├─ real_portfolio_advisor.py 投顾组合建议                 │
│     ├─ premarket_state.py       盘前状态评估                  │
│     └─ decision.py              决策聚合引擎（调度以上 10 个）│
├──────────────────────────────────────────────────────────────┤
│  📤 输出端 — 分析建议 OR 模拟交易执行                         │
│     ├─ 默认: 返回全引擎分析 + 买卖信号 + 置信度                │
│     └─ 可选: 安装 mx-moni → 策略自动下单到妙想模拟账户        │
└──────────────────────────────────────────────────────────────┘

📡 模块一：信息端（东方财富妙想 Skills）

> ⚠️ 引擎不含数据，你必须自己去东方财富申请免费 Key。

三步接入数据

# Windows CMD
set MX_APIKEY=你从妙想页面复制的Key

# Windows PowerShell
$env:MX_APIKEY="你从妙想页面复制的Key"

# macOS / Linux
export MX_APIKEY=你从妙想页面复制的Key

> 🔑 三个 Skill 共用同一把 MX_APIKEY。

🧠 模块二：模型端（10 引擎决策集群）

这是专业版与入门版唯一有区别的模块。 10 个引擎全部运行在你本地，通过 FastAPI 对外提供。

安装引擎

cd trading-engine-pro
pip install -r requirements.txt
python install.py

install.py 自动完成：检查 Python ≥3.8 → 安装 scikit-learn/numpy/pandas/scipy → 填入 mx_apikey → 验证 11 个模型文件 → 验证导入。

启动服务

python runner/start.py

启动时显示各引擎加载状态。浏览器打开 http://localhost:8000/docs。

10 引擎一览

API 端点

通用端点

专业版专属端点

> 💡 在线文档: http://localhost:8000/docs

📤 模块三：输出端（建议 or 模拟交易）

方式 A：分析建议（默认）

/api/v1/analyze 返回全引擎分析结果：

{
  "stock": "宁德时代 300750",
  "market_cluster": "bull",
  "recommendation": "buy",
  "confidence": 0.81,
  "signals": {
    "buy": ["regime_bull", "rl_positive", "reliability_pass"],
    "sell": []
  },
  "engines_used": ["regime_clustering", "rl_reward_engine", "reliability_screen", "prediction_model", "dynamic_params"],
  "score": 85
}

方式 B：接入妙想模拟交易（可选）

如果你有东方财富妙想模拟账户：

python mx_moni.py "买入 300750 价格 185.50 数量 100 股"
python mx_moni.py "一键撤单"
python mx_moni.py "我的持仓"

🆚 入门版 vs 专业版

⚙️ 配置文件（config.json）

{
  "mx_apikey": "你的东方财富 Key",
  "server_host": "0.0.0.0",
  "server_port": 8000,
  "no_auth": true,
  "rate_limit": { "rps": 10, "burst": 20 },
  "pro_engines": [
    "regime_clustering", "prediction_model", "rl_reward_engine",
    "reliability_screen", "dynamic_params", "auto_turnover",
    "self_reflect", "real_portfolio_manager",
    "real_portfolio_advisor", "premarket_state"
  ]
}

📂 文件结构

trading-engine-pro/
├── 📡 data/provider.py              ← 信息端：对接 mx-data/mx-search/mx-xuangu
├── 🧠 models/                        ← 模型端：10 引擎决策集群
│   ├── decision.py                   ← 决策聚合引擎
│   ├── regime_clustering.py          ← 市场聚类
│   ├── prediction_model.py           ← 预测模型
│   ├── rl_reward_engine.py           ← RL 强化学习
│   ├── reliability_screen.py         ← 风控筛选
│   ├── dynamic_params.py             ← 动态参数
│   ├── auto_turnover.py              ← 自适应换手
│   ├── self_reflect.py               ← 自我反思
│   ├── real_portfolio_manager.py     ← 仓位管理
│   ├── real_portfolio_advisor.py     ← 投顾建议
│   └── premarket_state.py            ← 盘前评估
├── 🚀 runner/start.py                ← API 服务启动
├── config.json                        ← 你的 mx_apikey 填这儿
├── requirements.txt                   ← pip 依赖
├── install.py                         ← 一键安装
├── SKILL.md                           ← 本文档
└── README.md                          ← 快速开始

⚠️ 法律声明

1. 不构成投资建议：本系统所有分析结果仅供参考，不构成任何投资建议。
2. 风险自负：用户自行决策并承担全部投资风险。
3. 数据免责：依赖第三方数据源，不对实时性、准确性、完整性作保证。
4. 无收益承诺：不承诺任何收益率或投资回报。
5. 合规使用：用户需确保使用行为符合所在地法律法规。
6. 接受即同意：安装或使用即视为已阅读并同意上述声明。

> ⚠️ 市场有风险，投资需谨慎。本工具为技术研究和学习辅助用途。