mirror of
https://ghfast.top/https://github.com/aeroxw/easy_tdx_max.git
synced 2026-09-12 15:44:18 +08:00
GitHub
5a3ad15477
Web 获取 K 线此前用 AsyncTdxClient.get_security_bars（标准协议不支持复权），
导致 REST API 无法取前复权/后复权数据。将 /bars（个股 K 线）迁移到
AsyncMacClient.get_stock_kline（MAC 协议，支持 NONE/QFQ/HFQ + QFQ 负价兜底），
保持旧输出契约不变（日线 date 列、分钟线 datetime 列、OHLC 顺序、无 float_shares），
新增 adjust 参数（默认 QFQ），MAC 主机不可用时自动回退标准 TdxClient。
⚠️ 半破坏性变更：/bars 默认复权从"不复权"改为 QFQ（前复权）。老调用方若需
不复权请显式传 ?adjust=NONE。输出 DataFrame 列名/顺序/字段与旧版完全一致
（_normalize_mac_df 规整），仅价格数值因复权变化。
改动：
- bars.py：/bars 改走 mac_client.get_stock_kline(adjust=...)，MAC 不可用回退
get_security_bars（无复权 + warning）；新增 _normalize_mac_df 规整输出契约；
新增 adjust 查询参数（默认 QFQ）。
- convert.py：period_times_from_category（KlineCategory→Period 映射，显式处理
YEAR 9→YEARLY 11、SEASON→QUARTERLY）+ adjust_from_str。
- deps.py：get_mac_client_optional（未连接返回 None，供回退判断）。
- schemas.py：AdjustEnum（OpenAPI 文档用）。
测试：新增 7 个（period_times 映射全表 + 不可映射值、adjust 转换、_normalize_mac_df
日线/分钟线/空 df）。全套 996 passed；ruff format/check + mypy 改动文件零错误。
不在本次范围：/bars/index（指数 K 线，MAC 另一套接口）、/minute、/transaction*
（MacClient tick_chart 语义不同，暂不迁移）。