Prhub

#28284 Update documentation for Ascend NPU Guide

原始 PR 作者 longxin9715 合并时间 2026-06-15 20:02 文件变更 4 提交数 11 评论 6 代码增减 +12 / -7

执行摘要

更新 Ascend NPU 文档:镜像版本、离线方案及参数修正

根据 PR body,更新 NPU 文档以解决以下问题:

  1. 网络下载问题,添加 HF 镜像和离线方案;
  2. 统一快速开始中的镜像版本;
  3. 修正 --hicache-write-policy 冲突描述;
  4. 补全优化文档中的参数说明。

此 PR 为纯文档更新,建议部署 NPU 的用户阅读更新后的文档,特别是离线部署和参数配置部分。

讨论亮点
  • 版本一致性:gemini-code-assist[bot]指出 memfabric-hybrid 安装命令更新到 1.0.8 但上方表格仍为 1.0.5,要求同步。作者已更新表格。

  • 列表渲染:bot 和 amote-i 均指出列表前缺少空行可能导致渲染失败,建议添加换行。作者已添加。

  • 版本存在确认:amote-i 要求确认 quick start 中新镜像版本存在。作者确认后合并。

实现拆解

  1. 统一 Docker 镜像版本:修改 ascend_npu_quick_start.mdx,将 Atlas 800I A3 和 910B 的稳定版本分别更新为 v0.5.13.post1-cann9.0.0-a3v0.5.13.post1-cann9.0.0-910b,与每日构建版本保持统一格式,减少用户混淆。

  2. 添加 Hugging Face 离线方案:修改 ascend_npu_performance_testing.mdx,在性能测试的 Note 中,除了原有的 export HF_ENDPOINT=https://hf-mirror.com,新增通过 --dataset-path 指定本地数据集文件的离线方法,解决网络不可用时的部署问题。

  3. 补全参数别名:修改 ascend_npu_optimization.mdx,在解码优化参数表格中为 --dp-size--ep 分别补充别名 --data-parallel-size--ep-size / --expert-parallel-size,使用户更易找到对应参数。

  4. 修正 HiCache 写策略描述:修改 ascend_npu_support_features.mdx,将 --hicache-write-policy 的 Supported Values 从仅 write_back 更新为 write_backwrite_throughwrite_through_selective,消除与默认值描述的矛盾。

  5. 根据 Review 意见微调格式:在多个文件中处理了列表前的空行、多余空格等渲染问题,并确认版本号存在。

文件 模块 状态 重要度
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_performance_testing.mdx 文档 modified 3.25
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_quick_start.mdx 文档 modified 3.01
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_optimization.mdx 文档 modified 2.52
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_support_features.mdx 文档 modified 2.14

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

评论区精华

memfabric-hybrid 版本不一致 documentation

gemini-code-assist[bot] 指出安装命令已更新到 1.0.8,但上方的版本表仍为 1.0.5,建议同步更新。

结论:作者已更新表格版本。 · 已解决

列表前缺少空行导致渲染问题 style

gemini-code-assist[bot] 和 amote-i 均指出列表前需要空行以确保正确渲染。

结论:作者添加了空行。 · 已解决

确认镜像版本存在 question

amote-i 要求在 quick start 中确保新版本号在实际中已发布。

结论:作者确认版本存在。 · 已解决

风险与影响

低风险。主要风险在于文档版本与实际发布版本不一致(reviewer 已确认),以及格式问题影响渲染(已修复)。对系统运行无影响。

影响面向 Ascend NPU 用户的文档可用性和准确性。离线下载方案的添加特别有助于在中国大陆网络环境下部署的用户。版本统一降低了混淆风险。

文档版本不一致风险 渲染格式风险

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论