安装

发布渠道

两个包独立发布到 PyPI，按需安装：

PyPI 名	路径	用途
rqalpha-mod-tushare-downloader	rqalpha_mod_tushare_downloader/	CLI 工具（含 tushare-downloader 控制台脚本）
rqalpha-mod-tushare-data	rqalpha_mod_tushare_data/	RQAlpha 运行时 mod（注册 BaseDataSource + rqdatac 补丁）

安装命令

# 下载 + 构建 bundle（需要 tushare 账号）
pip install rqalpha-mod-tushare-downloader

# 运行时 mod（回测 / 因子计算时需要）
pip install rqalpha-mod-tushare-data

备注

两个包互不依赖：如果你只是离线读取已经构建好的 bundle，只需要 rqalpha-mod-tushare-data； 要重新下载 / 更新数据再加 rqalpha-mod-tushare-downloader。

版本要求

依赖	版本	说明
Python	≥ 3.10
numpy	≥ 1.24	推荐 2.1.3（pandas 2.3.3 + numpy 2.5 + h5py 在 Python 3.13 高频分配下有堆损坏）
pandas	≥ 2.0	推荐 2.2.3（2.3.3 的 to_csv 有 segfault bug）
h5py	≥ 3.0	推荐 3.12.1（与 numpy 2.1 组合在 Windows 上稳定）
rqalpha	≥ 6.0	仅 rqalpha-mod-tushare-data 需要
rqdatac	≥ 3.0	仅 rqalpha-mod-tushare-data 需要
tushare	== 1.4.29	仅 rqalpha-mod-tushare-downloader 需要
tqdm	== 4.69.0	仅 rqalpha-mod-tushare-downloader 需要

推荐固定版本

pip install "numpy==2.1.3" "pandas==2.2.3" "h5py==3.12.1"
pip install rqalpha-mod-tushare-downloader rqalpha-mod-tushare-data

从源码安装

git clone https://github.com/joshuaxql/rqalpha-mod-tushare-bundle.git
cd rqalpha-mod-tushare-bundle
pip install -e ./rqalpha_mod_tushare_data
pip install -e .

验证安装

# downloader CLI
tushare-downloader --help

# data mod 可被 rqalpha 加载
python -c "import rqalpha_mod_tushare_data; print(rqalpha_mod_tushare_data.__version__)"