AI Skill 给大 QMT 策略做代码评审(三):QMT 内置多因子选股策略

本系列文章,前两篇评审的都是”小而短”的官方示例:
(一)双均线单品种、几十行,问题集中在”某个函数参数写错了”;
(二)日内回转多了持仓记账和收盘窗口,问题开始往状态管理和时段判断上走。

这一篇换个难度:多因子选股。沪深300 全池、扩展数据排名、20 日调仓、10 只等权持仓——代码一长,问题就从”某一行写错”变成”这套结构站不站得住”:状态该放哪、300 只订阅扛不扛得住、下单股数合不合法、回测和实盘的写法能不能共用。

先把背景交待清楚。qmt-strategy-review 是我给自己做的 AI Skill,只审代码实现层:API 签名、状态管理、单线程陷阱、实盘可用性,逐条标依据和风险等级。它不评价策略逻辑——因子有没有效、这套选股赚不赚钱,不在它的检查范围里,也不是这篇文章要讨论的。这个 Skill 目前仍只在我本地目录里跑,等上架了再更新。


下面这份,是把 QMT 官方那份多因子选股示例丢进去跑出来的报告,原样贴出。

第一部分:评审范围说明

本次只检查代码编写与代码实现层:单线程阻塞、数据层效率、ContextInfo 误用与状态管理(逐 K 线回滚、深拷贝成本、跨回调使用)、API 签名与参数(均当次对照 QMT 官方文档核实)、编码声明与乱码风险、Python 代码层错误(语法/类型/未定义/键访问)、回放与重复下单防护、日志与异常处理写法。

  • 不检查策略逻辑:因子是否有效、20 日调仓与 10 只持仓是否合理、盈亏与风险表现如何,属于策略逻辑范畴,本 skill 不评价、不预测、不下结论。下文提到”重复下单”指的是代码实现没有防护,不是对策略本身的判断。
  • 不收集、不存储策略代码:评审只在当前对话内完成——不落盘、不复制、不上传、不写进任何记忆或日志文件;阶段一连改后文件的磁盘副本都不生成。你的代码只用于本次评审。

先说最要紧的一句:文件头自己写了「回测模型示例(非实盘交易策略)」,这句话比任何评审意见都关键。它用的 order_shares 官方明确标注仅回测可用。所以下面条目按用途分成两类,你的目标决定了哪些必须改。

第二部分:修改意见

汇总表

编号 级别 位置 问题一句话
通1 严重 L1 声明 gbk,磁盘实际是 UTF-8,中文注释与 print 会乱码
严1 严重 L13 ContextInfo.get_sector 官方文档当前未核实到,init 可能直接报错
严2 严重 L56/L68 order_shares 官方标注仅回测可用,模拟/实盘不产生任何委托
严3 严重 L15-L20 / L57-L73 持仓、资金、盈亏、买点全部挂 ContextInfo,盘中逐 K 线回滚
严4 严重 L23/L30 缺盘中回放与单次触发保护,同一根 K 线每个分笔都会重复调仓
严5 严重 L56/L67/L68 下单股数是 float 且非 100 整数倍,官方要求 int + 100 股递增
严6 严重 L37/L38 ext_data_rank 的股票代码拼成 SH600000,官方形式为 600000.SH
警1 警告 L29/L56/L68 price[k] 无成员检查,缺 key 时 KeyError 直接中断 handlebar
警2 警告 L70 买入扣款把手续费写成减项,手续费反而没扣,资金记账偏乐观
警3 警告 L38/L40/L45/L63 第二因子算了没进评分;tmp_stock 是 set,资金分配结果不可复现
警4 警告 L76/L77 if not do_back_test 与回测用途相反,收益曲线永远画不出来
警5 警告 L14/L29/L83-85 旧接口官方已标「不再推荐使用」,且每根 bar 都取数、订阅 300 只易触上限
提1 提示 L19/L75 capital 官方标注仅回测有效;非回测取不到,为 0 会除零
提2 提示 L2-L6/L37-38 扩展数据 atr/adtm 需预先生成,缺失时返回值官方文档未说明
提3 提示 L7/L9/L15/L41 pandas/time 未使用、day 死变量、调试 print 刷屏

