第四章：快速上手：运行第一个回测

本章将引导使用一个预先配置好的工程文件（.kh文件），来快速完整地运行一次回测。这个过程不仅能直观地了解软件的基本操作流程，也是一个检验当前运行环境是否配置妥当、能否与本系统完美兼容的有效方式。

4.1 加载并配置示例工程

软件中内置了一些经典的策略示例，以供快速学习和测试。下面将加载其中一个进行演示。

4.1.1 加载示例工程

找到并点击主界面顶部工具栏上的 “加载配置” 按钮。
在弹出的文件选择对话框中，找到软件安装目录下的_internal\strategies目录，例如’C:\Program Files\KhQuant_internal\strategies’。
选择示例工程文件 demoMACD.kh，然后点击”打开”。

4.1.2 策略文件路径设置

检查并重设策略文件路径：由于每个用户的软件安装路径可能不同，加载 .kh 文件后，可能需要手动重新指定策略文件的位置。点击”策略文件”输入框右侧的浏览按钮。
⚠️ 重要提醒：策略文件保存位置

为了避免在软件升级或重新安装时丢失您的策略文件，强烈建议不要将策略文件保存在软件安装目录下。推荐的保存位置：
- 用户策略目录（推荐）：软件会自动为您创建专用的策略目录
  - Windows: C:\Users\[用户名]\AppData\Local\KhQuant\strategies\
- 自定义目录：如 D:\MyStrategies\ 或 C:\Users\[用户名]\Documents\KhQuant\
如何使用用户策略目录：
1. 在策略文件选择对话框中，默认会打开用户策略目录
2. 首次使用时，系统会自动复制默认策略文件到此目录
3. 您也可以手动导航到该目录进行文件管理
在策略文件选择对话框中，建议选择用户策略目录中的 MACD.py 文件。如果您是首次使用，系统已经自动将示例策略复制到了用户目录中。

4.1.3 保存配置

💡 提示：设置好正确的策略路径后，可以点击工具栏上的 “配置另存为” 按钮覆盖原有的 demoMACD.kh 文件。这样，下次加载时就不再需要重新选择了。同样建议将 .kh 配置文件也保存到用户目录或自定义目录中，而不是软件安装目录。

加载成功并设置好策略路径后，主界面参数会自动填充完毕。

加载并配置好工程文件后的主界面

💡 什么是 .kh 文件？

.kh 文件是”看海量化交易系统”的工程配置文件。它就像是工作台的快照，完整地保存了在图形界面上所做的所有设置，包括选择的策略脚本、回测时间、股票池、交易费率等等。

重点在于，.kh 文件本质上是一个可读的文本文件（使用JSON格式）。 这意味着完全可以用任何文本编辑器（如记事本、VS Code等）打开它，来查看甚至直接修改其中的配置参数。

4.1.4 策略文件管理最佳实践

🛡️ 文件安全保护机制

软件采用了智能的文件保护机制：

自动目录创建：首次运行时，系统会自动创建用户策略目录
默认策略复制：将内置的示例策略复制到用户目录，但不会覆盖已存在的文件
智能路径提示：选择策略文件时，如果文件不在安全目录中，系统会提醒您
升级保护：用户目录中的文件在软件升级时完全不受影响

🔧 管理策略文件

访问策略目录：通过策略文件选择对话框导航到用户策略目录
手动打开目录：直接在文件管理器中导航到用户策略目录路径
管理策略文件：您可以在此目录中：
- 查看和编辑现有策略文件
- 添加新的策略文件
- 创建策略文件的备份
- 组织策略文件的目录结构

⚠️ 避免的操作

不要将策略文件保存在软件安装目录（如 C:\Program Files\KhQuant\）
不要直接修改软件安装目录中的示例文件
不要将重要的策略文件只保存一份，建议定期备份

💡 迁移现有策略

如果您已经在软件安装目录中创建了策略文件，建议按以下步骤迁移：

手动打开用户策略目录（Windows: C:\Users\[用户名]\AppData\Local\KhQuant\strategies\）
将您的策略文件复制到用户策略目录中
重新加载配置文件，并重新选择策略文件路径
保存配置文件到用户目录或其他安全位置

4.2 准备回测数据（数据补充）

在启动回测之前，需要确保本地数据库中包含了策略所需的全部历史数据。本次示例中的MACD策略在计算指标时，不仅需要用到分钟数据，还需要日线数据作为参考。因此，我们需要将这两个周期的数据都补充到本地。

⚠️ 重要提醒：数据补充检查

