# 国内期货 · 交易复盘系统

基于 Flask 的国内期货 **CTP 下单 + 监控 + 复盘 + 统计** Web 应用。模拟盘连接 SimNow，实盘连接期货公司 CTP；支持关键位/计划提醒、交易记录同步、资金曲线、可开仓品种（仓位纪律）与企业微信推送。

## 文档

| 文档 | 说明 |
|------|------|
| **[功能说明](docs/FEATURES.md)** | 各模块功能、页面路径、数据库与后台任务 |
| **[部署文档](docs/DEPLOY.md)** | 一键部署、更新、PM2、故障排查 |
| **[备份与恢复](docs/BACKUP.md)** | 自动备份、下载、跨服务器恢复 |
| **[SimNow 接入](docs/SIMNOW.md)** | 仿真账号注册与 CTP 前置 |
| **[期货公司实盘 CTP](docs/CTP_LIVE.md)** | 实盘接入、与 SimNow 开平仓对比 |
| **[交易与策略](docs/TRADING.md)** | 下单、持仓、可开仓品种、策略 API |
| **[手续费与导航](docs/FEES.md)** | CTP 费率同步、导航开关 |
| **[软件购买与使用协议](docs/软件购买与使用协议.md)** | 个人版授权模板（含签署栏） |

## 功能一览

| 模块 | 路径 | 说明 |
|------|------|------|
| **下单监控**（默认首页） | `/positions` | CTP 连接、期货下单、当前持仓、可开仓品种 |
| **策略交易** | `/strategy` | 趋势回调 / 顺势加仓（可导航开关） |
| **开单计划** | `/plans` | 当日决策区间、触发推送（可开关） |
| **关键位监控** | `/keys` | 箱体/阻力支撑突破提醒 |
| **行情 K 线** | `/market` | 多周期 K 线（可开关） |
| **交易记录与复盘** | `/records` | 资金曲线、CTP 成交同步、复盘上传 |
| **统计分析** | `/stats` | 汇总指标 + 多维度分项统计 |
| **手续费配置** | `/fees` | CTP / 本地费率（可开关） |
| **系统设置** | `/settings` | 交易模式、CTP、计仓、微信、主题 |

登录后默认进入 **下单监控**；刷新当前页不会跳转，仅访问根路径 `/` 或新登录时进入默认页。

## 快速开始

**服务器（Ubuntu）**

```bash
cd /opt/qihuo && bash deploy.sh
# 访问 http://<IP>:6600
```

**更新**

```bash
cd /opt/qihuo
git fetch origin && git reset --hard origin/main
source venv/bin/activate && pip install -r requirements.txt
pm2 restart qihuo
```

详见 [部署文档](docs/DEPLOY.md)。

**本地开发**

```bash
python3 -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
python app.py
```

## 品种与行情

- 合约代码：**同花顺格式**（`ag2606`、`SR609`、`IF2606`），中文联想匹配主力
- 行情：默认 **新浪财经**；机构用户可配置同花顺 iFinD token

## 环境要求

- Python 3.10+（vnpy_ctp）
- PM2（生产部署）
- 网络：新浪行情、Git 仓库、SimNow/CTP 前置（见部署文档）

## 仓库

https://git.bz121.com/dekun/qihuo.git

## 版权与授权

- 著作权人：**马建军**
- 许可说明：[LICENSE.zh-CN.txt](LICENSE.zh-CN.txt)
- 个人购买协议模板：[docs/软件购买与使用协议.md](docs/软件购买与使用协议.md)

本软件为 **专有软件**，仅供经授权的个人自用部署。严禁用于带单、向他人推荐期货品种或买卖建议、融资配资、转售源码或搭建共享交易室等用途。本软件不构成投资建议，期货交易风险由使用者自行承担。

联系：手机 18364911125 · 微信 dekun03