Prhub

#37799 [NPU] [DOC] Refresh supported models and features on NPU

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

执行摘要

NPU 平台文档更新,修正模型支持列表和功能状态。

根据 PR body,动机是“Refresh supported models and features on NPU”和“Fix some docs issues on NPU”。目的是确保文档反映 NPU 平台当前的实际情况,避免用户参考过时或不准确的信息进行配置和部署。

该 PR 是一个标准的文档维护任务,值得快速审阅。它移除了可能引起困惑的过时模型支持信息,并统一了功能状态的表述,有助于保持文档的清洁和准确。对于关注 NPU 平台功能的团队成员,确认这些变更是最终状态即可。

讨论亮点

本次 PR 的 review 过程非常直接,没有产生任何讨论。由自动化 bot sglang-npu-bot 直接批准并合并,表明这是一个低风险、明确的文档维护任务。

实现拆解

  1. 更新受支持的模型列表:在 docs/docs/hardware-platforms/ascend-npus/reference/support_models.mdx 文件中,从模型支持矩阵中移除了两行:FLM/Tele-FLM(Tele FLM 52B-1T)和 AI-ModelScope/clip-vit-large-patch14-336(CLIP)。
  2. 修正功能状态描述:在 docs/docs/hardware-platforms/ascend-npus/reference/support_features.mdx 文件中,将 --enable-attn-tp-input-scattered 参数支持硬件一列从具体型号 “A2, A3” 更改为更通用的 “Experimental”。
  3. 修复文档示例拼写:在 docs/docs/hardware-platforms/ascend-npus/optimization/profiling.mdx 和 docs/docs/hardware-platforms/ascend-npus/development/operator_performance_optimizing.mdx 文件中,分别修正了日志示例和表格示例中的微小拼写错误(增加空格、修正数字)。
文件 模块 状态 重要度
docs/docs/hardware-platforms/ascend-npus/reference/support_models.mdx 文档 modified 3.26
docs/docs/hardware-platforms/ascend-npus/reference/support_features.mdx 文档 modified 2.54
docs/docs/hardware-platforms/ascend-npus/optimization/profiling.mdx 文档 modified 2.31
docs/docs/hardware-platforms/ascend-npus/development/operator_performance_optimizing.mdx 文档 modified 2.14

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

评论区精华

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

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

风险与影响

风险极低。本次变更仅涉及文档文件(.mdx),不涉及任何可执行代码、内核、模型逻辑或部署配置。主要风险在于文档更新可能滞后于实际代码支持状态,但此次更新本身即是为了纠正此类偏差。

影响范围:仅限于查阅 SGLang NPU 平台文档的用户(开发者、运维人员)。
影响程度:帮助用户更准确地了解哪些模型和功能可以在 NPU 上运行,避免因文档误导而进行错误的配置尝试,提升了文档的可靠性和用户体验。

纯文档变更

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论