14. 启动QTEASY

启动qteasy的配置信息:

qteasy.run(op: Operator, **kwargs) → Union[dict, list][源代码]

根据当前配置运行给定的 Operator，并进入回测、优化或实盘等不同工作模式。

本函数是 qteasy 的统一入口：根据全局配置 QT_CONFIG['mode']``（可通过 ``qt.configure(mode=...) 暂时覆盖），选择实盘模式、回测模式、优化模式等， 自动准备所需数据源与日志对象并调用 Operator.run() 执行完整流程。各模式 的详细行为与输出结构见文档「运行 qteasy 与工作模式」相关章节。

参数:

  • op (Operator) – 已配置好策略与运行参数的 Operator 对象。

  • **kwargs – 本次运行临时覆盖的配置项，键名需为合法的 qteasy 配置键，例如 mode、asset_pool、invest_start、invest_end 等。

返回:

当 ``mode == 1``（回测模式）时通常返回包含回测结果的字典； 当 ``mode == 2``（优化模式）时通常返回包含多组参数结果的列表； 实盘模式与其他模式的具体返回结构详见 Operator.run() 与相关文档说明。

返回类型:

dict or list

示例

run 通常会触及数据源、日志路径与运行模式等外部状态。下面示例展示最小的“可见且稳定”的调用准备：

>>> import qteasy as qt
>>> op = qt.Operator('dma')
>>> op.__class__.__name__
'Operator'

若你已正确配置数据源与资产池，可进一步执行（输出结构随模式而不同）：:

qt.run(op, mode=qt.BACKTEST_MODE)
qteasy.info(**kwargs)[源代码]

qteasy 模块的帮助信息入口函数（预留）。

参数:

**kwargs – 预留参数（当前版本未使用）。

返回:

当前版本未实现，调用将抛出 NotImplementedError。

返回类型:

None

抛出:

NotImplementedError – 当前版本未实现。

示例

本函数为预留入口，建议使用 Sphinx 文档或 help(qteasy) 获取帮助信息：

>>> import qteasy as qt
>>> qt.info.__name__
'info'

运行模式与常量速查

qteasy 使用一组全局常量表示运行模式（实盘/回测/优化/预测）。你可以在调用 qt.run 前后通过 qt.configure(mode=...) 或在 qt.run(op, mode=...) 中临时覆盖。

示例（常量值为稳定输出）：:

>>> import qteasy as qt
>>> qt.LIVE_MODE, qt.BACKTEST_MODE, qt.OPTIMIZE_MODE, qt.PREDICT_MODE
(0, 1, 2, 3)

日志与根目录路径常量（值受配置影响，尤其是日志路径支持运行时热更新）：:

>>> import qteasy as qt
>>> isinstance(qt.QT_ROOT_PATH, str)
True
>>> isinstance(qt.QT_SYS_LOG_PATH, str) and isinstance(qt.QT_TRADE_LOG_PATH, str)
True