执行摘要

该PR为HiSparse（分层稀疏注意力）功能添加了服务器参数检查，限制其仅适用于DSA（DeepSeek稀疏注意力）模型（如DeepSeek V3.2、GLM-5）。通过在server_args.py的check_server_args方法中添加断言实现，防止在不支持的模型上误用该功能。这是一个低风险、小范围的边界修复，已获批准并合并。

功能与动机

PR的动机源于HiSparse功能当前仅支持DSA模型，但服务器启动参数检查中缺少对此限制的验证。如代码变更所示，当用户启用--enable-hisparse时，系统需要确保模型配置为DSA类型，以避免潜在错误或未定义行为。PR标题“[HiSparse]: Optimize server args checking-HiSparse is temporarily only available for DSA models.”直接点明了这一目标。

实现拆解

实现仅涉及一个文件python/sglang/srt/server_args.py，在check_server_args方法中新增了以下代码块：

if self.enable_hisparse:
    from sglang.srt.configs.model_config import is_deepseek_nsa
​
    hf_config = self.get_model_config().hf_config
    assert is_deepseek_nsa(hf_config), (
        "--enable-hisparse is only supported for DSA (DeepSeek Sparse Attention) models now"
        "(e.g., DeepSeek V3.2, GLM-5). "
    )

• 导入is_deepseek_nsa函数用于判断模型配置。
• 通过get_model_config().hf_config获取模型配置。
• 断言失败时抛出明确错误消息，指导用户正确使用。

评论区精华

Review讨论非常简洁，仅有一条来自ShangmingCai的批准评论，无具体技术交锋。这表明变更被直接接受，可能因为：

1. 改动小且逻辑清晰。
2. 与团队对HiSparse功能限制的已有共识一致。
3. 错误处理方式（断言）符合项目惯例。

风险与影响

风险：

1. 兼容性风险：如果未来HiSparse支持扩展到非DSA模型，此断言需要更新，否则会错误阻止合法使用。
2. 错误处理：断言失败会直接抛出异常，可能中断服务器启动流程，需确保错误消息足够清晰。
3. 依赖导入：新增导入is_deepseek_nsa函数，需确保该函数在model_config模块中正确定义。

影响：

• 用户影响：DSA模型用户无影响；非DSA模型用户若误启用hisparse会收到明确错误，提升配置体验。
• 系统影响：增强参数验证，减少因配置错误导致的运行时问题。
• 团队影响：代码更健壮，降低维护负担。

关联脉络

从近期历史PR看，server_args.py文件在多个PR中被修改，例如：

• PR #21907：修复MoE模型CUDA图捕获问题，同样涉及服务器参数调整。
• PR #22007：清理注释重复单词，属于代码维护。

这表明server_args.py是服务器配置的核心模块，频繁被维护和增强。本PR延续了这一趋势，专注于HiSparse功能的参数验证，反映了项目对硬件/模型特定功能边界管理的重视。结合标签hicache（可能关联HiSparse缓存优化），可推测HiSparse是项目在稀疏注意力方向上的一个演进特性，当前处于有限支持阶段。