Prhub

#28279 [NPU] fix ascend_docs

原始 PR 作者 Hide-on-bushsh 合并时间 2026-06-15 21:11 文件变更 4 提交数 4 评论 3 代码增减 +36 / -262

执行摘要

更新 Ascend NPU 文档:移除 AISBench、升级依赖、修正命令

修正 Ascend NPU 文档中的过时信息和错误,确保指南与最新版本和工具链保持一致。PR body 仅说明 'fix ascend_docs',隐含清理目的。

属于常规文档维护,值得快速通过。注意 review 中指出的 'two tools' 描述残留应确认已修复;若无,应在合并前补充修正。依赖版本升级建议在发布说明中同步标注。

讨论亮点

Review 中 gemini-code-assist[bot] 指出 ascend_npu_accuracy_evaluation.mdx 描述仍写着 'two tools: EvalScope',由于 AISBench 已移除,应改为仅提及 EvalScope。该评论后由 sglang-npu-bot 直接 approve,未在讨论中确认是否修复合入。

实现拆解

  1. 大幅精简 Accuracy Evaluation 文档 (ascend_npu_accuracy_evaluation.mdx):移除 AISBench 相关全部内容(约 250 行),仅保留 EvalScope 评测指南;将命令参数 --eval-type server 改为 --eval-type openai_api,数据集名 math 改为 math_500mmbench 改为 mm_bench;新增代理环境变量 unset 的 Warning 块。
  2. 升级依赖版本 (ascend_npu.mdx):更新 MemFabric-Hybrid 从 1.0.5 到 1.0.8,PyTorch 从 2.8.0 到 2.10.0,TorchVision 从 0.23.0 到 0.25.0,TorchNPU 从 2.8.0.post2 到 2.10.0,并将 triton-ascend 安装命令固定为 ==3.2.1 版本。
  3. 修正 FAQ 代码片段格式 (ascend_npu_faq.mdx):调整 out_indices 初始化代码的缩进,使其符合 Python 语法。
  4. 调整算子开发测试示例 (ascend_npu_operator_development.mdx):将测试张量形状从 (1024,) 改为 (2048,),数据类型从 bfloat16 改为 float16,与 NPU 实际适配场景一致。
文件 模块 状态 重要度
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_accuracy_evaluation.mdx NPU 文档 modified 5.78
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu.mdx NPU 文档 modified 3.96
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_faq.mdx NPU 文档 modified 3.16
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_operator_development.mdx NPU 文档 modified 2.32

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

评论区精华

AISBench 移除后文本仍称 'two tools' documentation

gemini-code-assist[bot] 指出 accuracy evaluation 文档描述写 'two tools: EvalScope',但 AISBench 已移除,应改为 'using EvalScope'。

结论:未在讨论中明确确认是否修改,但 PR 已由 sglang-npu-bot approve 并合并。可能后续 commit 已修正或视为小问题。 · 已解决

风险与影响

低风险。仅涉及文档内容修订,不触及任何源码逻辑。主要风险包括:

  • ascend_npu.mdx 中依赖版本升级可能要求用户环境相应更新,若用户基于旧版本则需注意兼容性。
  • ascend_npu_accuracy_evaluation.mdx 中命令参数 --eval-type openai_api 和数据集 math_500 需确保与 EvalScope 最新版本匹配。
  • ascend_npu_operator_development.mdx 的测试示例改动不影响现有功能,但若用户照抄可能因显存需求增加需调整。

影响范围限于 Ascend NPU 用户文档阅读者。更新后文档与当前工具链(EvalScope 替代 AISBench、新版本依赖)保持一致,降低用户困惑。移除大量过时内容使文档更聚焦。无 API 或行为变更,对系统运行无影响。

文档描述不一致风险 依赖版本变更需用户注意

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论