sgl-project/sglang

修复空暂存环水位不前进导致的 PD 暂存转发卡死

值得精读。两个设计点值得学习：一是环形缓冲区水位的经典解法——用 round 的单调性抵消 tail 归零带来的回退，保证异步 readiness 检查始终可推进；二是作者用"allocator-reset-only 仍失败"的对照实验把问题拆成两个正交缺陷，这种验证方法可复用到其他分布式状态同步类 bug。对维护 staging 传输层的同学，建议后续关注 `_send_watermark` 静默异常路径与订阅快照丢失时的补偿重试。

修复 FakeReq 不可达初始化并补 Mamba 状态回归测试

值得快速浏览（无需精读）。该 PR 本身改动很小，但有两个可借鉴点： 1. 遇到"测试突然 AttributeError"时，先检查是否有字段赋值被误放在 `return` 之后的不可达位置，这比盲目补字段更能定位根因； 2. `save_from_req → restore_to_req` 往返断言是一种低成本、高价值的会话状态回归测试范式。 若要进一步加固，可考虑把新回归测试的断言扩展至全部会话状态字段，并在 review 检查单中增加"`return` 后不可达代码"的排查项。

新增组件级精度覆盖，贯通加载与驻留阶段

值得精读。核心看点有三个：一是 fail-closed 的组件能力声明模式（`component_load_precision` 基类默认拒绝、plain-state 子类放行、`load()` 模板方法统一调用），二是精度解析的优先级设计（显式覆盖 > pipeline_config 默认，且 residency 阶段只读 `resolve_component_precision_override` 以保持加载 dtype），三是 `_extract_dynamic_component_map` 的泛化复用（关闭别名后缀与路径展开）——这套模式可直接迁移到其他组件级配置键。

修复 GPT-NeoX 回退加载与 DeepSeek-VL2 V-cache 三个问题

值得精读。规模虽小，但三个修复都展示了“从 checkpoint 序列化来源与加载器构造对象的不匹配反推根因”的分析方法，尤其 v_head_dim=0 哨兵的识别对理解 SGLang 非 MLA 与 MLA 双路径的 KV 池 sizing 很有帮助。值得关注的设计决策：用显式 is None or == 0 而非 not 的写法；测试先证伪再证真（每个用例都验证了修复前失败）。对维护 Transformers 回退加载或 KV 池尺寸推导的工程师有直接参考价值。

为 LFM2 与 LFM2-MoE 新增 DSpark 投机解码支持

值得精读。两个设计决策很有参考价值：① 面对新旋转风格，没有新增第二套 KV 写入管线，而是把既有内核泛化为'两种配对'，并用 IS_NEOX=True 与旧路径逐位一致作为回归护栏；② radix 策略（extra_buffer）的 eligibility 必须尊重 hybrid 架构的 prefix-cache 恢复语义，宁可撤功能也不牺牲确定性输出。建议阅读时对照 dspark.py 的 `_build_fused_kv_write_bundle` 校验逻辑与 lfm2.py 的 `shortconv_target_verify`。另请留意：作者承诺的 `test/registered/spec/dspark/` 门禁测试尚未落地，合并后应补上，并确认 LFM2 + DSpark 的 speculative tape 在配置分辨率下的保障路径。

对齐三 PD 后端防御性协议行为，修复竞态与 KV 布局缺陷

值得精读。这是 RFC #33861 驱动的 staged refactor 的标杆 PR：1）范围控制——主动回退与 #35049/#35360 冲突的畸形消息隔离，避免扩大 scope；2）review 深度——rishabhsinha17 逐分支对照 Common planner 核验，并抓出 NIXL guard 差一行和 `_staging_ctx` 未关闭竞态两个真实问题；3）合并策略——遇到上游已落地等价实现时保留上游代码、丢弃本地重复分支，而不是强行 rebase 冲突。建议后续跟进两个遗留项：将测试合入主仓库、关闭 `_staging_ctx` 的 WATERMARK 竞态。

为 XPU Docker 镜像预装 Rust 工具链与 protobuf 编译器

值得快速浏览（diff 很小）。关注点有两个：一是 XPU CI 通过预构建镜像预装工具链、与后续变更解耦的策略，可作为"为依赖工具链的 PR 准备 CI 镜像"的典型先例；二是 rustup 未锁版本的问题，建议维护者评估是否需要固定工具链版本以保障构建可复现性。