outputManager.py

概述

utils/outputManager.py 是本 RAG 工程里负责管理所有运行结果的生成、版本归档、日志格式化收集与最终产物输出路径派发的一个统一集中控制器与配置挂靠的路由点工具实现脚本包。

它通过获取预设或者是动态的时间戳构建特定批次产生的诸如（跑批记录 logs， 测试评分 reports 或是检索过程的数据状态转储）能够按照规范的统一树结构安放在输出区里，使得多次测试评估或生成之间不会随意覆盖交叉或杂乱无章造成维护困扰的一种管控辅助管理程序控制组件点。

核心实现说明及配置部分操作工具

_init_run_directory(base_out_dir: str="outputs") -> str

在总系统的配置里给出的默认生成数据的大水槽地址基础上，创建一个带如 YYYY-MM-DD_HHMMSS 精确标识的本次专门运行记录挂靠根路径并返回用于随后一切执行生成数据存放处的基础统一绝对路径前置句柄功能点逻辑管理。

get_logger(name: str, log_file: str=None)

配置并组装封装提供全局的标准终端与日志信息双轴或者多轴异步输出与等级筛选抛出器控制器。给它指定不同的特定挂载处名称（如 RAG-Core 或是 Evaluation-Process ）返回一个装配完备包含各种颜色的提醒与预设落盘等格式化配置拦截钩子的 logging.Logger 操作单例结构组件对象，免去各种在到处散装配置样式的繁琐与控制混乱的控制层方法逻辑提供包装机制环境。

_save_run_parameters(params_dict, out_path)

每当系统利用此模块发生一个新的时间节点生成的批次时候能够附带着将当时的生成参数：如使用的什么大模型，搜索使用了多少 K 截断等配置作为证据连同输出一起留底备份存放以供溯源或复现结果的时候的参照配置操作工具等数据落地等固化保存执行函数接口。

_format_and_save_report(report_dict, target_path)

主要面向测评和结束指标的漂亮归纳统计展示功能的后处理。将带有机器可读性质或者是结构化的如百分比，等评估打分的树进行对人类阅读好接受展示结构并可以提供在诸如输出一份具备基础图表样式展示能力或者是 markdown 排版统计展现表格呈现的数据结果总结最终记录落盘打印实现格式处理结构组装器提供包裹功能逻辑等环境结构功能使用层操作方式逻辑点提供方法。