docs: record reproducible risk artifact contract

2026-08-21 23:41:21 +08:00
parent 1a60fef6e1
commit dc67f0e982
3 changed files with 30 additions and 5 deletions
@@ -27,6 +27,12 @@
 因此 `ResearchRunArtifact` 使用显式 `schema_version`、`config_hash`、代码版本和数据
 快照身份，并提供确定性 JSON / SHA-256 manifest；核心层仍不写数据库或 artifact store。

+schema `1.1.0` 将 Qlib 的独立 risk-analysis artifact 思路与 Riskfolio-Lib 的 Euler
+component-risk 语义结合，但只保留本项目需要的轻量合同：协方差快照必须声明
+`snapshot_id`、`as_of_date`、收益频率和年化期数；风险从成交后的实际日末持仓计算，
+component risk 闭合到年化组合波动，percentage contribution 闭合到 1。未来日期、资产
+标签不完整和零方差组合都直接失败，不以默认值伪造结果。
+
 ## hikyuu 的定位

 [hikyuu](https://github.com/fasiondog/hikyuu) 的 SG / MM / CN / PG 部件化思想、