Merge pull request vnpy#2976 from vnpy/dev

Dev
hardywu · May 1, 2021 · 7963389 · 7963389
2 parents 6dcaf92 + 5cf434c
commit 7963389
Show file tree

Hide file tree

Showing 132 changed files with 1,312 additions and 72,367 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,33 @@
+# 2.2.1版本
+
+## 修复
+1. 修复IbGateway断线重连后，没有自动订阅之前已订阅的合约行情问题
+2. 修复CTA模块的净仓交易模式中，部分平仓部分开仓时，开仓部分下单错误的问题
+3. 修复OkexfGateway，某个合约全部平仓后，持仓数量不更新为0的问题
+4. 修复HuobisGateway，当行情盘口不足5档时，TickData对象初始化出错的问题
+5. 修复HuobifGateway，查询历史数据时由于请求超过1999个数据点导致的失败问题
+6. 修复CtpGateway对于FAK和FOK委托指令的处理错误问题
+7. 修复HuobiGateway的成交数量为浮点数时，浮点数精度导致上层应用仓位计算偏差问题
+8. 修复BinancesGateway，U本位合约查询历史数据失败的问题
+9. 修复BinanceGateway，账户资金收不到推送更新的问题
+10. 修复IbGateway，查询历史数据由于传参错误导致的查询失败问题
+11. 修复IbGateway，当要查询的合约历史数据不存在时卡死的问题
+12. 修复IbGateway，查询返回的合约乘数（字符串）未作转换导致的上层应用问题
+13. 修复BitfinexGateway，查询的历史数据OHLC字段取值错误问题
+
+
+## 调整
+1. 修改CTA模块的净仓交易模式，支持上期所和能交所的今昨仓拆分下单
+2. 调整组合策略模块的回测引擎K线回放逻辑，当某个时间点K线数据缺失时，推送给策略的K线字典中不对其进行向前补齐
+3. 将CTP接口和API封装，剥离到vnpy_ctp项目中
+4. 将CTP穿透式测试接口和API封装，剥离到vnpy_ctptest项中
+
+## 新增
+1. 新增DataManager在导入CSV文件时，对于时间戳时区的选择功能
+2. 新增CtaStrategy模块的策略移仓助手功能，实现一键式期货换月移仓支持
+3. 新增OKEX V5 API接口支持，通过vnpy_okex项目进行加载
+
+
 # 2.2.0版本
 
 ## 修复

diff --git a/README.md b/README.md
@@ -5,7 +5,7 @@
 </p>
 
 <p align="center">
-    <img src ="https://img.shields.io/badge/version-2.2.0-blueviolet.svg"/>
+    <img src ="https://img.shields.io/badge/version-2.3.0-blueviolet.svg"/>
     <img src ="https://img.shields.io/badge/platform-windows|linux|macos-yellow.svg"/>
     <img src ="https://img.shields.io/badge/python-3.7-blue.svg" />
     <img src ="https://img.shields.io/github/workflow/status/vnpy/vnpy/Python%20application/master"/>
@@ -94,13 +94,7 @@ vn.py是一套基于Python的开源量化交易系统开发框架，于2015年1
 
         * 币安永续（binances)：数字货币永续合约
 
-        * OKEX（okex）：数字货币现货
-
-        * OKEX永续（okexs）：数字货币永续合约
-
-        * OKEX期货（okexf）：数字货币期货
-
-        * OKEX期权（okexo）：数字货币期权
+        * OKEX（okex）：数字货币现货、期货、永续、期权（V5统一账户）
 
         * 火币（huobi）：数字货币现货
 
@@ -190,7 +184,7 @@ vn.py是一套基于Python的开源量化交易系统开发框架，于2015年1
 
 ## 环境准备
 
