easy-tdx Vibe 项目

easy-tdx 是一个完全免费、无需注册、无需 API Key 的开源 A 股量化工具箱，基于通达信网络协议的净室实现（不依赖通达信客户端也不使用任何券商接口），通过 pip install easy-tdx 即可安装使用。项目覆盖行情数据、回测引擎、选股工具、AI 解读和 Web 看板五大功能模块，数据全部来自协议直连或公开数据源，输出格式为 JSON，可直接对接 AI Agent 进行自动化分析。

核心功能

行情数据获取：支持 K 线、五档报价、分时数据、逐笔成交、板块行情和资金流向等全部数据类型，通过通达信协议直连获取，不依赖任何第三方数据接口。用户无需注册账号、无需购买会员，一个 Python 库即可拉取全市场实时行情。

回测引擎：内置 54 个量化策略，覆盖全部 50 个注册技术指标，支持 init()/next() 两函数编写自定义策略。订单撮合、交易费率、滑点设置、移动止损等机制完整，引擎行为由 CI 黄金测试锁定，防止代码变更导致策略逻辑漂移。

防过拟合验证链：内置 Walk-Forward 样本外验证机制，对策略进行训练、验证、测试三段适配性体检，并给出 0-100 综合评分。评级体系不依赖收益率，而是基于风险调整后的持有体验（SQN、Ulcer、95% VaR/CVaR、最大连胜/连亏等 25 项绩效指标）。

选股与策略扫描：支持将任意策略翻转至全市场扫描，也可按多周期涨幅进行强势股排名。用户可以单策略回测、单策略全市场寻优，或一键触发全策略矩阵寻优，结果存入 SQLite 策略库持久化保存。

Web 终端看板：easy-tdx serve 可在本地启动一个专业看盘 Web 界面，无需安装通达信客户端即可查看五大指数实时行情、全市场涨跌统计、行业/概念热力图、板块异动雷达、龙头股扫描、期货持仓排名等全部功能。

技术实现

通达信二进制协议净室实现：项目对通达信网络协议进行了完整的逆向工程，实现了一套独立于通达信客户端的协议编解码层（标准协议 + MAC 协议两套），commands 层完全无 IO，可独立进行单元测试，不依赖任何外部运行环境。

向量化回测引擎：回测引擎核心计算逻辑全部向量化，54 个策略的指标基线作为 CI 黄金测试用例，每次代码变更自动运行全套回归测试，撮合逻辑漂移会在 CI 阶段直接暴露，而非等到实盘才发现问题。

本地 K 线仓库与增量同步：本地 K 线数据存储使用 DuckDB，进行增量同步管理。每个交易日 15:05 之前的当日 K 线 Bars 会标记为临时值，回测默认忽略这些临时值，避免将盘中价格当作收盘价使用。

三通道统一输出：CLI、Python API 和 REST Web API 三种调用方式共享同一套数据输出，均为标准 JSON 格式。这种设计使得 easy-tdx 可以无缝接入任何 AI Agent 工作流——Agent 通过 Python API 直接调用，或通过 REST API 由外部脚本调用，输出格式完全一致。

通达信公式兼容：项目实现了 30 多个通达信公式函数的向量化求值，用户可以直接粘贴通达信公式（如 BUY: CROSS(MA(C,5), MA(C,20));）进行指标计算、选股和回测，降低了量化策略编写门槛。

快速上手

安装与环境准备：执行 pip install easy-tdx 即可完成安装，依赖为 Python 3.8+。Windows 用户也可下载单文件 EXE，双击即可运行，无需配置 Python 环境。港股、美股数据支持同样开箱即用。

拉取行情数据：用 Python API 获取某股票 K 线数据，示例代码仅需数行，即可获取指定时间范围的日线数据并转为 Pandas DataFrame，方便后续分析。

启动 Web 看盘终端：执行 easy-tdx serve 后，浏览器打开本地地址即可进入 Web 看板，默认展示五大指数行情、全市场涨跌统计和板块热力图，全部数据由协议直连实时更新。

运行回测策略：选择一个内置策略或编写自定义策略（init()/next() 结构），配置回测时间范围和标的范围，执行回测后生成包含 25 项绩效指标的详细报告。

配置 AI 解读：在 easy-tdx 配置文件中填入自己的 AI 模型 API Key（支持 DeepSeek、通义千问、智谱 GLM、Kimi、OpenAI、Claude、Ollama 本地等 9 家 Provider），回测报告即可一键自动生成大白话解读和改进建议。

适用人群

easy-tdx 主要面向以下用户群体：个人投资者和散户，希望以零成本获取机构级别的行情数据和研究工具；量化研究爱好者，需要一个免费且代码可控的回测环境来验证自己的交易策略；Python 开发者，具备编程能力希望通过代码接入市场数据并构建自动化交易系统；AI Agent 使用者，需要将市场数据接入 AI 工作流进行自动化分析和策略研发。

项目为 MIT 协议，完全开源，代码托管于 GitHub，已有 1.1k+ Star，由独立开发者长期维护。