执行摘要

• 一句话：修复两处过时文档引用
• 推荐动作：PR 改动简单明确，无功能影响，值得合并以改善文档准确性。不建议精读。

功能与动机

PR 提交者发现两个文档引用已过时：VLLM_PORT 错误信息链接到 en/stable/serving/env_vars.html 返回 404，应指向 en/latest/configuration/env_vars.html；tool_parsers/init.py 的 docstring 示例中模块路径写的是 vllm.tool_parsers.kimi_k2_parser，但实际模块名为 kimi_k2_tool_parser。

实现拆解

1. 在 vllm/envs.py 中，将 get_vllm_port() 函数内 ValueError 的提示 URL 从 https://docs.vllm.ai/en/stable/serving/env_vars.html 更新为 https://docs.vllm.ai/en/latest/configuration/env_vars.html，避免用户跳转到 404 页面。
2. 在 vllm/tool_parsers/init.py 中，将 docstring 示例里的 module_path="vllm.tool_parsers.kimi_k2_parser" 修正为 module_path="vllm.tool_parsers.kimi_k2_tool_parser"，使示例与实际模块名称一致。

关键文件：

• vllm/envs.py（模块 环境配置；类别 source；类型 core-logic）: 修复 VLLM_PORT 错误信息中的文档 URL，避免用户访问 404 页面。
• vllm/tool_parsers/__init__.py（模块 工具解析器；类别 source；类型 docstring）: 修正 docstring 示例中的模块路径，与实际模块名称一致。

关键符号：get_vllm_port

关键源码片段

vllm/envs.py

修复 VLLM_PORT 错误信息中的文档 URL，避免用户访问 404 页面。

def get_vllm_port() -> int | None:
    """Get the port from VLLM_PORT environment variable."""
    if "VLLM_PORT" not in os.environ:
        return None
    port = os.getenv("VLLM_PORT", "0")
    try:
        return int(port)
    except ValueError as err:
        from urllib3.util import parse_url
        parsed = parse_url(port)
        if parsed.scheme:
            raise ValueError(
                f"VLLM_PORT '{port}' appears to be a URI. "
                "This may be caused by a Kubernetes service discovery issue,"
                "check the warning in: https://docs.vllm.ai/en/latest/configuration/env_vars.html"
                # 原 URL 为 en/stable/serving/env_vars.html（返回 404），
                # 已更新为 en/latest/configuration/env_vars.html
            ) from None
        raise ValueError(f"VLLM_PORT '{port}' must be a valid integer") from err

评论区精华

无 review 讨论。gemini-code-assist[bot] 的自动评论确认了改动的准确性，sfeng33 直接批准并回复 "Thanks"。

• 暂无高价值评论线程

风险与影响

• 风险：无技术风险。两个改动均为纯文档/字符串更正，不涉及逻辑变更。
• 影响：影响范围极小。仅影响：
  1) VLLM_PORT 设置错误时用户的错误提示链接（从 404 变为有效页面）；
  2) tool_parsers 模块文档字符串中示例代码的准确性。对系统行为、性能、安全性等均无影响。
  • 风险标记：暂无

关联脉络

• 暂无明显关联 PR