VeighNa · 第 1 章 VeighNa 与核心+插件哲学

VeighNa · 第 1 章 VeighNa 与核心+插件哲学

章节摘要:本章是全教程的起点,要先把一个关键认知钉死——你 clone 下来的 vnpy 仓库只是核心包,不包含 CTP 连接代码,也不包含完整 CTA 策略。这不是"残缺",而是 VeighNa 在 3.0 之后刻意做的架构拆分:核心只保留骨架(事件引擎、装配中枢、抽象契约、数据工具、AI 量化),所有网关/应用/数据库/数据服务都拆成独立的 PyPI 包,通过 import_module 动态加载。这种"核心 + 插件"设计让框架活了十年仍能持续扩展。本章先讲 VeighNa 是什么、为什么这样拆,再用 examples/veighna_trader/run.py 的七步装配演示怎么从零跑起一个交易程序。本章共 3 节,无前置依赖。

学习目标

阅读完本章,你应当能够:

1. 一句话说清 VeighNa 是什么、它在国内量化圈的地位。
2. 解释为什么本仓库里看不到 CTP 代码——理解"核心 + 插件"架构。
3. 复述 3.0 架构拆分的动机与收益。
4. 读懂 run.py 的七步装配流程,知道每一步在搭什么。
5. 在本地把 VeighNa 核心包跑起来(配合外部网关包)。

核心概念速览

VeighNa 的精妙不在某个网关或某个策略,而在这套让框架活了十年的"核心 + 插件"架构。

子章节导航

01 VeighNa 是什么与项目全貌

VeighNa 的来历、地位、整体生态(核心 + 30+ 网关 + 17 应用 + 8 数据库 + 9 数据服务),以及它"既是实盘平台也是工程范例"的双重价值。

02 核心包 vs 外部插件的架构边界

关键澄清:本仓库只是核心包;3.0 拆分的来龙去脉;为什么这样拆;核心包里到底有什么、没有什么;怎么按需 pip install 外部插件。

03 从 run.py 看七步装配与首次运行

精读 examples/veighna_trader/run.py:create_qapp → EventEngine → MainEngine → add_gateway ×N → add_app ×N → MainWindow → qapp.exec;以及注释掉的网关/应用清单(教程讲插件生态的素材)。

子章节之间的逻辑关系

本章第 01 节(是什么) ──► 第 02 节(架构边界) ──► 第 03 节(怎么跑)
                                                    │
                                                    ▼
                                  下一章(第 2 章 EventEngine 事件引擎)
​

前置知识与后续延伸

前置知识:

• Python 基础(import、类、字典)
• 对量化交易有基本概念(知道期货/股票是什么)

后续延伸:

• 第 2 章讲装配的"通信总线"——EventEngine
• 第 4 章讲装配中枢——MainEngine
• 第 5 章讲插件契约——BaseGateway/BaseApp