总体结论:回测用途基本成立,但不能直接上模拟或实盘。 通1 与严1 是回测前的必修项(一个让中文全乱码,一个可能让策略加载不起来);严5、严6 会让回测结果本身失真或不合法。最大风险是严2、严3、严4 三者叠加——切到模拟/实盘后,下单函数静默失效、记账被回退、盘中同一根 K 线反复调仓。另有一条重要澄清:静态审查报的 NO_IS_LAST_BAR 对纯回测模型是误报,回测本就需要逐根历史 K 线遍历,别盲目加 is_last_bar() 过滤,否则回测只剩最后一根。

逐条详述

通1(严重)编码声明与实际编码不符
首行 #coding:gbk,但磁盘文件实测为 UTF-8(LF 行尾)。QMT 内置 Python 按声明以 GBK 解码,文件头中文说明、print('stock pool:', ...) 前后的中文全变乱码,解码失败时策略直接加载不起来。依据:已经 QMT 官方文档核实《快速开始》「编写策略前注意事项」(原文要求首行写 #coding:gbk 统一脚本编码为 GBK)。改法(未落盘):首行保持 # coding:gbk,并把文件本体另存为 GBK 编码——只改声明不转码会更糟。回归:重新打开确认中文正常、策略能编译运行。

严1(严重)成分股接口官方文档未核实到
L13 ContextInfo.get_sector('000300.SH')。在《行情函数》《系统函数》《变量约定》三张页面里均未检索到该函数;官方收录的是 ContextInfo.get_stock_list_in_sector,且示例传的是板块名(《快速开始》定时任务示例写 C.get_stock_list_in_sector('沪深A股'),官方《获取行业概念数据》页写 get_stock_list_in_sector('沪深300'),返回 '000002.SZ' 形式的代码列表)。依据:已经 QMT 官方文档核实。这一条我不臆造签名——请你在本地客户端实测 get_sector 是否存在;若不存在,init 会 AttributeError,策略根本起不来,改用 get_stock_list_in_sector('沪深300'),参数以官方文档与本地实测为准。参考页面:innerApi/data_function.html 。回归:init 打印股票池长度与首只代码格式。

严2(严重)order_shares 只在回测里有效
L56、L68 两处下单都用 order_shares。官方文档把它放在《交易函数》「其他交易函数(仅回测可用)」章节,章节原文是「以下函数仅回测生效,实盘和模拟盘交易均不可用」;《常见问题》另说明「passorder 以外的下单函数不能指定快速交易参数,效果与传 0 的 passorder 一致」。签名 order_shares(stockcode, shares[, style, price], ContextInfo[, accId]) 与 'fix'(指定价)你的参数顺序是对的,问题在用途边界:切到模拟信号或实盘模式,这两处调用不产生任何委托,多数情况也不报错,是最危险的一种静默失效。改法(未落盘):要上模拟/实盘,换成 passorder(23/24, 1101, A.acct, code, prType, price, volume, '策略名', 0, 备注, ContextInfo),quickTrade 默认取 0;仅回测则保持现状。回归:模拟信号模式下确认「策略信号」栏有记录,回测结果与改前一致。

严3(严重)记账状态全挂在 ContextInfo 上
ContextInfo.s / day / holdings / weight / buypoint / money / profit / money_distribution 全部挂在 C 上,且 L57/L58/L70/L71 是累加、L62/L69/L73 是容器原地写。官方《使用须知》原文:「ContextInfo 中存储的变量值将会回滚……在完全理解 ContextInfo 机制之前,请避免在其中存储任何变量」,推荐写法是 class G(): pass + 全局实例;《常见问题》「逐 k 线保存的机制」进一步说明:每次 handlebar 前深拷贝,只有 K 线结束时最后一个分笔的修改才有效,其余分笔全部回退。回测里每根 bar 只调用一次,修改会在下一根 bar 体现,所以侥幸不出事;盘中每个分笔都调用,money += ...、holdings[k] = ... 会被吞掉,仓位与资金按错误值继续报单。改法(未落盘):整体搬到模块级单例 g.pos / g.money / g.s,见代码里的候选骨架。回归:回测结果应与改前一致;盘中打印 g.money 确认同一根 K 线内多次触发时数值不再回退。

严4(严重)缺盘中回放、时段与单次触发保护
handlebar 开头没有 is_last_bar()、没有交易时段判断,L30 只有 d > 60 and d % 20 == 0。回测下每根 K 线一次调用,语义正确;但盘中同一个 barpos 会被每个分笔反复触发,d % 20 == 0 恒真,于是同一天每一笔行情都会跑一次完整调仓(含 300 只取数 + 下单)。官方《使用须知》明确「盘中,每一个新的行情快照都会触发一次 handlebar 函数调用」,《常见问题》另说明非交易时段行情服务重启也会触发。改法(未落盘,仅模拟/实盘需要):加 if not C.is_last_bar(): return + 时段过滤 + is_new_bar() 收根结算,并用模块级 g.last_rebalance_bar 做每日幂等。注意:纯回测千万别加 is_last_bar(),否则历史 K 线全部跳过。回归:模拟模式下观察一根日 K 内只调仓一次。

