Function evaluate_and_refine

modules/refinement_processor.py:475–529

一键执行评估+补救的便捷函数 这个函数整合了MetricEvaluator和RefinementProcessor的完整流程。 Args: elements: 已检测的元素列表 image_path: 原始图片路径 eval_config: MetricEvaluator配置（可选） refine_config: RefinementProcessor配置（可选） Returns: 字典包含： - elements: 最终元素列

(elements: List[ElementInfo],
                        image_path: str,
                        eval_config: Dict = None,
                        refine_config: Dict = None)

    return result.elements

def evaluate_and_refine(elements: List[ElementInfo],
                        image_path: str,
                        eval_config: Dict = None,
                        refine_config: Dict = None) -> Dict[str, Any]:
    """
    一键执行评估+补救的便捷函数
    
    这个函数整合了MetricEvaluator和RefinementProcessor的完整流程。
    
    Args:
        elements: 已检测的元素列表
        image_path: 原始图片路径
        eval_config: MetricEvaluator配置（可选）
        refine_config: RefinementProcessor配置（可选）
        
    Returns:
        字典包含：
        - elements: 最终元素列表（包含原有+新增）
        - evaluation: 评估结果字典
        - refinement: 补救结果字典（如果执行了的话）
        
    使用示例:
        result = evaluate_and_refine(elements, "test.png")
        
        print(f"评分: {result['evaluation']['overall_score']}/100")
        print(f"新增元素: {result['refinement']['new_elements_count']}")
        print(f"最终元素数: {len(result['elements'])}")
    """
    from .metric_evaluator import MetricEvaluator
    
    # 1. 评估
    evaluator = MetricEvaluator(eval_config)
    context = ProcessingContext(
        image_path=image_path,
        elements=elements.copy()
    )
    eval_result = evaluator.process(context)
    
    result = {
        'evaluation': eval_result.metadata,
        'refinement': None,
        'elements': context.elements
    }
    
    # 2. 如果需要refinement且有问题区域
    bad_regions = eval_result.metadata.get('bad_regions', [])
    if eval_result.metadata.get('needs_refinement', False) and bad_regions:
        context.intermediate_results['bad_regions'] = bad_regions
        processor = RefinementProcessor(refine_config)
        refine_result = processor.process(context)
        
        result['refinement'] = refine_result.metadata
        result['elements'] = context.elements
    
    return result


def refine_from_rendered_comparison(elements: List[ElementInfo],