执行摘要

• 一句话：为 Nemotron Omni V3 模型添加别名支持
• 推荐动作：值得快速合并。这是一个标准的模型别名注册 PR，结构清晰，风险低。建议未来为 Nemotron Omni V3 添加独立的测试用例以验证加载和推理。

功能与动机

PR 标题为 'Nemotron-omni-v3-alias'，说明目的是为 Nemotron Omni V3 模型添加别名。根据 issues 关联为空，推测是支持新模型的快速引入，复用已有的 Nano Nemotron VL 实现。

实现拆解

1. 新增配置类：在 python/sglang/srt/configs/nano_nemotron_vl.py 中添加 NemotronH_Nano_Omni_Reasoning_V3_Config，继承自 NemotronH_Nano_VL_V2_Config，显式定义 __init__ 以防止 PretrainedConfig.__init_subclass__ 覆盖父类的自定义初始化。
2. 新增模型类：在 python/sglang/srt/models/nano_nemotron_vl.py 中添加 NemotronH_Nano_Omni_Reasoning_V3，继承自 NemotronH_Nano_VL_V2，未覆盖任何方法，完全复用父类逻辑，并将其加入 EntryClass 列表。
3. 更新多模态处理器注册：在 python/sglang/srt/multimodal/processors/nano_nemotron_vl.py 中，将 NanoNemotronVLImageProcessor.models 列表和 EVSProcessor 的配置映射扩展，纳入新模型和新配置类。
4. 更新模块导出：在 python/sglang/srt/configs/__init__.py 中添加新配置类的导入和 __all__ 条目。
5. 更新模型配置映射：在 python/sglang/srt/configs/model_config.py 中将新模型架构名称 NemotronH_Nano_Omni_Reasoning_V3 添加到 is_generation_model 列表中。
6. 更新 HuggingFace 工具：在 python/sglang/srt/utils/hf_transformers/common.py 中添加新配置类的导入和 CONFIG_TO_MODEL_MAP 中的映射。

关键文件：

• python/sglang/srt/configs/nano_nemotron_vl.py（模块 模型配置；类别 source；类型 core-logic；符号 NemotronH_Nano_Omni_Reasoning_V3_Config, init）: 新增 NemotronH_Nano_Omni_Reasoning_V3_Config 配置类，是模型注册的核心。
• python/sglang/srt/models/nano_nemotron_vl.py（模块 模型定义；类别 source；类型 data-contract；符号 NemotronH_Nano_Omni_Reasoning_V3）: 新增模型类 NemotronH_Nano_Omni_Reasoning_V3 并注册到 EntryClass，使模型可被加载。
• python/sglang/srt/multimodal/processors/nano_nemotron_vl.py（模块 多模态处理器；类别 source；类型 dependency-wiring）: 更新多模态处理器注册，使新模型能使用默认的视觉处理器。
• python/sglang/srt/configs/__init__.py（模块 模块导出；类别 source；类型 dependency-wiring）: 导出新配置类，使其可通过模块导入。
• python/sglang/srt/configs/model_config.py（模块 模型注册；类别 source；类型 data-contract）: 在 is_generation_model 中添加新模型架构名称，确保被识别为生成模型。
• python/sglang/srt/utils/hf_transformers/common.py（模块 HuggingFace 工具；类别 source；类型 core-logic）: 添加配置到模型的映射，支持 HuggingFace 自动加载。

关键符号：NemotronH_Nano_Omni_Reasoning_V3_Config.init

关键源码片段

python/sglang/srt/configs/nano_nemotron_vl.py

新增 NemotronH_Nano_Omni_Reasoning_V3_Config 配置类，是模型注册的核心。

# 文件 : python/sglang/srt/configs/nano_nemotron_vl.py
# 在文件末尾新增 Nemotron Omni V3 配置类，继承自 V2 配置
​
class NemotronH_Nano_Omni_Reasoning_V3_Config(NemotronH_Nano_VL_V2_Config):
    model_type = "NemotronH_Nano_Omni_Reasoning_V3"
​
    def __init__(self, *args, **kwargs):
        # Explicit __init__ prevents PretrainedConfig.__init_subclass__ from
        # replacing the parent's custom __init__ with a dataclass-generated one.
        super().__init__(*args, **kwargs)

python/sglang/srt/multimodal/processors/nano_nemotron_vl.py

更新多模态处理器注册，使新模型能使用默认的视觉处理器。

# 文件 : python/sglang/srt/multimodal/processors/nano_nemotron_vl.py
# 导入新模型和配置类，并注册到处理器
​
from sglang.srt.configs.nano_nemotron_vl import (
    NemotronH_Nano_Omni_Reasoning_V3_Config,
    NemotronH_Nano_VL_V2_Config,
)
from sglang.srt.models.nano_nemotron_vl import (
    NemotronH_Nano_Omni_Reasoning_V3,
    NemotronH_Nano_VL_V2,
)
​
class NanoNemotronVLImageProcessor(BaseMultimodalProcessor):
    models = [NemotronH_Nano_VL_V2, NemotronH_Nano_Omni_Reasoning_V3]
    # ... 其他代码 ...
    def __init__(self, hf_config, server_args, _image_processor, *args, **kwargs):
        # ...
        self.evs = EVSProcessor(
            hf_config,
            {
                NemotronH_Nano_VL_V2_Config: NemotronH_Nano_VL_V2,
                NemotronH_Nano_Omni_Reasoning_V3_Config: NemotronH_Nano_Omni_Reasoning_V3,
            },
        )

评论区精华

无 review 评论，仅有一条 APPROVED 审批。说明变更简单直接，无争议。

• 暂无高价值评论线程

风险与影响

• 风险：风险极低。新类和配置完全继承自已有实现，未修改任何现有逻辑，仅新增别名注册点。但需确认 HuggingFace 模型配置中 model_type 字段确为 NemotronH_Nano_Omni_Reasoning_V3，否则自动加载会失败。
• 影响：对用户：支持通过 HuggingFace 模型 ID 自动加载 Nemotron Omni V3 模型，无需手动指定配置。对系统：无性能影响，注册点增加少量导入条目。对团队：维护成本低，后续若模型逻辑有差异需独立实现。
• 风险标记：缺少测试覆盖

关联脉络

• PR #23974 [AMD] Fix Aiter RMSNorm layout handling: 同为模型相关修复，但无直接技术关联。
• PR #23874 Fix failing test_nvidia_nemotron_3_nano by fixing test_grouped_topk: 同属 Nemotron 系列模型，但本次 PR 不涉及内核或权重加载修复。