严5(严重)下单股数类型与整手规则都不符
L67 order[k] = int(money_distribution[k]/(price[k][-1]))/100:Python 3 里 int(...)/100 返回 float,只是把数值除以 100 再原样乘回去,并没有取整到整手;L68 order[k]*100 传进去的仍是 float 且常常不是 100 的倍数。官方《交易函数》参数表写 shares: 股数, int;《常见问题》「交易所委托数量规则」写主板「100 股起,100 股递增」。官方《快速开始》回测示例给的标准写法是 vol = int(available_cash / close_list[-1] / 100) * 100。改法(未落盘):见代码里的候选替换。不改会怎样:实盘直接废单,回测里数量不合法也可能报错或按可用数量撮合,结果失真。回归:打印一次下单股数,确认是 int 且为 100 整数倍。

严6(严重)扩展数据股票代码格式拼反
L37/L38 ext_data_rank('atr', k[-2:]+k[0:6], 0, ContextInfo)。官方《引用函数》定义 ext_data_rank(extdataname, stockcode, deviation, ContextInfo),其中 stockcode 形式如 '600000.SH'。而 signal() 里 if k in data_close60 与 get_history_data 返回的 key 都说明 k 已是 '600000.SH' 形式,拼完却变成 'SH600000'。依据:已经 QMT 官方文档核实。改法(未落盘):直接用 ext_data_rank('atr', k, 0, ContextInfo)。留个余地:若你本地扩展数据确实用另一种代码格式,请以本地实测为准并忽略本条,官方文档未定义其它形式。不改会怎样:取不到因子排名值,评分与选股可能全部落在默认值上。回归:打印一次单只股票的 rank 值,确认非默认/非异常。

警1(警告)price[k] 无成员检查
L29 取 price 后,L56/L67/L68 直接 price[k][-1],而 signal() 里 L91 反而写了 if k in data_close60——说明作者知道会有数据缺失。成分股变更、新股、退市或停牌导致 price 里没有该 key 时,会 KeyError 让 handlebar 抛异常。改法(未落盘):下单前 if k not in price or not price[k]: continue。回归:故意从股票池里塞一只无数据的代码,确认跳过而不是崩。

警2(警告)买入扣款手续费符号写反
L70 money -= 成交额 - 0.0003*...:买入成本应是「成交额 + 手续费」,写成减号后手续费反而没扣,money 与 profit(L71 单独扣了手续费)口径不一致。L57 卖出侧写的是 成交额 - 手续费,是对的。改法(未落盘):改为 money -= 成交额 + 手续费。回归:单笔买入后手算可用资金,与打印值一致。

警3(警告)第二因子与资金分配的实现残留
L38 算了 rank2[k] = ext_data_rank('adtm', ...),但 L40 只用 1.0 * rank1[k] 评分,注释却写「此处取了 0.5 和 -0.5」——rank2 完全没进评分,等于白跑一次全池调用。另外 L45 tmp_stock 是 set,L63 zip(tmp_stock, weight) 依赖它的迭代顺序,跨运行可能不同,资金分配不可复现。改法(未落盘):要么把 rank2 按你的权重纳入 rank_total,要么删掉这次调用;tmp_stock 改成 list 保序。(排序方向是否该 reverse 属策略意图,本评审不评价,只提示注释与实现需你自行确认。)

警4(警告)do_back_test 判断与用途相反
L76 if not ContextInfo.do_back_test: 才画 profit_ratio。官方《变量约定》定义 do_back_test 是「表示当前是否为回测模式,只读,默认 False」。也就是回测时它为 True,条件恒为假——这份回测示例的收益曲线永远不会画出来,反而在非回测模式才画,而那时 capital/profit 又不可靠。改法(未落盘):改成 if ContextInfo.do_back_test:。paint('profit_ratio', profit, -1, 0) 的参数顺序与官方《绘图函数》一致,无需改。回归:回测副图上能看到曲线。

