cfquant

项目简介

CFQuant 是 MiniQMT 的开源替代方案：让原有 xtquant / 外部 Python 策略低成本接入大 QMT。

1. 项目定位

cfquant 是面向大 QMT 的本地桥接层，专注解决 MiniQMT 迁移、大 QMT 外部 Python 调用、账号路由、交易回调和 Web 可观测这些实际问题。它不会替代 QMT 终端本身，而是把大 QMT 已有的行情、查询、交易和回调能力整理成更接近 miniQMT / xtquant 的调用方式，让旧策略可以更低成本迁移到大 QMT 环境。

2. 核心能力

3. 兼容方式

项目尽量保持 miniQMT / xtquant 常用接口的调用习惯。已有外部 Python 策略通常只需要调整连接方式或少量配置，不需要重写主要的行情和交易逻辑。具体接口能力和兼容边界请以项目文档为准。

4. 使用方式

完成部署后，QMT 负责运行桥接策略，cfquant 负责提供本地通信和接口转发。外部 Python 程序可以继续使用熟悉的接口访问 QMT 能力，Web 控制台则用于账号绑定、状态检查、接口测试、策略部署和日常运维。

5. 部署建议

部署需要同时配置本地 Python 环境、QMT 目录、账号绑定和 QMT 入口策略。建议第一次使用时优先选择通用模式，按 QMT 部署教程 和 Web 控制台中的初始化向导逐步完成；高级模式和两地多中心需要额外配置多个 QMT 或多个市场入口。

6. 官方资源

• 官网与问题反馈：www.cfquant.org
• 版本更新日志：docs/版本日志.md
• 完整部署、模式选择和接口说明见下方“文档”目录

快速开始

环境要求

• Windows
• 已安装并登录大 QMT
• Python 3.8 - 3.12，生产环境优先使用 3.10 或 3.12

模式选择

部署前先根据 QMT 环境选择模式：

选择建议：

• 不确定时优先使用通用模式。
• 如果 QMT 无法导入 cfquant，或受到 Python 包白名单限制，选择极致模式。
• 高级模式需要两个不同的 QMT，不能在同一个 QMT 中同时加载普通入口和极速交易入口。

安装方式

方式一：源码包部署（推荐）

开始前请先阅读 QMT 部署教程。

新用户和生产环境优先使用源码包部署。原因很简单：cfquant 的 Web 控制台、QMT 入口脚本和本地配置是一起工作的，源码包保留完整项目目录，后续在网页里检查更新、更新 Web、回滚版本、提示 QMT 入口脚本变更都更方便。

1. 将项目解压到固定目录，例如 D:\cfquant。
2. 直接双击项目目录中的 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 托管策略。

Web 控制台绑定与初始化流程

1. 在初始化向导或“绑定”页面填写资金账号、账户类型、模式和 QMT 目录，勾选“自动导入并管理 QMT 策略”，确认模拟／实盘与策略自动运行设置。
2. 保存后系统自动部署核心包、身份配置和托管策略，弹窗显示部署结果及启动提醒，无需复制代码或手工新建策略。
3. 按提示重启并登录 QMT。如果勾选了“自动启动 QMT”，在启动后的 QMT 中登录即可；QMT 自身已设置自动登录时，等待自动登录完成。国金证券 QMT 目前不支持自动登录，每次启动后需手动输入密码登录。
4. 若提示等待退出，正常退出 QMT，保持 cfquant 运行，等待模型配置完成后再启动。若部署失败，修正目录、权限或模型账号 Key 后重新保存。
5. “知道了”直接关闭提醒；“检测连接”可进入通道检测，随后查询资金或持仓确认账号数据。

“自动启动 QMT”负责启动客户端；“QMT 启动后自动运行”负责运行托管策略。未勾选策略自动运行时，登录后需在“模型交易”运行已导入的托管策略。编辑已有绑定会保留这些选项，不会自动开启。

多 QMT 部署需分别完成各终端登录，自动启动选项仅启动绑定的主 QMT 目录。同一资金账号在同一个 QMT 中只允许一种模式。完整配置及状态说明见 Web 账号运行配置说明。

Web 控制台

Web 控制台提供账号绑定、资金和持仓查询、委托和成交查询、下单和撤单、行情订阅、接口调试、部署指引以及版本更新管理。

常用脚本：

start_cfquant.bat       启动
stop_cfquant.bat        停止
restart_cfquant.bat     重启

cftrader 100 单本地基准

2026-09-11 使用本地假 QMT 交易桥复测 100 单，5 次预热、30 次采样；该基准不连接 Web、LTtx、PipeHub 或真实 QMT，不产生真实委托，只衡量 SDK 到桥接分发和本地 passorder 循环的协议开销。

批量接口用于组合调仓、批量止盈止损和撤掉一组未成委托。它的原理是外部 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；批量返回只表示请求提交情况，最终成交或撤成仍以委托查询和回调为准。

cftrader 模拟账号实测

2026-09-11 02:45 使用模拟信用账号 900010001595 通过 Web LTtx 统一路由连接 acct_4b2b38c167，对 600000.SH 以 8.88 元买入价、每笔 100 股测试。四条路径各提交 100 单，均返回 submitted=100；02:48 只读复核该批 400 笔委托状态均为 54（已撤），可撤数量为 0。

文档

更详细的教程也可以在 Web 控制台的“教程”页面查看。

Star History

项目交流群

联系作者

• 地球号:shcfquant,请注明来意

• 邮箱:litaoflyme@163.com

许可证

本项目采用 MIT License 开源。