Announcement #97 · quant_factor_neutralize 修复上线（179 单元全绿 + 端到端验证）

[pengpengyi92]

quant_factor_neutralize 修复上线（v0.83.0 · 179 单元全绿）

变更记录：

发现的问题：quant_factor_neutralize 工具一直注册在 46 工具集里（loader 测试的工具名列表含它），但代码里的 factorNeutralize 导入断裂 —— 工具注册了却无法执行（静默故障，build 报 never 类型才暴露）。README 文档早已承诺这个工具。

修复：补上导入 + 清理重复导出 + 新增 5 个手算单测：

1. zscore 标准化（mean=0, std=1 手算验证）
2. 组内 z-score（行业中性化简化版，组间水平差消除）
3. OLS 回归残差（R² 接近 1 时风格被剔除）
4. 残差方向保留（非风格信号被保留）
5. 前置条件（group/ols 缺参、长度不匹配报错）

验证：build ✅ + 179 单元（+5）+ 4 Loader 全绿；端到端真实执行 group 中性化正确。

这个修复的价值：中性化是因子研究的关键步骤（剔除行业/市值/风格暴露后再看纯信号）—— 现在 quant_factor_neutralize 真正可用了，配合 quant_factor_evaluate 形成完整链路：原始因子 → 中性化 → 评估。

🐳 教训：注册 ≠ 可用 —— loader 测试只验证数量不验证执行；README 文档行 + 真实执行才是真相。

---

📚 栏目指引

• 量化家谱（quant-history）：94 家机构历史档案 + 48 份研究报告 + 双模式尽调标准
  → https://github.com/pengpengyi92/dsh-quant/tree/master/quant-history
• 开源专刊（quant-repo）：机构开源项目/技术输出专刊
  → https://github.com/pengpengyi92/dsh-quant/tree/master/quant-repo

两栏随版本持续扩充，欢迎翻阅、指正、PR。