# EasyXT

**Repository Path**: coderbank/EasyXT

## Basic Information

- **Project Name**: EasyXT
- **Description**: clone from https://github.com/quant-king299/EasyXT.git
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-10-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EasyXT - 模块化QMT量化交易工具集

[![Python](https://img.shields.io/badge/Python-3.9+-blue.svg)](https://www.python.org/)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![QMT](https://img.shields.io/badge/QMT-Compatible-orange.svg)](https://www.gtja.com/)
[![Website](https://img.shields.io/badge/Website-ptqmt.com-blue?logo=google-chrome)](https://www.ptqmt.com)

> **🎉 重要更新：** EasyXT 已全面支持**大 QMT（完整版）和 miniQMT**！
> - ✅ 大 QMT 用户：通过信号桥接实现完整交易功能（知识星球专属）
> - ✅ miniQMT 用户：直连模式，响应速度极快
> - ✅ 代码零改动：自动检测并选择最优模式
> - 详细说明请参阅 [📖 QMT版本说明](docs/assets/QMT_VERSIONS.md) 和下方"大 QMT 支持说明"章节

> 量化为王，策略致胜，我是只聊干货的王者 quant！

---

## 🎯 项目定位

**EasyXT 不是单一框架，而是一套模块化的量化交易工具集**，包含：

### 核心特性

- 🎯 **简化API**: 封装复杂的QMT接口，提供易用的Python API
- 💰 **真实交易**: 支持通过EasyXT接口进行真实股票交易
- 🔀 **双模式支持**: 大 QMT（信号桥接）和 miniQMT（直连）自动切换
- 📊 **多数据源**: Tushare、DuckDB、东方财富、akshare 智能降级
- 📈 **技术指标**: 内置常用技术指标计算
- 🚀 **策略开发**: 提供完整的量化策略开发框架
- 🔐 **自动登录**: 支持QMT/miniQMT自动登录，包括验证码识别
- 📚 **学习实例**: 丰富的教学案例，从入门到高级
- 🌍 **跨平台支持**: 支持Windows、macOS、Linux（通过xqshare远程客户端）

### 模块概览

| 模块 | 类型 | 说明 | 独立性 |
|------|------|------|--------|
| **easy_xt** | 📦 核心库 | QMT API的轻量级封装，支持大 QMT/miniQMT 双模式 | ✅ 可独立使用 |
| **easyxt_backtest** | 🔧 扩展工具 | 通用回测框架，支持多策略、多数据源 | ✅ 可独立使用 |
| **101因子平台** | 📊 独立应用 | 基于Streamlit的因子分析Web应用 | ✅ 完全独立 |
| **strategies** | 📁 策略集合 | 完整的交易策略示例（雪球跟单、网格交易等） | ⚠️ 依赖easy_xt |
| **quant_strategies** | ⭐ 知识星球专属 | 大 QMT 信号桥接 + 高级策略集合 | ⚠️ 星球专属 |
| **学习实例** | 📚 教学案例 | 从入门到实战的代码教程 | ⚠️ 依赖easy_xt |

**核心理念**：按需选用，低耦合，清晰边界

---

## 🚀 快速导航

### 🤔 我该从哪里开始？

#### 我是新手，想学习量化交易
→ 📖 **[学习路径](#-学习路径)** → 从 `学习实例/` 开始

#### 我只需要API封装，要在自己的项目中使用
→ 📦 **[easy_xt API文档](easy_xt/README.md)** → 只需安装 `easy_xt`

#### 我想做策略回测
→ 🔧 **[回测系统指南](easyxt_backtest/README.md)** → 使用 `easyxt_backtest`

#### 我要用现成的策略
→ 📁 **[策略列表](strategies/README.md)** → 查看 `strategies/` 目录

#### 我想做因子分析
→ 📊 **[101因子平台](101因子/101因子分析平台/README.md)** → 独立Web应用

#### 我想自动登录QMT
→ 🔐 **[QMT自动登录](core/auto_login/README.md)** → 一键启动并登录

#### 我想下载/更新基础数据
→ 📋 **数据下载速查表**（见下方）

### 📋 环境要求

| 组件 | 要求 | 说明 |
|------|------|------|
| **Python** | 3.9+ | 推荐使用 3.10 或 3.11 |
| **操作系统** | Windows/macOS/Linux | Windows 原生支持，Mac/Linux 通过 xqshare |
| **QMT** | 大 QMT 或 miniQMT | 交易功能必需，回测功能可选 |
| **数据源** | Tushare Token（推荐） | 可选，但有 Tushare 数据体验更好 |

---

### 📋 数据下载速查表

> 前置条件：项目根目录 `.env` 中已配置 `TUSHARE_TOKEN`

#### GUI 方式（推荐）

运行 `python run_gui.py` → 点击「Tushare下载」标签 → 各子标签页下载数据。

#### 命令行方式

```bash
# 进入项目根目录
cd /path/to/EasyXT

# ─── 基础数据（5000分专属，优先下载） ───
# 一键下载全部：复权因子 + 涨跌停价格 + 停复牌 + 申万行业
python -m tushare_manager.download_basic_data --all

# 单独下载某类（指定起始日期）
python -m tushare_manager.download_basic_data --adj-factor --start 20200101   # 复权因子
python -m tushare_manager.download_basic_data --stk-limit --start 20200101    # 涨跌停价格
python -m tushare_manager.download_basic_data --suspend --start 20200101      # 停复牌信息
python -m tushare_manager.download_basic_data --sw-industry                   # 申万行业分类

# ─── 常规数据 ───
# 股票基本信息 + 指数成分股
python -m tushare_manager.supplement_tables --all

# DuckDB 一键初始化（市值 + 日线）
python tools/setup_duckdb.py
```

> 💡 所有下载命令都支持**增量更新**——重复运行只会下载缺失的数据，不会重复下载。

### 🔧 遇到问题了？

→ 🆘 **[疑难问题解答 (FAQ)](docs/assets/TROUBLESHOOTING.md)** ← **点击这里！**
- DuckDB数据库找不到？数据下载失败？
- 安装报错？运行失败？性能问题？
- 这里收集了最常见的问题和解决方案！

### 📂 不确定路径配置？

→ 📁 **[路径配置指南](docs/SETUP_GUIDE.md#15-qmt-路径配置)** ← **新手必读！**
- 什么是"项目根目录"？
- 从 GitHub 下载后文件夹是什么名字？
- 如何正确配置路径？

### 🏗️ 我想了解系统架构

→ 📐 **[系统架构文档 (ARCHITECTURE)](docs/ARCHITECTURE.md)** - 了解项目整体设计、模块关系和技术选型

---

## 🌍 跨平台支持

EasyXT 现已支持 **Windows、macOS、Linux** 三大平台！

### 平台支持矩阵

| 平台 | 本地 QMT | 远程 xqshare | 推荐场景 |
|------|----------|--------------|----------|
| **Windows** | ✅ 原生支持 | ✅ 可选 | 专业交易用户 |
| **macOS** | ❌ 不可用 | ✅ 完美支持 | Mac 用户 |
| **Linux** | ❌ 不可用 | ✅ 完美支持 | 服务器部署 |

### Mac/Linux 用户快速开始

通过 **xqshare 远程客户端**，EasyXT 可以在 macOS 和 Linux 上完美运行！

#### 1️⃣ 安装 xqshare

```bash
pip install xqshare
```

#### 2️⃣ 配置环境变量

```bash
# 设置远程服务器地址
export XQSHARE_REMOTE_HOST="your-server-ip"
export XQSHARE_REMOTE_PORT="18812"

# 或者使用 .env 文件
echo "XQSHARE_REMOTE_HOST=your-server-ip" >> .env
echo "XQSHARE_REMOTE_PORT=18812" >> .env
```

#### 3️⃣ 正常使用 EasyXT

```python
from easy_xt import get_api

# 获取 API（自动检测并使用 xqshare）
api = get_api()

# 数据获取和交易完全相同
data = api.data.get_price(['000001.SZ'])
```

### 数据源自动降级

EasyXT 会自动选择最佳数据源：

```
QMT (本地)
    ↓ 失败
xqshare (远程)  ← Mac/Linux 用户自动使用
    ↓ 失败
TDX (通达信)
    ↓ 失败
Eastmoney (东方财富)
```

> 更多跨平台问题见 [FAQ - xqshare 相关](docs/assets/TROUBLESHOOTING.md#xqshare-相关)

### 感谢贡献者

特别感谢 **[@jasonhu](https://github.com/jasonhu)** 为项目贡献了 xqshare 跨平台支持功能！

---

## 🔥 大 QMT 支持说明

EasyXT 已全面支持**大 QMT（完整版）**和 miniQMT，实现代码零改动的双模式运行！

### 🎯 双模式架构

```
┌─────────────────────────────────────────────────────────────┐
│                    EasyXT 智能检测层                         │
├─────────────────────────────────────────────────────────────┤
│  检测 XtItClient.exe 进程 → 自动选择最优模式                 │
└─────────────────────────────────────────────────────────────┘
                              ↓
         ┌────────────────────┴────────────────────┐
         ↓                                         ↓
    大 QMT 运行中                              miniQMT 可用
         ↓                                         ↓
   ┌─────────────────┐                     ┌─────────────────┐
   │  信号桥接模式    │                     │   直连模式      │
   │ (星球专属)      │                     │                 │
   ├─────────────────┤                     ├─────────────────┤
   │ Python策略      │                     │ xttrader API    │
   │     ↓           │                     │     ↓           │
   │ 文件信号        │                     │ 直接调用        │
   │     ↓           │                     │     ↓           │
   │ 大QMT执行       │                     │ miniQMT执行     │
   └─────────────────┘                     └─────────────────┘
```

### ⭐ 知识星球专属功能

**大 QMT 信号桥接**是知识星球专属功能，提供：

- 📡 **信号桥接系统**：通过文件信号实现 Python 策略与大 QMT 的通信
- 🚀 **高级策略集合**：ETF 热门主题轮动、ETF 趋势、涨停板策略等
- 🔄 **完整交易支持**：买入、卖出、撤单、查询持仓/资产
- 📊 **实时监控**：订单状态跟踪、执行结果反馈

**工作原理**：
```python
# Python 端（EasyXT）
from easy_xt import get_api

api = get_api()
api.init_trade()  # 自动检测大 QMT，启用信号桥接

# 下单（自动走信号桥接）
api.buy(account_id='xxx', code='600000.SH', volume=100, price=12.5)
```

```python
# 大 QMT 端（星球专属 qmt_signal_receiver_for_qmt.py）
# 定时扫描信号目录，自动执行交易指令
```

> 💡 **加入知识星球**获取完整的大 QMT 信号桥接代码和高级策略！

### 📊 数据获取完全独立

无论使用大 QMT 还是 miniQMT，数据获取都完全独立于 QMT 行情端：

```
行情数据源（不依赖 xtdata）：
├── Tushare        → 完整历史 + 实时数据
├── DuckDB         → 本地极速查询
├── 东方财富       → 免费备用数据源
└── akshare        → 补充数据源

交易通道：
├── 大 QMT         → 信号桥接（星球专属）
└── miniQMT        → xttrader 直连
```

### 📖 相关文档

- [📖 QMT版本说明](docs/assets/QMT_VERSIONS.md)
- [📖 QMT自动登录](docs/assets/QMT_AUTOLOGIN_SECTION.md)

---

## 📦 核心模块说明

### 📁 详细项目结构

```
EasyXT/                          # 项目根目录（从 GitHub 下载后的文件夹名）
├── easy_xt/                    # 核心API模块
│   ├── __init__.py
│   ├── api.py                  # 主API接口
│   ├── data_api.py            # 数据接口
│   ├── trade_api.py           # 交易接口
│   ├── advanced_trade_api.py  # 高级交易接口
│   └── utils.py               # 工具函数
├── easyxt_backtest/           # 回测框架
│   ├── enhanced_backtest_engine.py  # 事件驱动回测引擎
│   ├── vectorized_engine.py   # 向量化回测引擎
│   ├── metrics.py             # 统一绩效指标
│   ├── performance.py         # 性能分析
│   └── strategies/            # 策略实现
├── core/data_manager/         # 回测与研究共用的数据管理器
│   ├── hybrid_manager.py      # 多数据源管理
│   ├── local_price_reader.py  # 规范化本地日线读取
│   └── sources/               # DuckDB/QMT/Tushare/BaoStock适配器
├── 101因子/                    # 因子分析平台
│   └── 101因子分析平台/       # Streamlit应用
├── strategies/                 # 策略集合
│   ├── xueqiu_follow/         # 雪球跟单
│   ├── grid_trading/          # 网格交易
│   ├── jq2qmt/                # 聚宽转QMT
│   └── tdxtrader/             # 通达信预警交易
├── 学习实例/                   # 学习案例
│   ├── 01_基础入门.py
│   ├── 02_交易基础.py
│   └── ...
├── gui_app/                    # GUI应用
│   ├── main_window.py
│   └── widgets/
├── tools/                      # 开发工具
│   ├── debug_qmt_api.py
│   └── demos/
├── config/                     # 配置文件
├── data/                       # 数据存储
├── logs/                       # 日志目录
├── xtquant/                    # QMT相关文件（需手动安装）
├── requirements.txt            # 依赖列表
└── README.md                   # 本文件
```

### 1️⃣ easy_xt - 核心库（可独立使用）

**定位**：轻量级QMT API封装库

**特点**：
- ✅ 简洁的Python接口，隐藏QMT复杂性
- ✅ 统一的数据获取（行情、财务、指数成分股等）
- ✅ 标准化的交易接口（下单、查询、持仓管理）
- ✅ **无依赖其他模块**，可单独集成到任何项目

**安装**：
```bash
pip install -e ./easy_xt
```

**使用示例**：
```python
from easy_xt import get_api

# 获取API实例
api = get_api()

# 获取行情数据
data = api.get_price(
    ['000001.SZ'],
    start='20240101',
    period='1d'
)
```

**📖 详细文档**：[easy_xt/README.md](easy_xt/README.md)

---

### 2️⃣ easyxt_backtest - 回测框架（可独立使用）

**定位**：通用量化策略回测框架

**特点**：
- ✅ 支持多种策略类型（选股策略、因子策略）
- ✅ 多数据源支持（DuckDB、QMT、Tushare）
- ✅ 完整的交易模拟（佣金、滑点、持仓管理）
- ✅ 详细的性能分析（夏普比率、最大回撤等）
- ✅ **不依赖101因子平台**，可独立使用

**安装**：
```bash
# 方法1：添加到 PYTHONPATH（推荐）
# Windows PowerShell:
$env:PYTHONPATH += ";C:\path\to\EasyXT"

# 或永久添加：
[System.Environment]::SetEnvironmentVariable("PYTHONPATH", "C:\path\to\EasyXT", "User")
```

**使用示例**：

```python
from easyxt_backtest import BacktestEngine, DataManager
from easyxt_backtest.strategies import SmallCapStrategy

# 创建数据管理器（无需参数，自动使用QMT/Tushare）
data_manager = DataManager()

# 如果有DuckDB数据库，可以指定路径（可选，提速10倍）
# data_manager = DataManager(duckdb_path='D:/StockData/stock_data.ddb')

# 创建回测引擎
engine = BacktestEngine(initial_cash=1000000, data_manager=data_manager)

# 运行回测
strategy = SmallCapStrategy(select_num=5)
result = engine.run_backtest(strategy, '20230101', '20231231')
result.print_summary()
```

**💡 提示**：
- ✅ **不需要DuckDB** - 无参数即可使用QMT/Tushare数据
- 🚀 **DuckDB是可选的** - 如果有，速度提升10倍

**📖 详细文档**：[easyxt_backtest/README.md](easyxt_backtest/README.md)

---

### 3️⃣ 101因子分析平台（完全独立应用）

**定位**：基于Streamlit的因子研究Web应用

**特点**：
- ✅ 191个Alpha因子（Alpha101全系列 + Alpha191扩展）
- ✅ 可视化工作流编辑器（拖拽式构建策略）
- ✅ 完整的因子分析工具（IC分析、分层回测）
- ✅ **完全独立的Web应用**，不依赖其他模块

**启动**：
```bash
cd 101因子/101因子分析平台
python 启动增强版.py
```

访问：http://127.0.0.1:8510

**📖 详细文档**：[101因子分析平台/README.md](101因子/101因子分析平台/README.md)

---

### 4️⃣ strategies - 策略集合（依赖easy_xt）

**定位**：完整的实战策略示例

**包含策略**：
- ❄️ **雪球跟单**：自动跟随雪球组合调仓
- 🔲 **网格交易**：固定网格、高频分时网格
- 📡 **通达信预警交易**：基于通达信预警自动交易
- 🔄 **聚宽策略转QMT**：JQ2QMT适配器

**依赖关系**：依赖 `easy_xt` 核心库

**📖 详细文档**：[strategies/README.md](strategies/README.md)

---

### 5️⃣ 学习实例 - 教学案例（依赖easy_xt）

**定位**：从入门到实战的代码教程

**学习路径**：
1. **01_基础入门.py** - 数据获取和API使用
2. **02_交易基础.py** - 基础交易操作
3. **04_策略回测.py** - 策略开发与回测
4. **07_akshare数据获取** - 多数据源集成
5. **10_qstock真实案例** - 完整实战案例

**依赖关系**：依赖 `easy_xt` 核心库

---

## 🏗️ 项目架构图

```
EasyXT 项目结构
│
├── 【核心层】可独立使用
│   ├── easy_xt/              # 核心API封装库
│   │   └── 无任何其他依赖
│   │
│   └── easyxt_backtest/      # 回测框架
│       └── 可独立使用（不依赖101因子平台）
│
├── 【应用层】独立应用
│   └── 101因子/101因子分析平台/  # 因子分析Web应用
│       └── 完全独立，不依赖其他模块
│
└── 【示例层】依赖核心库
    ├── strategies/           # 策略集合（依赖easy_xt）
    ├── 学习实例/             # 教学案例（依赖easy_xt）
    └── gui_app/             # GUI界面（依赖easy_xt）
```

**模块依赖关系**：
- `easy_xt` ← 零依赖，可独立使用
- `easyxt_backtest` ← 可独立使用（不依赖101因子）
- `101因子平台` ← 完全独立
- `strategies` → 依赖 `easy_xt`
- `学习实例` → 依赖 `easy_xt`

---

## 📚 学习路径

### 🚀 快速开始（5分钟上手）

#### 基础数据获取

```python
from easy_xt import EasyXT

# 创建API实例
api = EasyXT()

# 初始化数据服务
api.init_data()

# 获取股票价格
data = api.get_price('000001.SZ', count=100)
print(data.head())
```

分钟K线（`1m`、`5m`、`15m`、`30m`）首次读取会先查 QMT 本地缓存；
缓存为空时，指定 `start`/`end` 的查询会按该日期范围请求下载，不再固定为最近三天。
使用 `count` 时会按周期和条数估算包含周末的下载窗口；不指定日期或条数时默认请求最近十个自然日。
窗口是下载请求范围，不保证 QMT 上游一定有足够的K线；下载后若仍为空，错误会写明实际请求区间。

```python
bars = api.get_price('002714.SZ', period='1m', count=100)
history = api.get_price('002714.SZ', start='20260901', end='20260914', period='1m')
```

#### 简单交易示例

```python
# 初始化交易服务
api.init_trade(USERDATA_PATH)
api.add_account(ACCOUNT_ID)

# 买入股票
order_id = api.buy(
    account_id=ACCOUNT_ID,
    code='000001.SZ',
    volume=100,
    price_type='market'
)
```

### 初学者路线

```bash
# 第1步：学习基础API
学习实例/01_基础入门.py
学习实例/02_交易基础.py

# 第2步：了解策略开发
学习实例/04_策略回测.py

# 第3步：运行现成策略
strategies/grid_trading/固定网格.py
```

### 进阶路线

```bash
# 第1步：学习回测框架
easyxt_backtest/examples/small_cap_backtest.py

# 第2步：开发自定义策略
easyxt_backtest/strategies/ (参考策略基类)

# 第3步：使用因子平台
cd 101因子/101因子分析平台
python 启动增强版.py
```

### 实战路线

```bash
# 第1步：部署雪球跟单
strategies/xueqiu_follow/启动雪球跟单.bat

# 第2步：部署通达信预警交易
strategies/tdxtrader/ (查看README)

# 第3步：监控和优化
gui_app/main_window.py
```

---

## ⚙️ 安装指南

> 📖 **安装文档**：
> - **[INSTALL.md](docs/INSTALL.md)** - 快速安装指南
> - **[SETUP_GUIDE.md](docs/SETUP_GUIDE.md)** - 🆕 增强版配置指南（包含详细的 xtquant、数据源、IDE 配置说明）
>
> ⚠️ **遇到 `cannot import name 'datacenter' from 'xtquant'` 错误？** 查看 [SETUP_GUIDE.md - xtquant 配置](docs/SETUP_GUIDE.md#15-qmt-路径配置)

### 环境要求

- Python 3.9+
- Windows系统（QMT限制，但 Mac/Linux 可通过 xqshare 使用）
- 已安装QMT客户端（大 QMT 或 miniQMT，如需交易功能）

### 克隆项目

```bash
# 克隆时加 --recursive，否则 code_converter/ 目录为空
git clone --recursive https://github.com/quant-king299/EasyXT.git

# 如果已经克隆过，用这条命令拉取子模块
git submodule update --init
```

> `code_converter/` 是独立的子模块 [JQ2PTrade](https://github.com/quant-king299/JQ2PTrade)（聚宽策略转PTrade代码转换器），可按需使用。

### 快速安装

#### 1️⃣ 安装xtquant（必需且重要）

**⚠️ 重要：本项目需要特殊版本的 xtquant，不能使用 pip 安装的官方版本！**

##### 为什么必须使用特殊版本？

不同券商的QMT版本发布节奏不一致，xtquant接口和行为存在差异。为避免连接失败、字段缺失、接口不兼容等问题，**本项目仅支持以下特定版本**。

##### 下载地址

🔗 **https://github.com/quant-king299/EasyXT/releases/tag/v1.0.0**

下载附件：`xtquant.rar`

##### 安装步骤

**方法 1：直接解压到项目根目录（推荐）**

1. 下载 `xtquant.rar`
2. 解压到项目根目录（即克隆/下载 EasyXT 项目后的文件夹）
3. 确保目录结构为：`项目根目录/xtquant/`

> **说明**：如果你从 GitHub 下载的是 `EasyXT-main.zip`，解压后的文件夹名为 `EasyXT-main`，那么项目根目录就是 `EasyXT-main/`

**方法 2：解压到自定义目录 + 设置环境变量**

1. 解压到自定义目录，如：`C:\xtquant_special`
2. 设置环境变量 `XTQUANT_PATH`：

   **PowerShell**：
   ```powershell
   setx XTQUANT_PATH "C:\xtquant_special"
   ```

   **CMD**：
   ```cmd
   setx XTQUANT_PATH "C:\xtquant_special"
   ```

3. **重启终端/IDE** 使环境变量生效

##### 验证安装

```bash
python -c "from xtquant import xtdata; print('✓ xtquant 安装正确')"
```

如果报错 `No module named 'xtquant'`，说明 xtquant **未安装**。

##### 一键下载并解压（PowerShell）

```powershell
$url = "https://github.com/quant-king299/EasyXT/releases/download/v1.0.0/xtquant.rar"
$dest = "$PWD\xtquant.rar"
Invoke-WebRequest -Uri $url -OutFile $dest -UseBasicParsing
if (Test-Path "$env:ProgramFiles\7-Zip\7z.exe") {
  & "$env:ProgramFiles\7-Zip\7z.exe" x -y "$dest" -o"$PWD"
} elseif (Get-Command 7z.exe -ErrorAction SilentlyContinue) {
  7z x -y "$dest" -o"$PWD"
} else {
  Write-Host "未检测到 7-Zip，请手动解压 $dest 到项目根目录"
}
Remove-Item $dest -ErrorAction SilentlyContinue
if (Test-Path "$PWD\xtquant") { Write-Host "✓ xtquant 安装完成" } else { Write-Host "✗ xtquant 目录未找到，请检查解压" }
```

#### 2️⃣ 安装核心库

```bash
# 安装easy_xt核心库
pip install -e ./easy_xt

# 验证安装
python -c "from easy_xt import get_api; print('✓ 安装成功')"
```

#### 3️⃣ 按需使用扩展模块

```bash
# 如果需要回测功能，将项目路径添加到 PYTHONPATH
# PowerShell:
$env:PYTHONPATH += ";$PWD"

# 或永久添加：
[System.Environment]::SetEnvironmentVariable("PYTHONPATH", "$PWD", "User")

# 如果需要因子平台
cd 101因子/101因子分析平台
pip install -r requirements.txt

# 如果需要自动登录功能（🆕）
pip install pywinauto pyautogui
```

#### 4️⃣ 配置自动登录（可选）

如果需要使用 QMT 自动登录功能：

1. 复制配置文件：
   ```bash
   cp .env.example .env
   ```

2. 编辑 `.env` 文件，填写QMT登录信息：
   ```env
   QMT_EXE_PATH=D:/QMT交易端/bin.x64/XtMiniQmt.exe
   QMT_USER_ID=8888499999
   QMT_PASSWORD=your_password
   QMT_DATA_DIR=D:/QMT交易端/userdata_mini
   ```

3. 运行自动登录：
   ```bash
   python start_qmt.py
   ```

详细说明：[🔐 QMT自动登录指南](core/auto_login/README.md)

---

### ⚙️ 首次使用配置

#### 配置 Tushare Token（数据下载功能需要）

```bash
# 1. 复制配置模板
copy .env.example .env

# 2. 编辑 .env，填入你的 Token
# TUSHARE_TOKEN=你的Token

# 3. 验证
python -c "import os; from dotenv import load_dotenv; load_dotenv(); print('OK' if os.getenv('TUSHARE_TOKEN') else '未配置')"
```

Token 获取地址：https://tushare.pro → 注册 → 用户中心 → 接口Token

> 不配置 Token 不影响核心功能，QMT 本地数据照常使用。详细说明见 [FAQ - Tushare 配置](docs/assets/TROUBLESHOOTING.md#tushare配置问题)

---

### 📋 安装检查清单

在开始使用前，请确认以下事项：

- [ ] 已下载并解压特殊版本的 `xtquant`
- [ ] 验证 `from xtquant import xtdata` 不报错
- [ ] 已安装 `easy_xt` 核心库（`pip install -e ./easy_xt`）
- [ ] 如需回测，已设置 PYTHONPATH 指向项目目录
- [ ] 如需Tushare数据，已配置 Token
- [ ] QMT客户端已安装并登录
- [ ] Python 版本 ≥ 3.9

### 快速验证安装

运行以下命令验证所有组件：

```bash
# 1. 验证 xtquant（如果报错，查看 SETUP_GUIDE.md）
python -c "from xtquant import xtdata; print('✓ xtquant OK')"

# 2. 验证 easy_xt
python -c "from easy_xt import get_api; print('✓ easy_xt OK')"

# 3. 验证 easyxt_backtest（如果已安装）
python -c "import easyxt_backtest; print('✓ easyxt_backtest OK')"

# 4. 验证 Tushare Token（如果已配置）
python -c "from dotenv import load_dotenv; load_dotenv(); import os; print('✓ Tushare Token:', os.getenv('TUSHARE_TOKEN')[:10] + '...') if os.getenv('TUSHARE_TOKEN') else print('✗ Token未配置')"
```

**如果第 1 步报错**（`cannot import name 'datacenter' from 'xtquant'`），请查看 **[SETUP_GUIDE.md - xtquant 配置](docs/SETUP_GUIDE.md#15-qmt-路径配置)** 获取详细解决方案。

---

## 🛠️ 开发者工具（可选）

项目包含一些开发者工具和演示脚本，位于 `tools/` 目录：

### 诊断工具
- `tools/debug_qmt_api.py` - 检查 easy_xt API 结构
- `tools/debug_data_api.py` - 验证数据连接

### 演示脚本
- 配置系统演示
- 监控告警演示
- 任务调度器演示
- 性能压测演示
- 日志管理演示

### 监控系统
```bash
# 启动监控服务
python start_monitor.py --config config/monitor_config.json

# 查看状态
python start_monitor.py --status
```

### 雪球跟单策略

**快速启动**：
```powershell
# 批处理脚本（Windows）
.\strategies\xueqiu_follow\启动雪球跟单.bat

# 或 Python 入口
python strategies\xueqiu_follow\start_xueqiu_follow_easyxt.py
```

**常见问题**：
- **Q**: 连接返回 -1 / "交易服务连接失败"？
- **A**: 99% 为 `qmt_path` 路径错误，请确保指向本机 `userdata` 或 `userdata_mini` 目录，避免 `0MT` 与 `userdata mini` 等拼写错误。

**详细配置**: 查看 `strategies/xueqiu_follow/README.md`

### JQ2QMT / QKA 服务（聚宽策略迁移）

如需将聚宽策略迁移到QMT：
```powershell
python strategies\jq2qmt\run_qka_server.py --account YOUR_ACCOUNT_ID --mini-qmt-path "C:\\Path\\To\\miniQMT"
```

详细文档：查看 `strategies/jq2qmt/README.md`

---

详细文档：查看 `tools/` 目录下的 README 文件

---

## 🎓 常见问题

> 完整 FAQ 见 **[疑难问题解答](docs/assets/TROUBLESHOOTING.md)**

**Q: 我应该安装哪些模块？**
根据需求选择：只要API → `easy_xt`；做回测 → `easy_xt` + `easyxt_backtest`；因子研究 → `101因子平台`（独立）；用现成策略 → `easy_xt` + `strategies/`

**Q: 我是新手，从哪里开始？**
`学习实例/01_基础入门.py` → `02_交易基础.py` → `04_策略回测.py`

---

## 🔗 相关链接

- **项目主页**: https://github.com/quant-king299/EasyXT
- **问题反馈**: https://github.com/quant-king299/EasyXT/issues
- **网站**: https://www.ptqmt.com
- **微信公众号**: 量化王国Quantaria

---

## 📄 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

---

## ⚠️ 风险提示

1. **投资风险**：量化交易存在投资风险，请谨慎操作
2. **测试环境**：建议先在模拟环境中测试策略
3. **资金管理**：合理控制仓位，设置止损止盈
4. **合规要求**：遵守相关法律法规和交易所规则

---

## 🙏 致谢

- [迅投QMT](https://www.gtja.com/) - 提供量化交易平台
- [qstock](https://github.com/tkfy920/qstock) - 股票数据获取
- [akshare](https://github.com/akfamily/akshare) - 金融数据接口
- **[@jasonhu](https://github.com/jasonhu)** - xqshare 跨平台支持

---

**免责声明**: 本项目仅供学习和研究使用，不构成投资建议。使用本项目进行实际交易的风险由用户自行承担。

---

## 关注公众号 / 加群交流

- 关注公众号：

<img src="docs/assets/wechat_qr.jpg" alt="公众号二维码" width="260" />

- 欢迎加入QQ交流群：1018087929（或扫码加入）

<img src="docs/assets/qq_group_qr.jpg" alt="QQ群二维码" width="260" />

- 欢迎加入知识星球，获取更多量化交易干货和一对一答疑服务

<img src="docs/assets/知识星球.jpg" alt="知识星球二维码" width="260" />