-* 推荐使用vn.py团队为量化交易专门打造的Python发行版[VNStudio-2.2.0](https://download.vnpy.com/vnstudio-2.2.0.exe)，内置了最新版的vn.py框架以及VN Station量化管理平台，无需手动安装
+* 推荐使用vn.py团队为量化交易专门打造的Python发行版[VNStudio-2.3.0](https://download.vnpy.com/vnstudio-2.3.0.exe)，内置了最新版的vn.py框架以及VN Station量化管理平台，无需手动安装
 * 支持的系统版本：Windows 7以上/Windows Server 2008以上/Ubuntu 18.04 LTS
 * 支持的Python版本：Python 3.7 64位（**注意必须是Python 3.7 64位版本**）
 

diff --git a/docs/algo_trader.md → docs/algo_trading.md b/docs/algo_trader.md → docs/algo_trading.md
diff --git a/docs/chart_wizard.md b/docs/chart_wizard.md
@@ -1 +1,73 @@
-# K线图表模块
+# ChartWizard - 实时K线图表模块
+
+
+## 功能简介
+
+ChartWizard是用于**实时K线图表展示**的功能模块，用户可以通过其UI界面查看实时和历史K线行情，目前只支持显示1分钟级别的K线数据，实时K线（最新的一根K线）为Tick级刷新。
+
+
+## 加载启动
+
+### VN Station加载
+
+启动登录VN Station后，点击【VN Trader Pro】按钮，在配置对话框中的【上层应用】栏勾选【ChartWizard】。
+
+### 脚本加载
+
+在启动脚本中添加如下代码：
+
+```
+# 写在顶部
+from vnpy.app.chart_wizard import ChartWizardApp
+
+# 写在创建main_engine对象后
+main_engine.add_app(ChartWizardApp)
+```
+
+
+## 启动模块
+
+在启动模块之前，请先连接交易接口（连接方法详见基本使用篇的连接接口部分）。看到VN Trader主界面【日志】栏输出“合约信息查询成功”之后再启动模块，如下图所示：
+
+![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/cta_strategy/1.png)
+
+请注意，IB接口因为登录时无法自动获取所有的合约信息，只有在用户手动订阅行情时才能获取。因此需要在主界面上先行手动订阅合约行情，再启动模块。
+
+由于vn.py本身并不提供任何数据服务，对于K线图表绘制过程中用到的历史数据，国内期货历史数据由[RQData](https://www.ricequant.com/welcome/purchase?utm_source=vnpy)数据服务提供，用户需要准备和配置RQData账号（配置方法详见基本使用篇的全局配置部分）。数字货币历史数据则直接由交易所接口提供，用户无需进行额外配置。
+
+成功连接交易接口后，在菜单栏中点击【功能】-> 【K线图表】，或者点击左侧按钮栏的图标：
+
+![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/chart_wizard/1.png)
+
+即可进入实时K线图表模块的UI界面，如下图所示：
+
+![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/chart_wizard/2.png)
+
+
+## 新建图表
+
+打开图表窗口后，在【本地代码】编辑框中输入合约代码（注意本地代码由代码前缀和交易所后缀两部分组成，如rb2112.SHFE）。
+
+点击【新建图表】的按钮，即可创建对应合约的K线图表，如下图所示：
+
+![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/chart_wizard/3.png)
+
+用户可以新建多个合约的K线图表，通过切换窗口来实现快速切换： 
+
+![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/chart_wizard/4.png)
+
+
+## 查看图表
+
+每个合约的图表分为上下两块子图区域：
+
+- 上面的子图为行情K线；
+- 下面的子图为成交量数据。
+
+图表上的十字光标可用于定位和显示特定时间点的具体数据，在X轴和Y轴上均会对应数据点的标签，同时在左上角也会显示此根K线的OHLCV等信息。
+
+其他快捷操作：
+
+- 可以通过鼠标左键的拖拽，左右平移K线图显示的时间范围；
+- 可以通过鼠标滚轮的滚动，放大和缩小K线图显示的时间范围。
+
diff --git a/docs/cta_backtester.md b/docs/cta_backtester.md
@@ -35,7 +35,7 @@ C:\Users\Administrator\strategies
 
 其中Administrator为当前登录Windows的系统用户名。
 
-启动VN Trader后，在菜单栏中点击【功能】-> 【CTA回测】，或者点击左侧按钮栏的图标
+启动VN Trader后，在菜单栏中点击【功能】-> 【CTA回测】，或者点击左侧按钮栏的图标：
 
 ![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/cta_backtester/00.png)