研究模板设计
语言：简体中文 · English
本页说明何时使用本地派生配置，何时把实验沉淀为仓库模板。配置字段和目录结构由当前仓库的 strategy_pipeline 维护，研究问题与验证协议由 quant-market-research 维护。
快速判断
| 改动范围 | 建议 |
|---|---|
| 日期、输出目录、运行名称或少量参数 | 使用本地派生配置 |
| 同一路线内的模型、特征或参数比较 | 先使用本地派生配置 |
| 长期维护的新频率、数据源或股票池 | 新建仓库模板 |
| 团队会反复使用的新基线 | 新建仓库模板 |
| 新增本地资产或数据准备步骤 | 新建模板并补充资产文档 |
同一研究单元通常共享以下边界：
- 股票池和可交易性规则
- 数据频率与来源
- 标签、持有期和成本口径
- 训练与验证协议
- 本地资产依赖
这些边界没有变化时，优先派生本地配置。这样可以减少一次性模板，也方便在相同口径下比较结果。
本地派生配置
本地配置适合参数搜索、小范围特征试验、模型比较和临时日期调整。建议放在 configs/local/，只改本次实验需要的字段，并使用稳定的 run_name 前缀。
特征试验应遵循统一比较协议，固定样本、标签、成本和组合构造。新增一组特征时，先完成覆盖率检查、同族消融和重复字段检查。相关要求见本仓库的 benchmark 阶梯。
需要团队复用或在文档中作为正式入口时，再将本地配置整理到仓库维护的目录。
仓库模板
仓库模板应对应一条稳定路线，并能回答以下问题：
- 它解决了哪个长期研究问题。
- 它依赖哪些数据资产和准备步骤。
- 它采用什么样本、标签、成本和验证协议。
- 它与现有模板有什么可验证的差异。
新模板的名称应体现市场或股票池、数据路线以及频率或研究重点。A 股实验模板通常放在调用方维护的版本化配置目录中。历史港股配置只从 quant-market-research 的归档文档追溯。
同步内容
新增仓库模板时，至少同步以下内容：
只在本地使用的派生配置通常无需修改公共文档。
决策顺序
依次检查以下问题：
- 改动是否引入新的频率、数据源或股票池。
- 改动是否增加新的资产准备步骤。
- 配置是否会成为多人复用的稳定基线。
- 现有模板是否已经可以承载这次实验。
前三项都为否且现有模板可用时，继续使用本地派生配置。完成稳定复现和验证后，再决定是否沉淀为仓库模板。