MiniQT 介绍

概述

MiniQT 是一款基于 minibt 与 PyQt6-Fluent-Widgets（Fluent Design 设计风格）开发的量化交易可视化桌面应用，集成了天勤量化（TqSdk）API、多周期 K 线图表、策略回测引擎以及 SQLite 本地数据库，旨在为量化交易者提供一个功能完善、界面美观、易于扩展的交易分析与策略开发平台。

MiniQT 支持期货、股票、指数等多种金融品种的实时行情展示、历史数据查询与离线缓存，并提供可视化策略回测、交互式开发工具（Jupyter / JupyterLab / 终端）、系统设置等模块，帮助用户高效完成从行情监控、策略研究到回测验证的全流程量化交易工作。

📚 相关资源

• GitHub 仓库：https://github.com/MiniBtMaster/miniqt
• PyPI 仓库：https://pypi.org/project/miniqt/
• 在线教程：https://www.minibt.cn
• 联系邮箱：407841129@qq.com

主界面概览

MiniQT 启动后默认进入主界面，采用 Fluent Design 设计风格，提供清晰的模块化导航。

顶部 Banner

展示项目名称 "Mini Quant Trader" 与 K 线背景图。

资源链接区

提供外部资源链接，方便用户快速访问相关文档和社区：

快捷入口

快捷入口区是 miniqt 四大核心功能模块的快速访问入口，每个卡片对应一个完整的子模块：

行情报价

• 功能：查看各交易所主力合约的实时行情数据
• 模块路径：miniqt/app/view/market_quote_interface.py
• 核心特性：
  • 支持期货、股票、指数、主连、主力等多种合约类型
  • 按交易所分组（中金所、上期所、大商所、郑商所、上交所、深交所、能源所等）
  • 实时显示代码、名称、最新价、开盘价、最高价、最低价、成交量、涨跌幅等字段
  • 支持列排序、右键菜单快速打开 K 线图
  • 集成 SQLite 本地数据库

策略回测

• 功能：创建和运行量化策略回测，分析策略表现
• 模块路径：miniqt/app/windows/strategy_backtest_window.py
• 核心特性：
  • 可视化回测参数配置
  • 支持多策略并行回测
  • 回测结果图表化展示
  • 详细的回测报告（收益率、最大回撤、夏普比率等）
  • Pi Agent 智能助手：集成 pi-agent-web，AI 辅助策略开发
    • AI 对话：与 AI 模型自然语言交互，辅助编写策略代码、分析回测结果、调试错误
    • 文件自动同步：AI 写入或编辑策略文件后，自动在代码编辑器中打开/刷新
    • 文件树双向同步：Pi Agent 文件树与代码编辑器文件树实时双向同步
    • 主题联动：跟随 MiniQT 深色/浅色主题自动切换
    • 快捷 AI（F2）：在代码编辑器中一键调起 AI，直接对当前文件提出修改需求
    • 会话管理：支持多会话切换、历史会话恢复
    • ⚠️ 首次使用需自行安装前端依赖（npm install），详见下方「使用」章节的说明

K线图表

• 功能：查看各交易所主力合约的 K 线图，分析价格趋势
• 模块路径：miniqt/app/view/kline_chart_interface.py
• 核心特性：
  • 支持期货、股票、指数、主连、主力等多种合约类型
  • 按交易所分组（中金所、上期所、大商所、郑商所、上交所、深交所、能源所等）
  • 实时显示 K 线图，支持缩放、平移等交互操作
  • 支持列排序、右键菜单快速打开 K 线图
  • 集成 SQLite 本地数据库

miniqt 官网

• 功能：访问 miniqt 官方网站，获取最新资讯和文档
• 模块路径：miniqt/app/view/official_website.py
• 核心特性：
  • 内置浏览器组件
  • 直接访问官方网站内容
  • 支持相关社区和文档跳转

系统设置

• 功能：配置应用主题、数据源、图表参数等选项
• 模块路径：miniqt/app/view/setting_interface.py
• 核心特性：
  • 主题切换（亮色/暗色）
  • 数据源配置
  • 图表样式自定义
  • 全局参数调整

登录入口

登录入口区提供两种登录方式，满足不同用户场景：

期货登录

