vllm-project/vllm

修复 XPU 单测 OOM 与无 graph 死循环

值得 XPU/Intel GPU 相关贡献者精读，重点是"把平台特有测试机制泛化为通用原语"的设计手法：先有 ROCm 的延迟显存回收等待，再通过重命名与平台分支扩展覆盖 XPU，避免复制一份平行实现。对普通读者而言这是一条小而有代表性的测试基建收口 PR，其中 graph 禁用时的 skip 防护模式也可以在其它依赖 CUDA graph/SYCL graph 的用例中复用。

MXFP8 FlashInfer 路径加可用性守卫，修复无 FlashInfer 时崩溃

改动小巧但值得精读。核心价值不在代码量，而在 PR body 展现的工程判断过程：明确“默认路径不受影响”的问题范围、用表格给出修复前后测试对比、主动论证设备门槛为何不能收窄、用 `git log -S` 与 issue 检索排除重复 PR。建议重点关注“守卫放在选择期而非运行时”的设计语义，以及测试文件在合并前被删除这一异常信号——后续若有人重开同类修复，应先确认该测试被删的背景。

fused GDN MTP 内核支持 Qwen 头比例 1/2/3/4/8，提升 MTP 解码吞吐

值得精读。核心看三点：一是如何把运行期整数 ratio 提升为编译期模板参数并保留 10 个特化；二是 host 端用 C++20 templated lambda 消除 dispatch 重复；三是用 config audit 而非拍脑袋决定支持集合，并把“不支持比例回退”显式纳入 guard 测试。对后续内核工作，建议把质量等价性评估（如 GSM8K 等）与性能评估一起纳入 CI 门禁，避免 -1.06 pp 类点估计长期悬而未决。

完善 FlashInfer one-sided All2All，支持 DeepSeek Blockwise FP8 与序列并行

值得精读。该 PR 展示了如何将一个分布式通信后端的“载荷字节量”概念抽象为中央函数，并用显式校验防止 shape/dtype 不匹配，设计上具有可扩展性。建议重点阅读 `all2all_utils.py` 中的布局函数和 `trtllm_fp8_moe.py` 中的 scale 校验函数，它们为同类问题提供了可复用的模式。若团队正在使用 FlashInfer one-sided A2A 或计划支持更多量化格式，此 PR 是重要参考。

Kimi-K3 开启 DCP 部分前缀缓存命中，修复 Mamba 块表越界

值得精读。核心设计决策是"cache identity 而非 virtual-page 或 interleave 几何决定 hash 语义"以及"每种 cache 类型自己负责 CP 感知的块表宽度"，这两个思路对后续 hybrid 模型（attention + mamba）在并行化下的缓存设计有直接借鉴价值。建议按 `kv_cache_coordinator.py` → `model_runner.py` → `block_table.py` 的顺序阅读三个源码文件，再配合 `test_gpu_model_runner_v2.py` 中捕获块表宽度的测试技巧（monkeypatch `get_block_table_width` 并断言两次调用值）理解修复前后差异。

给 on_gfx1250 加 ROCm 平台守卫，修复非 ROCm 平台导入异常

值得花 2 分钟快速浏览：改动虽小，但它是“平台特有调用应放在平台门控之后”的标准修法，可作为后续跨平台代码审查的参考范式。核心设计决策是先用 `is_rocm()` 做前缀守卫、再用局部变量缓存求值结果，避免在函数体内重复做平台判断，这种写法值得在同时支持多平台的量化工具函数中推广。

SM120 稀疏 MLA 关闭 dense prefill，修复长提示词失败

建议精读这个小而关键的修复。它展示了 vLLM 后端能力声明（class attribute）如何驱动 prefill 路由，以及派生实现继承默认值时可能踩坑的模式。值得关注的决策点：用一行类属性覆盖代替改造路由逻辑，以最小变更面修复事故。若后续演进，可在类上补注释说明 why，避免维护者误删。

补 XPU 版 forward_xpu，修复 HunyuanOCR 强制 eager 崩溃

建议精读。该 PR 虽小，但清晰展示了 vLLM `CustomOp` 按平台分发的机制（`forward_native` / `forward_cuda` / `forward_xpu`），以及平台适配时如何避免 fallback 到不兼容的通用 kernel。对理解 XPU 支持模式和平台相关 bug 排查有很高参考价值。阅读时可重点关注 `CustomOp.dispatch_forward()` 的路由逻辑与 mrope 在 XPU 上的既有处理对比。