docs: 流水线 spec 判定弹药/AST防换皮/三路对拍/test隔离四块增补+quant12_v2a 权重窗审计结论 [nas]

docs/superpowers/specs/2026-09-22-research-to-trading-pipeline-design.md

@@ -75,6 +75,16 @@ F 环是「管道」与「飞轮」的分界：归因发现→可能=衰减触
 - **出生 description 链路（2026-10-09 补丁，用户反馈「光看名字看不明白」）**：分解器输出 schema 四字段（name/expression/**description**/justification）——description=一句话说因子本身是什么（LLM 出生时生成，≤120 字），justification=如何承载假设（既有语义不变）；注册时落 registry **条目级**（与 hypothesis/origin 同级，仅建条落盘幂等不覆盖，换描述走升版本）；`/pipeline/factors` 与 detail 端点带出；工厂看板因子名下方副行展示+详情页出生档案行。存量因子无 description 显示空，不做迁移（新出生自动有）。
 - **详情页送墓园触点（2026-10-09 补丁）**：因子详情页危险区加「送墓园」——状态机本就允许任何活着状态→graveyard（incubating/assessable/promoted/decaying/retired），verdict 端点+判死回写卡片全现成，本补丁只补 UI 入口（此前唯一入口=晋级评审页，只收 assessable 且 t≥2，incubating 因子无处可毙）；**note 死因必填**（墓园档案价值所在，弹窗输入）；promoted/decaying 态=重确认档（生产在用、合成层钉着版本，文案引导「建议先退役」），incubating/assessable=普通确认档；墓园因子不出工厂板（卡片因子清单 registry 反查自动消失）。**不做物理删除**（Linus 三问不通过：名字释放可绕[决议 D 换假设开新因子]、墓园除噪场景为空、三处置动作概念负担大于收益——墓园=有档案的死亡防重复造轮，足够）。
 - **因子墓园可见性（2026-10-09 深夜补丁，用户验收「送进墓园去哪看」暴露）**：判死因子的回写链只覆盖 `hyp-` 新卡（H- 老编号静默跳过），且 registry 的 graveyard 档案（name+cause）原本无任何 UI 视图——判死即「不可见」。补：`GET /pipeline/factors/graveyard`（registry graveyard 条目带 cause/hypothesis/origin）+假设池页墓园 tab 加「☠ 判死因子」区（名称划线+死因+无卡兜底文案）——**因子墓园唯一视图**（死假设卡列表仍在同 tab 上方，卡片/因子两个维度并列）；夜班批自动判死同走此视图。
+- **判定弹药三件（2026-10-10 补丁，QuantaAlpha 论文口径借鉴；业务问题=月度批评判定人信息缺口——只有近窗 t，分不清「废了」vs「挨风格打」vs「靠几天撑均值」）**：
+  - **全期 t=出生以来累积均值**：factors 端点/详情页的全史 t 从如实 null 升级为 monthly_points 序列累积均值——数据已有纯聚合，不建出厂全窗批（12M 滚动已覆盖近态，全窗批成本高收益低挂可选 backlog）；
+  - **t 统计量+正 IC 天数占比**进月度批评报告与因子详情（t=mean/(std/√n)、正 IC 占比=正点数/总点数；QuantaAlpha 论文 A.5 同款报告纪律，其开源代码亦无——抄论文不抄代码）；
+  - **逐年 IC**：报告/工厂看板按年聚合（月度点 groupby year；日度化后点更密判读力自然上来）；
+  - **小样本诚实注记**：月度点仅 12 个时 t 判读弱（95% 置信需 t>2.2，小样本难达）——本弹药与日度化配套，点数上量后判读力自然上来；判定动作不因此自动化（宪法：阈值叫人、处置人选）。
+- **AST 防换皮（2026-10-10 补丁，QuantaAlpha `factors/coder/factor_ast.py` 移植；业务问题=换皮因子虚增池数/稀释合成层权重/重复评估）**：
+  - 移植其 597 行纯 Python 零依赖实现：表达式→语法树→最大公共子树匹配，含交换律识别（`a+b`≡`b+a`）；
+  - 接入点=版本注册表：**注册新因子时**对既有因子池做结构比对，高相似=**提示非硬拒**（「疑似换皮：与 fXX 最大公共子树占比 X%」，人决定收不收）——judgement 永远人做，硬拒违反人工卡点宪法；
+  - 方言适配：parse_expression 按我们分解器白名单算子集适配；
+  - 不抄 RD-Agent 的 prompt 软门（「请勿生成重复因子」——LLM 自觉防不住换皮，业界反例）。
 
 ### §4.3 晋级闸门
 
