返回列表 发布新帖

QMT内置与原生Python配置读写接口:write_config / read_config 使用及实测

62 0

一、接口介绍

迅投QMT提供两个用于策略配置存储的函数:

  • write_config():写入策略配置。
  • read_config():读取策略配置。
  • 据迅投官方说明,python3.6和python3.12都支持,但是需要QMT客户端版本是2.1.37以上才可以。

根据接口文档,配置内容会加密保存至终端本地配置库,支持两种Python调用方式:

  1. QMT内置Python:直接调用函数。
  2. 原生Python:通过 qmt_api 模块调用。

两种方式读写同一份配置数据。

这两个接口可用于保存策略参数、运行标记及少量需要跨启动恢复的状态信息,不需要自行调用Python文件读写函数。

下面介绍两个接口的使用方法,并结合实际测试说明其行为。

image.png image.png

二、write_config:写入策略配置

2.1 函数说明

函数签名:

write_config(path, content)

参数说明:

参数 类型 说明
path str 配置键,用于标识一条配置
content str 需要保存的配置内容

虽然接口参数名称为 path,但它并不要求传入Windows文件路径。可以直接使用简单的字符串作为配置键。

例如:

write_config('test_key', 'hello')

表示将字符串 hello 保存到名为 test_key 的配置项中。

返回值:

返回值 含义
0 写入成功
1 存储失败
-1 参数错误或打开配置库失败

2.2 QMT内置Python调用示例

#coding:gbk

def init(C):
    key = 'test_key'
    content = 'hello_qmt'

    ret = write_config(key, content)

    print('写入返回值:', ret)

    if ret == 0:
        print('配置写入成功')
    else:
        print('配置写入失败')

def handlebar(C):
    pass

2.3 原生Python调用示例

原生Python需要从 qmt_api 导入:

#coding:gbk

from qmt_api import write_config

ret = write_config('test_key', 'hello_qmt')

print('写入返回值:', ret)

实测正常写入返回 0。

三、read_config:读取策略配置

3.1 函数说明

函数签名:

read_config(path)

参数说明:

参数 类型 说明
path str 配置键,与写入时使用的键一致

返回值:

返回值 含义
str 读取到的配置内容
None 配置键不存在或读取失败

3.2 QMT内置Python调用示例

#coding:gbk

def init(C):
    value = read_config('test_key')

    if value is None:
        print('配置不存在或读取失败')
    else:
        print('读取配置:', value)

def handlebar(C):
    pass

3.3 原生Python调用示例

#coding:gbk

from qmt_api import read_config

value = read_config('test_key')

print('读取结果:', repr(value))

需要区分:

  • 读取到 '':表示配置内容为空字符串。
  • 返回 None:表示配置不存在或读取失败。

建议使用 value is None 判断。

四、接口实测结果

4.1 基础读写测试

测试日期:2026年11月18日。

本次进行了25项专项测试,其中17项通过、7项参数异常检查需要进一步结合文档解释,另有1项持久性观察。

测试内容 实测结果
普通字符串 通过
数字字符串 通过
中文字符串 通过
多行文本、制表符 通过
JSON格式字符串 通过
空字符串 通过
特殊符号 通过
1024字符内容 通过
4096字符内容 通过
同键覆盖写入 通过
相同内容重复写入 通过
不同配置键独立保存 通过
不存在的配置键 返回None

测试确认,这两个接口可以正常存储常见字符串内容,且本次测试的4096字符内容能够完整写入和读取。

最大存储容量尚未验证。

4.2 参数错误测试

根据接口文档,write_config() 的两个参数均为字符串。

测试以下错误类型:

write_config(None, 'abc')
write_config(123, 'abc')
write_config('test_key', None)
write_config('test_key', 123)

实际抛出:

TypeError: write_config(): incompatible function arguments

read_config() 传入错误类型时同样会触发异常:

read_config(None)
read_config(123)

实际抛出 TypeError。

因此,实际使用时需要注意:错误参数类型可能直接触发Python异常,而不是返回文档中的 -1。

文档定义的存储失败返回值 1 和错误返回值 -1,本次未实际触发。

4.3 覆盖写入测试

使用相同配置键依次写入不同内容:

write_config('test_key', 'value_1')
write_config('test_key', 'value_2')

print(read_config('test_key'))

读取结果:

value_2

实测确认同键重复写入可以覆盖旧内容,重复写入相同内容也正常。

五、配置持久化与跨环境共享测试

5.1 跨策略运行读取

首先写入固定配置:

write_config('last_run', 'saved_state_001')

停止策略后,在另一份独立脚本中读取相同配置键:

value = read_config('last_run')
print(value)