警5(警告)旧接口 + 每 bar 取数 + 订阅上限
官方《常见问题》原文把 set_universe、get_history_data、get_market_data 标为「不再推荐使用!」,并说明 set_universe 订阅的品种没有订阅号、无法反订阅;订阅有数量上限,超出时「返回的行情数据会使用前值填充,出现重复值,非正确行情数据」——HS300 全池 300 只正好容易踩线。另外 L29 的取数在 if d > 60 and d % 20 == 0 之外,每个 bar 都取一次却只有 1/20 的 bar 用得上。官方《快速开始》明确回测应「指定 subscribe 参数为 False」读本地数据。改法(未落盘):迁 get_market_data_ex(..., subscribe=False);至少先把 L29 移进调仓分支。回归:取数长度、首尾开盘价与主图一致。

提1(提示)capital 的回测边界:《变量约定》写 ContextInfo.capital「只支持回测模式」「默认为 1000000」。L19 用它做初始资金、L75 拿它做分母;非回测模式下取不到会 AttributeError,界面里若设为 0 会 ZeroDivisionError。建议加个非零保护,并把资金记账与 capital 解耦。

提2(提示)扩展数据前置依赖:文件头说明需要「补完 HS300 成分股数据之后生成」VBA 指标 ATR/ADTM 并命名 atr/adtm。官方《引用函数》只给了 ext_data_rank 的签名,没有说明扩展数据不存在时的返回值,这一点请以本地实测为准,别假定是 0 或 None。

提3(提示)死代码与日志:pandas、time 导入后全文未用;ContextInfo.day 只写不读;L41 print(1111111, rank1[k]) 是调试残留,每轮对每只候选股打印一次,回测日志会很大。清掉更清爽。

已核实无误 / 误报澄清(正面确认)

  • get_history_data(..., 3) 的第 4 参数 dividend_type 是 int,3 = 等比向前复权,与官方《常见问题》推荐回测用等比前复权一致 ✓
  • timetag_to_datetime(get_bar_timetag(barpos), '%Y%m%d') 与官方《快速开始》示例逐字一致;barpos 是只读属性,代码只读未写 ✓
  • ext_data_rank / order_shares 的参数顺序、'fix' 指定价、paint 的参数顺序均与官方文档一致 ✓
  • 静态审查报的 PYUNDEF(timetag_to_datetime、ext_data_rank、order_shares)是误报:它们都是客户端内置函数,分别收录于《快速开始》《引用函数》《交易函数》 ✓
  • 静态审查报的 CTX_READONLY(accountID) 也是误报:官方《变量约定》未把 accountID 列为只读,官方回测示例自己就在 init 里写 C.accountid = "testS"。不过账号属配置项,放模块级更稳妥 ✓
  • 无 sleep、无线程库、无死循环、无 count=-1 全量取数、无网络/文件外接 ✓ 五条铁律中「阻塞 / 线程 / 全量取数」三条未触碰;命中的是「ContextInfo 存状态」与「回放防护」
  • signal() 里 L91 的 if k in data_close60 成员检查写法正确,问题在于 handlebar 侧没对称处理 ✓

第三部分:部分代码 + 注释(原样,逻辑零改动)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
#coding:gbk
# [qmt-strategy-review] ============ 评审(阶段一, 未修改任何逻辑)============
# [qmt-strategy-review][通1][严重] 磁盘实际是 UTF-8, 首行却声明 gbk
# 原因: QMT 内置 Python 按 GBK 解码, 中文注释与 print 会乱码
# 依据: 已经 QMT 官方文档核实, 见《快速开始》编写策略前的注意事项
# 改法: 首行写 # coding:gbk, 并把文件本体另存为 GBK 编码
# [qmt-strategy-review] 本文件自述为回测模型示例, 条目按用途分两类:
# 只做回测 -> 通1 / 严1 / 严5 / 严6 必修, 严2 / 严3 / 严4 不影响回测
# 上模拟或实盘 -> 严2 / 严3 / 严4 必须改, 是一次结构性改造
# [qmt-strategy-review] 静态审查的 PYUNDEF 与 CTX_READONLY 多为误报:
# timetag_to_datetime / ext_data_rank / order_shares 是客户端内置函数,
# accountID 未被官方文档列为只读, 官方回测示例自己也在 init 里写账号属性
"""
回测模型示例(非实盘交易策略)
#HS300日线下运行,20个交易日进行 一次调仓,每次买入在买入备选中因子评分前10的股票,每支股票各分配当前可用资金的10%(权重可调整)
#扩展数据需要在补完HS300成分股数据之后生成,本模型中扩展数据暂时使用VBA指标ATR和ADTM生成,命名为atr和adtm
"""
# [qmt-strategy-review][提3] pandas / time 导入后全文未使用, day 只写不读, 可清掉
import pandas as pd
import numpy as np
import time
import datetime

