Appearance
投研模块
投研为用户提供了策略研究、研究环境、帮助手册、策略商城、插件下载以及数据下载等功能。
| 功能名称 | 功能说明 |
| 策略研究 | 允许用户回测研究各种交易策略。用户可以使用历史数据进行回测,评估策略的表现,并进行优化。 |
| 研究环境 | 允许用户基于Jupyter Notebook进行研究。 |
| 帮助手册 | 帮助用户了解和使用策略研究的功能。手册包括api使用说明、客户端使用说明等。 |
| 策略商城 | 为用户提供一个策略分享、交流和学习的平台。 |
| 插件下载 | 提供python插件的下载功能。 |
| 数据下载 | 提供用户下载本地回测需要的行情数据、财务数据等功能。 |

策略研究
用户可以使用创建策略、编辑策略、策略调试、运行回测、查看回测详情等功能,以及将策略上传到实验室、实验室策略列表等实验室功能(前提是已经加入实验室,查看【使用说明书-> 实验室】)。
本地策略列表
在本地策略列表,用户可以使用创建策略、编辑策略、策略调试、运行回测等功能。

创建策略
在策略研究界面,用户可以创建自己的策略。
点击“创建策略”,系统将弹出新建策略窗口。

| 功能名称 | 功能说明 |
| 策略名称 | 为您的策略命名,建议使用简洁明了的名称,便于后续管理和识别。 |
| 策略模板 | 系统提供多种模板供选择 |
| 标签 | 在创建策略时,标签功能帮助用户对策略进行分类和细化,确保策略能够精准匹配您的交易需求和市场环境。 品种:选择策略适用的交易品种 触发频率:设置策略的触发频率 交易信号:选择策略的交易信号生成方式 盈利模式:选择策略的盈利模式 自定义标签:如果系统提供的选项无法满足您的需求,您可以选择自定义设置。 |
| 用法解释 | 用户可以填写用法解释对所选策略模板和参数的简要说明,帮助您理解策略的运行逻辑和适用场景。 |
填写完相关信息,点击“确定”,策略创建成功,弹出 vscode 编辑器。
编辑策略
选中待编辑的策略,点击“打开策略”按钮,弹出的编译器 vscode,在“main.py”中编写您的策略。编写规则和函数说明见 api 使用说明书。

调试策略
在回测之前,需要在【投研-> 数据下载】下载数据到本地。
每个策略调试(F5)之前,需要先在 vscode 下方的【我的回测-创建】界面设置策略回测所需的参数。回测周期目前仅支持回测近两年。

回测过程中,在下方【终端】界面,会显示回测过程中的打印信息和日志信息。

回测完成后,在下方【回测-运行中】界面,会显示回测结果和日志。点击详情,可以查看详细的回测结果。

运行回测
在回测之前,需要在【投研-> 数据下载】下载数据到本地。
点击客户端上的【投研-> 策略研究】的“运行”,弹出填写回测参数界面。或者在 vscode 下方点击“运行回测”。

| 参数名称 | 参数说明 |
| 回测周期 | 策略回测的时间范围。目前仅支持回测近两年。 |
| 回测初始资金 | 策略回测时的初始资金。 |
| 选择频率 | 策略回测的运行频率,包括低(day)、中(min)、高(tick)。 |
| 一般参数模板 | 包括系统默认参数模板和自定义参数模板。 |
| 一般费率模板 | 包括系统默认费率模板和自定义费率模板。 |
参数模板设置
| 参数名称 | 参数说明 |
| 基准 | 默认沪深300,可以在策略内容中修改基准 |
| 买卖自适应调整数量 | 可选不自动调整、可用资金/可用仓位数调整、可用资金/可用仓位数调整+手续费 |
| 开仓均价计算公式 | 除权除息场景中,聚宽模式下,开仓均价不考虑个税问题,分红金额不考虑舍入问题;证量通模式下会考虑个税问题,同时在处理分红时,会对金额做四舍五入处理 |
| 手续费收取模式 | 聚宽的手续费收取不做舍入,同时不区分佣金部分和印花税部分 |
| 滑点 | 显示回测中是否考虑了滑点(交易成本)。滑点是指实际交易中由于市场波动导致的成交价格与预期价格的差异。如果未设置滑点,则显示为“-”。 |
| 最大成交比例 | 默认为1.0,取值范围 (0.0 - 1.0), 根据实际bar成交量限制每个订单的成交量 |
| 盘口撮合 | 暂不支持 |
| 撮合模式 | 暂只支持当前bar收盘价撮合 |
| 开启避免未来函数 | 暂只支持开启状态 |
费率模板设置
可设置股票、期货、基金等品种的交易费率。
回测详情
点击“详情”,可以查看当前策略编译回测详情。

