Bootstrap 模板
jh_quant.trading.bootstrap 用来降低模拟盘和实盘启动成本。CLI 入口只需要选择模板、backend、策略、股票池和少量运行参数,bootstrap 会完成行情服务、持久化、选股器、session config、API 和 Dashboard 的组装。
CLI 入口
uv run python run_paper.py --helpuv run python run_live.py --help
run_paper.py和run_live.py文件位于代码仓库的根目录下面
常用参数:
| 参数 | 说明 |
|---|---|
--template | 模板:paper-basic、paper-compare、live-basic |
--backend | 行情 backend:tushare、akshare、xquant |
--strategy | 一个或多个策略名,多个用英文逗号分隔 |
--symbols | 股票池,纯代码格式,例如 688041,688256 |
--db-path | SQLite 数据库路径 |
--host | API 服务绑定地址,默认 127.0.0.1 |
--port | API 服务端口,默认 8000 |
--no-dashboard | 只启动 API,不自动打开 Dashboard |
--dashboard-refresh-ms | Dashboard 刷新间隔,默认 15000 毫秒 |
--no-backfill | 关闭回填模式 |
--no-auto-start | 创建 session 但不自动启动调度 |
内置模板
| 模板 | 行为 |
|---|---|
paper-basic | 创建一个模拟盘 session;多个策略会在同一个 session 内等权聚合 |
paper-compare | 为每个策略创建一个独立模拟盘 session,适合做策略对比 |
live-basic | 创建一个实盘 session;broker 使用 xtquant/MiniQMT |
默认策略:
| 模板 | 默认策略 |
|---|---|
paper-basic | momentum |
paper-compare | turtle,momentum |
live-basic | momentum |
run_paper.py 默认使用 paper-compare。当用户传入 --strategy rsi 时,bootstrap 会自动保留 turtle 基准场景,并额外创建 paper-rsi。
默认股票池
默认股票池偏向半导体 / AI 芯片链,便于演示并行策略比较:
688041, 688256, 688981, 688012, 688008, 688347, 603986,603501, 300604, 002371, 688072, 688525, 688126, 688521行情 Backend
| backend | 历史行情 | 实时行情 |
|---|---|---|
tushare | TuShareHistoricalBarProvider | 暂用 AkShare 实时行情合并当天数据 |
akshare | AkShareHistoricalBarProvider | AkShare 实时行情 |
xquant | TuShareHistoricalBarProvider | xtquant 实时行情 |
默认 backend 是 tushare。因为当前 TuShare 实时行情积分可能不可用,TuShareMarketDataService 会复用 AkShare 的实时行情和当天数据 merge 逻辑。
Dashboard
默认情况下,bootstrap 会先启动 API,再自动调用:
from jh_quant.dashboard import display_trading
display_trading(host=host, port=port)因此用户运行 run_paper.py 后不需要再手动启动 Dashboard。若只需要 API:
uv run python run_paper.py --no-dashboard