从这里开始¶
职责边界¶
| 工具包负责 | 工具包不负责 |
|---|---|
| 截面分桶、多空构建 | 生成 alpha 信号 |
| 等权 / 市值加权及自定义加权 | 提供行情数据 |
| 年化收益、波动、夏普、回撤、换手、IC | 撮合、滑点与交易成本建模 |
| 净值曲线与指标表落盘 | 实盘下单 |
设计约定¶
三条贯穿全包、且有测试覆盖的口径约定：
截面加权只用简单收益
绝不在截面上平均对数收益。对数刻度仅是可视化层的选择。
forward_return.horizon 是唯一的「一期有多长」
engine.holding_days 留空即继承该值。两者显式不等时告警但不中断，因为那意味着收益的测量期与年化时假定的持有期不是同一件事。
一期的单位则由 input.frequency 单独声明：日度数交易日、月度数自然月，年化基数随之取 252 或 12。月频面板漏声明会让年化指标偏离 21 倍且不告警，写法见月频面板。
调仓间隔应与测量期相等
input.calendar.rebalance_freq 与 horizon 不等时，相邻两期的持有窗口会重叠或留下空仓缺口，逐期累乘出的净值与最大回撤会失真。引擎就此发出告警。
基准¶
基准序列由使用者自备，在 input.references 中声明后进入结果表与图表，bucket 固定为 REF。包内不附带任何市场指数数据。
等权组合应配等权指数、市值加权组合应配市值加权指数——同口径才谈得上比较。两套加权各配一条指数的完整配置见日频例子。
许可证¶
MIT