Report 与 Artifact¶

MARS 将计算结果分成内存中的结构化对象和可选的持久化产物。两者用途不同。

Report¶

Report 保存汇总表、明细表、趋势表和元数据。它适合在 Python 中继续筛选、排序、复盘或组合，也可以按需导出 Excel、HTML 和图表资产。

导出不是读取结果的前置步骤。对自动化流程，优先消费 report 字段；对人工交付，再调用 write_excel() 或 write_html()。

Excel 适合归档和人工筛选。HTML 适合大量特征的搜索、图表浏览和离线分享。大报告的 HTML 可将图片写入同级资产目录并按需加载；单文件交付则使用内嵌模式。

Modeling 的 artifact 保存调参历史、运行配置、模型、重要性和元数据。artifact_dir=None 表示完全不落盘；指定目录时，每次运行创建独立子目录，避免覆盖旧实验。

Artifact 是实验复现和模型交付材料，不等同于 report。Report 回答“本次结果如何”，artifact 回答“本次模型如何产生并如何恢复”。

已拟合分箱规则的正式跨版本格式是 schema_version=1 JSON artifact，通过 save_json() 和 MarsBinnerBase.load_json() 写入、恢复。它保存构造配置、分箱规则、 WOE、趋势状态和拟合诊断，不保存训练数据缓存。

Pickle/joblib 可用于同一受控 Python 环境中的便利存储，但不是分箱规则的跨版本承诺。旧 {params, state} dict/JSON 不兼容 0.0.26 artifact，不应为它建立自动降级路径。