feat: v1.1.0 - MAC protocol, CLI tool, extended markets, unified client

- Add MacClient/AsyncMacClient with full MAC protocol support (quotes, kline
  with adjustment, tick charts, transactions, boards, capital flow, auction,
  unusual, symbol info, server info)
- Add MacExClient/AsyncMacExClient for extended markets (HK, US, futures)
- Add UnifiedTdxClient auto-routing between A-share and extended markets
- Add `easy-tdx` CLI tool with JSON default output, Agent-friendly
- Add field bitmap protocol for custom quote field selection
- Fix quote-list missing fields (default to BASIC+VOLUME preset)
- Add config.py with centralized host management and auto-discovery
- Add 50+ examples covering all APIs (01-20)
- Rewrite README with CLI-first, Agent-friendly documentation
- Bump version to 1.1.0

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
GitHub
2026-05-22 22:44:45 +08:00
co-authored by Claude Opus 4.7
parent 67a0415c38
commit 4820b4a049
108 changed files with 10345 additions and 932 deletions
+49
View File
@@ -0,0 +1,49 @@
"""演示:分时缩略采样。
通过 MacClient 的 get_chart_sampling() 获取指定股票当日分时图的约 240 个价格采样点。
这些采样点将全部分时数据均匀压缩到 240 个点,适合绘制缩略分时走势图(例如手机端
或列表页的小型走势图)。
参数:
market -- 市场代码(Market.SH / Market.SZ
code -- 股票代码
返回 DataFrame 列说明:
price float 采样点价格(共约 240 行)
"""
from easy_tdx import MacClient, Market
with MacClient.from_best_host() as c:
# 获取贵州茅台分时采样(240 个价格点)
df = c.get_chart_sampling(Market.SH, "600519")
print(f"采样点数: {len(df)}")
# 仅展示前 10 个和后 5 个点
print("\n--- 前 10 个点 ---")
print(df.head(10).to_string(index=False))
print("\n--- 后 5 个点 ---")
print(df.tail(5).to_string(index=False))
# 运行结果:
# 采样点数: 240
#
# --- 前 10 个点 ---
# price
# 1510.00
# 1511.00
# 1512.00
# 1511.50
# 1513.00
# 1515.00
# 1514.00
# 1516.00
# 1515.50
# 1518.00
#
# --- 后 5 个点 ---
# price
# 1518.00
# 1519.00
# 1520.00
# 1521.00
# 1521.00