VeighNa (vnpy) 4.0.0 版本变更全解读vnpy.alpha 机器学习模块与工程化升级深度指南【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/vnpy/vnpy本文以仓库中的 CHANGELOG.md 为主体完整梳理 VeighNavnpy从 2.1.9 到 4.0.0 的版本演进脉络重点解析 4.0.0 版本的三大主线新增面向机器学习多因子策略的vnpy.alpha模块、核心支持 Python 3.13 及工具链全面升级pyproject.toml、loguru、mypy、ruff、uv。读完后你将能够读懂每个版本号的变更含义、掌握 4.0.0 新模块的目录结构与 API 边界、并依据源码快速验证当前仓库的实际能力。一、变更日志的版本覆盖范围与阅读方式CHANGELOG.md 按版本倒序组织当前仓库最新版本号为4.0.0这一点可以从 vnpy/init.py 中的版本声明交叉验证__version__ 4.0.0变更日志中每个版本统一使用「新增 / 调整 / 修复 / 剥离」四类条目组织其中「剥离」类条目集中出现在 2.x 系列记录了核心框架将交易接口、数据库适配器、应用模块逐步拆分到独立仓库如 vnpy_ctp、vnpy_ib、vnpy_tora的架构决策过程。版本与 pyproject.toml 中声明的 Python 支持范围对应requires-python 3.10classifiers中同时声明了 3.10 / 3.11 / 3.12 / 3.13 四个 CPython 版本这与 4.0.0 变更条目「核心支持版本升级到 Python 3.13」一致。二、4.0.0 版本详解2.1 新增面向机器学习多因子策略的 vnpy.alpha 模块4.0.0 最核心的变更是新增vnpy.alpha模块它提供「数据 → 因子特征 → 预测模型 → 策略回测」的一站式机器学习投研流程。模块位于 vnpy/alpha 目录从源码结构看包含四个子包和一个实验室类组成路径职责datasetvnpy/alpha/dataset因子特征工程支持表达式计算与批量特征处理modelvnpy/alpha/model预测模型训练统一fit/predictAPIstrategyvnpy/alpha/strategy策略投研与回测labvnpy/alpha/lab.py投研流程与本地文件资产管理1数据资产层AlphaLabAlphaLab 类是本地投研工作区的入口构造时传入一个lab_path自动创建如下目录结构源码见 lab.py 初始化逻辑daily/、minute/按合约存储的日线/分钟线 Parquet 行情文件component/指数成分股历史shelve 格式用于跟踪成分变化dataset/以.pkl保存的特征数据集model/以.pkl保存的训练好的模型对象signal/以.parquet保存的预测信号contract.json合约配置多头/空头费率、合约乘数、最小价格变动。典型方法包括save_bar_data/load_bar_dataParquet 读写并按时区无关化处理、load_bar_df批量读取并做价格归一化、停牌日转 NaN 等清洗、save_dataset/load_dataset、save_model/load_model、add_contract_setting维护 contract.json。这意味着模型、数据集、信号均以文件形式落盘整个投研产物可以在 Notebook 之间复用。2特征工程层AlphaDatasetAlphaDataset 模板接收一个polars.DataFrame以及训练/验证/测试三段区间dataset AlphaDataset( dfdf, train_period(2023-01-01, 2023-06-30), valid_period(2023-07-01, 2023-09-30), test_period(2023-10-01, 2024-03-31), )通过add_feature(name, expression)以字符串表达式或 polars 表达式添加因子特征支持add_infer_processor/add_learn_processor分别对推理侧与训练侧数据做预处理源码中维护infer_processors与learn_processors两个列表。内置的 Alpha158 特征集 提供源自 Qlib 项目的 158 个股票市场特征覆盖 K 线形态、价格趋势、时序波动等维度。3模型层AlphaModelAlphaModel 抽象基类定义了两个必须实现的接口class AlphaModel(metaclassABCMeta): abstractmethod def fit(self, dataset: AlphaDataset) - None: ... abstractmethod def predict(self, dataset: AlphaDataset, segment: Segment) - np.ndarray: ...内置三种实现Lasso 回归L1 正则化做特征选择、LightGBM梯度提升树、MLP 神经网络PyTorch 实现。由于所有模型共享fit/predict签名可以无缝切换算法做对比测试。4策略与回测层vnpy/alpha/strategy 提供策略模板与 BacktestingEngine 回测引擎支持截面多标的和时序单标的两种策略类型示例策略见 equity_demo_strategy.py。5完整投研 Notebook 示例examples/alpha_research 目录提供四个可直接运行的工作流 Notebookdownload_data_rq.ipynb基于 RQData 下载 A 股指数成分股数据含成分变化跟踪与历史行情获取research_workflow_lasso.ipynb线性回归工作流research_workflow_lgb.ipynbLightGBM 工作流research_workflow_mlp.ipynb神经网络工作流。注意安装前提vnpy.alpha的机器学习依赖被声明为可选依赖见 pyproject.toml 的alpha组需要额外安装[project.optional-dependencies] alpha [ polars1.26.0, scipy1.15.2, alphalens-reloaded0.4.5, scikit-learn1.6.1, lightgbm4.6.0, torch2.6.0, pyarrow19.0.1, ]即安装时需要pip install vnpy[alpha]才能使用 LightGBM/MLP 等完整能力。2.2 调整工程化与工具链升级4.0.0 的另一条主线是开发工具链的系统性升级各项调整均可在仓库中找到落地证据1Python 3.13 支持pyproject.toml 的 classifiers 声明支持 3.10 至 3.13最低要求3.10。升级前提核心框架以兼容性优先方式升级大多数模块可直接使用但涉及 C API 封装的交易接口必须升级到适配 4.0 的版本见 CHANGELOG.md 中的扩展模块升级条目。2pyproject.toml 统一项目配置项目从传统setup.py/requirements.txt迁移到 PEP 621 标准变更条目「使用 pyproject.toml 统一项目配置」。关键配置包括核心依赖tzlocal、PySide66.8.2.1、pyqtgraph、numpy2.2.3、pandas2.2.3、ta-lib、deap遗传优化、pyzmq、loguru等构建后端hatchling版本自动从 vnpy/init.py 的__version__解析打包钩子见 vnpy/trader/locale/build_hook.py用于构建国际化.mo文件。3loguru 替代 logging日志模块 vnpy/trader/logger.py 已完全基于 loguru 实现format: str ( green{time:YYYY-MM-DD HH:mm:ss.SSS}/green | level{level}/level | cyan{extra[gateway_name]}/cyan | level{message}/level ) level: int SETTINGS[log.level] logger.remove() if SETTINGS[log.console]: logger.add(sinksys.stdout, levellevel, formatformat) if SETTINGS[log.file]: ... logger.add(sinkfile_path, levellevel, formatformat)从源码可见日志格式带彩色时间戳与 gateway 标识级别由设置项log.level控制文件日志按天写入log/vt_YYYYMMDD.logvnpy.alpha子模块则自带独立的 logger。业务代码统一从vnpy.trader.logger导入logger即可复用该配置。4mypy 与 ruff 静态质量配置「使用 mypy 优化静态类型声明」「使用 ruff 优化代码细节质量」两项调整在 pyproject.toml 中有完整配置[tool.ruff] target-version py310 output-format full [tool.ruff.lint] select [B, E, F, UP, W] # flake8-bugbear/pycodestyle/pyflakes/pyupgrade ignore [E501] [tool.mypy] python_version 3.10 warn_return_any true disallow_untyped_defs true strict_optional true warn_unused_ignores truemypy 配置启用了disallow_untyped_defs、strict_optional等严格项这也解释了源码中普遍的类型注解与# type: ignore注释的存在。5uv 作为开发环境管理工具变更条目声明开发侧采用 uv 管理依赖环境。仓库内未附带 uv 配置文件此项为变更日志声明的开发流程约定使用者可继续按 install.sh、install.bat 提供的脚本安装运行环境。6扩展模块 4.0 适配4.0 版本同步升级了四个核心扩展vnpy_ctpCTP 交易接口、vnpy_ctastrategyCTA 策略、vnpy_sqliteSQLite 数据库、vnpy_rqdataRQData 数据服务。由于 C API 封装对 Python 版本与核心对象结构敏感使用这些接口的用户应确认扩展版本与 4.0.0 核心匹配。2.3 修复PySide6 单元格排序乱序4.0.0 唯一一条修复项是「修复 PySide6 中单元格排序可能出现的乱序问题」。该问题出现在基于 PySide6 的表格监控组件中数据监控 UI 位于 vnpy/trader/ui/widget.py从源码结构看这类乱序与 PySide6 模型/视图在排序代理下的索引同步行为有关对使用监控表格界面的开发者属于体验层面的修正。三、3.x 系列演进脉络3.9.4 → 3.9.03.9 系列是 4.0 前的最后一个大版本线主线是国际接口强化、i18n 国际化与多交易所覆盖版本关键变更3.9.4vnpy_tora 登录动态密钥vnpy_taos 适配 TDengine 3.0vnpy_xt 涨跌停价字段vnpy_dolphindb 批量写入内存优化EmailEngine 异常捕获3.9.3新增 vnpy_lstar利星资管、vnpy_voltrader 数据服务RpcDatafeed 数据服务代理PySide6 6.3.0 适配vnpy_ib 系列大幅完善本地缓存委托/成交回报、UTC 时间戳、600 秒等待、期权链更新结束回报、浮点合约乘数ContractData 增加max_volume字段3.9.2vnpy_xt 实时行情接口 XtGateway 与 xtdc 文件锁单例vnpy_ib 行情退订CTA/组合策略模块 i18n 国际化vnpy_xt 期货真实夜盘时间与集合竞价 K 线合成3.9.1i18n 国际化整体落地新增英文翻译CFD/SWAP 品种枚举vnpy_ib 新增 COMEX、Eurex 交易所与 CFD 品种支持3.9.0迅投研数据服务 vnpy_xt股票/期货/期权/债券/基金历史数据vnpy_ib 支持 CBOE、CBOT 与指数期权BarGenerator 移除 Tick 时间戳检查交由上层控制遗传优化增加ngen_size与max_workers参数其中 i18n 国际化的落地细节_()标记、pot/po 文件生成流程可参考 docs/community/info/i18n.md打包侧的.mo构建钩子在 pyproject.toml 中声明。遗传/穷举优化算法本身位于 vnpy/trader/optimize.py参数如进程数上限、并行 worker的演进与上表条目一一对应。3.8.0 之前还有两个值得注意的架构性变更3.7.0 新增 vnpy_tap Linux 支持、rqdata 新型主力合约复权3.6.0 新增 vnpy_ctp MacM1/M2支持并在 OmsEngine 中集中化 OffsetConverter不再需要各 AppEngine 自行维护开平转换。四、2.x 系列模块剥离与框架瘦身2.9.0 → 2.1.92.x 系列的变更日志清晰地记录了 VeighNa 从「大而全单包」走向「核心框架 独立插件」的分立过程。变更日志中的「剥离」类条目是理解当前仓库结构的关键阶段剥离/新增要点2.9.0国泰君安统一接入网关剥离至 vnpy_hft、顶点飞创剥离至 vnpy_sec、RPC 服务剥离至 vnpy_rpcservice2.8.0新增 vnpy_ost华鑫奇点剥离至 vnpy_tora4.0 API、投资组合策略剥离至 vnpy_portfoliostrategy、Excel RTD 剥离至 vnpy_excelrtd、本地仿真剥离至 vnpy_paperaccount2.7.0新增 Wind/iFinD/TuShare/天软等数据服务IB 剥离至 vnpy_ib、算法交易剥离至 vnpy_algotrading、脚本交易剥离至 vnpy_scripttrader2.6.0建立vnpy.trader.database数据库抽象接口与vnpy.trader.datafeed数据服务抽象接口SQLite/MySQL/PostgreSQL/MongoDB/InfluxDB 等数据库全部剥离为独立项目2.5.0新增 vnpy_tts、vnpy_esunnyBarData/TickData 增加turnover字段融航/CTP Mini/CTP 期权/UFT 剥离2.4.0新增 asyncio aiohttp 的 vnpy_rest 风格异步客户端与 vnpy_websocket多进程遗传算法优化CTA 策略/回测模块剥离穷举与遗传优化算法收编到vnpy.trader.optimize2.3.0CTP 及穿透式测试接口剥离CTA 策略移仓助手一键期货换月DataManager CSV 导入时区选择2.2.0IbGateway 断线自动重连10 秒检查OffsetConverter 净仓交易模式ChartWidget 按需绘制2.1.9.xBarGenerator 小时线重复推送修复InfluxDB Tick 存储BaseMonitor 列宽自动保存这些变更解释了当前仓库 vnpy/trader 目录的构成核心只保留trader交易引擎、数据库/数据服务抽象、事件引擎、RPC 通讯 vnpy/rpc、图表 vnpy/chart而具体接口与功能应用全部以独立插件形式存在。五、如何查阅与验证变更内容完整变更条目直接阅读 CHANGELOG.md每个版本按「新增/调整/修复/剥离」分节可按版本号定位版本一致性核对vnpy/init.py 的__version__与 pyproject.toml 中的 Python 支持范围应相互印证当前为 4.0.0 / 3.10–3.134.0 新模块能力验证查看 vnpy/alpha 各子模块源码与 examples/alpha_research 的 Notebook 工作流注意先安装alpha可选依赖工具链行为验证日志格式与输出开关由 vnpy/trader/logger.py 与SETTINGS[log.*]设置项决定静态检查规则以 pyproject.toml 中[tool.ruff]、[tool.mypy]段为准。六、总结VeighNa 4.0.0 的变更日志可以归纳为两条主线能力层面新增vnpy.alpha机器学习多因子投研模块dataset → model → strategy → lab 四层结构 Parquet/pkl 文件化资产管理 Lasso/LightGBM/MLP 三种内置模型工程层面完成 Python 3.13 适配与 pyproject.toml/loguru/mypy/ruff/uv 工具链升级。而整份 CHANGELOG.md 的 2.x「剥离」史则解释了当前仓库「精简核心 插件生态」的架构由来——理解这段演进脉络是正确选用扩展模块版本、避免 C API 封装不兼容问题的前提。【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/vnpy/vnpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考