V3 扩展了 V2.2 的使用方式和数据来源；本次 V2.2.0 对齐 V3.4.1.10 的回测内核；在此之上多了更多数据源、定时补数据、内置编辑器和断点调试、命令行 kh、Web 回测工作台，还能装在 Mac 和 Linux 上。配合 Codex、Claude Code 等 AI 助手，用一句中文就能让它下数据、改策略、批量回测、写结论。
1 V3 多了什么
在 V2 能做的一切之上，V3 多出这 8 项能力：
2 重点：命令行 + AI 助手，用中文做量化研究（最推荐的用法）
命令行 + AI 智能策略研究是使用 khQuant V3 的核心方式，也是我们最推荐的方式。第 2 部分里，2.2 命令行模式与 AI 智能策略研究是从装好软件到用 AI 跑出第一个研究结果的完整路线，V3 用户读完 2.1 就请直接看它。
V3 的每一步——下数据、跑回测、出报告——都有对应的 kh 命令，而且能输出机器可读的结果。这让 Codex、Claude Code、Cursor 这类 AI 编码助手可以直接「上手操作」khQuant：你用中文描述想法，它自己查命令、写文件、批量回测、汇总成表，最后把结论和风险讲给你听。
kh data downloadkh run --json实测：把这个问题交给 Codex
2026 年 10 月 7 日，我们在 Codex 里装好 khQuant Skill，把这个问题和几条要求（文件放哪、参数范围、回测区间、要哪些指标）用中文发给它。它只用 kh 命令，自己下数据、把内置双均线案例改成可调参数的版本、跑了 9 组回测、按收益和回撤排名、给第一名出了 HTML 报告，用时约 15 分钟，没有改动软件的全局设置。
结论也没有替策略说好话：9 组全部亏损，同期指数本身上涨约 12.6%，它如实写了「不能证明有超额收益」，还提醒了过度拟合和交易成本的风险。
完整的过程、9 组结果表和报告截图见 2.2 第 2 节。
AI 能做到这些，靠的是命令行
- V2 只有图形界面，AI 点不了按钮；V3 的
kh让每一步都能用命令完成 --json输出、--data-root独立数据目录，适合 AI 批量跑、互不干扰- khQuant Skill 教 AI 用真实命令，改东西前先问你；
kh没有下单功能，碰不到交易账户
想自己试一试：2.2 命令行模式与 AI 智能策略研究一篇讲完全程：先五分钟上手（确认 kh 能用、让 AI 装好 khQuant Skill、照抄 2.2 第 1.5 节的提示词做研究），再讲细节；自己敲命令的用法放在篇末。想让 AI 从零写策略并回测验证，见 3.4。
3 亮点一览
在浏览器里做回测
- 导入策略项目，改参数、跑回测、看实时日志
- 报告在新标签页打开，界面、命令行、网页的回测历史在一起
- 一键开启临时外网访问，手机扫码就能看
打断点，单步看变量
- 工具栏点「编辑器」，直接打开策略目录（Windows 版，需先自行安装 VS Code，见 2.7）
- 在 khHandlebar 里打断点，回测停在那一刻
- 变量、调用栈、日志一屏看全
更多数据源，每天自动补齐
- tx 免注册，日线、1 分钟、5 分钟都能下
- 同花顺、Tushare、HTTP 桥接、miniQMT 按需选用
- 每天自动补数据：界面「定时补充」窗口需 Windows + miniQMT，其他数据源用
kh data sync（见 2.3）；缺口一键扫描
换台电脑也能接着研究
- Apple Silicon Mac 有完整的桌面界面
- Linux 用 pipx 安装，跑在服务器上
- 策略、配置和数据三个平台通用，拷过去就能用
4 一张表看清 V2 和 V3
| 能力 | V2（开源版） | V3（内测版） | 详见 |
|---|---|---|---|
| 回测内核、撮合规则 | ✓ | ✓ 完全相同 | — |
| 支持的平台 | Windows | Windows、macOS、Linux | 2.1、2.4、2.5 |
| 图形界面（桌面版） | Windows | Windows、macOS（Linux 没有） | 2.1、2.4 |
| 数据源 | BaoStock、Tushare | 另有 tx、同花顺、HTTP 桥接、miniQMT | 2.3 |
| 定时补数据、缺口扫描 | — | ✓ | 2.3 |
| 内置编辑器、断点调试 | — | ✓（Windows） | 2.7 |
| 包管理 | — | ✓（Windows） | 2.8 |
| 命令行 kh | — | ✓ 三个平台都有 | 2.2 |
| Web 回测工作台、手机访问 | — | ✓ 三个平台都有 | 2.6 |
| AI 助手用中文做研究（khQuant Skill） | — | ✓ | 2.2 |
| 策略案例 | 4 个 | 13 个 | 3.5 |
| 源码 | 开源（CC BY-NC 4.0） | VIP 有效期内可访问源码私有库 | — |
Windows 和 macOS 上的 V3 三样都有：图形界面、命令行 kh、Web 回测工作台。只有 Linux 没有图形界面，只用命令行和 Web 工作台。各平台的详细区别见第 6 节。
5 两版完全一样的部分
- 同一套回测内核：本次开源版 V2.2.0 对齐 V3.4.1.10 的成交、费用、滑点、T+0/T+1、复权与挂单规则；不能据此保证其他历史版本或未来版本恒等。
- 结果逐笔一致：2.2.0 与 V3.4.1.10 的六组冻结案例，在相同数据、固定参数和相同配置下已逐笔核对；其他版本或条件需要重新验证。
- 文件通用：
.py策略、.kh配置、DuckDB 数据目录直接拿过去用，不用改。 - 第 1 部分全部适用：1.1～1.12 讲的配置回测、下载数据、看报告，V3 一样操作。T+0、日内多次触发、自定义指标读写这些内核能力，V2 也有；V3 多的是对应的案例，见 3.5。
结果对不上时，先检查两边的数据（数据源、下载时间、复权方式）和配置（区间、股票池、触发方式、费用、滑点）是否真的相同。
6 三个平台各能做什么
| 功能 | Windows | macOS（Apple Silicon） | Linux |
|---|---|---|---|
| 图形界面 | 有 | 有 | 无 |
命令行 kh、Web 回测工作台 | 有 | 有 | 有 |
| 内置编辑器、包管理页 | 有 | 无 | 无 |
| miniQMT 数据 | 有（需本机运行 miniQMT） | 无 | 无 |
| 定时补充数据 | 界面和命令行 | 命令行 | 命令行 |
macOS 版只支持 M1 及以后的 Mac；Linux 推荐 Ubuntu 22.04/24.04。详见 2.4、2.5。
策略案例只用来演示软件功能和写法，不构成投资建议，回测结果不代表未来收益。
7 本部分目录与选读
- 入门：2.0 V2 和 V3 的区别（本篇）、2.1 安装与升级
- 核心用法（推荐 · 必读）：2.2 命令行模式与 AI 智能策略研究
- 数据：2.3 数据管理模块（V3）——数据源、定时补数据、缺口扫描；数据库结构在 1.4
- 其他平台：2.4 macOS、2.5 Linux
- 界面与工具：2.6 Web 端、2.7 内置编辑器、2.8 包管理
- 附录：附录 A 命令参考、附录 B 排错总表
写策略（框架、函数、Skill、用 AI 写策略、13 个内置案例）在第 3 部分；大规模回测与性能设置在 1.12。
V3 用户推荐的阅读路线：1.1 → 1.3（只看安装向导）→ 2.0 → 2.1 → 2.2；1.4～1.12 用到界面时再查。各篇讲什么、两条航线怎么走，见新手学习路线图。
之后按目标选读：大多数 V3 用户 2.2 → 2.3；Mac 用户 2.1 → 2.4 → 2.2；服务器用户 2.5 → 2.2 → 2.6；喜欢在界面里写代码、打断点的 2.7 → 2.8 → 第 3 部分。
常见问题
问：我一直用 V2，换 V3 后策略还能用吗？
答：能。.py 策略和 .kh 配置直接拷到 V3 的策略目录就能加载，应同时核对内核版本、数据、配置和策略参数，再比较回测结果。
问：V2 和 V3 能装在同一台电脑上吗？
答：V2.2 可以，两者互不干扰。较早的 V2.1 不行，装 V3 会把它原地升级掉。详见 2.1。
问：AI 助手会不会乱动我的数据或账户？
答：kh 只有数据、回测、结果这些功能，没有下单功能。khQuant Skill 会让 AI 在下载、回测这类操作前先给你看命令；像上面的实测那样，让它用 --data-root 指定一个单独目录，你平时的数据就不会被碰到。不过 AI 工具本身能在你的电脑上执行任意命令，平时请保持「执行命令前需要批准」，看清每条命令再同意；批量研究想走开时，只在专用研究目录里临时放宽，见 2.2 第 1.5 节。Tushare Token 这类密钥请自己填，不要交给 AI。
问：Mac 上能用 miniQMT 吗？
答：不能，miniQMT 只有 Windows 版。Mac 上可以用 BaoStock、tx、同花顺、Tushare，或者通过 HTTP 桥接从一台 Windows 电脑取数据，见 2.3。
本篇基于 V3.4.1.10 编写。