执行摘要

• 一句话：移除 sgl-kernel 中的过时遗留路径和内核，清理代码库。
• 推荐动作：该 PR 值得快速浏览以了解代码清理方向，但无需精读细节。对于关注内核演进或 sgl-kernel 模块的工程师，可注意移除的设计决策（如 AOT 到 JIT 的迁移）和过时功能的淘汰趋势。

功能与动机

PR body 中明确说明动机是“remove unused and obsolete legacy paths from sgl-kernel”和“clean up old AOT-only kernels and compatibility wrappers that are no longer used in runtime”，旨在简化代码并适配当前运行时使用的 jit_kernel 和 merge_state_v2。

实现拆解

实现方案主要包括删除过时代码和更新相关文件：

1. 注意力模块：移除 merge_state v1 内核（如删除 sgl-kernel/csrc/attention/cascade.cu）及其 Python 接口和测试。
2. 元素操作模块：移除 downcast_fp8 AOT 内核（如删除 sgl-kernel/csrc/elementwise/cast.cu）和相关基准。
3. 采样模块：移除 top_k_mask_logits 函数及相关测试和接口。
4. 其他清理：移除 hadamard_transform 接口和 flash_attn_origin 兼容层，并更新 CMakeLists.txt 和 init.py 以移除引用。
5. 测试和基准：修改基准文件（如 bench_cast.py）移除 AOT 对比，仅保留 JIT 版本；移除相关测试文件（如 test_merge_state.py）。

关键文件：

• sgl-kernel/csrc/attention/cascade.cu（模块 attention）: 移除过时的 merge_state v1 内核实现，该函数已由 merge_state_v2 替代，是注意力模块的关键清理。
• sgl-kernel/csrc/elementwise/cast.cu（模块 elementwise）: 移除 AOT 版本的 downcast_fp8 内核，该功能已迁移到 jit_kernel，是元素操作模块的核心变更。
• python/sglang/jit_kernel/benchmark/bench_cast.py（模块 benchmark）: 更新基准测试文件，移除 AOT 对比代码，仅保留 JIT 版本，反映性能测试的演进。
• sgl-kernel/python/sgl_kernel/__init__.py（模块 python-interface）: 移除过时函数的导出，如 merge_state、downcast_fp8 和 top_k_mask_logits，影响模块公共接口。

关键符号：merge_state, downcast_fp8, top_k_mask_logits, hadamard_transform

评论区精华

review 中无实质性讨论，仅 gemini-code-assist[bot] 在评论中表示“I have no feedback to provide”，表明变更被接受且无争议或设计权衡。

• 无实质性讨论 (other): 变更无争议，无需额外 review。

风险与影响

• 风险：风险较低：
• 回归风险：移除的代码被标记为“未使用和过时”，但需确保无残留依赖；例如，merge_state v1 已由 merge_state_v2 替代，downcast_fp8 AOT 已由 JIT 版本替代。
• 性能影响：无直接影响，因为移除的是非核心路径；但基准测试更新可能影响性能对比分析。
• 兼容性：需确保所有调用点已迁移到新实现，如 jit_kernel 中的相应函数。
• 测试覆盖：移除测试文件可能减少对过时代码的验证，但因其已废弃，风险可控。
• 影响：影响范围有限：
• 用户影响：无直接用户可见变化，因为是内部代码清理。
• 系统影响：减少二进制大小和编译时间，简化代码库维护；可能轻微提升构建效率。

• 团队影响：工程师需了解旧内核已移除，避免误用；代码更整洁，便于未来开发。
  影响程度为低，主要涉及开发体验和代码质量。

• 风险标记：依赖移除, 测试覆盖减少

关联脉络

• PR #21554 [CI] Remove more redundant PCG tests: 同为清理冗余代码的 PR，涉及测试移除，反映仓库的持续重构趋势。
• PR #21787 Remove redundant test_moe_eval_accuracy_large: 移除冗余测试文件，与本 PR 的测试清理类似，展示代码库优化方向。