新增 - 文档站(MkDocs + Material + mkdocstrings),push main 自动构建并部署 GitHub Pages - SKILL.md:面向 AI 编程助手的技能文件(三条必守约定 / 枚举取值表 / 任务→方法决策表 / 9 条陷阱) - docs/ai.md:文档站的「AI 助手接入」页 - tests/test_check_docs.py(10 项):漂移检查器自身的自测 变更 - README 361 → 125 行,只保留入口层;CLI 手册 / API 表 / 通道路由 / 架构树 / 扩展市场 / easy-tdx 对比 / Changelog 全部移交文档站与 CHANGELOG.md - README 相对链接改为绝对 URL(PyPI 渲染不重写相对链接,原本在 PyPI 页面全 404) - check_docs.py 扩展为两档:MUST_LIST_ALL(须列全)+ MUST_NOT_BE_STALE(只需无过时引用), 并把 SKILL.md / README / llms.txt / 教程类页面纳入;白名单放行 config 的模块级函数 - 版本号 0.4.0 → 0.5.0;包元数据 Documentation 指向文档站 - uv.lock 同步 修复 - ExMarket 成员数 52 → 46(实测 IntEnum 成员数),4 处文档同步更正 - docs/ai.md 的 3 处相对链接 + CHANGELOG 的 SKILL.md 链接(会导致 mkdocs --strict 失败) - README 标注的测试数量 85 → 109(pytest 实际收集用例数)
5.4 KiB
5.4 KiB
更新日志
本项目遵循 语义化版本。
0.5.0 - 2026-09-15
新增
- 文档站(MkDocs + Material +
mkdocstrings),每次 push 自动构建并部署到 https://openbot-coder.github.io/pytdxdata/ SKILL.md— 面向 AI 编程助手的技能文件:三条必守约定、枚举取值表、 「想做什么 → 用哪个方法」决策表、9 条真实陷阱llms.txt— 面向 LLM 的结构化摘要,随站点发布到根路径CHANGELOG.md独立成文件(此前内嵌在 README 中)scripts/check_docs.py+ CI 步骤 — 文档漂移检查:代码有而文档漏写、或文档引用了已删除的方法,都会 failtests/test_check_docs.py(10 项)— 漂移检查器自身的自测
变更
- README 瘦身为「入口层」:361 → 129 行。只保留定位 / 安装 / 30 秒上手 / 特性 / 文档导航 / 免责声明;
CLI 手册、API 表、通道路由、架构树、扩展市场、easy-tdx 对比、Changelog 全部移交文档站与
CHANGELOG.md - API 文档改由
mkdocstrings从 docstring 实时生成,不再手抄(根治漂移) - 漂移检查扩展为两档:
MUST_LIST_ALL(须列全所有公开方法)+MUST_NOT_BE_STALE(只需无过时引用), 并把SKILL.md/README.md/llms.txt/ 教程类页面一并纳入 - 包元数据
Documentation由仓库首页改指文档站 - 测试用例 99 → 109
文档
- 新增文档站 19 页:快速开始 / 场景示例 / CLI / FAQ / 贡献指南 / 更新日志 / API 参考(总览·TdxData·枚举·模型·指标·解析器)/ 深入原理(架构·协议·三池路由·缓存)
- 明确口径:
TdxData公开方法共 53 个(= 51 个数据方法 +start/close), 此前各处笼统写的「51 个公开方法」不严,已统一更正
修复
- 修正中文标题锚点被默认 slugify 剥光导致跨页深链接全部失效的问题
(改用
pymdownx.slugs.slugify,并给被引用的标题加显式 ASCII id;--strict不会报这个错,只能靠锚点检查兜住) - README 中标注的测试数量(85)与 pytest 实际收集数不符,已更正为 109 个用例
0.4.0 - 2026-09-15
新增
- 服务器文件「下载 + 解析」能力(对齐并超越 easy-tdx 的文件解析):
get_block_parsed(filename)— 板块block_zs/gn/fg.dat→list[TdxBlock](板块名 / 类别 / 成分股代码)get_industry_map()—tdxhy.cfg→dict[str, IndustryInfo](通达信行业 + 申万行业)get_financial_file_infos()—tdxfin/gpcw.txt→list[FinancialFileInfo](文件名 / MD5 / 大小)get_financial_records_parsed(filename)—gpcw*.zip解压 + 解析 →list[FinancialRecord](每股原始字段)
- 解析器模块
codec/block.py、codec/industry.py、codec/financial.py(纯标准库,脱网可单测) - 数据模型
TdxBlock/IndustryInfo/FinancialFileInfo/FinancialRecord - CLI 新增 4 个命令:
tdx block/tdx industry/tdx financial-list/tdx financial - 测试
tests/test_cli_files.py(11 项 CLI 离线测试,FakeTD 桩)
修复
- 修复财报索引市场字段解析(
<6s1c1L→<6sBL)。此前恒判深市,现市场字段 0=深 / 1=沪 正确
变更
- 公开异步方法 47 → 51,新增接口全部向后兼容(原
bytes方法保留) - README 与
docs/API_REFERENCE.md同步更新
0.3.2 - 2026-08-17
新增
get_kline_batch(stocks, period, ...)— 批量 K 线,多股票自动并发,连接池分配不同服务器get_minute_batch(stocks, ...)— 批量分时,多股票自动并发
0.3.1 - 2026-08-17
变更
get_kline(MIN_1)切换为 MAC 通道(0x122E),解决标准通道 1 分钟 K 线深度不足的问题router.py中KlinePeriod.MIN_1强制路由到 MAC 通道- 标准通道其他周期(
MIN_5/15/30/60/DAY/WEEK/MONTH)不受影响
修复
- 修复 MAC K 线并发分页的数据空洞:并发分页器把不同页分配到不同服务器,
而各服务器数据深度不一致时
stop_when_short会导致非确定性数据丢失。 改为单连接串行分页(_fetch_mac_kline_serial,start动态偏移,与 easy-tdx 一致)
0.3.0 - 2026-08-17
变更
get_minute切换为 MAC 通道(0x122DMacTickChartCmd),历史分时稳定返回完整 240 条(09:30~14:59)- 移除不再使用的
GetHistoryMinuteTimeDataCmd
新增
protocol/commands/mac_tick.py— MAC 单日分时图命令
[0.2.2] 及之前
- 初始版本:动态连接池 + 双层 TTL 缓存 + 3 连接并发分页 + 双通道(标准 / MAC)+ 扩展市场(港股 / 美股 / 期货 / 期权)