执行摘要

• 一句话：支持JSON CLI参数中的人类可读数字后缀（如1k、80m），提升用户体验。
• 推荐动作：建议工程师阅读此PR以了解如何扩展CLI参数解析，关注正则表达式设计（单词边界使用）和循环导入的解决方式（函数移动）。对于类似功能，可参考此实现模式。

功能与动机

根据PR body，动机是'允许人类可读数字（m/k/g..）类似于已经可用于--max-model-len的选项'，以提供更方便的CLI参数输入，例如在--kv-transfer-config或--compilation-config.max_cudagraph_capture_size中使用'80m'或'1k'。

实现拆解

1. 添加解析函数：在vllm/utils/argparse_utils.py中新增human_readable_int和human_readable_int_or_auto函数，用于解析带后缀的数字（如'1k'为1000，'1K'为1024），并支持小数和特殊值'auto'。
2. 扩展JSON字符串：在vllm/engine/arg_utils.py中新增_expand_json_human_readable_numbers函数，使用正则表达式在JSON字符串中识别并扩展人类可读数字后缀，同时避免修改引号内的字符串值。
3. 集成到参数解析：在arg_utils.py的_compute_kwargs函数中，解析dataclass类型参数前调用_expand_json_human_readable_numbers，确保JSON参数中的数字被正确处理；在argparse_utils.py的parse_args逻辑中，处理点状配置参数（如--config.field 1k）时尝试使用human_readable_int转换值。
4. 测试配套：在tests/engine/test_arg_utils.py中添加test_expand_json_human_readable_numbers测试函数，覆盖十进制/二进制后缀、小数、嵌套JSON和字符串保护等用例。

关键文件：

• vllm/engine/arg_utils.py（模块 参数解析；类别 source；类型 core-logic；符号 _expand_json_human_readable_numbers, human_readable_int, human_readable_int_or_auto）: 核心参数解析逻辑，新增JSON扩展函数并集成到dataclass解析中，影响所有JSON配置参数的解析。
• vllm/utils/argparse_utils.py（模块 工具函数；类别 source；类型 dependency-wiring；符号 human_readable_int, human_readable_int_or_auto）: argparse工具模块，新增人类可读数字解析函数，并在点状参数解析中集成，影响CLI参数处理。
• tests/engine/test_arg_utils.py（模块 测试；类别 test；类型 test-coverage；符号 test_expand_json_human_readable_numbers）: 测试文件，新增测试函数验证JSON扩展逻辑，确保功能正确性和回归防护。

关键符号：human_readable_int, human_readable_int_or_auto, _expand_json_human_readable_numbers, test_expand_json_human_readable_numbers

关键源码片段

vllm/engine/arg_utils.py

核心参数解析逻辑，新增JSON扩展函数并集成到dataclass解析中，影响所有JSON配置参数的解析。

def _expand_json_human_readable_numbers(val: str) -> str:
    """Expand human-readable number suffixes in a JSON string.
​
    Based on :func:`human_readable_int` so that the ``k/m/g/t`` (decimal) and
    ``K/M/G/T`` (binary) conventions work out the box.
    Also works inside JSON config arguments such
    as ``--kv-transfer-config '{"cpu_bytes_to_use": 80m}'``.
​
    Only bare (unquoted) tokens are replaced so that JSON string values
    like ``"model_name"`` are never modified.
    """
    # Split on quoted strings so we only touch non-string regions.
    parts = re.split(r'("(?:[^"\\]|\\.)*")', val)
    for i in range(0, len(parts), 2): # even indices = outside strings
        parts[i] = re.sub(
            r"\b\d+(?:\.\d+)?[kKmMgGtT]\b", # 使用单词边界避免部分匹配
            lambda m: str(human_readable_int(m.group())),
            parts[i],
        )
    return "".join(parts)

评论区精华

review中，gemini-code-assist[bot]指出正则表达式需要添加单词边界（\b）以避免部分匹配（如'1k1'被错误替换），并建议移动human_readable_int函数到argparse_utils.py以避免循环导入。NickLucche采纳了正则表达式建议，并通过提交历史将函数移动解决了导入问题。DarkLight1337批准认为此方案比原PR更便捷。

• 正则表达式需要单词边界以避免错误匹配 (correctness): 采纳建议，在正则表达式中添加了单词边界（\b），确保只匹配完整令牌。
• 循环导入问题及函数移动 (design): 通过提交历史将human_readable_int和human_readable_int_or_auto函数从arg_utils.py移动到argparse_utils.py，解决了导入问题。

风险与影响

• 风险：技术风险包括：正则表达式可能错误匹配非数字令牌（已通过添加单词边界缓解）；JSON解析可能因无效后缀而失败（函数有异常处理，回退到原始字符串）；兼容性上，现有使用纯数字的参数不受影响，但新后缀可能引入解析歧义（如'1k'被解释为1000而非字符串）。性能影响微小，因为额外解析步骤仅针对特定参数路径。
• 影响：对用户：简化了命令行配置，特别是对于需要指定大数字（如内存大小、缓存尺寸）的场景，提升易用性。对系统：扩展了参数解析能力，不影响核心推理逻辑，但增加了配置灵活性。对团队：代码更易维护，通过统一工具函数减少重复，并提供了测试覆盖。
• 风险标记：正则表达式匹配风险, JSON解析兼容性

关联脉络

• 暂无明显关联 PR