执行摘要

• 一句话：重排 ServerArgs 字段分组为常用优先，并内联架构元组
• 推荐动作：纯重构的典范，值得阅读以了解如何安全地重排大型配置类。AST-diff 验证方法值得借鉴。如果团队依赖 ServerArgs 字段顺序，需要沟通此变更。

功能与动机

ServerArgs 的字段部分历史增长导致顺序混乱，频繁使用的选项分散各处。本 PR 将其按通用性排序，提高可维护性。同时，LLAMA4 和 MIMO_V2 架构元组仅在两处使用，内联后可减少全局常量。动机来自 PR body 的描述。

实现拆解

1. 将 server_args.py 中 ServerArgs 类的每个字段代码块按新分组顺序移动，形成“核心模型/运行时” → “服务/API” → “性能/后端” → “可选特性” → “高级部署” → “调试/实验”的层次。
2. 删除 MIMO_V2_MODEL_ARCHS 和 LLAMA4_MODEL_ARCHS 常量，将元组直接内联到两个使用处（模型特定调整处理器中）。
3. 更新 test_legacy_global_ratchet.py 中的基数，因为 PR#30137 已更改计数，本 PR 同步为 280。

关键文件：

• python/sglang/srt/server_args.py（模块 服务配置；类别 source；类型 core-logic）: 核心配置文件，所有字段重排和内联操作在此文件执行。这是 PR 的主要变更点。
• test/registered/unit/test_legacy_global_ratchet.py（模块 测试基线；类别 test；类型 test-coverage）: 更新 get_global_server_args 调用计数基线，从 278 改为 280，以匹配 PR#30137 后的实际计数。这是纯文本测试维护变更。

关键符号：未识别

关键源码片段

python/sglang/srt/server_args.py

核心配置文件，所有字段重排和内联操作在此文件执行。这是 PR 的主要变更点。

# -------------------------------------------------------------------------
# Core model & runtime config —— 常用优先，移至最前
# -------------------------------------------------------------------------
model: A[
    Optional[str],
    Arg(help="The model name or path."),
] = None
model_impl: A[
    str,
    Arg(
        help=(
            'Which implementation of the model to use.
​
'
            '* "auto" ...'
        )
    ),
] = "auto"
# ... ( 其他模型配置字段 ) ...
​
# -------------------------------------------------------------------------
# Quantization and data type —— 原位于其他位置，现紧随模型配置
# -------------------------------------------------------------------------
dtype: A[
    str,
    Arg(
        help=(
            "Data type for model weights and activations.
​
"
            '* "auto" will use FP16 precision ...'
        ),
        choices=["auto", "half", "float16", "bfloat16", "float", "float32"],
        resolvable=True,
    ),
] = "auto"
quantization: A[
    Optional[str],
    Arg(
        help="The quantization method.",
        choices=QUANTIZATION_CHOICES,
        resolvable=True,
    ),
] = None
# ...

评论区精华

无实质性人工讨论。仅有一条自动代码审查评论，未提出具体问题。

• 暂无高价值评论线程

风险与影响

• 风险：风险极低。PR 作者通过 AST-diff 验证了 420 个字段的字段集、类型注解和默认值完全一致，仅声明顺序变化。argparse 派生参数列表除顺序外无差异。不过，依赖字段声明顺序的少数场景（如某些配置文件或脚本按位置解析）可能受影响，但 CLI 解析基于选项名称，故影响有限。测试基线更新是必要同步，已验证为正确。
• 影响：对用户：CLI 参数帮助文档顺序变化，但选项名称和功能不变。对系统：无功能影响。对团队：提高配置类可读性，降低维护成本。对依赖字段顺序的自动化脚本可能产生轻微影响，但概率低。
• 风险标记：无功能变更已验证, 测试基线同步

关联脉络

• PR #30137 [refactor] Config resolution pipeline: full-stack review (10-PR series, review only): 修改了 server_args.py 并增加了 get_global_server_args 计数，导致本 PR 需要同步更新测试基线。
• PR #30154 [fix] Reconcile the legacy-getter ratchet baseline after racing merges: 同样调整了同一测试文件的基线，与本 PR 的基线更新相关。