# PR #22700 完整报告

- 仓库：`sgl-project/sglang`
- 标题：Improve parameters usage constraints for npu deployment
- 合并时间：2026-04-13 22:02
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/22700

---

# 执行摘要
本次 PR 更新了 Ascend NPU 支持特性文档，在专家并行参数表中为 `--moe-a2a-backend ascend_fuseep` 选项添加了“与 eplb 不兼容”的约束说明，并移除了两个已删除的参数。这是纯文档变更，旨在澄清部署配置限制，降低用户错误风险，对系统无直接影响。

# 功能与动机
根据 PR body“Not supported currently --moe-a2a-backend ascend_fuseep”和提交历史中的表述，动机是明确 `ascend_fuseep` 选项的当前使用限制。该选项在 Ascend NPU 平台上与 eplb（专家负载均衡）功能不兼容，文档更新旨在防止用户错误启用冲突的参数组合，提升部署成功率。

# 实现拆解
仅修改了 `docs/platforms/ascend/ascend_npu_support_features.md` 文件中的专家并行参数表：
- 在 `--moe-a2a-backend` 行的 `Options` 列中，将 `ascend_fuseep` 的说明从“`ascend_fuseep`”更新为“`ascend_fuseep`(It is incompatible with eplb)”。
- 根据提交历史，还删除了 `--mm-max-concurrent-calls` 和 `--mm-per-request-timeout` 两个参数的行（但提供的 patch_excerpt 未显示这部分变更）。

# 评论区精华
review 中只有一条来自 gemini-code-assist[bot] 的评论，指出原变更将说明放在反引号内可能引发混淆：
> “The note `(Not supported currently)` is included inside the backticks for the `ascend_fuseep` option. This makes it look like the option name itself contains the parenthesis and the note. It should be moved outside the backticks to ensure clarity and allow for easy copy-pasting of the option name.”

作者采纳了建议，在最终提交中将说明移到反引号外，提升了文档的清晰度和实用性。

# 风险与影响
- **风险**：极低，纯文档变更无代码回归风险；但若约束说明不够明确，用户仍可能误解。
- **影响**：帮助 Ascend NPU 用户避免配置冲突，减少部署问题；对系统和团队无实质性影响。

# 关联脉络
- 与近期 PR #22698（“[Docs] Fix default values and options in Ascend server arguments documentation”）直接相关，同属 Ascend NPU 文档更新系列，反映了团队持续完善平台文档的努力。
- 结合历史 PR 分析，Ascend NPU 是 sglang 项目的重点支持平台之一，近期有多项文档和功能更新（如 #22687、#22698），显示该平台处于活跃维护阶段。