用户指南

按建模场景分册的实战指南，每一篇都包含 背景 → 关键 API → 完整代码 → 常见问题。

分册列表

• 样本管理

  SampleSplitter / StratifiedSampler / SampleBalancer / select_sample_seed

• ODPS 数据抽取

  ODPSRunner / parse_sql_file / pull_attributes_in_batch

• 数据一致性对比

  ProcCompareEngine / proc_compare / DataFrame 与 CSV 大表一致性校验

• WOE 编码

  WOE_Master / MonotoneWOEBinner / is_monotonic

• WOE 分箱引擎

  as_woe_engine / binning_engine / woe_binner / Master-Monotone 统一协议

• 特征筛选

  PSICalculator / VarExtractionInsights / CorrelationFilter

• 模型训练

  LRMaster / GradientBoostingModel / BackwardVariableEliminator（含 weight_col）

• GBM 超参搜索

  GradientBoostingModel.param_search / grid search / Optuna / INS-OOS-OOT holdout（含加权 AUC）

• 模型注册与版本管理

  save_model / load_model / load_model_metadata / 模型 metadata artifact

• 模型评估

  PerformanceEvaluator / GainsTableCalculator / EvaluationPipeline（含加权 Gains / KS / AUC）

• 模型解释

  ModelExplainer（SHAP / Owen Value / PDP / ICE / ALE / LIME）

• 拒绝推断与分布适配

  RejectInferenceFactory / DistributionAdaptation

• 线上线下一致性校验

  UATConsistencyChecker / UATConfig

• Excel 报告生成

  ExcelMaster / Template / Report

阅读顺序建议

新手路径

1. 先读 快速上手 跑通一遍
2. 再读 端到端流水线 理解整体流程
3. 如果使用单调分箱，优先读 WOE 分箱引擎
4. 然后按需查阅各分册

API 速查

任何时刻想查具体函数签名，跳转到 API 参考 — 由源码 docstring 自动生成。