# [qmt-strategy-review] ---- 候选替换(未应用, 确认 严3 后启用)----
# class G(): pass
# g = G()
# def init(ContextInfo):
# g.s = ContextInfo.get_stock_list_in_sector('沪深300')
# ContextInfo.set_universe(g.s)
# g.holdings = {i: 0 for i in g.s}
# g.weight = [0.1] * 10
# g.buypoint = {}
# g.money = ContextInfo.capital
# g.profit = 0
# g.last_rebalance_bar = -1
# [qmt-strategy-review] ---- /候选替换 ----

def init(ContextInfo):
# [qmt-strategy-review][严1][严重] ContextInfo.get_sector 官方文档当前未核实到
# 原因: 官方收录的是 get_stock_list_in_sector, 且示例传板块名而非指数代码
# 依据: 已经 QMT 官方文档核实《行情函数》《系统函数》《快速开始》
# 改法: 先在本地实测该函数是否存在; 若不可用改用
# ContextInfo.get_stock_list_in_sector('沪深300')
# 不改会怎样: 函数不存在时 init 直接 AttributeError, 策略加载不起来
ContextInfo.s = ContextInfo.get_sector('000300.SH')
ContextInfo.set_universe(ContextInfo.s)
# [qmt-strategy-review][严3][严重] 以下全部状态挂在 ContextInfo 上
# 原因: 每次 handlebar 前深拷贝, 只有 K 线结束分笔的修改才生效
# 依据: 已经 QMT 官方文档核实《使用须知》与《常见问题》逐 k 线保存机制
# 改法: 整体迁到模块级 g, 见上方候选替换
# 注意: 回测每根 K 线只调用一次, 回滚不显现; 盘中每分笔调用必错
# [qmt-strategy-review][提3] day 为死变量, 全文只写不读
ContextInfo.day = 0
ContextInfo.holdings = {i:0 for i in ContextInfo.s}
ContextInfo.weight = [0.1]*10 #设置资金分配权重
ContextInfo.buypoint = {}
# [qmt-strategy-review][提1] capital 官方标注只支持回测模式, 默认 1000000
ContextInfo.money = ContextInfo.capital
ContextInfo.profit = 0
# [qmt-strategy-review] 静态扫描报此处"写只读属性"属误报, 官方示例有同样写法
ContextInfo.accountID='testS'

> 策略代码全文和审阅完整版报告请在 WTSolutions 公众号后台发送“代码评审”获取。

⚠️ 实盘风险提示:涉及真实下单。请先在 QMT「模拟信号模式」或「模拟柜台」中充分验证后,再切换实盘账号;股票受 2% 价格笼子限制,数量超可用会产生废单。

要不要我落地改? 请回编号,例如「改 通1、严5、严6」或「全改」。动之前我会先复制 多因子选股.txt.bak,只改你点到的条目,改完重跑静态审查并对比严重项数量。两种典型组合可以直接说:

  • 只做回测 → 建议「通1 + 严1(先确认接口)+ 严5 + 严6 + 警1 + 警2 + 警4」,其余保留现状即可。
  • 要上模拟/实盘 → 必改「通1 + 严1 + 严2 + 严3 + 严4 + 严5 + 严6 + 警1 + 警2 + 警5」,这是一次结构性改造(passorder + 模块级状态 + 委托状态机 + 每日幂等),我会给完整骨架。

注意通1 的「文件转 GBK 编码」需要在磁盘上转码保存,落地时一并处理;严1 请先告诉我 get_sector 在你本地客户端是否可用,我不替你猜。


策略代码全文和审阅完整版报告请在 WTSolutions 公众号后台发送“代码评审”获取。

⚠️ 风险提醒与免责声明

  • 本回答基于 QMT 官方公开文档与公开社区资料整理,仅供编程学习与技术研究,不构成任何投资建议。
  • 实盘前必须在「模拟信号模式」或「模拟柜台」充分验证;未经模拟验证直接实盘,后果自负。
  • 具体行为以官方文档、券商柜台与本地客户端实际输出为准,不承诺任何委托结果。
  • 因使用本回答中的代码或建议造成的任何盈亏,由使用者自行承担全部责任。