@@ -83,6 +93,14 @@ F 环是「管道」与「飞轮」的分界：归因发现→可能=衰减触
 ### §4.4 合成层
 
 - **等权=每个新合成层的基线**（composite_fund8 现状）；**权重进化走「考场晋级+版本化」**（决议 K，09-24 辩论裁决）：ICIR 拟合形态=从等权基线在 h2 样外考场打赢在位者后以新版本上位（先例 quant12 v1 等权→v2a ICIR，09-11 收官），护栏=非负+单源≤2×等权+年频拟合+0.7 族压缩前置（均已测试锁死），档案铁律=新档案新名字+reason 必填+生产冠军定义永不改。P3 归因贡献类权重（第三形态）攒数据后再议。
+- **三路加权对拍（2026-10-10 定案；业务问题=「ICIR 加权是不是最优」无对照永拍脑袋——组合因子的核心要素是加权方式，用实验攒证据）**：
+  - 三路：**等权基线**（配置级零开发）/**ICIR 在位者**（quant12_v2a）/**LightGBM challenger**（新开）——同池同窗同考核，#69 影子 A/B 既有基建+归因 challenger/ 子目录机制复用；
+  - LGBM challenger 要素：qlib Alpha158 基准超参起步（lambda_l1=205.7/lambda_l2=581/lr=0.1/num_leaves=210/min_child_samples=100/early_stopping=50）；**月度重训**对齐月度批评节奏（优于 QuantaAlpha 一次训练跑四年 test 的弱点）；特征=晋级因子池双侧 CSRankNorm 截面秩归一；label=T+1→T+2 防缺口口径；
+  - **池贪心准入（自建；QuantaAlpha 论文有代码无——实验脚本未开源）**：近窗 RankIC 贪心准入+|corr|<0.7 去冗余（高相关对弃低 RankIC）+容量上限（起步=晋级因子全量不设限；饱和点意识挂账——池到几十个再议上限，论文饱和点≈350 因子参考）；
+  - 判读：等权≈ICIR=因子相关性高、加权信息少，安心用简单；LGBM 明显跑赢两者=组合方式升级叙事，且 feature importance 天然产出「组合内各因子贡献」（对接 §4.7 归因）；预期两三个完整月度周期才有判读力；
+  - 纪律：challenger 永远影子不进生产；若升级仍走决议 K 考场晋级+用户口令，与实盘升级同构。
+- **test 隔离条款（2026-10-10 成文，QuantaAlpha 附录 E 纪律借鉴）**：**合成层（含 challenger）权重/训练只用截至 as_of 的数据，表现评估只看 as_of 之后——权重窗与成绩窗永不重叠**。现状核实动作=审计 quant12_v2a 权重计算代码确认滚动结构天然合规（每月 T-12~T 算权、T+1 后出成绩），核实结论落本档。防什么=将来实盘与回测打架时，回测成绩有「未被自己污染」的底气；防将来改动（全历史拟合/未来数据调参类）悄悄破坏。
+  核实结论（2026-10-10 审计）：quant12_v2a（quant12_icirfit_v1）fit_window=2018-01~2021-06、h2 考场窗=2021-07-01 起（exam_gate DEFAULT_START，同批同 run 对照）——**无重叠**（考场首日恰后于拟合窗末月，首尾相接）；v2c 滚动天然合规：Y 年制度档案 fit [Y-3 年初, Y-1 年末]、考核 Y 年段（walk-forward），且注册路径只挂载档案冻结权重（load_profile→resolve_weights），评估数据不回流拟合。
 - **版本钉住+影子对照闸门（决议 A）**：策略钉住合成层具体版本；合成层变更（晋级/退役/调权）→新旧版影子对照（起步默认 4 周，首年校准）→用户口令→各策略**择期**升级。可回滚、历史可复现，与推 vps 纪律同构。
 - **集体衰减判别门（决议 C）**：月度批评输出两个指标——个别因子衰减（相对同侪，E 环照常机械告警）+集体水位（全体 IC 中位数）。**集体水位跌破阈→不开降权 issue，改开「市况研判」卡片上交用户裁决，因子权重冻结不动。**集体信号=判断题归人，个别信号=机械题归系统；防机械追涨杀跌。
 - **研判卡=带介入菜单的决策卡**：七档介入阶梯（从轻到重）——