大家好,分享一个我一直在维护的开源项目 easy-tdx,最近过了 1.1k star ,MIT 协议,今天来发个迟到的介绍帖。
起因
做 A 股研究最烦的不是策略,是数据:行情平台要注册、要会员、接口按次收费;通达信客户端数据全,但锁在自己的软件里。这个项目的思路很简单——通达信的 TCP 协议是公开可逆的,那就自己实现一遍,把数据解放出来。
它是什么
一个纯 Python 的 A 股量化工具箱,pip install easy-tdx 就能用:
- 行情:K 线 / 五档报价 / 分时 / 逐笔成交 / 板块 / 资金流,通达信协议直连,不需要装通达信客户端
- 回测:内置 54 个策略、Walk-Forward 样本外验证、一条龙评估、25 项绩效指标、S-D 五档评级
- 选股:策略翻转到全市场扫描,也有按多周期涨幅的强势股排名
- AI 解读:回测报告自动组装成提示词发给你自己的模型( DeepSeek / GLM / Kimi / Ollama 本地都行),返回大白话解读和信心分
- Web 终端:
easy-tdx serve起一个本地看板,行业/概念热力图、异动雷达、期货持仓排名 - 免注册、免 API Key ,所有数据通道都是协议直连或公开数据源
几张截图
行情终端(行业总览热力图):

回测的防过拟合验证链(评级 + Walk-Forward 逐窗样本外):

技术上几个可能值得一看的点
- 通达信二进制协议是净室实现的,标准协议 + MAC 协议两套编解码,commands 层无 IO 可独立单测
- 回测引擎是向量化的,54 个策略的指标基线进了 CI 黄金测试,撮合逻辑漂移会直接红
- 本地 K 线仓库用 DuckDB 做增量同步,15:05 前的当日 bar 标临时值,回测默认忽略,避免拿盘中价当收盘价
- CLI / Python API / REST 三通道输出同一份 JSON ,喂给 Agent 或脚本都行
- 有 Windows 单文件 EXE ,不装 Python 双击就能跑
丑话说在前面
回测 ≠ 实盘,历史收益不代表未来;龙头池名单只是扫描范围,不是荐股; AI 解读仅供参考。工具是研究中用的,不构成任何投资建议。
链接
- 仓库: https://github.com/handsomejustin/easy_tdx
- 文档 Wiki: https://github.com/handsomejustin/easy_tdx/wiki
- 零基础上手手册( 13 章图文): https://github.com/handsomejustin/easy_tdx/blob/main/docs/回测系统完全上手手册.html
觉得有用的话给个 star ,遇到 bug 或想要的功能直接开 issue ,或者在评论区聊,谢谢大家。