ZLT 投研插件（内测版）

ZLT Investment Research Plugin for Visual Studio Code

证量通投研插件是为量化交易策略开发者打造的 VS Code 集成工具，提供从策略开发、调试到回测分析的完整工作流支持。通过与证量通投研平台的深度集成，让您在熟悉的编辑器环境中高效完成量化研究工作。

功能特性

🔐 用户认证管理

支持手机验证码登录和账号密码登录
自动保存登录状态，持久化认证凭据
支持密码找回功能
个人资料管理

⚡ 智能 Debug 启动

F5 一键启动 - 智能识别当前策略工程，自动生成调试配置
前置校验 - 自动检查登录状态、服务配置、IPC连接等前置条件
工程自动识别 - 支持多工程工作区，自动定位策略入口
Gate 文件机制 - F5 启动前自动写入策略配置，确保回测参数正确

📊 回测管理

准备回测面板 - 配置回测参数，选择实验室环境
回测中监控 - 实时查看运行状态
成功/失败列表 - 分类展示回测结果
回测详情 - 查看完整回测报告和性能指标
历史记录 - 浏览历史回测任务
回测对比 - 多个策略结果对比分析

🧪 实验室管理

实验室节点管理 - 添加、切换实验室服务节点
团队管理 - 管理团队成员和权限
集群管理 - 监控和管理计算集群
执行主机管理 - 配置回测执行主机
人员管理 - 团队成员管理
交易账号管理 - 管理模拟/实盘交易账号
服务策略监控 - 实时监控策略运行状态
策略审核 - 策略上线审核流程

🎯 策略管理

策略列表 - 快速访问所有策略
策略工程切换 - 支持工作区内多个策略工程切换

🔌 服务连接

IPC/HTTP 双模式 - 支持本地管道和HTTP两种通讯方式
服务状态监控 - 实时监控本地回测服务、行情服务、市场规则服务等
自动重连 - 连接断开时自动重试
证量通终端路径配置 - 灵活配置服务路径

📁 工作区管理

默认工作区 - 无项目时自动创建默认工作区
多工程支持 - 支持同时管理多个策略工程
策略配置持久化 - 自动保存策略配置到 .vscode/tradesetting.json

系统要求

操作系统: Windows 10/11 (推荐 Windows 11 或 Windows 10 21H2+)
VS Code: 1.81.0 或更高版本
Python: 支持 Python 调试 (需要安装 Python 扩展)

注意: 本插件依赖 Windows 特定的系统调用与原生二进制库（如 zltclient.dll），目前仅支持 Windows 系统。

安装

从 VS Code 市场安装

打开 VS Code
进入扩展市场 (Extensions Marketplace)
搜索 ZLT 投研插件 或 Zhengliangtong
点击 Install 安装

从 .vsix 文件安装

code --install-extension zlt-vscode-plugin-x.x.x.vsix

快速开始

1. 登录证量通账号

安装完成后，在侧边栏会出现"证量通"图标，点击后：

在"证量通用户管理"面板中选择登录方式
使用手机验证码或账号密码登录

2. 配置服务路径

在"服务配置"面板中点击 + 按钮
选择证量通终端安装目录
系统会自动验证路径并尝试连接服务

3. 运行策略回测

打开包含 main.py 的策略工程
按 F5 键或在"准备回测"面板中配置参数
点击启动开始回测
在"回测中"面板监控运行状态
回测完成后查看结果

命令列表

命令	快捷键	描述
`ZLT: 智能运行当前工程`	`F5`	智能识别并启动当前策略工程
`切换工程`	-	在工作区的多个策略工程间切换
`进入证量通回测面板`	-	快速打开回测列表
`刷新回测列表`	-	刷新回测数据
`刷新实验室`	-	刷新实验室节点列表
`刷新服务配置`	-	刷新服务连接状态

配置选项

插件支持以下 VS Code 设置：

{
  "zlt.databasePath": "C:\\Path\\To\\ZLT\\Terminal"
}

zlt.databasePath: 证量通终端安装路径

工作区结构

插件会在策略工程中创建以下配置文件：

your-strategy-project/
├── .vscode/
│   ├── tradesetting.json    # 策略配置文件
│   ├── tasks.json           # 任务配置 (自动生成)
│   └── launch.json          # 调试配置 (自动生成)
└── main.py                  # 策略入口文件

常见问题

Q: 提示"IPC 服务未连接"？

A: 请确保证量通终端已启动，并在"服务配置"面板中点击"建立连接"按钮。

Q: F5 启动后没有反应？

A: 请检查：

是否已登录证量通账号
是否配置了证量通终端路径
当前文件是否在策略工程目录下
策略工程是否包含 main.py 文件

Q: 如何切换不同的策略工程？

A: 可以通过以下方式：

在"准备回测"面板点击"切换工程"按钮
切换到其他策略工程的 Python 文件会自动切换

技术支持

问题反馈: GitHub Issues
邮箱联系: TEA

版本历史

v1.0.2 (2026-02-10)

移除服务框架
引入工作区，默认创建工作区
重写策略运行交互
新增 F5 前置操作
Bug 修复

v1.0.1 (2025-12-20)

修改登录 bug

v1.0.0 (2025-11-25)

初始版本发布
用户认证管理
服务配置面板
回测列表管理
数据管理面板
IPC 服务框架

许可证

ISC

ZLT 投研插件 - 量化策略开发助手 - 让量化策略开发更高效

zlt-vscode-plugin

zltyang