# TuShare点时全量数据接入说明

日期：2026-08-05

## 当前状态

- 已有：2016–2026真实前复权日线的受限试验集；公开沪深北证券目录；227只已核验T+0基金目录。
- 缺少：退市证券、历史ST/更名、停复牌、逐日可交易状态、完整复权因子、点时财务数据，以及券商级分钟/逐笔、IOPV和Level-2。
- 因此：可以运行研究和影子账户，不能把结果宣称为全量无偏回测，也不能启用真实资金。

## 已交付的安全加载器

源码：`portal/research/tushare_point_in_time_loader.mjs`

加载器从环境变量 `TUSHARE_TOKEN` 读取Token，不把Token写入日志、网页、成果档案或Git。它首先拉取上市/退市证券、停复牌和更名历史，为点时股票池建立基础。日线、复权因子、日度基本面等大表应按交易日增量保存。

## 用户需要做的唯一动作

1. 注册或登录TuShare Pro并取得自己的Token及所需积分权限。
2. 在本机Terminal或云端Secrets中设置 `TUSHARE_TOKEN`；不要把Token粘贴到聊天或网页。
3. 运行：`node research/tushare_point_in_time_loader.mjs`。

## 验收原则

- 任一交易日只能使用该日当时已经可得的数据。
- 退市、停牌、ST、涨跌停和上市日期必须进入可交易性过滤。
- 研究结果只公开聚合指标；原始许可数据不随公开成果档案发布。
- 点时数据闸门未通过时，实盘资金权限继续为LOCKED。