cfquant 0.2.9__tar.gz → 0.2.22__tar.gz

{cfquant-0.2.9 → cfquant-0.2.22}/LTtx/tx/LTtx_server.py

@@ -16,9 +16,17 @@ import datetime
 import importlib
 import subprocess
 import sys
-from packaging import version
-
-#运行需要的库
+from packaging import version
+
+#运行需要的库
+DEFAULT_PIP_INDEX_URL = "https://pypi.tuna.tsinghua.edu.cn/simple"
+
+
+def _pip_index_args():
+    index_url = os.environ.get("CFQUANT_PIP_INDEX_URL", DEFAULT_PIP_INDEX_URL).strip()
+    return ["--index-url", index_url] if index_url else []
+
+
 need_packge = {
     'psutil': {'pip_name': 'psutil', 'version': '1.0.0'},
     'pandas': {'pip_name': 'pandas', 'version': '0.0.1'},
@@ -84,10 +92,9 @@ def ensure_modules_with_version(modules: dict):
             install_target = pip_name if required_version == "latest" else "%s>=%s" % (pip_name, required_version)
             print(f"[AutoInstall] 正在安装/升级 {pip_name} → {required_version}...")
             try:
-                subprocess.check_call([
-                    sys.executable, "-m", "pip", "install", install_target,
-                    "-i", "https://pypi.tuna.tsinghua.edu.cn/simple"
-                ], **_hidden_subprocess_kwargs())
+                subprocess.check_call([
+                    sys.executable, "-m", "pip", "install", install_target,
+                ] + _pip_index_args(), **_hidden_subprocess_kwargs())
                 print(f"[AutoInstall] 成功安装 {pip_name} {required_version}")
             except Exception as e:
                 print(f"[AutoInstall] 安装 {pip_name} 失败: {e}")

{cfquant-0.2.9 → cfquant-0.2.22}/LTtx/tx/tx.py

@@ -17,10 +17,18 @@ import datetime
 import sys
 import subprocess
 import importlib
-import pandas as pd
-
-
-def _hidden_subprocess_kwargs():
+import pandas as pd
+
+
+DEFAULT_PIP_INDEX_URL = "https://pypi.tuna.tsinghua.edu.cn/simple"
+
+
+def _pip_index_args():
+    index_url = os.environ.get("CFQUANT_PIP_INDEX_URL", DEFAULT_PIP_INDEX_URL).strip()
+    return ["--index-url", index_url] if index_url else []
+
+
+def _hidden_subprocess_kwargs():
     if os.name != "nt":
         return {}
     kwargs = {}
@@ -113,9 +121,11 @@ class txl:
             self.orjson_on = True
             return importlib.import_module(import_name)
         except ImportError:
-            self.sys_price(f"[TxLink自动安装] 缺少依赖 {package_name}，正在安装...请不要退出，安装完成后程序将正常运行")
-            try:
-                subprocess.check_call([sys.executable, "-m", "pip", "install", package_name], **_hidden_subprocess_kwargs())
+            self.sys_price(f"[TxLink自动安装] 缺少依赖 {package_name}，正在安装...请不要退出，安装完成后程序将正常运行")
+            try:
+                subprocess.check_call([
+                    sys.executable, "-m", "pip", "install", package_name,
+                ] + _pip_index_args(), **_hidden_subprocess_kwargs())
                 self.orjson_on = True
                 return importlib.import_module(import_name)            
             except:
@@ -258,13 +268,16 @@ class txl:
         else:
             self.sys_print('当前版本已经是最新')    
     
-    def sys_print(self,data,show_force=False):
-        msg = '%sLTtx[info]>>>>:%s,'%(self.get_nowtime(),data)
-        if self.sys_print_on or show_force:            
-            print(msg)
-        self.save_log(msg)
-
-    def send_file(self,file_name,show_on=True):
+    def sys_print(self,data,show_force=False):
+        msg = '%sLTtx[info]>>>>:%s,'%(self.get_nowtime(),data)
+        if self.sys_print_on or show_force:            
+            print(msg)
+        self.save_log(msg)
+
+    def sys_price(self,data,show_force=False):
+        return self.sys_print(data,show_force=show_force)
+
+    def send_file(self,file_name,show_on=True):
         '''
         将本地文件上传至数据中心
 

{cfquant-0.2.9 → cfquant-0.2.22}/MANIFEST.in

@@ -4,13 +4,13 @@ include cfquant_web_server.py
 include cfquant_pipe_hub.py
 
 recursive-include cfquant *.py
+recursive-include cfquant/tests *.py *.md
 recursive-include LTtx *.py
 include LTtx/tx/Config.txt
 
 recursive-include web_dashboard *.html *.css *.js *.svg *.png
 recursive-include qmt_scripts *.py *.md
 
-recursive-exclude cfquant/tests *
 recursive-exclude LTtx/tx/__pycache__ *
 recursive-exclude LTtx/tx/log_data *
 recursive-exclude LTtx/tx/tx_log *
@@ -30,6 +30,7 @@ recursive-exclude pip_library_dev *
 recursive-exclude .cfquant_project_updates *
 recursive-exclude .cfquant_updates *
 recursive-exclude .updates *
+recursive-exclude .cfquant_ops *
 recursive-exclude .pytest_cache *
 recursive-exclude .playwright-cli *
 recursive-exclude .local_archive *

{cfquant-0.2.9 → cfquant-0.2.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cfquant
-Version: 0.2.9
+Version: 0.2.22
 Summary: QMT local bridge and xtquant-compatible Python client.
 License: MIT
 Requires-Python: >=3.8
@@ -9,10 +9,11 @@ License-File: LICENSE
 Requires-Dist: pandas>=1.0
 Requires-Dist: packaging>=20
 Requires-Dist: psutil>=5.8
+Requires-Dist: pycryptodome>=3.20
 Requires-Dist: pytz
 Requires-Dist: tabulate
 Requires-Dist: pandas-market-calendars
-Requires-Dist: importlib-resources>=5; python_version < "3.9"
+Requires-Dist: importlib-resources>=5
 Provides-Extra: dev
 Requires-Dist: build>=1.0; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"
@@ -101,11 +102,19 @@ Requires-Dist: pyzmq>=25; extra == "zmq"
 新用户和生产环境优先使用源码包部署。原因很简单：cfquant 的 Web 控制台、QMT 入口脚本和本地配置是一起工作的，源码包保留完整项目目录，后续在网页里检查更新、更新 Web、回滚版本、提示 QMT 入口脚本变更都更方便。
 
 1. 将项目解压到固定目录，例如 `D:\cfquant`。
-2. 直接双击项目目录中的 `start_cfquant.bat`。启动脚本会使用项目 `.venv`（如果存在）或当前 Python，自动安装 `requirements.txt` 中的项目依赖，并安装当前源码版本的 `cfquant`，不需要用户手动执行安装命令。
+2. 直接双击项目目录中的 `start_cfquant.bat`。启动脚本会使用项目 `.venv`（如果存在）或当前 Python，先检查当前环境是否已经安装 `cfquant`；已通过 PyPI 或其他方式安装时直接跳过，缺失时会用等价于 `python -m pip install --editable .` 的参数列表自动安装当前源码版本，不需要用户手动执行安装命令。若 Web 端口上已经运行 cfquant，会直接复用已有实例并打开页面；若端口被其他程序占用，会提示换端口或停止占用进程。
 
 自动安装失败时，启动窗口会保持打开，并把安装日志写入 `log\cfquant_startup.log`，修复 Python、网络或权限问题后重新启动即可。
 
-启动后打开 <http://127.0.0.1:8765/>，按网页中的“新手初始化向导”完成账号、模式和 QMT 目录配置。然后在 QMT 中加载对应的入口脚本，回到网页验证资金、持仓、委托和行情。
+项目默认使用清华 PyPI 镜像安装依赖，适合中国大陆网络环境。启动脚本、网页源码更新、`requirements.txt` 安装以及 LTtx 缺失依赖自动安装都会遵循这个设置。需要切换到企业私有源或其他镜像时，可在启动前设置 `CFQUANT_PIP_INDEX_URL` 环境变量。
+
+通过 PyPI 安装后，可以使用下面任一命令启动本地 Web 控制台；`run` 和 `serve` 等价：
+
+```powershell
+cfquant run
+```
+
+启动后打开 <http://127.0.0.1:8765/>，按网页中的“新手初始化向导”完成账号、模式和 QMT 目录配置。开启“自动导入并管理 QMT 策略”可配置账号、模拟/实盘及 QMT 启动自运行；按绑定页进度完成 QMT 导入和重启，再验证资金、持仓、委托和行情。流程及模式互斥规则见 [Web 账号运行配置说明](docs/Web账号运行配置说明.md)。
 
 重点：
 
@@ -118,42 +127,22 @@ Requires-Dist: pyzmq>=25; extra == "zmq"
 
 ### Web 控制台绑定与初始化流程
 
-完成源码部署并启动 Web 控制台后，账号绑定和首次初始化都按下面的顺序进行：
-
-1. 在“新手初始化向导”或“绑定”页面填写资金账号、账户类型、运行模式和 QMT 目录。QMT 目录可以填写 QMT 安装目录、`bin.x64`，也可以填写对应的 `python` 目录。
-2. 点击保存后，系统会显示 QMT 核心包复制状态。通用模式和高级模式会自动复制 `cfquant` 到对应 QMT 的 `bin.x64\cfquant`；极致模式的入口脚本自包含，但仍建议填写 QMT 目录，以便写入身份配置和显示准确的策略路径。
-3. 保存完成后，页面会显示与当前模式匹配的 QMT 策略代码。点击每份策略右侧的复制按钮，在 QMT 的模型研究中选择“新建策略”->“新建 Python 策略”，粘贴代码后保存。
-4. 关闭代码指引后，页面会进入“重启 QMT 并运行策略”步骤。重启对应的 QMT，在策略列表中运行刚刚保存的策略，然后点击“我已重启并运行，开始检测”。
-5. 系统会持续检测 QMT 通道是否在线。检测过程中不能跳过或直接关闭，可以使用“返回上一步”回到代码指引重新复制；只有“强制关闭本次绑定流程”会结束本次检测，但已经保存的账号绑定不会丢失。
-6. 所有必需通道上线后，页面进入接口测试步骤，并可直接打开“查资金”接口，点击“发送请求”确认 QMT 返回当前账号数据。
-
-初始化向导和普通绑定使用同一套复制状态、重启提示和在线检测流程。编辑已有账号时，编辑窗口只显示账号配置，不显示策略源码；修改并保存后，页面会重新打开对应的代码指引。
+1. 在初始化向导或“绑定”页面填写资金账号、账户类型、模式和 QMT 目录，勾选“自动导入并管理 QMT 策略”，确认模拟／实盘与策略自动运行设置。
+2. 保存后系统自动部署核心包、身份配置和托管策略，弹窗显示部署结果及启动提醒，无需复制代码或手工新建策略。
+3. 按提示重启并登录 QMT。如果勾选了“自动启动 QMT”，在启动后的 QMT 中登录即可；QMT 自身已设置自动登录时，等待自动登录完成。**国金证券 QMT 目前不支持自动登录，每次启动后需手动输入密码登录。**
+4. 若提示等待退出，正常退出 QMT，保持 cfquant 运行，等待模型配置完成后再启动。若部署失败，修正目录、权限或模型账号 Key 后重新保存。
+5. “知道了”直接关闭提醒；“检测连接”可进入通道检测，随后查询资金或持仓确认账号数据。
 
-#### 不同模式需要加载的入口脚本
+“自动启动 QMT”负责启动客户端；“QMT 启动后自动运行”负责运行托管策略。未勾选策略自动运行时，登录后需在“模型交易”运行已导入的托管策略。编辑已有绑定会保留这些选项，不会自动开启。
 
-| 模式 | QMT 中需要新建并运行的策略 | 在线检测要求 |
+| 模式 | 自动部署目标 | 在线检测要求 |
 |---|---|---|
-| 通用模式 | `qmt_scripts/CFQUANT_CTYPE_ALL_LOWLAT.py` | 同一个 QMT 的查询通道和交易通道都在线 |
-| 极致模式 | `qmt_scripts/CFQUANT_LITE.py` | 同一个 QMT 的查询通道和交易通道都在线 |
-| 高级模式 | 普通 QMT：`qmt_scripts/CFQUANT.py`；极速交易端 QMT：`qmt_scripts/CFQUANT_TRADE_LOWLAT.py` | 普通端和极速交易端都在线 |
-
-例如极致模式的策略文件通常位于：
-
-```text
-D:\中信证券QMT交易终端\python\CFQUANT_LITE.py
-```
-
-高级模式必须使用两个不同的 QMT 目录，不能在一个 QMT 中同时加载普通入口和极速交易入口。
+| 通用模式 | 单个 QMT 中的通用托管策略 | 查询通道和交易通道都在线 |
+| 极致模式 | 单个 QMT 中的自包含托管策略 | 查询通道和交易通道都在线 |
+| 高级模式 | 普通端与极速交易端两个不同的 QMT | 两端都在线 |
+| 同账号独立市场 | 对应上海和深圳市场的 QMT | 沪市和深市交易通道都在线 |
 
-#### 两地多中心 / 同账号独立市场
-
-开启同账号独立市场路由后，不能继续使用普通入口文件。页面会根据模式显示上海、深圳两份策略：
-
-- 通用模式：`CFQUANT_CTYPE_ALL_LOWLAT_SH.py`、`CFQUANT_CTYPE_ALL_LOWLAT_SZ.py`
-- 极致模式：`CFQUANT_LITE_SH.py`、`CFQUANT_LITE_SZ.py`
-- 高级模式：`CFQUANT_TRADE_LOWLAT_SH.py`、`CFQUANT_TRADE_LOWLAT_SZ.py`
-
-上海 QMT 只运行 `_SH.py`，深圳 QMT 只运行 `_SZ.py`。该模式只有沪市和深市两个交易通道都在线后，绑定检测才会通过。完整文件说明见[同账号独立市场说明](qmt_scripts/同账号独立市场/readme.md)。
+多 QMT 部署需分别完成各终端登录，自动启动选项仅启动绑定的主 QMT 目录。同一资金账号在同一个 QMT 中只允许一种模式。完整配置及状态说明见 [Web 账号运行配置说明](docs/Web账号运行配置说明.md)。
 
 ## Web 控制台
 
@@ -167,16 +156,43 @@ stop_cfquant.bat        停止
 restart_cfquant.bat     重启
 ```
 
+## cftrader 100 单本地基准
+
+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`；批量返回只表示请求提交情况，最终成交或撤成仍以委托查询和回调为准。
+
+## cftrader 模拟账号实测
+
+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 部署教程](docs/QMT部署教程.md) |
+| cftrader 批量同步/异步下单与撤单 | [cftrader 批量交易与撤单](docs/cftrader批量交易.md)，含 100 单本地基准 |
 | 通用模式部署 | [通用模式部署指南](docs/通用模式部署指南.md) |
 | 极致模式部署 | [极致模式部署指南](docs/极致模式部署指南.md) |
 | 高级模式部署 | [高级模式部署指南](docs/高级模式部署指南.md) |
 | 账号和 QMT 目录配置 | [Web 账号运行配置说明](docs/Web账号运行配置说明.md) |
 | 从 miniQMT 迁移 | [miniQMT 迁移到大 QMT 指南](docs/miniQMT迁移到大QMT指南.md) |
+| 官网 nativeApi 接口功能及适配状态 | [xtquant 原版接口适配清单](docs/xtquant原版接口适配清单.md) |
+| Level2 六类行情、订阅回调与千档边界 | [Level2 行情适配说明](docs/Level2行情适配说明.md) |
 | `xtdata` 兼容性 | [xtdata 平替追踪](docs/xtdata平替追踪.md) |
 | `xttrader` 兼容性 | [xttrader 平替追踪](docs/xttrader平替追踪.md) |
 | 接口能力范围 | [QMT 函数封装能力清单](docs/QMT函数封装能力清单.md) |
@@ -193,7 +209,7 @@ restart_cfquant.bat     重启
 
 
 ## 项目交流群
-<img src="ba67bb2fcfa8a067d2c8249656248449.jpg" alt="cfquant 项目交流群二维码" width="280" />
+<img src="631c6525c1a95aaf22ea46aeda3297f7.jpg" alt="cfquant 项目交流群二维码" width="280" />
 
 
 ## 联系作者

{cfquant-0.2.9 → cfquant-0.2.22}/README.md

@@ -80,11 +80,19 @@
 新用户和生产环境优先使用源码包部署。原因很简单：cfquant 的 Web 控制台、QMT 入口脚本和本地配置是一起工作的，源码包保留完整项目目录，后续在网页里检查更新、更新 Web、回滚版本、提示 QMT 入口脚本变更都更方便。
 
 1. 将项目解压到固定目录，例如 `D:\cfquant`。
-2. 直接双击项目目录中的 `start_cfquant.bat`。启动脚本会使用项目 `.venv`（如果存在）或当前 Python，自动安装 `requirements.txt` 中的项目依赖，并安装当前源码版本的 `cfquant`，不需要用户手动执行安装命令。
+2. 直接双击项目目录中的 `start_cfquant.bat`。启动脚本会使用项目 `.venv`（如果存在）或当前 Python，先检查当前环境是否已经安装 `cfquant`；已通过 PyPI 或其他方式安装时直接跳过，缺失时会用等价于 `python -m pip install --editable .` 的参数列表自动安装当前源码版本，不需要用户手动执行安装命令。若 Web 端口上已经运行 cfquant，会直接复用已有实例并打开页面；若端口被其他程序占用，会提示换端口或停止占用进程。
 
 自动安装失败时，启动窗口会保持打开，并把安装日志写入 `log\cfquant_startup.log`，修复 Python、网络或权限问题后重新启动即可。
 
-启动后打开 <http://127.0.0.1:8765/>，按网页中的“新手初始化向导”完成账号、模式和 QMT 目录配置。然后在 QMT 中加载对应的入口脚本，回到网页验证资金、持仓、委托和行情。
+项目默认使用清华 PyPI 镜像安装依赖，适合中国大陆网络环境。启动脚本、网页源码更新、`requirements.txt` 安装以及 LTtx 缺失依赖自动安装都会遵循这个设置。需要切换到企业私有源或其他镜像时，可在启动前设置 `CFQUANT_PIP_INDEX_URL` 环境变量。
+
+通过 PyPI 安装后，可以使用下面任一命令启动本地 Web 控制台；`run` 和 `serve` 等价：
+
+```powershell
+cfquant run
+```
+
+启动后打开 <http://127.0.0.1:8765/>，按网页中的“新手初始化向导”完成账号、模式和 QMT 目录配置。开启“自动导入并管理 QMT 策略”可配置账号、模拟/实盘及 QMT 启动自运行；按绑定页进度完成 QMT 导入和重启，再验证资金、持仓、委托和行情。流程及模式互斥规则见 [Web 账号运行配置说明](docs/Web账号运行配置说明.md)。
 
 重点：
 
@@ -97,42 +105,22 @@
 
 ### Web 控制台绑定与初始化流程
 
-完成源码部署并启动 Web 控制台后，账号绑定和首次初始化都按下面的顺序进行：
-
-1. 在“新手初始化向导”或“绑定”页面填写资金账号、账户类型、运行模式和 QMT 目录。QMT 目录可以填写 QMT 安装目录、`bin.x64`，也可以填写对应的 `python` 目录。
-2. 点击保存后，系统会显示 QMT 核心包复制状态。通用模式和高级模式会自动复制 `cfquant` 到对应 QMT 的 `bin.x64\cfquant`；极致模式的入口脚本自包含，但仍建议填写 QMT 目录，以便写入身份配置和显示准确的策略路径。
-3. 保存完成后，页面会显示与当前模式匹配的 QMT 策略代码。点击每份策略右侧的复制按钮，在 QMT 的模型研究中选择“新建策略”->“新建 Python 策略”，粘贴代码后保存。
-4. 关闭代码指引后，页面会进入“重启 QMT 并运行策略”步骤。重启对应的 QMT，在策略列表中运行刚刚保存的策略，然后点击“我已重启并运行，开始检测”。
-5. 系统会持续检测 QMT 通道是否在线。检测过程中不能跳过或直接关闭，可以使用“返回上一步”回到代码指引重新复制；只有“强制关闭本次绑定流程”会结束本次检测，但已经保存的账号绑定不会丢失。
-6. 所有必需通道上线后，页面进入接口测试步骤，并可直接打开“查资金”接口，点击“发送请求”确认 QMT 返回当前账号数据。
-
-初始化向导和普通绑定使用同一套复制状态、重启提示和在线检测流程。编辑已有账号时，编辑窗口只显示账号配置，不显示策略源码；修改并保存后，页面会重新打开对应的代码指引。
+1. 在初始化向导或“绑定”页面填写资金账号、账户类型、模式和 QMT 目录，勾选“自动导入并管理 QMT 策略”，确认模拟／实盘与策略自动运行设置。
+2. 保存后系统自动部署核心包、身份配置和托管策略，弹窗显示部署结果及启动提醒，无需复制代码或手工新建策略。
+3. 按提示重启并登录 QMT。如果勾选了“自动启动 QMT”，在启动后的 QMT 中登录即可；QMT 自身已设置自动登录时，等待自动登录完成。**国金证券 QMT 目前不支持自动登录，每次启动后需手动输入密码登录。**
+4. 若提示等待退出，正常退出 QMT，保持 cfquant 运行，等待模型配置完成后再启动。若部署失败，修正目录、权限或模型账号 Key 后重新保存。
+5. “知道了”直接关闭提醒；“检测连接”可进入通道检测，随后查询资金或持仓确认账号数据。
 
-#### 不同模式需要加载的入口脚本
+“自动启动 QMT”负责启动客户端；“QMT 启动后自动运行”负责运行托管策略。未勾选策略自动运行时，登录后需在“模型交易”运行已导入的托管策略。编辑已有绑定会保留这些选项，不会自动开启。
 
-| 模式 | QMT 中需要新建并运行的策略 | 在线检测要求 |
+| 模式 | 自动部署目标 | 在线检测要求 |
 |---|---|---|
-| 通用模式 | `qmt_scripts/CFQUANT_CTYPE_ALL_LOWLAT.py` | 同一个 QMT 的查询通道和交易通道都在线 |
-| 极致模式 | `qmt_scripts/CFQUANT_LITE.py` | 同一个 QMT 的查询通道和交易通道都在线 |
-| 高级模式 | 普通 QMT：`qmt_scripts/CFQUANT.py`；极速交易端 QMT：`qmt_scripts/CFQUANT_TRADE_LOWLAT.py` | 普通端和极速交易端都在线 |
-
-例如极致模式的策略文件通常位于：
-
-```text
-D:\中信证券QMT交易终端\python\CFQUANT_LITE.py
-```
-
-高级模式必须使用两个不同的 QMT 目录，不能在一个 QMT 中同时加载普通入口和极速交易入口。
+| 通用模式 | 单个 QMT 中的通用托管策略 | 查询通道和交易通道都在线 |
+| 极致模式 | 单个 QMT 中的自包含托管策略 | 查询通道和交易通道都在线 |
+| 高级模式 | 普通端与极速交易端两个不同的 QMT | 两端都在线 |
+| 同账号独立市场 | 对应上海和深圳市场的 QMT | 沪市和深市交易通道都在线 |
 
-#### 两地多中心 / 同账号独立市场
-
-开启同账号独立市场路由后，不能继续使用普通入口文件。页面会根据模式显示上海、深圳两份策略：
-
-- 通用模式：`CFQUANT_CTYPE_ALL_LOWLAT_SH.py`、`CFQUANT_CTYPE_ALL_LOWLAT_SZ.py`
-- 极致模式：`CFQUANT_LITE_SH.py`、`CFQUANT_LITE_SZ.py`
-- 高级模式：`CFQUANT_TRADE_LOWLAT_SH.py`、`CFQUANT_TRADE_LOWLAT_SZ.py`
-
-上海 QMT 只运行 `_SH.py`，深圳 QMT 只运行 `_SZ.py`。该模式只有沪市和深市两个交易通道都在线后，绑定检测才会通过。完整文件说明见[同账号独立市场说明](qmt_scripts/同账号独立市场/readme.md)。
+多 QMT 部署需分别完成各终端登录，自动启动选项仅启动绑定的主 QMT 目录。同一资金账号在同一个 QMT 中只允许一种模式。完整配置及状态说明见 [Web 账号运行配置说明](docs/Web账号运行配置说明.md)。
 
 ## Web 控制台
 
@@ -146,16 +134,43 @@ stop_cfquant.bat        停止
 restart_cfquant.bat     重启
 ```
 
+## cftrader 100 单本地基准
+
+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`；批量返回只表示请求提交情况，最终成交或撤成仍以委托查询和回调为准。
+
+## cftrader 模拟账号实测
+
+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 部署教程](docs/QMT部署教程.md) |
+| cftrader 批量同步/异步下单与撤单 | [cftrader 批量交易与撤单](docs/cftrader批量交易.md)，含 100 单本地基准 |
 | 通用模式部署 | [通用模式部署指南](docs/通用模式部署指南.md) |
 | 极致模式部署 | [极致模式部署指南](docs/极致模式部署指南.md) |
 | 高级模式部署 | [高级模式部署指南](docs/高级模式部署指南.md) |
 | 账号和 QMT 目录配置 | [Web 账号运行配置说明](docs/Web账号运行配置说明.md) |
 | 从 miniQMT 迁移 | [miniQMT 迁移到大 QMT 指南](docs/miniQMT迁移到大QMT指南.md) |
+| 官网 nativeApi 接口功能及适配状态 | [xtquant 原版接口适配清单](docs/xtquant原版接口适配清单.md) |
+| Level2 六类行情、订阅回调与千档边界 | [Level2 行情适配说明](docs/Level2行情适配说明.md) |
 | `xtdata` 兼容性 | [xtdata 平替追踪](docs/xtdata平替追踪.md) |
 | `xttrader` 兼容性 | [xttrader 平替追踪](docs/xttrader平替追踪.md) |
 | 接口能力范围 | [QMT 函数封装能力清单](docs/QMT函数封装能力清单.md) |
@@ -172,7 +187,7 @@ restart_cfquant.bat     重启
 
 
 ## 项目交流群
-<img src="ba67bb2fcfa8a067d2c8249656248449.jpg" alt="cfquant 项目交流群二维码" width="280" />
+<img src="631c6525c1a95aaf22ea46aeda3297f7.jpg" alt="cfquant 项目交流群二维码" width="280" />
 
 
 ## 联系作者

{cfquant-0.2.9 → cfquant-0.2.22}/cfquant/__init__.py

@@ -9,14 +9,16 @@ cfquant: 面向 QMT 的 xtquant 兼容层。
     from cfquant.xttype import StockAccount
 """
 
-from . import xtconstant, xtdata, xttrader, xttype
+from . import xtconstant, xtdata, xttrader, xttype
+from . import cftrader
 from .client import CfquantError, CfquantTimeout, configure, get_client
 from .version import __version__
 
 __all__ = [
     "xtconstant",
     "xtdata",
-    "xttrader",
+    "xttrader",
+    "cftrader",
     "xttype",
     "configure",
     "get_client",