CFQuant 是 MiniQMT 的开源替代方案：让原有
xtquant/ 外部 Python 策略低成本接入大 QMT。
cfquant 是面向大 QMT 的本地桥接层，专注解决 MiniQMT 迁移、大 QMT 外部 Python 调用、账号路由、交易回调和 Web 可观测这些实际问题。它不会替代 QMT 终端本身，而是把大 QMT 已有的行情、查询、交易和回调能力整理成更接近 miniQMT / xtquant 的调用方式，让旧策略可以更低成本迁移到大 QMT 环境。
| 能力 | 解决的问题 |
|---|---|
MiniQMT / xtquant 兼容调用 |
原有外部 Python 策略可以沿用接近 xtdata、XtQuantTrader、StockAccount 的写法，降低迁移成本。 |
| 大 QMT 本地桥接 | 把大 QMT 内部的行情、查询、交易、撤单和回调能力桥接给外部 Python 程序和 Web 控制台。 |
| Web 控制台 | 在浏览器里完成账号绑定、QMT 入口脚本指引、在线检测、接口调试、版本更新和回滚。 |
| 多账号 / 多 QMT 路由 | 按 bridge_id、account_type、account_id 路由请求，适配多资金账号、普通账户、信用账户和多 QMT 终端。 |
| 通用、极致、高级三种模式 | 普通环境快速跑通；受限 QMT 使用自包含入口；低延迟场景可拆分普通桥和交易桥。 |
| 交易回调与行情推送 | 接收委托、成交、账号状态和行情事件，方便外部策略处理异步结果。 |
| 部署与排障闭环 | 通过日志、状态检查、教程、反馈和论坛沉淀接入问题，减少部署和维护成本。 |
项目尽量保持 miniQMT / xtquant 常用接口的调用习惯。已有外部 Python 策略通常只需要调整连接方式或少量配置，不需要重写主要的行情和交易逻辑。具体接口能力和兼容边界请以项目文档为准。
完成部署后，QMT 负责运行桥接策略，cfquant 负责提供本地通信和接口转发。外部 Python 程序可以继续使用熟悉的接口访问 QMT 能力，Web 控制台则用于账号绑定、状态检查、接口测试、策略部署和日常运维。
部署需要同时配置本地 Python 环境、QMT 目录、账号绑定和 QMT 入口策略。建议第一次使用时优先选择通用模式，按 QMT 部署教程 和 Web 控制台中的初始化向导逐步完成；高级模式和两地多中心需要额外配置多个 QMT 或多个市场入口。
- 官网与问题反馈：www.cfquant.org
- 版本更新日志：docs/版本日志.md
- 完整部署、模式选择和接口说明见下方“文档”目录
- Windows
- 已安装并登录大 QMT
- Python
3.8-3.12，生产环境优先使用3.10或3.12
部署前先根据 QMT 环境选择模式：
| 模式 | QMT 入口 | 适用场景 |
|---|---|---|
| 通用模式 | CFQUANT_CTYPE_ALL_LOWLAT.py |
默认选择，适合大多数用户、单账号和常规 QMT 环境 |
| 极致模式 | CFQUANT_LITE.py |
适合国泰君安、国泰海通的君弘君智，以及其他存在 Python 包白名单或导入限制的 QMT |
| 高级模式 | 普通 QMT 加载 CFQUANT.py，极速交易端加载 CFQUANT_TRADE_LOWLAT.py |
需要进一步降低下单、撤单延迟，并且能够准备两个 QMT 时使用 |
选择建议：
- 不确定时优先使用通用模式。
- 如果 QMT 无法导入
cfquant，或受到 Python 包白名单限制，选择极致模式。 - 高级模式需要两个不同的 QMT，不能在同一个 QMT 中同时加载普通入口和极速交易入口。
开始前请先阅读 QMT 部署教程。
新用户和生产环境优先使用源码包部署。原因很简单：cfquant 的 Web 控制台、QMT 入口脚本和本地配置是一起工作的，源码包保留完整项目目录，后续在网页里检查更新、更新 Web、回滚版本、提示 QMT 入口脚本变更都更方便。
- 将项目解压到固定目录，例如
D:\cfquant。 - 直接双击项目目录中的
start_cfquant.bat。启动脚本会使用项目.venv（如果存在）或当前 Python，先检查当前环境是否已经安装cfquant；已通过 PyPI 或其他方式安装时直接跳过，缺失时会用等价于python -m pip install --editable .的参数列表自动安装当前源码版本，不需要用户手动执行安装命令。若 Web 端口上已经运行 cfquant，会直接复用已有实例并打开页面；若端口被其他程序占用，会提示换端口或停止占用进程。
自动安装失败时，启动窗口会保持打开，并把安装日志写入 log\cfquant_startup.log，修复 Python、网络或权限问题后重新启动即可。
项目默认使用清华 PyPI 镜像安装依赖，适合中国大陆网络环境。启动脚本、网页源码更新、requirements.txt 安装以及 LTtx 缺失依赖自动安装都会遵循这个设置。需要切换到企业私有源或其他镜像时，可在启动前设置 CFQUANT_PIP_INDEX_URL 环境变量。
通过 PyPI 安装后，可以使用下面任一命令启动本地 Web 控制台；run 和 serve 等价：
cfquant run启动后打开 http://127.0.0.1:8765/，按网页中的“新手初始化向导”完成账号、模式和 QMT 目录配置。开启“自动导入并管理 QMT 策略”可配置账号、模拟/实盘及 QMT 启动自运行；按绑定页进度完成 QMT 导入和重启，再验证资金、持仓、委托和行情。流程及模式互斥规则见 Web 账号运行配置说明。
重点：
- 源码部署后，网页里的“版本/更新”功能会按完整项目目录更新，适合从官网或 GitHub 拉取新版本。
- 更新时会尽量保留本地配置、数据库、日志和运行目录，便于日常升级和回滚。
- 如果新版本修改了
qmt_scripts/里的入口脚本，网页会提示你重新更新 QMT 侧脚本并重启对应 QMT 策略。 - 建议把源码目录固定下来，例如
D:\cfquant，不要频繁挪动目录。
新用户建议先使用通用模式。所有部署配置都在 Web 控制台完成，保存绑定后系统会自动准备并管理 QMT 托管策略。
- 在初始化向导或“绑定”页面填写资金账号、账户类型、模式和 QMT 目录，勾选“自动导入并管理 QMT 策略”，确认模拟／实盘与策略自动运行设置。
- 保存后系统自动部署核心包、身份配置和托管策略，弹窗显示部署结果及启动提醒，无需复制代码或手工新建策略。
- 按提示重启并登录 QMT。如果勾选了“自动启动 QMT”，在启动后的 QMT 中登录即可；QMT 自身已设置自动登录时，等待自动登录完成。国金证券 QMT 目前不支持自动登录，每次启动后需手动输入密码登录。
- 若提示等待退出，正常退出 QMT，保持 cfquant 运行，等待模型配置完成后再启动。若部署失败，修正目录、权限或模型账号 Key 后重新保存。
- “知道了”直接关闭提醒；“检测连接”可进入通道检测，随后查询资金或持仓确认账号数据。
“自动启动 QMT”负责启动客户端；“QMT 启动后自动运行”负责运行托管策略。未勾选策略自动运行时，登录后需在“模型交易”运行已导入的托管策略。编辑已有绑定会保留这些选项，不会自动开启。
| 模式 | 自动部署目标 | 在线检测要求 |
|---|---|---|
| 通用模式 | 单个 QMT 中的通用托管策略 | 查询通道和交易通道都在线 |
| 极致模式 | 单个 QMT 中的自包含托管策略 | 查询通道和交易通道都在线 |
| 高级模式 | 普通端与极速交易端两个不同的 QMT | 两端都在线 |
| 同账号独立市场 | 对应上海和深圳市场的 QMT | 沪市和深市交易通道都在线 |
多 QMT 部署需分别完成各终端登录，自动启动选项仅启动绑定的主 QMT 目录。同一资金账号在同一个 QMT 中只允许一种模式。完整配置及状态说明见 Web 账号运行配置说明。
Web 控制台提供账号绑定、资金和持仓查询、委托和成交查询、下单和撤单、行情订阅、接口调试、部署指引以及版本更新管理。
常用脚本：
start_cfquant.bat 启动
stop_cfquant.bat 停止
restart_cfquant.bat 重启
2026-09-11 使用本地假 QMT 交易桥复测 100 单，5 次预热、30 次采样；该基准不连接 Web、LTtx、PipeHub 或真实 QMT，不产生真实委托，只衡量 SDK 到桥接分发和本地 passorder 循环的协议开销。
| 路径 | RPC 次数 | 中位耗时 | 平均耗时 |
|---|---|---|---|
批量同步 order_stock_batch |
1 | 4.802 ms | 4.901 ms |
单笔同步循环 order_stock x100 |
100 | 9.169 ms | 8.930 ms |
批量异步 order_stock_batch_async |
1 | 7.093 ms | 7.122 ms |
单笔异步循环 order_stock_async x100 |
100 | 9.053 ms | 9.186 ms |
批量接口用于组合调仓、批量止盈止损和撤掉一组未成委托。它的原理是外部 Python 只发一次批量 RPC，Web/LTtx/ctypes 将整批请求路由到 QMT 后，由 QMT 本地连续调用 passorder 或 cancel，减少逐笔跨进程往返。cftrader 目前提供 order_stock_batch、order_stock_batch_async、cancel_order_stock_batch 和 cancel_order_stock_batch_async；批量返回只表示请求提交情况，最终成交或撤成仍以委托查询和回调为准。
2026-09-11 02:45 使用模拟信用账号 900010001595 通过 Web LTtx 统一路由连接 acct_4b2b38c167，对 600000.SH 以 8.88 元买入价、每笔 100 股测试。四条路径各提交 100 单，均返回 submitted=100；02:48 只读复核该批 400 笔委托状态均为 54（已撤），可撤数量为 0。
| 路径 | RPC 次数 | 提交耗时 | 单笔均摊 |
|---|---|---|---|
批量同步 order_stock_batch |
1 | 963.252 ms | 9.6325 ms |
单笔同步循环 order_stock x100 |
100 | 23250.174 ms | 232.5017 ms |
批量异步 order_stock_batch_async |
1 | 52.578 ms | 0.5258 ms |
单笔异步循环 order_stock_async x100 |
100 | 2952.912 ms | 29.5291 ms |
| 需求 | 文档 |
|---|---|
| QMT 综合部署教程 | QMT 部署教程 |
| cftrader 批量同步/异步下单与撤单 | cftrader 批量交易与撤单，含 100 单本地基准 |
| 通用模式部署 | 通用模式部署指南 |
| 极致模式部署 | 极致模式部署指南 |
| 高级模式部署 | 高级模式部署指南 |
| 账号和 QMT 目录配置 | Web 账号运行配置说明 |
| 从 miniQMT 迁移 | miniQMT 迁移到大 QMT 指南 |
| 官网 nativeApi 接口功能及适配状态 | xtquant 原版接口适配清单 |
| Level2 六类行情、订阅回调与千档边界 | Level2 行情适配说明 |
xtdata 兼容性 |
xtdata 平替追踪 |
xttrader 兼容性 |
xttrader 平替追踪 |
| 接口能力范围 | QMT 函数封装能力清单 |
| AI 接口 Skill | cfquant-qmt skill |
| 日志、更新和回滚 | 运维与更新 |
| 版本更新日志 | 版本日志 |
更详细的教程也可以在 Web 控制台的“教程”页面查看。
本项目采用 MIT License 开源。