Skip to content

v0.3.1 — 发布 PyPI:pip install tdx2db

Choose a tag to compare

@xbfighting xbfighting released this 06 Jul 06:34

亮点

tdx2db 现已发布到 PyPI:https://pypi.org/project/tdx2db/

pip install tdx2db              # 默认支持 SQLite,零配置开箱即用
pip install 'tdx2db[postgres]'  # PostgreSQL
pip install 'tdx2db[mysql]'     # MySQL
pip install 'tdx2db[all]'       # 全部驱动

安装后直接使用 tdx2db sync,无需 clone 仓库。本 release 涵盖 v0.3.0 + v0.3.1 全部变更(v0.3.0 存在 .env 读取缺陷,请直接使用 0.3.1)。

新功能

  • pip install tdx2db + tdx2db 命令行入口(3803608,#27):包目录 src/ 改名 tdx2db/,pyproject 迁移 PEP 621;数据库驱动改为可选依赖(extras),默认安装仅 SQLite,缺驱动时报错附带安装命令;python main.py 老用法保持兼容
  • tdx2db status 命令(42b40b7,#29):只读查看每表行数/覆盖股票数/日期范围,支持 --json;不需要 TDX_PATH;衍生分钟表覆盖缺口自动告警
  • Windows 路径自动探测(08c459e,#33):TDX_PATH 未配置时探测 C/D/E 盘常见安装目录(new_tdx/zd_zsone/tdx/new_jyplug),显式配置永远优先
  • AI agent 支持(a2de4c0,#31):新增 AGENTS.md(schema/典型查询/陷阱清单)与 Claude Code skill tdx2db-query

Bug 修复

  • SQLite 下第二次增量同步全部失败(MAX(date) 返回 TEXT 导致 latest + timedelta 崩溃),storage 层统一归一化为 datetime(3803608)
  • 分钟线衍生表(15/30/60)缺口无法通过增量重跑自愈——增量起点从只查 minute5 改为按表分别计算(42b40b7,closes #11)
  • v0.3.1:pip 安装场景下工作目录的 .env 被静默忽略(load_dotenv 默认从 site-packages 向上查找),改为从当前工作目录向上查找(a2de4c0 / bd5956c)

升级说明

  • 老用户(clone 运行)无需迁移,python main.py sync 用法不变
  • 开发环境安装方式改为 pip install -e '.[all]'