AKShare 金融数据获取

akshare-cli 封装了 AKShare（1090+ 个函数），覆盖中国几乎所有金融数据及部分全球数据。

核心原则

1. 轻量优先, 查单只股票用 stock_individual_info_em(0.1s)，不要用 stock_zh_a_spot_em(59s)。详见 references/known-issues.md。
2. 先查后调, 不熟悉的函数先 --full-help 看参数，再 call。
3. 失败必降级, 不要在第一次失败后就告诉用户"查不到"，走完三级降级。
4. 控制输出量, 全量接口加 --limit N --sort desc，确保拿到最新数据而非最旧数据。

---

工作流程：发现 → 查看 → 调用 → 降级

严格按以下步骤顺序执行，不要跳步。

第一步：发现函数

三种方式，按场景选一种：

A. 快捷命令（常用场景直接用，不需要搜索）：

akshare-cli stock hist <代码> [--period daily|weekly|monthly] [--adjust qfq|hfq]
akshare-cli stock spot [--market all|sh|sz|bj|hk|us]
akshare-cli fund etf [代码]
akshare-cli futures hist <合约>
akshare-cli bond convertible
akshare-cli macro gdp | macro cpi
akshare-cli forex spot | forex hist [货币对]
akshare-cli index spot [--market global|cn]

B. 关键词搜索（知道大致方向时用）：

akshare-cli search <关键词>    # 支持中英文

英文匹配函数名（结果更全），中文匹配描述和分类路径。

用户意图	英文关键词（推荐）	中文关键词
新闻	news	新闻
股票	stock	股票
涨停/跌停	stock_zt	涨停
龙虎榜	stock_lhb	龙虎榜
板块/概念	stock_board	板块
资金流向	fund_flow	资金流向
基金/ETF	fund	基金
期货	futures	期货
债券	bond	债券
外汇	forex	外汇
宏观	macro	宏观
指数	index	指数

C. 按分类浏览（不确定关键词时用，按中文目录逐级查找）：

akshare-cli browse                                # 30 个顶级分类
akshare-cli browse 股票数据/A股/历史行情数据          # 逐级深入
akshare-cli browse --func stock_zh_a_hist         # 反查函数归属

第二步：查看参数（用快捷命令时可跳过）

akshare-cli call --full-help <函数名>
akshare-cli call --full-help fn1,fn2,fn3       # 批量查询

输出包括：说明、数据源、目标地址、参数（含可选值枚举）、用法示例。

仔细看参数：不同函数参数名不同（symbol/code/indicator），有些有枚举约束，日期一般是 YYYYMMDD。

第三步：调用

akshare-cli call <函数名> [--参数 值 ...] [--json] [--limit N] [--sort desc]

查最新数据时加 --sort desc --limit N，否则 --limit 会截取最旧的数据。

第四步：失败时三级降级

AKShare 底层爬取第三方网站，上游随时可能挂。失败后必须依次尝试：