• 功能：登录天勤期货交易账户
• 模块路径：miniqt/app/view/future_login_interface.py
• 核心特性：
  • 登录天勤期货账户，获取实时行情数据
  • 支持实盘交易接口
  • 登录后自动同步所有合约信息到本地数据库

股票登录

• 功能：登录股票交易账户
• 模块路径：miniqt/app/view/stock_login_interface.py
• 核心特性：
  • 登录股票交易账户
  • 获取股票实时行情

开发工具

开发工具区为开发者和高级用户提供便捷的开发与调试工具：

终端窗口

• 功能：打开交互式终端窗口，执行系统命令
• 模块路径：miniqt/app/view/terminal_interface.py
• 核心特性：
  • 内置终端模拟器
  • 支持常用的系统命令
  • 方便开发者进行调试和测试

Jupyter 窗口

• 功能：启动 Jupyter Notebook 交互式编程环境
• 模块路径：miniqt/app/view/jupyter_interface.py
• 核心特性：
  • 集成 Jupyter Notebook
  • 支持 Python 交互式编程
  • 方便进行数据分析和策略验证

JupyterLab 窗口

• 功能：启动 JupyterLab 交互式开发环境
• 模块路径：miniqt/app/view/jupyterlab_interface.py
• 核心特性：
  • 集成 JupyterLab
  • 比 Jupyter Notebook 更强大的开发环境
  • 支持文件浏览器、终端、文本编辑器等扩展功能

测试图表

• 功能：打开测试图表窗口，验证图表显示功能
• 模块路径：miniqt/app/view/test_chart_interface.py
• 核心特性：
  • 用于测试图表组件是否正常工作
  • 展示图表基本功能
  • 方便开发调试图表相关功能

侧边导航栏

主窗口左侧为侧边导航栏，可快速切换到各个子模块：

安装

# 通过源码安装（开发模式）
pip install -e .

# 通过 PyPI 安装
pip install miniqt

使用

# 通过命令行启动
miniqt run
miniqt

# 或通过 Python 模块启动
python -m miniqt run
python -m miniqt

Pi Agent 智能助手：首次使用需自行安装前端依赖

Pi Agent 基于 pi-agent-web（Next.js + Node.js）。前端依赖不随 Python 包一起发布——node_modules 体积很大，一并打包会显著增大安装包，因此需要你在首次使用时手动安装一次：

# 1. 确认已安装 Node.js（建议 18+）
node -v

# 2. 进入 pi-agent-web 目录安装依赖（只需一次）
#    目录在 Python 环境的 site-packages 内，例如：
#    <venv>/Lib/site-packages/miniqt/app/pi-angent-web
cd "<site-packages>/miniqt/app/pi-angent-web"
npm install

完成后，在 MiniQT 的「策略回测」界面即可启动 Pi Agent。若未安装 Node.js 或未执行 npm install，Pi Agent 只会提示“依赖未安装”，不影响其它功能。

项目结构

miniqt/
├── app/
│   ├── common/          # 公共模块（数据库、天勤对象等）
│   ├── components/      # UI组件
│   ├── view/            # 主界面视图
│   └── windows/         # 子窗口（图表、回测等）
├── resource/            # 资源文件（图片、图标等）
├── __main__.py          # 启动入口
├── pyproject.toml       # 项目配置
└── requirements.txt     # 依赖列表

依赖

• Python >= 3.12
• minibt >= 1.2.6（含 PyQt6 >= 6.11、PyQt6-Fluent-Widgets、PyQt6-WebEngine、 tqsdk、pandas、numpy 等）
• pylightcharts >= 0.1.0（K 线 / 插件面板图表引擎）
• qtvscode >= 0.1.0（VS Code Web 代码编辑器控件）
• mootdx → 富途 OpenAPI（futu SDK 随仓库附带在 futu/；需先启动并 登录 FutuOpenD 网关，默认 127.0.0.1:11111）
• click >= 8.0.0
• pywinpty >= 3.0.5（Windows 终端支持）
• PyYAML >= 6.0（配置文件读写）
• QtAwesome >= 1.3.1（图标字体）
• requests >= 2.28.0（HTTP 请求）

数据库使用标准库 sqlite3，不再需要 DuckDB； Jupyter / JupyterLab 窗口已移除，不再需要 qtconsole / jupyterlab。

详见 requirements.txt

许可证

MIT License