快速入门

QuantCraft 是一款一体化桌面应用，用于开发、测试和迭代 Python 交易策略。
本指南只涵盖快速、正确地上手所需的内容。如需了解整体概况，请阅读简介；有关 IDE 区域和面板，请参阅工作区布局。

前提条件

在使用策略功能之前，请先安装以下内容：

• QuantCraft 桌面应用（最新稳定版）
• Python 3.10+（推荐 3.11）
• pip（大多数 Python 安装中已包含）
• 互联网连接（用于安装软件包以及连接数据/服务）
• 足够的磁盘空间，用于存放项目、日志和回测输出

---

1. 安装 Python

从 python.org 下载并安装 Python。

安装时：

• 启用 Add Python to PATH

验证：

如果在 Windows 上无法识别 python，请尝试：

---

2. 安装并打开 QuantCraft

下载并运行适用于您的 Windows 架构的安装程序（v1.3.0）：

Windows（Microsoft Store，推荐）

macOS（Apple Silicon，v1.3.0）

• QuantCraft_1.3.0_aarch64.dmg.zip — 磁盘映像（zip）
• QuantCraft.app.tar.gz — 应用包（tar.gz）

然后：

• 启动 QuantCraft
• 打开策略 IDE/工作区

---

3. 创建您的第一个策略

1. 创建或导入一个 .py 策略文件
2. 添加核心生命周期回调：
   • on_init
   • on_bar 和 on_tick
   • on_finish
   • 可选的 on_timer（仅限前向运行——IDE 回测中不可用）
3. 为可调整的值定义可配置的 params

---

4. 运行回测

在 Run backtest 中配置（最多三个标签页）：

• Symbol & data — 价格数据源、标的、时间周期，可选的 Additional timeframes（用于 rt.get_bar），可选的基本面数据 / 因子
• Simulation — 日期范围、预热期、初始余额、手续费 / 滑点
• Script — 当您的文件声明了输入参数（params）时

使用 Test（运行代码），然后查看：

• 输出面板中的日志/错误
• 测试结果：指标、交易/历史、图表

关于引擎如何驱动您的策略，请参阅回测。

---

5. 确认设置正常

当满足以下条件时，说明您的设置正确：

• Python 脚本运行时没有导入/运行时错误
• 回测能够完成并生成结果面板
• 策略日志和图表与预期行为一致

---

常见设置问题

• 找不到 python：重新安装 Python 并启用 PATH
• 模块导入错误：在当前环境中安装依赖项
• 结果不一致：检查标的、日期范围、时间周期和 params
• 没有生成交易：检查入场/出场条件以及预热期/数据可用性

---

新用户最佳实践

• 从一个标的和一个简单策略开始
• 将常量参数化（不要把所有内容都硬编码）
• 记录关键决策，便于调试
• 在信任结果之前，先在多个日期范围/市场环境中验证