Prhub

#30370 [NPU] [DOC] Update features and mainstream models on ascend npu

原始 PR 作者 amote-i 合并时间 2026-07-07 19:03 文件变更 3 提交数 3 评论 3 代码增减 +37 / -37

执行摘要

NPU 文档更新,添加新模型和参数说明

根据 PR body,目的是更新 Ascend NPU 文档,使其与最新的特性和支持的模型保持一致,并为快速入门页面添加指向完整安装指南的链接,方便用户获取更详细的安装信息。

此 PR 为常规文档维护,无需深入代码审查。但值得关注的是,NPU 平台对 Prefill 上下文并行(--enable-prefill-cp)的支持标志着该平台在长上下文场景下的优化进展,开发者可查阅相关参数使用文档。

讨论亮点

仅有一个 Gemini Code Assist 的自动审查评论,确认 PR 内容为文档更新,无具体质疑或修改建议。最终由 sglang-npu-bot 审核通过。

实现拆解

变更涉及三个文档文件:

  1. ascend_npu_quick_start.mdx:在页面元数据之后添加一个 <Note> 组件,提示用户当前仅介绍了使用官方容器镜像的部署流程,如需完整安装指南(包括源码安装、Docker 构建、系统设置、版本映射等),应参阅完整安装文档。
  2. ascend_npu_support_models.mdx:在表格中插入三行新模型记录,包括 Eco-Tech/DeepSeek-V4-Pro-w4a8-mtpEco-Tech/DeepSeek-V4-Flash-w8a8-mtp(属于 DeepSeek 系列)和 Eco-Tech/GLM-5.2-w8a8(属于 GLM-5 系列)。同时修正了 Eco-Tech/GLM-5.1-w4a8 的系列名从 "GLM-5.1" 改为 "GLM-5",保持一致性。
  3. ascend_npu_support_features.mdx:在服务器参数表格中新增 --enable-prefill-cp(bool 类型,支持 A2/A3)和 --cp-strategyNone/zigzag/interleave,支持 A2/A3)两行;同时删除已废弃的参数 --disable-piecewise-cuda-graph--enable-nsa-prefill-context-parallel--enable-dsa-prefill-context-parallel--piecewise-cuda-graph-disable-attach-mlp,使文档与当前代码的实际参数对齐。
文件 模块 状态 重要度
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_support_features.mdx 文档 modified 3.52
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_support_models.mdx 文档 modified 3.43
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_quick_start.mdx 文档 modified 2.44

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

风险极低:仅涉及文档描述性内容的增删改,不涉及代码逻辑变更。潜在风险包括:1)新参数描述与代码实际行为不一致;2)删除的废弃参数如果仍有用户在使用,可能导致用户困惑。但鉴于参数更迭已是既定事实,且 PR 由维护者合并,风险可控。

直接影响 Ascend NPU 平台的用户文档体验:快速入门引导更清晰,模型列表覆盖更全面,特性参数文档与代码同步,减少用户因使用已废弃参数导致的配置错误。影响范围仅限于 NPU 文档阅读者,无需代码改动。

纯文档变更

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论