docs(factor): 因子域总设计补 7.8 challenger 档案锚点(设计全貌归流水线 spec §4.4)+两工程坑入账(CLI guard/symbols 裸码格式);design-doc 门 fe1b27f 补档 [nas]

docs/factor_research/factor-system-design.md

@@ -248,6 +248,11 @@
 
 开工批收编（2026-10-07，#91①⑤+P3-14；计划=plans/2026-10-07-factor-followup-batch.md）：exam_gate 缺周期判定扩 isnan——任一侧 ICIR 为 NaN 视同缺失（部分 NaN=INSUFFICIENT_PERIODS、全 NaN=DATA_INSUFFICIENT），上段 defer 台账「首年校准加 isnan」就此提前闭合（#91⑤）。条目级 origin 写入方落地——upsert_factor 增 origin 参（合法 decomposer/manual；建条即落、同名幂等返回不覆盖、非法值拒），decompose 透传 origin=decomposer，P3-11 条目级分支由向前兼容位转正（人工改判退出=yaml 手改 origin: manual；§4.2 表两行同步勘正）（#91①）。缺口开单权威单机制（P3-14）——maybe_open_gap_issue 增 host 参，vps 侧结构性拒开（开单仅 NAS 单侧权威）；data_gap_check/monthly_batch CLI 增 --host 透传，NAS sh 与 VPS ps1 wrapper 双侧声明侧别（台账仍本地 append-only，跨机第一道去重=Gitea 双层查询，本机制=第二道结构性闸）。
 
+## 7.8 LGBM challenger 三路对拍（2026-10-10 班次二，spec §4.4 定案；本节=因子域档案位）
+
+- 模块 `sanguo_factor/challenger_lgbm.py`：影子实验（永不进生产）——等权/ICIR/LGBM 三路同池同窗样外对拍；池=quant12 在役 12 源；数据源=stage4 截面盘+`universe.load_universe_bars` 收盘价；产物 `challenger_lgbm/{host}_{as_of}.json`（三路 IC/ICIR/Q5-Q1+特征贡献+冗余注记）；挂月度链 stage6 失败不阻链。设计全貌与判读纪律=流水线 spec §4.4（唯一活文档分工：流水线 spec 管设计演进，本节管因子域档案锚点）。
+- **工程坑（真跑实证 2026-10-10）**：①CLI 尾部漏 `__main__` guard=`python -m` 静默空跑 exit 0（测试直调 main 函数全绿掩盖）——CLI 入口类模块 guard 必检；②`load_universe_bars` symbols 期望**裸代码**（内部 guess_exchange 拼 exchange），截面盘列名带 `.SZSE` 后缀直传=查不中恒空——跨模块传 symbols 先核格式。
+
 ## 8. 前端与任务态
 
 - 投研三页（IC 排行榜/因子详情/批量评估）：终端风 tokens（深空黑/荧光青），路由挂侧边栏「投研」组；mockup 三份在 `docs/factor_research/*mockup.html`。**先读 frontend/src/styles/tokens.css 再做前端设计**（第一版亮色被打回的教训）。