empty_annotations.py — 空标记实现

文件路径: verl/utils/profiler/empty_annotations.py

文件概述

提供 mark_start_range、mark_end_range、mark_annotate 的空实现（no-op）。当 NVTX 和 MSTX 都不可用时作为 fallback 使用。

内容

def mark_start_range(message=None, color=None, domain=None, category=None):
    pass

def mark_end_range(range_id):
    pass

def mark_annotate(message=None, color=None, domain=None, category=None):
    def decorator(func):
        return func  # 直接返回原函数，不做任何修改
    return decorator

所有函数都是空操作，确保在没有分析工具时代码不报错。

与其他模块的关系

• 被 __init__.py 在无 NVTX/MSTX 时导入

小结

安全的 fallback 实现，让分析标记代码在任何环境下都不会出错。