示例预期结果:

saved_state_001

实际专项测试使用固定配置键及时间标记,已确认新脚本能够读取先前写入的内容。

这表明配置数据不会随着原策略结束而立即消失。

5.2 终端重启后读取

完成配置写入后,退出并重新启动投研终端,再运行读取测试。

测试中仍然成功读取之前保存的内容。

因此,本次测试确认配置内容能够跨策略运行和终端重启保留。

5.3 内置Python与原生Python共享配置

先在QMT内置Python中写入:

write_config('shared_key', 'written_by_strategy')

再在原生Python中读取:

from qmt_api import read_config

value = read_config('shared_key')
print(value)

示例预期输出:

written_by_strategy

实际测试中,原生Python成功读取内置Python此前保存的时间标记。

另外,原生Python自身的写入、读取、同键覆盖和中文JSON保存也均已测试通过。

目前确认:

  • 内置Python写入、读取正常。
  • 原生Python写入、读取正常。
  • 内置Python写入的数据可以由原生Python读取。
  • 原生Python写入后由内置Python反向读取,尚待单独取得最终验证日志。

六、应用示例:保存和恢复策略参数

例如,保存策略使用的仓位比例,重新启动策略时尝试恢复:

#coding:gbk

KEY = 'position_ratio'

def init(C):

    value = read_config(KEY)

    if value is None:
        position_ratio = 0.2
        print('未读取到配置,使用默认参数')
    else:
        try:
            position_ratio = float(value)
        except Exception:
            position_ratio = 0.2
            print('配置内容无效,使用默认参数')

    print('当前仓位比例:', position_ratio)

    ret = write_config(KEY, str(position_ratio))
    print('配置保存返回:', ret)

def handlebar(C):
    pass

该示例只演示参数保存和恢复,不执行交易委托。

实际策略中,也可以保存策略运行日期、交易信号标记、自定义风控参数等。

需要注意,订单、成交和持仓仍应以交易账户查询结果为准,不能单独依赖配置库中的历史标记。

七、注意事项

7.1 配置键不是本地文件路径

虽然函数参数名为 path,实际使用时可以直接传入简单的配置键:

write_config('test_key', 'hello')
read_config('test_key')

不需要提供Windows文件路径。

根据接口说明,配置内容会加密存放在终端本地配置库中,具体物理文件名、文件格式及存储目录尚未确认。

7.2 不需要自行读写文件

使用这两个接口,不需要自行调用:

open()
pandas.read_csv()

配置的读写操作由迅投QMT接口完成。

7.3 建议使用独立配置键

不同策略建议使用不同的键名,例如:

strategy_a_last_signal
strategy_a_position_ratio

strategy_b_last_signal
strategy_b_position_ratio

避免多个策略无意间使用相同的键并覆盖彼此的数据。

7.4 尚未验证的边界

  • 最大存储容量。
  • 不同账户、不同终端实例之间的数据隔离。
  • 多个策略同时写入同一配置键时的行为。
  • 终端升级或卸载后的数据保留情况。
  • 配置库异常时的恢复机制。
  • 是否支持删除配置项。

对于重要交易状态,建议结合订单、成交和持仓记录进行恢复校验。

八、总结

通过本次迅投QMT接口测试,可以得到以下结论:

  1. write_config() 和 read_config() 均可正常使用。
  2. 支持QMT内置Python直接调用,以及原生Python通过 qmt_api 调用。
  3. 支持普通字符串、中文、JSON、空字符串及至少4096字符的测试内容。
  4. 相同配置键重复写入会覆盖旧内容。
  5. 不存在的配置键读取返回 None。
  6. 参数类型不匹配时,实测会抛出 TypeError。
  7. 配置数据支持跨策略运行及终端重启后读取。
  8. 原生Python可以读取内置Python此前写入的配置。
  9. 配置库的具体物理存储路径尚未确认。

这两个接口适合用于迅投QMT策略参数保存、简单配置管理与少量状态持久化。

对于需要在策略重启后恢复参数或运行标记的场景,可以考虑使用这两个配置读写接口。

以上结论基于2026年11月18日的实际测试,具体行为仍可能受到终端版本、权限及运行环境影响。

回复

您需要登录后才可以回帖 登录 | 立即注册

客服专线

400-080-8112

用思考的速度交易,用真诚的态度合作,我们是认真的!
  • 关注公众号
  • 添加微信客服
Copyright © 2001-2026 迅投QMT社区 版权所有 All Rights Reserved. 京ICP备2025122616号-3
关灯 快速发帖
扫一扫添加微信客服
QQ客服返回顶部
快速回复 返回顶部 返回列表