此外,在客户端【投研-> 策略研究】界面下,点击“回测历史”,再点击“详情”,也可查看当前策略的回测详情。


回测详情页面提供了对策略回测结果的全面分析,帮助用户深入了解策略的表现。

上方展示的是这条回测结果的基本信息。包括回测周期、回测进度、初始资金、回测频率、回测耗时、费率配置等。
回测详情页面主要包括收益概况、每日持仓、交易明细、异常订单详情、代码及日志。
收益概况
在收益概况页面下,点击“更多收益详情”,查看更详细的收益指标,如:
| 指标名称 | 指标说明 |
| 策略收益 | 显示策略在整个回测周期内的总收益率。策略收益是策略在回测周期内的累计收益,正值表示盈利,负值表示亏损。 |
| 策略年化收益 | 显示策略的年化收益率。年化收益是将策略收益按年折算后的结果,便于与其他投资产品进行比较。 |
| 超额收益 | 策略收益与基准收益的差值。 |
| 基准收益 | 参考基准(如沪深300指数)的收益率。 |
| 阿尔法 | 策略相对于基准的超额收益。 |
| 贝塔 | 策略相对于基准的系统性风险。 |
| 夏普比率 | 衡量策略的风险调整后收益。夏普比率越高,表示策略在承担相同风险的情况下收益越高。负值表示策略的风险调整后收益为负。 |
| 胜率 | 显示策略交易中盈利交易的比例。胜率越高,表示策略的盈利交易次数越多。例如,胜率0.14%表示每100次交易中约有0.14次盈利。 |
| 盈亏比 | 显示策略的平均盈利与平均亏损的比例。盈亏比越高,表示策略的盈利交易平均收益大于亏损交易平均损失。 |
| 最大回撤 | 策略在回测周期内的最大资金回撤。 |
| 索提诺比率 | 策略的下行风险调整后收益。 |
| 日均超额收益 | 策略每日相对于基准的平均超额收益。 |
| 超额收益最大回撤 | 超额收益的最大回撤。 |
| 超额收益夏普比率 | 超额收益的风险调整后收益。 |
| 日胜率 | 每日盈利的比例。 |
| 盈利次数 | 盈利交易的次数。 |
| 亏损次数 | 亏损交易的次数。 |
| 信息比率 | 策略超额收益的稳定性。 |
| 策略波动率 | 策略收益的波动性。 |
| 基准波动率 | 基准收益的波动性。 |

收益走势图
展示策略和基准净值随时间的变化趋势。
支持打开“买卖点”开关,在图上标注策略的买入和卖出点。

盈亏分布图
展示策略每日的盈亏情况。正值为盈利,负值为亏损。

每日买卖量图
展示策略每日的买卖成交量。

每日持仓
用户可以点击想查看的日期,会详细显示持仓标的,当日盈亏,市值等信息。

交易明细
用户可以点击想查看的日期,会详细显示持仓标的,委托时间,买卖类型,下单类型等信息。

异常订单详情
异常订单详情记录回测中出现的异常订单。

代码
代码页展示策略的源代码。

日志
记录策略运行中生成的'debug'/'info'/'warning'/'error'级别的日志信息。日志等级可以通过策略中使用 set_level 函数设置,日志内容可以使用 log 函数生成。函数使用方法见 api 使用说明书。

上传实验室
【实验室功能】点击实验室图标,可以将本地的策略上传至实验室,在【投研-策略研究-实验室策略列表】会产生一个相同的策略。

实验室策略列表
【实验室功能】在实验室策略列表,包含策略和作业两个专区。
- 策略专区:可以打开策略、运行、提交所属团队的策略等等。
- 作业专区:可以提交作业、批改作业等等
策略专区:
| 功能名称 | 功能说明 |
| 打开策略 | 在vscode打开策略,可以使用本地资源进行编辑和调试 |
| 运行 | 在实验室环境运行策略回测 |
| 提交 | 实验室的策略修改后需点击提交,实现实验室环境中的策略版本更新 |
| 克隆 | 点击克隆,在【投研-策略研究-本地策略列表】创建一个副本 |
| 最新回测 | 查看实验室环境中最新的一条历史回测结果 |
| 回测历史 | 查看实验室环境中自己进行的历史回测结果 |
| 删除 | 删除实验室的策略。仅作者和管理员(包含超级管理员、团队管理员、研究管理员,后面简称管理员)可使用。 |
| 历史版本 | 查看实验室环境中的策略历史版本 |

