概述
今天(2026-11-19)看到券商推送的一条,标题是 QMT测试环境相关变更通知,其中一条直接点名了 save_py_key。通知原文转录如下(个别字词按语义校正):
QMT测试环境相关变更通知
2026-11-18 09:31:27 系统留言信息
尊敬的投资者:
QMT:
save_py_key(key,value)接口仅用作存储中间变量或计算过程中的少量临时数据设计,严禁作为数据库使用,为避免影响服务稳定性和数据读写性能 11 月 20 日(星期五)17:00 后系统会将超过 1 万条数据的测试账户下全量数据清理删除。如您有使用请注意及时备份保存。我司测试环境客户端已更新至 2.1.36 版本。该版本在支持 Python 3.12 版本基础上修复优化了部分 2.1.33 错误拦截 IP 的问题。
Python 3.12 版本变更说明详见:(省略)
如您有正在运行的策略程序或工具,请务必在测试环境完成测试验证,确认相关功能可正常运行。
请登陆客户端选择自动更新,若无法完成自动更新可重新下载安装:(省略)
2026 年 11 月 18 日
通知的核心意思有三层:
save_py_key的定位是存中间变量、计算过程中少量临时数据,严禁作为数据库使用;- 为「避免影响服务稳定性和数据读写性能」,11 月 20 日(周五)17:00 后,系统会将超过 1 万条数据的测试账户下的全量数据清理删除;
- 测试端客户端已更新到 2.1.36(在支持 Python 3.12 的基础上修复了 2.1.33 错误拦截 IP 的问题)。
注意三个关键词:「测试环境」、「超过 1 万条」、「全量删除」。这决定了这件事现在该不该慌、以及该做什么。
一、这不是孤立事件,是 10·23 收口的延续
把最近一个多月的时间线摆出来,脉络很清楚:
| 时间 | 事件 | 对应文章 |
|---|---|---|
| 2026-08-28 | 中证协、中基协联合发布《证券公司交易信息系统接入管理规范(试行)》 | — |
| 2026-10-23 前后 | 券商关闭大 QMT 内置策略的本地文件读写与外部网络连接,取消独立交易入口 | 传言成真:券商推送QMT重要更新 |
| 2026-10-26 | 内置 Python 从 3.6.8 升到 3.12 | QMT 内置 Python 3.6→3.12 |
| 2026-11-18 | 测试端通知:限制 save_py_key 用途,清理超 1 万条账户数据 |
本文 |
上一轮把 文件读写 和 网络连接 两条路堵死之后,策略状态能落到哪里,一下子成了悬而未决的问题。迅投给出的官方答案是 save_py_key / get_py_key——把数据存到券商服务端。
当时它是那扇半开的窗。现在,这扇窗也要被限制开口了。
顺带说一句:这份通知来自测试环境,正式客户端大概率还没同步这个限制。但券商的惯例是测试端先行、正式端跟进——10 月那轮接口限制也是模拟端(10-13)先于实盘端(10-23)。把它当成正式端的预告来看,比当成孤立的测试公告更稳妥。
二、save_py_key 是什么,数据存在哪里
这是最容易被误解的一点,说清楚三件事:
它是两个内置全局函数。save_py_key(key, value) 写,get_py_key(key) 读,key 和 value 都是字符串。返回值的常见形态是 errid, errmsg = save_py_key(...)、value, errid, errmsg = get_py_key(...),errid == 0 表示成功。要注意它不在迅投官网公开 API 文档里,而是在 QMT 客户端自带函数文档(<客户端目录>\config\fun.xml)里——所以搜官网搜不到,搜客户端目录才找得到。
数据存在券商 QMT 后台服务端,不是你本地硬盘。 以 key-value 键值对的形式持久化到券商服务端,据社区资料是加密保存的。这就是为什么在「本地文件读写被封」之后它还活着:数据压根不经过被封的本地文件系统。
容量很小。单个 value 上限约 5000 字节(约 5000 英文字符 / 2500 汉字),单个键的数量也有限制。这个量级从设计上就写明了定位:存的是「少量临时数据」,不是让你塞持仓历史、K 线、交易日志的。
一句话总结它的正确姿势:QMT 服务端给你的一个带配额的小记事贴,不是数据库。
三、为什么券商要限制它(猜一猜)
通知给出的直接理由只有一句:「为避免影响服务稳定性和数据读写性能」。但往下挖一层,有三个叠加的动机:
1. 合规大背景。 8·28 的《证券公司交易信息系统接入管理规范(试行)》把「交易信息系统接入」纳入强监管,核心诉求之一是券商要能管住客户策略系统的行为边界。文件读写、外部网络、独立交易入口,都在收口。服务端 KV 是券商自己的基础设施,自然也在管理范围内——不能让客户策略在券商服务器上无限制地读写数据。
2. 它被当成数据库滥用了。 这从「超过 1 万条数据」这个阈值就能反推出来:真按「少量临时数据」的定位用,一个策略几个 key 顶天了,怎么会有人存到 1 万条?现实是文件读写被封之后,大量策略把原来写 JSON / SQLite 的状态全搬到了服务端 KV——一个标的一个 key、一个日期一个 key、成交记录也往里塞。券商的服务端 KV 不是为这种读写模式设计的,量一大就会拖慢服务、挤占存储,这正是通知里「影响服务稳定性和数据读写性能」的实指。
3. 定位纠偏。 通知特意强调「严禁作为数据库使用」,是在划一条线:我给你这个接口,是让你在沙箱里还能记住「上次做到哪一步」,不是让你把券商服务器当免费云数据库。这次还配合了一个很硬的手段——超 1 万条的账户直接全量删除,不是只删超出的部分。这个力度的信号意义大于清理本身:配额是硬的,别踩。
四、会不会有 delete_py_key?
这是很多人看完通知的第一反应:既然你能全量清理,那能不能给我一个 delete_py_key,让我自己删?
先说事实:目前没有。迅投公开的客户端函数里只有 save_py_key 和 get_py_key 两个,没有任何删除接口。社区里有人问「是否有过期、过期清理工作怎么做」,官方没有正面答复。这次券商做的「全量清理删除」,是券商运维侧的管理动作,不是 open 给策略的 API——两者性质完全不同。
| 维度 | 分析 |
|---|---|
| 技术 | 服务端既然能按账户全量清理,加一个按 key 删除的接口并不难,实现层面几乎没有障碍 |
| 用户需求 | key 写错、状态过期、测试残留,确实都需要清理,这是合理需求;社区已经有人追问过期清理,是个真实的痛点 |
| 更可能的形态 | 与其给裸 delete_py_key,券商更可能上配额 + TTL 自动过期 + 命名空间隔离这类带生命周期管理的机制,让数据「自然消失」而不是让策略随意删 |
在官方给方案之前,务实的做法是用覆盖写实现软删除:
1 | # coding:gbk |
配套的读取逻辑要把「空串」和「读不到」都当成无状态处理。这样既不新增接口、也不越界,还能顺手解决「测试残留键占配额」的问题。
一句话:delete_py_key 有技术可能,但别等它;先用覆盖写 + 配额自律把问题解决掉。 如果哪天真的出了,大概率也是包在「合规存储方案」里一起给的,而不是单独补一个函数。
写在最后
10 月 23 日 QMT 客户端限制后,目前看来各大券商依然在“查漏补缺”,而且动作速度并不慢,希望很快,大家能用上一个状态持久化的合规工具。
说明:本文包含 AI 创作内容,请自行判断是否适用。文中通知原文与政策信息来自第三方券商通知,不同券商的调整范围、时间节点与执行尺度可能存在差异,一切请以您开户券商的官方通知与公告为准。本文仅作科普使用,不构成任何投资建议,据此操作风险自担。