7709-服务器统计文件解析¶

作用¶

下载 zhb.zip 并解析其中的 tdxstat.cfg 与 tdxstat2.cfg，返回结构化的统计数据。它是基于 0x06b9 的上层便捷调用，不是新的二进制命令。

项目	内容
主要调用	`client.resources.read_stats(path="zhb.zip", chunk_size=30000)`
底层接口	`0x06b9`
返回模型	`TdxStatsResource`

示例¶

from eltdx import TdxClient

with TdxClient(timeout=3) as client:
    stats = client.resources.read_stats()
    stat, stat2 = stats.row(0, "000001")  # 0=深圳，1=上海
    print(stats.stats_date, stat, stat2)

如果已经取得 ZIP bytes，可以只调用纯解析函数：

from eltdx.stats import parse_tdx_stats_archive

stats = parse_tdx_stats_archive(payload, source_path="local://zhb.zip")

tdxstat.cfg 和 tdxstat2.cfg 的字段、列号和格式校验见服务器文件读取。

参数¶

参数	含义
`path`	服务器 ZIP 文件路径，默认 `zhb.zip`
`chunk_size`	分块读取大小，默认 `30000` 字节，不能超过单次读取上限

返回字段¶

返回 TdxStatsResource，同时保存两个 CFG 的按 (market_id, code) 索引结果。

`TdxStatsResource` 字段 / 属性	含义
`stat`	`tdxstat.cfg` 的 `{(market_id, code): TdxStatRow}`
`stat2`	`tdxstat2.cfg` 的 `{(market_id, code): TdxStat2Row}`
`source_path`	实际读取的服务器路径
`stat_count` / `stat2_count`	两个 CFG 的有效记录数
`stats_date`	两个文件中出现次数最多的统计日期
`stats_date_counts`	各统计日期出现次数的字典
`stats_date_coverage`	主统计日期覆盖的记录比例
`row(market_id, code)`	同时取得两个 CFG 中对应股票的行；缺失的一侧为 `None`

真实返回样本¶

真实返回 JSON · TdxStatsResource（sz000001）

服务器文件zhb.zip

统计日期20260814

返回类型TdxStatsResource

真实采样；完整资源各有 7986 条记录，只展示 sz000001 在两个 CFG 中的行。

{
  "source_path": "tdx://zhb.zip",
  "stats_date": "20260814",
  "stat_count": 7986,
  "stat2_count": 7986,
  "stats_date_coverage": 0.9937390433258202,
  "stat": {
    "market_id": 0,
    "code": "000001",
    "beta_60d": -0.2146,
    "pe_ttm": 5.01,
    "free_float_shares_10k": 816056.56,
    "year_limit_up_days": 0
  },
  "stat2": {
    "market_id": 0,
    "code": "000001",
    "amount_10k": 92909.84,
    "prev_amount_10k": 84835.88,
    "open_volume_hand": 2852.0,
    "open_amount_10k": 319.99
  }
}