vllm-project/vllm

Rust 前端 generate 路由显式拒绝 n>1，消除静默丢结果

值得精读的小型修复。它展示了在不动共享 crate 的前提下，用 `serde(flatten)` 包装类型在路由层捕获共享类型故意省略字段的通用模式，对参与 vllm-text Rust 前端开发的工程师有参考价值。值得关注的决策点：`unwrap_or(1)` 的默认值语义、与 OpenAI 路由校验文案的一致性、render 复用路径显式 `n: None` 的构造方式，以及评审中 `> 1` vs `!= 1` 的边界收紧。

修复 EPD 代理 encoder 轮询重置问题

值得快速精读，重点关注两点：(1) 把游标数学抽成纯函数并让测试直接驱动真实模块，避免测试复制生产逻辑的常见反模式；(2) 在单事件循环 async 服务中，用一把锁保护跨请求共享状态的最小化做法。若后续要扩展 EPD 代理（如 encoder 健康检查、加权分配），可在此基础上演进，并建议补一次真实集群端到端验证。

新增 trace_decode_token_ids 实现确定性解码重放

值得精读。重点关注：采样后注入再算 logprob 的顺序设计、以 GPU 状态推导 step 避免 CPU 同步、UVA `StagedWriteTensor` 的批量写入模式、以及“配置开关 + 输入归一化 + 统一校验”三层防护。对想扩展 MRV2 sampler 或实现类似重放/调试功能的工程师是很好的参考。合并前建议在 GPU 上跑通 `examples/generate/trace_replay_offline.py` 端到端验证。

XPU 上跳过 fused_shared_expert 测试

该 PR 简单直接，无需精读。关注测试跳过策略的合理性，确保未来功能支持时能及时调整。

ROCm 融合 DSV4 mHC 与 RMSNorm 内核，吞吐约增 1%

值得精读，尤其是对 kernel 融合接入模式和 ROCm 后端开发有兴趣的工程师。重点关注三点：`_aiter_ops.py` 中 `mhc_fused_post_pre` 的返回值顺序转换与空 token 分支、`model.py` 中融合能力的条件探测（`hc_mult == 4` + hidden size 白名单）、以及 `mhc.py` 各 `forward_hip` 中 AITER/TileLang/torch 的三级回退结构。若后续推广类似融合，建议补上覆盖 fake/meta 与回退路径的单元测试，并考虑把 hidden size 白名单收敛为 AITER 侧的查询接口，避免多处硬编码。

修复 ROCm CUDA graph capture 时 CPU query offset 被清除

值得精读，尤其是关注 ROCm CUDA graph capture 细节的开发者。该 PR 揭示了一个隐藏在共享 metadata 状态下的时序问题，并提供了最小化的修复方案，展示在性能和安全捕获之间的权衡。可作为处理类似共享状态清理问题的参考案例。

修复 MP4 edit-list 裁剪视频加载时帧数采样塌缩

值得精读。这是一个典型的"容器元数据与真实呈现时间线不一致"导致静默帧丢失的 bug，修复思路（用 seek / duration 交叉校验头部计数）对多模态视频加载设计有参考价值；同时展示了一个 PR 从复杂修复（重读整个流）被 maintainer 简化为元数据修正的演进过程，是学习代码评审权衡的好案例。建议关注 pyav 分支的除零隐患是否已兜底。

优化 GDN 元数据构建重复 mask 计算

该 PR 是一个小范围性能优化，逻辑清晰，风险低，值得合并。但建议补充相关单元测试以覆盖 spec decode 边界情况，防止未来回归。