Tushare原始数据助手
使用边界
- 当前、非PIT查询可直接使用本Skill。
- 涉及
as_of、公告可得日、历史股票池、回测、AKShare降级或生产资格时,必须调用china-market-data,本Skill不能宣称数据“回测可用”。 - Token只从进程环境
TUSHARE_TOKEN读取;不得调用全局Token缓存、打印、写入或提交凭证。
工作流
- 将问题拆成接口、标的、日期、字段、频率、单位和预期行数。
- 在Tushare官方文档核对接口名、参数、字段、积分与行数限制;6000积分只是规划画像,实际权限以本次调用为准。
- 单票财务用
income、balancesheet、cashflow、fina_indicator;全市场截面在权限允许时用对应*_vip接口。 - 行情保存不复权价格与
adj_factor,不把动态前复权序列直接称作PIT价格。 - 分页或分段获取后检查主键、重复、空值、单位和行数上限。空表先诊断日期、参数、上市状态和权限,不自动换源。
- 输出原始数据与元信息:接口、去敏参数、抓取时间、返回行数、单位、权限结果和限制。
常用接口
使用references/数据接口.md中的精简清单。不要根据旧接口大全猜测名称或字段;清单外接口先查官方文档。
非PIT原始导出可使用scripts/stock_data_demo.py和scripts/fund_data_demo.py:两者显式limit/offset分页、写入全部记录及响应SHA-256,分页停滞或超过最大页数会失败,不再用head()样例冒充完整结果。它们明确输出pit_eligible=false;历史研究仍必须转china-market-data。
输出
区分documented、live_call_succeeded、permission_denied、empty和partial。未运行的接口不能标成可用,离线样例不能标成真实权限验证。