请特别注意： 即使本地数据库中没有足够的历史数据，回测程序依然能够启动并正常运行，但这可能导致策略计算结果不准确或产生错误的回测报告。因此，在编写和运行回测程序时，务必仔细检查数据是否已经被正确补充到本地。

对于本次演示的MACD策略，特别需要确保以下两种周期的数据都已完整补充：

分钟数据：用于策略的主要交易逻辑计算

日线数据：用于移动平均参数计算

缺失任何一种周期的数据都可能影响策略的正确运行和回测结果的成功。

在主界面顶部工具栏点击 “数据” 按钮，打开数据中心模块。
在数据中心，我们首先补充 分钟数据，设置如下：
- 股票列表: 在”自选清单”中输入 000001.SZ,平安银行，并勾选它。【这里应该是点击”自选清单”，然后在文本编辑器，比如记事本中输入000001.SZ,平安银行，然后保存，然后勾选自选清单】
⚠️ 免责声明

本教程中使用的股票（如 000001.SZ,平安银行）及其代码仅为功能演示目的，并非投资建议或推荐。市场有风险，投资需谨慎。请在实际使用中替换为您自己研究的投资标的。

周期类型: 勾选 1分钟。
日期范围: 设置开始日期为 2024-04-03，结束日期为 2024-11-01。
1. 点击 “补充数据” 按钮，等待分钟数据下载完成。
2. 接下来补充 日线数据。保持其他设置不变，仅将 周期类型 的勾选项从 1分钟 改为 1日。
3. 再次点击 “补充数据” 按钮，下载日线数据。

数据补充模块的设置方式

等待两个周期的数据都补充完成的提示出现后，就可以进行下一步的回测了。

“数据补充”与”数据下载”的区别

“数据补充” 的设计目标是服务于 系统内部 的回测功能。它的核心任务是更新和完善 MiniQMT 内部所依赖的历史数据库，为策略回测引擎提供坚实的数据基础。换句话说，回测系统中使用到的数据，通常不是临时从网络获取的，而是通过”数据补充”提前下载到本地的。这样做可以极大提升回测速度。技术上讲，”数据补充”调用的是xtquant的download_history_data函数，而回测过程中则通过get_market_data_ex来高速读取本地数据。

“数据下载” 的核心在于将金融数据以独立、可见的 .csv 文件 形式提供给用户，支持 系统外部 的多元化数据应用。用户可以方便地将数据导入 Excel、Python、R 等进行复杂的统计建模或外部回测。

4.3 开始回测与观察

当工程文件加载完毕，数据也准备就绪后，就可以启动回测了。

点击工具栏上的 “开始运行” 按钮。
此时，回测开始进行，可以将注意力转移到界面的以下两个区域：

右侧的”系统日志”面板：这里会实时滚动输出策略运行的详细信息，包括数据下载进度、策略初始化状态、交易信号的触发、订单的委托与成交等。如果出现任何问题，错误信息也会在这里以醒目的颜色显示。
底部的状态栏：这里会显示一个详细的进度条，告知当前回测进行到了哪一天，以及总体的完成百分比。

4.4 解读第一个回测报告

等待回测进度条走到100%，系统日志中也会提示”回测运行结束”。此时，回测报告将自动弹出。

回测报告窗口

如果后续不小心关闭了报告窗口，可以随时点击日志面板上方的 “打开回测指标” 按钮来重新打开它。

这份报告浓缩了策略在历史数据中的全部表现，主要包含：

核心绩效指标：如总收益率、年化收益、最大回撤、夏普比率等。
可视化图表：包括策略净值与基准对比的资金曲线、回撤曲线等。
详细交易记录：每一笔买入和卖出的明细。
每日持仓与资产快照：方便复盘策略在任何一天的具体状态。

关于如何深入解读这份报告中的每一项数据，我们将在后续的【第九章：策略绩效复盘】中进行详尽的拆解。现在，只需要对它有一个初步的印象即可。

恭喜！已经成功完成了在KHQuant中的第一次策略回测。接下来，可以尝试更深入的策略研究了。

4.5 重要提醒：保护您的策略文件

在结束本章之前，再次强调策略文件安全的重要性：

⚠️ 策略文件安全检查清单

在继续使用软件之前，请确认：

✅ 已了解用户策略目录的位置

✅ 已确认策略文件选择对话框默认打开用户策略目录

✅ 重要的策略文件已保存在安全位置（非软件安装目录）

✅ 已为重要策略文件创建备份

✅ 配置文件（.kh文件）也保存在安全位置

记住：软件安装目录中的文件在升级时可能会被覆盖！

通过遵循这些最佳实践，就可以安心地使用KHQuant进行策略开发，而不用担心重要文件的丢失。