#6983 [doc] feat: update installation instructions for Atlas 950DT A5

原始 PR 作者 fh188 合并时间 2026-07-09 16:12 文件变更 1 提交数 4 评论 1 代码增减 +17 / -13

执行摘要

官方发布后，部分依赖包版本已更新，同时安装步骤中的路径指引不完整，需要同步刷新文档以保证用户能够正确安装。

此 PR 为常规文档维护，无特殊设计决策，建议快速合并。

讨论亮点

无实质性 review 讨论，仅 bot 自动评论提及 transformers 版本变更，且 reviewer 已批准。

在 docs/ascend_tutorial/get_start/install_guidance_A5.rst 中更新版本表格：将 transformers 从 4.57.6 改为 4.57.3，vLLM 从 0.20.2+empty 改为 0.20.2，Megatron-LM 从 core_r0.16.0 改为 core_r0.12.0，MindSpeed 更新 commit hash，triton-ascend 版本简化，torch_npu 改为待定链接。
修正安装命令：在 vLLM 和 vLLM-Ascend 的 pip install 后添加 cd .. 回到上级目录；vLLM 安装改为 VLLM_TARGET_DEVICE=empty pip install -v -e .，vLLM-Ascend 安装添加 --no-build-isolation 等参数。
调整 MindSpeed 和 Megatron-LM 的 git checkout 至新版本，并在 pip install 后补充 cd ..。
更新文档最后更新日期。

文件	模块	状态	重要度
`docs/ascend_tutorial/get_start/install_guidance_A5.rst`	文档	modified	3.1

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

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

风险极低：仅涉及文档内容更新，不修改任何代码；但需确保列出的版本号与真实可用版本一致，否则可能误导用户安装失败。

影响范围仅限于使用 Atlas 950DT A5 硬件并参考此文档安装环境的用户。版本号对齐后用户可按照准确步骤安装，减少出错概率。

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

此 PR 更新了 Atlas 950DT A5 的安装指导文档，主要对齐了多个依赖包的版本号（transformers、vLLM、Megatron-LM、MindSpeed 等），并修正了安装命令中的路径切换缺失问题，确保文档能够正确指导用户完成环境搭建。

官方正式发布后，部分关键依赖（如 transformers、vLLM、Megatron-LM）已发布新版本，同时原文档中 pip install 后缺少 cd .. 返回上级目录的命令，可能导致后续步骤路径错误。本次更新旨在保证文档与当前推荐版本及最佳实践一致。

版本表更新：将 transformers 从 4.57.6 降为 4.57.3（更稳定兼容版本），vLLM 从 0.20.2+empty 改为 0.20.2，Megatron-LM 从 core_r0.16.0 回退至 core_r0.12.0，MindSpeed 更新 commit hash，triton-ascend 版本简化，torch_npu 改为待 Q2 CANN 发布后更新链接。
安装命令修正：在 vLLM 和 vLLM-Ascend 的 pip install 后添加 cd .. 返回上级，避免后续步骤路径混乱；vLLM 安装增加 VLLM_TARGET_DEVICE=empty 环境变量；vLLM-Ascend 安装增加 --no-build-isolation 等参数。
MindSpeed 与 Megatron-LM 步骤调整：更新 git checkout 至新版本，并在 pip install -e . 后增加 cd ..。
文档日期更新：将最后更新日期从 07/08/2026 改为 07/09/2026。

无实质性讨论，仅 Gemini Code Assist 自动评论提及 transformers 版本号变更，且 reviewer 已批准。

与 PR #6981（同一文件但不同提交）功能重叠，建议确认是否需要合并或保留最新变更。