跳转至

变更记录

Unreleased

  • 补全短线指标 21 个字段的中文名称、业务含义、单位和来源/计算口径，并明确自由流通 Z 口径、百分比/倍数读法及封单字段的适用条件。

v1.2.0 - 2026-07-19

  • 新增 client.helpers.shortline_indicators() 和兼容入口 client.helpers.get_shortline_indicators()，返回固定 21 个统计资源及短线计算字段。
  • 新增 ShortlineIndicatorTable、ShortlineIndicator、ShortlineIndicatorsNotReadyError 和 TdxStatsDateError。
  • 目标交易日来自 TDX 握手，上一交易日来自上证指数实际日 K；tdxstat.cfg 与 tdxstat2.cfg 必须日期一致且主导日期覆盖率均不低于 95%。
  • 统计资源仅接受目标交易日或上一实际交易日；过期、CFG 日期冲突、低覆盖率及交易日 09:25 前未就绪等情况明确失败，不跨日猜算。
  • 已验证统计资源在客户端内存缓存；refresh_stats=True 可强制刷新，client.clear_cache() 同步清理统计缓存，不新增数据库或磁盘缓存。
  • README、Pages 接口目录、API 参考、方法手册、字段手册和短线指标专页同步补充调用及字段口径。

v1.1.0 - 2026-07-19

  • 7709 transport 改为每连接槽位一个单线程非阻塞 ConnectionActor。
  • 请求使用全池 FIFO admission、exact-once lease 和真正独占的 pin() proxy。
  • timeout 现在覆盖数字 IP/已缓存 endpoint 的排队、连接、握手、发送、响应和一次 retry。
  • push queue 改为有界 buffer；溢出会丢弃最旧帧并通过 PushOverflowError 明确报告 gap。
  • 新增 max_pending_requests、push_queue_size、push_queue_bytes，以及 PoolBusyError、PushOverflowError、TransportCloseTimeoutError。
  • TdxClient、TdxClient.from_hosts()、PooledSocketTransport 和 eltdx-smoke 的 pool_size 默认值统一为 1；该参数现在必须是正整数，非法值直接抛出 ValueError，不再静默截断或改写。
  • 自定义 hostname 的首次 DNS 仍使用标准库阻塞解析，但在 Actor 外执行，不占 slot；该解析无法提供严格取消保证。
  • Actor fatal 或 close deadline 到期现在 fail-closed，不会悄悄创建替代线程。