已合并
docs:rename Ascend Extension for PyTorch #2835
kali00创建于 7月14日
docs:rename Ascend Extension for PyTorch #2835
已合并
Pull Request已成功合入, 合并人@ascend-robot
(感谢 kali00 的贡献)atomgit-bot
7月14日 评论:
7月14日 评论:
变更摘要
此 PR 主要是文档层面的术语统一更新:将昇腾生态中 PyTorch 拓展插件的名称从 Ascend Extension for PyTorch / torch_npu 统一更名为 TorchNPU,并同步补充了快速入门指南中的环境最低配置说明。涉及 54 个文档文件,变更集中在用户指南的配置参数、模型迁移指引和环境搭建等章节。
主要改动
- 产品名称统一:将文档中所有
Ascend Extension for PyTorch引用替换为TorchNPU,涵盖链接文字与描述文本(如环境搭建.rst中的下载指引和安装参考链接)。 - 包名/模块名术语更新:将文档中出现的
torch_npu引用统一改为TorchNPU,包括训练参数说明(训练参数.rst中分布式后端 patch 描述)和模型迁移指引(模型迁移.rst中版本推荐说明)。 - 安装指引措辞同步调整:在
环境搭建.rst的 PyTorch 安装章节中,将章节标题、命令说明及示例中的torch_npu全部替换为TorchNPU,保持安装文档与新命名一致。


不准确?
atomgit-bot
7月14日 评论:
7月14日 评论:
代码审查
所有 54 个文件均已完成逐一审查。以下是最终审查摘要:
审查结论
发现问题汇总
| 优先级 | 数量 | 说明 |
|---|---|---|
| P1 | 1 | NPU 数量描述矛盾(quickstart_fsdp2.md) |
| P2 | 2 | 空格缺失(install_guide.md);FSDP2 模型参考表格被删(quickstart_fsdp2.md) |
各文件审查结果
| 文件 | 结果 |
|---|---|
README.md |
无问题(列头名称变更) |
SECURITYNOTE.md |
无问题(名称变更) |
UserGuide/config/训练参数.rst |
无问题(名称变更) |
UserGuide/dev_guide/模型迁移.rst |
无问题(名称 + 版本说明变更) |
UserGuide/quick_start/环境搭建.rst |
无问题(名称变更) |
docs/zh/FAQ.md |
无问题(名称变更) |
docs/zh/introduction.md |
无问题(名称变更) |
docs/zh/pytorch/args_readme.md |
无问题(描述文案变更) |
docs/zh/pytorch/install_guide.md |
P2:第 53 行 "TorchNPU26.0.0" 缺少空格 |
docs/zh/pytorch/model-migration-guide.md |
无问题(名称变更) |
docs/zh/pytorch/model-migration.md |
无问题(名称变更) |
docs/zh/pytorch/model_migration_dev_guide.md |
无问题(名称变更) |
docs/zh/pytorch/performance_tuning.md |
无问题(名称变更;未改行残留旧名属既有问题) |
docs/zh/pytorch/quickstart.md |
无问题(新增 NOTE + 开发者前置要求 + 修复 shell 续行符) |
docs/zh/pytorch/quickstart_fsdp2.md |
P1:第 20 行 NPUS_PER_NODE=16 vs "需要8个NPU" 矛盾;P2:第 196–212 行 FSDP2 模型样例表格被删除 |
docs/zh/release_notes_mm.md |
无问题(表头重命名 + 新增文档条目 + 病毒扫描日期更新) |
docs/zh/troubleshooting.md |
无问题(名称变更) |
examples/bagel/README.md ~ examples/wan2.2/README.md(37 个文件) |
均无问题(全部为名称替换或描述文案变更) |
整体风险评估:中等
核心发现是 quickstart_fsdp2.md 中的 NPU 数量矛盾(P1),会直接误导用户的硬件资源配置。另外两个 P2 问题——拼写错误(TorchNPU26.0.0)和可能误删的参考表格——影响较小,但仍需处理。其余 51 个文件的修改均为一致且安全的名称替换或文档补充,未发现其他问题。
| 类型 | 数量 |
|---|---|
| 🔴 阻塞 | 1 |
| 🟡 建议 | 1 |
⛔ 需要修改


不准确?
7月14日 添加了label:ascend-cla/yes
此处折叠了101条消息 查看更多
7月21日 解决了最后一个问题
7月21日 合入了pull request
ascend-robot
7月21日 评论:
7月21日 评论:
Pull Request 已合并或已关闭。
If you want to solve this problem, you can click here to do it in the FAQs.


ascend-robot
7月21日 评论:
7月21日 评论:
Pull Request 已合并或已关闭。
If you want to solve this problem, you can click here to do it in the FAQs.


ascend-robot
7月21日 评论:
7月21日 评论:
Pull Request 已合并或已关闭。
If you want to solve this problem, you can click here to do it in the FAQs.


What this PR does / why we need it?
https://gitcode.com/Ascend/MindSpeed-MM/issues/506
1、更新Ascend Extension for PyTorch名称为TorchNPU
2、补充快速入门环境最低配置
Does this PR introduce any user-facing change?
Please describe whether the PR will result in any user-facing usage changes. If there is related documentation, please specify its path.
How was this patch tested?
Please explain how to verify the correctness and effectiveness of this feature, as well as its usage constraints and limitations.