cyijun 中国市场数据路由
先确定研究问题和可得时点要求，再选择数据接口。不要从“哪个接口方便”倒推研究口径。
数据源策略
- 法定披露与交易所原文是高影响事实的最终依据。
- Tushare Pro 是结构化主源。本项目按6000积分规划，但每次真实任务仍以运行时返回的权限为准。
- AKShare 是补充源，适合公开网页行情、当前股票/行业列表和交叉核对；其上游网页、字段和可用性可能变化。
MockProvider只用于显式离线测试，绝不能作为生产自动降级。
工作流
- 把请求规范化为数据集、标的、期间、字段、
as_of、是否严格PIT及预期行数。 - 读取 references/provider-matrix.md 选择主接口与备选接口；涉及历史研究或回测时同时读取 references/point-in-time-contract.md。涉及中国国债曲线、宏观期限结构或DCF无风险利率时读取 references/china-yield-curve.md。
- 先调用Tushare。跨全市场财务截面在6000积分规划下使用
income_vip、balancesheet_vip、cashflow_vip、fina_indicator_vip、forecast_vip或express_vip。 - 只有主源发生依赖、网络、权限、限流或服务错误时才考虑AKShare；参数、schema和代码错误不得触发降级，主源返回空表也不自动等于失败。
- 若请求
require_pit=true，备用接口没有公告可得时点或历史成员区间时必须停止，不得静默降级。 - 清洗后执行schema、主键、日期、数值、非负、重复、版本、空值和行数检查。完整抽取优先显式设置
paginate=true；达到接口上限但未证明分页完成时标记partial，require_complete=true则失败关闭。 - 输出数据及元信息：provider、interface、原始请求、实际接口参数、抓取时间、
as_of、PIT等级、过滤行数、分页完成度、响应SHA-256、权限是否真实验证和降级链。
中国市场不变量
- 财务报表按
ann_date/f_ann_date或可核验实际披露时间生效。只有日期无时刻时，路由器保守地从上海时区次日00:00起可用；这仍不能证明完整修订历史。 disclosure_date是披露计划，不等于实际发布时刻。- 回测用价格默认取不复权日线和复权因子分别保存；不得用今天计算的前复权序列污染历史决策。
- 历史股票池必须处理上市/退市/过会未发行状态、ST、停牌、涨跌停、指数/行业成分进出和
920xxx.BJ等北交所代码。 - 历史基金池同时获取
fund_basic的L/D/I状态并按上市/摘牌区间过滤；摘牌日按区间终点含当日处理。ETF日线与基金净值不得混用，净值按ann_date而非仅nav_date进入严格PIT研究。fund_share.trade_date只有份额变动日、没有官方日内发布时间，不能单独满足严格PIT。 - Tushare的同花顺板块接口在当前文档中要求6000积分，但版权与商业使用边界仍需遵守。
- AKShare财务报表若没有可靠公告日期，只能用于当前研究或交叉核对，不能进入严格PIT回测。
china_yield_curve必须显式指定curve_type=0（到期）或curve_type=1（即期）。数据层的yield单位固定为百分数；DCF的risk_free_rate固定为小数，两者之间必须有可核验的除以100换算。
脚本
scripts/china_market_data.py 提供：
capabilities：输出6000积分规划矩阵，不访问网络；fetch：显式选择tushare、akshare、auto或mock；adjust：只用截止as_of已存在的不复权行情和复权因子构造qfq/hfq序列，未来因子不会改变历史输出；- Tushare优先、AKShare有条件降级；
- 日期或ISO-8601时刻级
as_of过滤、Token进程内读取、显式limit/offset分页、schema/单位契约、质量门禁、截断检测和可审计元数据。
脚本只实现capabilities列出的规范数据集；Skill正文提到但清单未声明的数据必须由调用方提供带来源的数据，或现场扩展并测试路由，不能假装已有接口。
运行真实接口前检查依赖和 TUSHARE_TOKEN。不要打印、写入或提交Token。
运行环境为Python 3.11+；按实际启用的数据源安装锁定版本的tushare或akshare。Tushare认证只接受进程环境中的TUSHARE_TOKEN。
输出契约
返回 dataset、records、metadata。如果不能满足权限或PIT要求，返回结构化错误并说明缺口；不得伪造数据或宣称未运行的接口已经可用。