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