作业专区:
| 功能名称 | 功能说明 |
| 打开策略 | 在vscode打开策略,可以使用本地资源进行编辑和调试。仅作者和管理员可使用。 |
| 运行 | 在实验室环境运行策略回测。仅作者和管理员可使用。 |
| 提交 | 实验室的策略修改后需点击提交,实现实验室的策略版本更新。仅作者和管理员可使用。 |
| 最新回测 | 查看实验室环境中最新的一条历史回测结果。仅作者和管理员可使用。 在最新回测中,管理员可以打分,打分结果仅作者和管理员可查看。 |
| 回测历史 | 查看实验室环境中自己进行的历史回测结果。仅作者和管理员可使用。 |
| 删除 | 删除实验室的策略。仅作者和管理员可使用。 |
| 历史版本 | 查看实验室的策略历史版本。仅作者和管理员可使用。 |

研究环境
研究环境基于 Jupyter Notebook,内核配置需指定证量通软件安装目录下的 Python 解释器路径(".\python\python.exe")。



帮助手册
提供策略研究 api 使用说明书

策略商城
策略商城旨在为用户提供一个策略分享、交流和学习的平台。策略商城分为证量通社区、实验室专区和实验室作业专区三个部分,用户可以根据需求浏览、新建和克隆策略。以下是策略商城的详细介绍:
策略商城分为以下三个专区,满足不同用户的需求:
- 证量通社区:面向所有用户,提供策略分享、讨论和学习的功能。
- 【实验室功能】实验室专区:用户可以在实验室专区进行策略分享、讨论和学习。
- 【实验室功能】实验室作业专区:实验室管理员(含超级管理员、团队管理员、研究管理员,后面简称管理员)可以在实验室作业专区创建作业,创建完成后会在【投研-策略研究-实验室策略列表】产生对应的作业专区。
| 功能名称 | 功能说明 |
| 新建帖子 | 用户可以点击“新建帖子”按钮,发布自己的策略。新建内容包括策略名称、策略逻辑、代码、标签等。 |
| 策略搜索 | 用户可以在搜索框中输入关键词,搜索策略 |
| 推荐/热门 | - 推荐:按照帖子发布的时间顺序排序,展示最新发布的帖子。 - 热门:按照帖子热度排序,展示最热门的帖子。 |
| 克隆 | 点击克隆,在【投研-策略研究-本地策略列表】创建一个副本 |
| 置顶 | 置顶帖子,仅管理员有权限。 |
| 加精 | 加精帖子,仅管理员有权限。 |
| 编辑 | 编辑帖子,仅作者有权限。 |
| 详情 | 点击详情,查看帖子策略逻辑、代码 |
| 删除 | 删除帖子,仅作者和管理员有权限。 |
| 写作业 | 点击写作业,在【投研-策略研究-实验室策略列表-作业专区】创建一个以“作者+作业名”命名的策略 |
| 热门标签 | 用户可以通过标签快速筛选策略。 |
| 热门帖子 | 用户可以通过热门帖子了解社区的热门帖子和最新帖子。 |

插件下载
支持用户自主安装使用 Python 插件。 点击“插件下载”->"插件自主安装”,用户可结合安装示例、使用命令行(pip)安装 Python 插件及其依赖。


数据下载
数据下载功能为用户提供了便捷的数据获取方式,用户可以根据需求选择数据类型、日期范围,并灵活选择下载方式。以下是数据下载功能的详细介绍:
点击“数据下载”
**选择数据类型:**点击数据类型下拉框,选择需要下载的数据类型。
- 选择父类会自动勾选子类
- 选择一分钟 k 线或快照,自动勾选日 K 线
- 选择专业财务,自动勾选核心财务
选择下载日期
在日期选择界面,用户可以通过以下方式选择日期范围:
- 点击“下载”:把选中的数据下载到本地。
- 点击消息中心的“立即重启”:更新加载最新数据。

除此之外,用户可手动点击“更新”更新数据到本地,也可以选择自动更新最新数据到本地。以下是数据自动更新攻略的操作步骤:
- 点击“展开自动更新”
- 选择数据范围:用户可选择自动更新行情或财务数据。
- 选择每日自动更新时间
- 点击“启动”:开始自动更新数据。
用户可点击“停止”,来终止自动更新数据。
