已关闭
[Documentation|文档反馈]: #3840
m0_66486191创建于  7月4日关闭于  7月24日
m0_66486191
m0_66486191
7月4日 创建

Thanks for sending an issue! Please fill in the following template to help quickly solve your problem.

Document Link(文档链接)

docs/QUICKSTART.md

Issues Section(问题文档片段)

QuickStart 文档中涉及以下内容:

非 CANNLab 环境需要根据 release 仓库中的源码与 CANN 版本配套关系下载源码;
编译 AddExample 算子时需要指定 --soc=${soc_version};
文档列出了 Atlas A2、Atlas A3、950 系列产品对应的 soc_version;
文档说明快速入门默认采用单算子编译,整库编译需要查看源码构建指南。

Existing Issues(存在的问题)

当前 QuickStart 已经能够指导用户完成 AddExample 算子的编译、安装和运行,但对于第一次接触 ops-nn / CANN 算子开发的新用户来说,仍然可能存在以下理解成本:

版本配套关系入口不够直观
文档提示需要根据 release 仓库确认 CANN 版本与 ops-nn 源码 tag 的配套关系,但没有在 QuickStart 中给出一个简单的“确认步骤”或“检查清单”。新手可能直接使用 master 分支,导致后续出现 CANN 包版本与源码不匹配的问题。
soc_version 参数选择容易出错
文档列出了部分产品系列对应的 soc_version,但对于不熟悉 Ascend 产品型号的用户,仍然不容易判断自己应该填写 ascend910b、ascend910_93 还是 ascend950。如果参数填错,编译失败时用户也不一定能快速定位到是芯片版本参数问题。
缺少常见失败现象与排查建议
QuickStart 目前主要展示正常流程,但新手在非 CANNLab / 非 Docker 环境中可能遇到环境变量未配置、CANN 路径不正确、源码分支不匹配、--soc 参数错误、依赖缺失、run 包安装后运行找不到库等问题。建议增加一个简短的 FAQ 或 Troubleshooting 小节。
单算子编译与全量编译的适用场景可以更明确
文档提到默认采用单算子编译,整库编译请参阅源码构建指南。建议进一步说明:快速入门、单个算子开发和调试推荐使用 --ops=<算子名>;只有需要构建完整算子包或进行整库验证时再考虑省略 --ops 进行全量编译。

likedislike
yuning_chenyuning_chen成员
7月4日 将 caiwenwen 设为负责人
yuning_chen
yuning_chen成员
7月4日 评论:

您好,感谢反馈,问题已收到,当前 @caiwenwen 正在跟踪处理。

likedislike
Ccaiwenwen成员
7月23日 issue状态由 进行中 改变为 挂起
Ccaiwenwen成员
7月24日 issue状态由 挂起 改变为 已完成
Ccaiwenwen成员
7月24日 关闭了 issue
caiwenwen成员
7月24日 评论:

您的反馈已经收到,我们会在下一个阶段采取措施

likedislike
Ccaiwenwen成员
23 天前 关联了pull request:fix quickstart
Ccaiwenwen成员
23 天前 关联了pull request:fix quickstart 9.1.0
Ccaiwenwen成员
23 天前 关联了pull request:fix QUICKATRAT
CANN-robotCANN-robot成员
22 天前 添加了label:resolved
Ccaiwenwen成员
22 天前 关联了pull request:fix quickstart
Ccaiwenwen成员
1 天前 关联了pull request:fix quickstart
Ccaiwenwen成员
1 天前 删除了关联的pull request:fix quickstart