# si-srp **Repository Path**: yao2019ss/si-srp ## Basic Information - **Project Name**: si-srp - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-23 - **Last Updated**: 2026-10-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # rotfunda — 中证二三级行业 ETF 轮动买卖建议系统 ## 项目定位 基于行业轮动理论 + 机器学习的中证二三级行业 ETF 买入/卖出建议与历史回测系统。当日 14:40 决策、当日收盘(净值)成交;卖出建议仅使用买入日起可得信息(卖出信息闭包,杜绝前视)。 ## 目录结构 ``` src/rotfunda/ 核心包(数据/特征/ML/策略/回测/窗口/指标/绘图) scripts/ 命令行脚本(取数/回测/建议/出图) tests/ 无前视回归测试 + 指标/窗口测试 docs/ 详细设计(DESIGN.md / DESIGN_impl.md) reports/ 效果报告、交易明细、建议示例、figures/ 图表 data/ 行情缓存与研究数据 ``` ## 快速开始 在项目根目录下,使用虚拟环境 `.venv`: ```bash # 1) 安装 .venv/bin/python -m pip install -e . # 2) 取数(baostock 主源,缓存于 data/etf_daily/) .venv/bin/python scripts/fetch_universe.py # 3) 回测(21 交易日窗 + 3 月窗,2024 起) .venv/bin/python scripts/run_full_backtest.py --tag r10 --top-k 4 --max-positions 4 # 4) 当日建议(14:40 口径) .venv/bin/python scripts/generate_advice.py --asof 2026-10-21 --top-k 4 \ --ml-scores data/ml_scores_r10.csv # 5) 出图(每 3 只 ETF 一张,走势 vs CSI300,红▲买入 / 绿▼卖出) .venv/bin/python scripts/plot_trades.py --tag r10 --start 2024-01-01 --end 2026-10-21 ``` ## 核心约束与测试 - **无前视**:特征 `asof_shift=1`;ML 标签 embargo(训练样本 t+H < 预测日);卖出特征签名级隔离;T+1 卖出。 - **复权**:用 baostock `pctChg` 重建收益一致的复权价,规避份额折算假跳空。 - **卖出规则族**(仅路径变量):止损/移动止损/止盈/持有期衰减/动量衰减/波动上限,任一触发即卖出。 - **数据源**:baostock 主源、腾讯 fqkline 备用。 运行测试固化上述约束: ```bash .venv/bin/python tests/test_no_lookahead.py .venv/bin/python tests/test_metrics_windows.py ``` 效果与推荐配置详见 `reports/REPORT.md`。 ## 免责声明 本项目仅供研究与教学使用,**不构成任何投资建议**。回测结果基于历史数据,不代表未来表现;使用者应自行承担一切交易风险与数据使用合规责任。 ## 许可证 LGPL-2.1-only,详见 `LICENSE.txt`。