VeighNa Station 量化交易管理平台使用指南:从登录启动到策略加密与组件更新
【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/vnpy/vnpy
VeighNa(vnpy)是一套基于 Python 的开源量化交易系统开发框架,而VeighNa Station是随官方 VeighNa Studio Python 发行版内置的图形化管理工具,负责统一完成账户登录、VeighNa Trader 启动、投研环境拉起、策略文件加密以及组件版本更新等日常操作。本文基于 docs/community/info/veighna_station.md 整理,并结合当前仓库源码与 README.md 的官方说明,系统讲解 VeighNa Station 的完整使用流程;读完本文,你将掌握从首次登录、界面操作,到一键启动 VeighNa Trader、编译加密策略、管理组件更新的一整套实战方法。
一、VeighNa Station 的定位
VeighNa 官方为 Windows 用户提供了名为VeighNa Studio的一站式 Python 量化发行版,它整合了三部分内容(见 Windows 安装指南):
- Python 3.10 64 位环境;
- VeighNa 框架及全部相关依赖库;
- VeighNa Station(VeighNa 框架的图形化管理工具)。
换句话说,VeighNa Station 是用户与 VeighNa 框架之间的“操作面板”:它本身不直接下单交易,而是负责托管 VeighNa Trader 的启动与运行。这一点在 README.md 的「使用指南」中体现得很明确:注册社区论坛账号后启动 VeighNa Station 登录,再点击其中的VeighNa Trader按钮进入交易程序,并且在 VeighNa Trader 运行过程中不要关闭 VeighNa Station(关闭 Station 会导致 Trader 自动退出)。
二、启动程序
2.1 点击图标启动
安装 VeighNa Studio 成功后,桌面会自动创建VeighNa Station 快捷方式。双击该图标即可运行 VeighNa Station。
2.2 命令行启动
除了图形化双击之外,也可以打开命令行工具(CMD / PowerShell / Terminal),直接输入:
veighna回车后即可启动 VeighNa Station。该命令由 VeighNa Studio 安装时写入系统 PATH,因此无需进入特定目录即可执行。
三、用户登录
3.1 首次登录流程
首次使用 VeighNa Station 时会依次经历两个弹窗:
- 免责声明:弹出 VeighNa Studio 的免责声明,仔细阅读后点击【确认】进入下一步;
- 登录界面:包含用户名输入框、密码输入框、登录按钮和注册按钮。输入用户名与密码后点击【登录】即可进入 VeighNa Station 主程序。
3.2 新用户注册注意事项
新用户可点击【注册】按钮注册账户,注册完成后即可登录。注册时有三个关键约束,务必留意:
- 个人邮箱请如实填写,后续用于找回密码等论坛功能;
- 用户名自动使用注册时的微信昵称,且不支持修改;
- 密码请牢记,该密码与 VeighNa 社区论坛密码通用。
这一设计在 README.md 的「使用指南」中亦有印证:直接使用在 VeighNa 社区论坛注册获得的账号密码,即可登录 VeighNa Station。
3.3 自动登录机制
登录界面只在首次运行 VeighNa Station 时弹出。之后再次运行 VeighNa Station 时会自动完成登录、直接进入主界面。如果希望重置该状态,可通过后续介绍的【系统】-【登出】功能手动登出,下次启动时便会重新要求登录。
四、界面窗口总览
登录完成后,VeighNa Station 主界面自动弹出,整体分为以下几个区域:
| 区域 | 位置 | 内容 |
|---|---|---|
| 菜单栏 | 顶部 | 【系统】和【帮助】两个按钮 |
| 标题栏 | 顶部 | 显示程序名称与标题 |
| 功能栏 | 左侧 | 社区、交易、投研、加密、更新等功能入口 |
| 主显示区域 | 右侧 | 随左侧功能栏选择显示对应内容 |
| 学习与使用区域 | 左下角 | 【使用文档】【社区求助】入口 |
| 官方频道区域 | 学习与使用区域下方 | 官方 GitHub 仓库、微信公众号、知乎账号入口 |
4.1 菜单栏
菜单栏位于顶部,包含【系统】和【帮助】两个按钮,其中【系统】下辖三个子功能。
配置
点击【系统】-【配置】会弹出系统配置窗口,可对两项内容进行修改:
- PyPI 索引:用于更换 VeighNa Station 使用的 pypiserver 地址。留空时默认使用
https://pypi.org的官方 PyPI 服务器;当用户使用私有 PyPI 镜像或内网 pypiserver 时,可在此填写对应地址; - pip 代理:默认为空,用户可按需自行设置,用于在受限网络环境下完成依赖包下载。
修改完成后点击【保存】按钮即可保存配置并退出窗口。该项配置直接决定了 VeighNa Station 后续安装、更新组件时从哪个源拉取 Python 包,是内网或受限网络环境下必看的设置项。
登出
点击【系统】-【登出】会弹出登出确认窗口,点击【Yes】后将登出当前用户并立即关闭程序。登出后,下次启动 VeighNa Station 时需要重新进行用户登录。
关闭
点击【系统】-【关闭】会弹出退出确认窗口,点击【Yes】立即关闭程序(不登出用户,下次启动仍为自动登录状态)。
4.2 学习与使用区域
VeighNa Station 界面左下角为学习与使用区域:
- 【使用文档】:点击后打开浏览器跳转到官方文档,可查询 VeighNa 的详细使用说明;
- 【社区求助】:点击后打开浏览器跳转到官方论坛,可在论坛中检索技术贴并发帖交流。
4.3 官方频道区域
学习与使用区域下方为官方频道区域,从左到右依次为官方 GitHub 仓库、官方微信公众号和官方知乎账号的入口,点击即可在浏览器中打开对应页面。
五、功能使用
VeighNa Station 左侧功能栏包含社区、交易、投研、加密、更新五大功能,随选择不同,右侧主显示区域会显示对应内容。
5.1 社区
点击左侧【社区】按钮,右侧主显示区域直接展示官方论坛内容,用户无需打开浏览器即可在 Station 内浏览论坛帖子。
5.2 交易:一键启动 VeighNa Trader
点击【交易】按钮,右侧主显示区域呈现交易接口、应用模块选择区域以及信息输出区域:
- 在需要加载的交易接口(如 CTP)或应用模块(如 CTA 策略、回测等)后的白色复选框中打勾;
- 点击主显示区域左下角的【启动】按钮,VeighNa Station 即会按所选组合拉起VeighNa Trader;
- 右侧输出区域会实时输出程序运行过程中的信息,便于排查启动异常。
这一“勾选即启动”的机制,与脚本方式启动 VeighNa Trader 在原理上完全一致。以仓库中的 examples/veighna_trader/run.py 为例,其核心逻辑是:
from vnpy.event import EventEngine from vnpy.trader.engine import MainEngine from vnpy.trader.ui import MainWindow, create_qapp from vnpy_ctp import CtpGateway from vnpy_ctastrategy import CtaStrategyApp from vnpy_ctabacktester import CtaBacktesterApp from vnpy_datamanager import DataManagerApp def main(): """""" qapp = create_qapp() event_engine = EventEngine() main_engine = MainEngine(event_engine) main_engine.add_gateway(CtpGateway) main_engine.add_app(CtaStrategyApp) main_engine.add_app(CtaBacktesterApp) main_engine.add_app(DataManagerApp) main_window = MainWindow(main_engine, event_engine) main_window.showMaximized() qapp.exec() if __name__ == "__main__": main()其中,交易接口对应main_engine.add_gateway(...),应用模块对应main_engine.add_app(...)。从源码看,应用模块统一继承自 vnpy/trader/app.py 中的BaseApp抽象基类,通过app_name、app_module、display_name、engine_class、widget_name等属性声明模块的身份与挂载方式;交易接口与应用的加载、事件分发、日志输出等统一由 vnpy/trader/engine.py 中的MainEngine负责。VeighNa Station 的【交易】面板本质上就是把上述add_gateway/add_app的流程可视化,免去手写代码。
此外,点击主显示区域右下角的【修改】按钮,可以修改VeighNa Trader 的运行目录。运行目录对应源码中 vnpy/trader/utility.py 的TRADER_DIR机制:程序启动时会优先在当前工作目录查找.vntrader文件夹,若存在则以其所在目录作为运行目录,否则回退到系统用户主目录下创建并使用~/.vntrader。该目录存放全局配置(如 vnpy/trader/setting.py 中的vt_setting.json)、日志、数据库文件等运行时数据,修改运行目录即可实现多套环境(如仿真/实盘)的数据隔离。
5.3 投研:拉起 JupyterLab
点击【投研】按钮,右侧主显示区域为jupyterlab 应用操作目录:
- 点击主显示区域左下角的【启动】按钮;
- VeighNa Station 会在右下角指定的运行目录启动 JupyterLab 应用;
- 之后即可在 JupyterLab 中完成数据下载、因子研究、策略回测等投研操作。
这与 VeighNa 的 notebook 生态直接衔接,仓库中的 examples/alpha_research 便提供了基于 RQData 的数据下载(download_data_rq.ipynb)以及 Lasso、LightGBM、MLP 三种机器学习模型的投研工作流示例,均可放入该运行目录下通过 JupyterLab 打开使用。
5.4 加密:将策略 .py 编译为 .pyd
点击【加密】按钮,右侧主显示区域显示策略加密相关内容。该功能用于将选定的 .py 文件编译成 .pyd 文件,从而对策略源码进行加密保护。操作步骤如下:
- 点击【选择】按钮,在弹出的窗口中选择需要加密的策略文件路径,点击【打开】;
- 此时主显示区域左下角的输入栏会显示待加密文件的绝对路径;
- 点击【加密】按钮对文件进行编译,中央显示区域会实时输出加密过程中的相关信息;
- 等输出文件中加密进程终止后,在加密文件所在位置会生成一个加密后的 .pyd 文件。
使用生成的加密文件时有一条关键注意事项:需要先把 pyd 文件名中的.cp310-win_amd64部分移除,然后再放进自建的strategies文件夹中。之所以出现该后缀,是因为 VeighNa Studio 内置的是Python 3.10 64 位环境(见 Windows 安装指南),编译产物会带上解释器平台标识;而 VeighNa Trader 加载策略时按策略类名.py/策略类名.pyd的命名规则查找,因此必须去掉该后缀才能被正确识别加载。加密后的策略与其他策略一样,放置在运行目录.vntrader下的strategies文件夹中,供 CTA 策略等应用模块加载使用。
5.5 更新:检查与更新组件
点击【更新】按钮,右侧主显示区域显示组件更新相关内容:
- 点击主显示区域左下角的【检查】按钮,会显示本地已安装模块和版本列表;
- 点击主显示区域右下角的【更新】按钮,后台将启动更新进程并输出相关信息;
- 更新完成后会弹出通知窗口,点击【OK】并重启 VeighNa Station即可生效。
该功能配合【系统】-【配置】中设置的 PyPI 索引与 pip 代理使用:更新过程本质上是基于 pip 对 VeighNa 各组件包进行升级,私有源或代理配置会直接影响更新能否成功。
六、从 Station 到 Trader:两种启动方式对比
VeighNa Trader 共有两种启动方式(详见 VeighNa Trader 使用文档):
| 启动方式 | 操作 | 适用场景 |
|---|---|---|
| 图形模式 | 登录 VeighNa Station → 点击【交易】→ 勾选接口/模块 → 点击【启动】 | 日常使用,无需编写代码 |
| 脚本模式 | 下载源码,在examples/veighna_trader目录下运行python run.py | 二次开发、调试、自定义加载组合 |
两种方式殊途同归:脚本模式的run.py通过MainEngine.add_gateway/add_app显式声明要加载的接口与应用;Station 图形模式则把同样的流程封装成了勾选框。从源码结构看,二者最终都会进入 vnpy/trader/ui/mainwindow.py 中的MainWindow,其窗口标题会附带当前运行目录TRADER_DIR,方便确认程序实际使用的数据目录。
七、小结
VeighNa Station 是 VeighNa 量化开发框架的图形化入口,覆盖了“登录鉴权 → 环境配置 → 启动交易 → 投研分析 → 策略加密 → 组件更新”的完整使用闭环。掌握本文介绍的五大功能区块(社区、交易、投研、加密、更新)与菜单栏配置项后,即可在图形界面下完成 VeighNa Trader 的日常启动与维护;对于更细粒度的交易接口连接、应用模块使用与全局配置(如 vnpy/trader/setting.py 中的字体、日志、邮件、数据服务与数据库参数),可继续参阅仓库 docs 目录下的 交易接口说明、数据库配置 及 VeighNa Trader 使用文档 等资料。
【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/vnpy/vnpy
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考