执行摘要

• 一句话：恢复 WeightTransferConfig.backend 的 Literal 类型提示
• 推荐动作：该 PR 属于小型改进，评审已通过，可直接合并。值得关注的是 vLLM 使用 Literal | str 模式表示内置选项 + 扩展点的惯用做法。

功能与动机

PR body 说明：Using Literal[...] | str is the pattern used elsewhere to indicate that the Literal contains the in-tree options and str allows any value to be passed for out-of-tree options. The Literal was removed in #43121 and this PR adds it back so that the API docs linked to by the CLI help is more useful.

实现拆解

1. 在 vllm/config/weight_transfer.py 中，将 backend 字段的类型注解从 str 改回 Literal["nccl", "ipc"] | str，并补回 from typing import Literal 导入。
2. 该变更仅影响类型提示，不影响运行时行为；@config 装饰器仍会按现有逻辑处理。
3. 无测试、配置或部署相关改动。

关键文件：

• vllm/config/weight_transfer.py（模块 配置；类别 source；类型 dependency-wiring）: 唯一变更文件，修复了类型注解的丢失问题，影响 CLI 和文档的提示信息。

关键符号：未识别

关键源码片段

vllm/config/weight_transfer.py

唯一变更文件，修复了类型注解的丢失问题，影响 CLI 和文档的提示信息。

# SPDX-License-Identifier: Apache-2.0
# SPDX-FileCopyrightText: Copyright contributors to the vLLM project
from typing import Literal # 补回 Literal 导入
​
from vllm.config.utils import config
​
​
@config
class WeightTransferConfig:
    """Configuration for weight transfer during RL training."""
​
    # Literal["nccl", "ipc"] 列出内置选项，| str 允许传入任意字符串以支持外部后端
    backend: Literal["nccl", "ipc"] | str = "nccl"
    """The backend to use for weight transfer. Validated against the
    `WeightTransferEngineFactory` registry at engine creation time.
    """

评论区精华

机器人 gemini-code-assist[bot] 建议使用 Union 替代 | 以兼容 Python 3.9，但作者 hmellor 回复“vLLM does not support Python 3.9”，因此最终保留了 | 语法。审核者 yewentao256 批准了 PR。

• Python 3.9 兼容性 (style): 作者 hmellor 指出 vLLM 不支持 Python 3.9，因此保留 | 语法。

风险与影响

• 风险：变更极小，仅涉及类型注解，无运行时逻辑变化，风险极低。唯一潜在风险是若未来 vLLM 降级支持 Python 3.9，| 语法会导致语法错误，但目前无此计划。
• 影响：影响范围限于 CLI --help 输出和自动生成的 API 文档，使用户能直观看到 backend 的可选值。不影响现有功能，对团队无额外维护负担。
• 风险标记：暂无

关联脉络

• PR #43121 Removed Literal from WeightTransferConfig.backend: 本 PR 直接修复了 #43121 中移除 Literal 的问题，恢复了对内置选项的提示。